DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.
#[cfg(windows)]
use std::sync::atomic::AtomicBool;
#[cfg(windows)]
use std::sync::Arc;
#[cfg(windows)]
use tauri::webview::{PageLoadEvent, PageLoadPayload};
use tauri::{
webview::{DownloadEvent, NewWindowFeatures, NewWindowResponse},
AppHandle, Emitter, Runtime, Url, Webview, WebviewWindow, Wry,
};
use tauri_plugin_opener::OpenerExt;
use crate::config;
use crate::desktop::payload::DownloadFinishedPayload;
/// 接管内嵌 iframe 的 `window.open()` / `target=_blank` 新窗口请求:
/// WebView2 里这类请求走 NewWindowRequested,wry 在没有 handler 时直接吞掉。
/// 这里把 http(s) 链接交给系统浏览器打开,其余协议一律拒绝。
pub fn on_new_window<R: Runtime>(
app_handle: tauri::AppHandle<R>,
url: Url,
_features: NewWindowFeatures,
) -> NewWindowResponse<R> {
if matches!(url.scheme(), "http" | "https") {
if let Err(e) = app_handle.opener().open_url(url.to_string(), None::<&str>) {
log::warn!("[new-window] open in browser failed {e}");
}
} else {
log::debug!("[new-window] denied {url}");
}
NewWindowResponse::Deny
}
/// 接管下载:保存到系统下载目录,重名时自动加 " (n)" 后缀,
/// 完成后向前端 emit `harness-download-finished`。
pub fn on_download<R: Runtime>(webview: Webview<R>, event: DownloadEvent<'_>) -> bool {
match event {
DownloadEvent::Requested { url, destination } => {
*destination = config::unique_download_path(destination);
log::info!("[download] requested {} -> {}", url, destination.display());
true
}
DownloadEvent::Finished { url, path, success } => {
let path_str = path.as_ref().map(|p| p.to_string_lossy().to_string());
let payload = DownloadFinishedPayload {
url: url.to_string(),
path: path_str,
success,
};
let _ = webview.emit("harness-download-finished", payload);
log::info!(
"[download] finished {} success={} path={:?}",
url,
success,
path
);
true
}
// DownloadEvent 为 #[non_exhaustive],预留未来变体
_ => true,
}
}
/// 关掉 WebView2 的外部拖放(`AllowExternalDrop`)。
///
/// wry 只在它自己接管拖放时才关闭该开关(`drop_handler` 为空就跳过);本项目用
/// `disable_drag_drop_handler()` 关掉了那份接管以恢复 iframe 内的 HTML5 拖拽,
/// 于是开关留在默认开启状态。而开启时,在页面内拖放文本会让 WebView2 卡在失效的
/// 鼠标捕获上:选中无法取消、点击与输入失效、滚轮仍可用(WebView2Feedback #5141 /
/// #5613)。这里补回这道防护——它只影响外部拖放,页面内 HTML5 拖拽不受影响。
#[cfg(windows)]
pub fn disable_external_drop(webview: &tauri::webview::PlatformWebview) {
use webview2_com::Microsoft::Web::WebView2::Win32::ICoreWebView2Controller4;
use windows_core::Interface;
unsafe {
match webview.controller().cast::<ICoreWebView2Controller4>() {
Ok(controller) => {
if let Err(e) = controller.SetAllowExternalDrop(false) {
log::warn!("[webview] failed to disable external drop: {e}");
}
}
Err(e) => log::warn!("[webview] ICoreWebView2Controller4 unavailable: {e}"),
}
}
}
#[cfg(windows)]
pub fn on_page_load(
webview_window: WebviewWindow<Wry>,
payload: PageLoadPayload<'_>,
notification_handlers_registered_for_page: Arc<AtomicBool>,
) {
// Windows 依赖 WebView2 的 FramePermissionRequested / FrameCreated 机制,
// 需要在页面加载时注册;非 Windows 已在 build_main_window 里通过
// initialization_script_for_all_frames 注入,这里不需要再做处理。
if payload.event() != PageLoadEvent::Started {
return;
}
log::info!("[webview] on_page_load started");
if !notification_handlers_registered_for_page.swap(true, std::sync::atomic::Ordering::SeqCst) {
log::info!("[notification] top-level page load started; scheduling handler registration");
let parent = webview_window.clone();
if let Err(e) = webview_window.with_webview(move |platform| {
disable_external_drop(&platform);
if let Err(error) = crate::desktop::frontend_preload::install(&platform, &parent) {
log::warn!("FRONTEND_PRELOAD_UNAVAILABLE: {error}");
}
if let Err(e) =
crate::desktop::notification::enable_notification_permissions(platform, parent)
{
log::warn!("[webview] failed to enable notification permission: {e}");
}
}) {
log::warn!("[webview] failed to schedule notification permission setup: {e}");
}
}
}
/// 跳转信息全局名(与 `packages/dsh-tauri/src/client/register/navigation.ts` 逐字一致)。
const NAVIGATION_GLOBAL: &str = "__DSH_NAVIGATION__";
/// 「全屏右栏」窗口形态:壳层换用 `full-sidebar-navbar`,页面把右栏展开并切进全屏。
/// 载荷值同样与插件 `sidebar-fullwindow.ts` 逐字一致。
const PRESENTATION_FULL_SIDEBAR: &str = "full-sidebar";
/// 壳层导航栏「文件 → 新建窗口」:以同一 `index.html` 再开一个独立 webview 窗口。
///
/// 传入 `session_id` 时把跳转目标注入新窗口的全部 frame,由 dsh-tauri 插件在启动后接收并
/// 打开该会话。注入而不是拼 `index.html#...`:hash 只有壳层可读,内嵌 dsh 的插件拿不到,
/// 只能退回壳层轮询转发,并把新窗口误当成 remote 视图。
///
/// `presentation` 与 `session_id` 同行:壳层读它决定导航栏形态,插件读它把右栏展开成全屏。
///
/// 异步命令(不占用主线程)是唯一安全的调用侧:`WebviewWindowBuilder::build()`
/// 需要主线程事件循环回包,主线程调用会死锁(与 `pet::ensure_pet_window` 同约束)。
#[tauri::command]
pub async fn create_app_window(
app_handle: AppHandle<Wry>,
window: WebviewWindow<Wry>,
session_id: Option<String>,
presentation: Option<String>,
) -> Result<(), String> {
if let Some(value) = presentation.as_deref() {
if value != PRESENTATION_FULL_SIDEBAR {
return Err("WINDOW_CREATE_FAILED: unsupported presentation".into());
}
if session_id.is_none() {
return Err("WINDOW_CREATE_FAILED: presentation requires sessionId".into());
}
}
log::info!(
"[window] create_app_window from {}: session={session_id:?} presentation={presentation:?}",
window.label()
);
let navigation = session_id
.as_deref()
.map(|session_id| session_navigation_script(session_id, presentation.as_deref()))
.transpose()?;
let _transition = crate::service::workflow::acquire_core_transition().await?;
let profile = crate::service::workflow::instances::window_profile(&app_handle, window.label());
crate::desktop::builder::build_extra_window(
&app_handle,
"index.html".into(),
&profile,
navigation.as_deref(),
)
.map(|_| ())
.map_err(|error| format!("WINDOW_CREATE_FAILED: {error}"))
}
/// 校验会话 id 与窗口形态并生成跳转脚本;JSON 序列化负责转义,避免把用户输入拼成可执行代码。
fn session_navigation_script(
session_id: &str,
presentation: Option<&str>,
) -> Result<String, String> {
if session_id.trim().is_empty() || session_id.len() > 512 {
return Err("WINDOW_CREATE_FAILED: invalid sessionId".into());
}
let payload = match presentation {
None => serde_json::json!({ "sessionId": session_id }),
Some(PRESENTATION_FULL_SIDEBAR) => serde_json::json!({
"sessionId": session_id,
"presentation": PRESENTATION_FULL_SIDEBAR,
}),
Some(_) => return Err("WINDOW_CREATE_FAILED: unsupported presentation".into()),
};
Ok(format!("globalThis.{NAVIGATION_GLOBAL} = {payload};"))
}
#[cfg(test)]
mod session_navigation_tests {
use super::{session_navigation_script, NAVIGATION_GLOBAL, PRESENTATION_FULL_SIDEBAR};
fn payload_of(script: &str) -> serde_json::Value {
let assignment = format!("globalThis.{NAVIGATION_GLOBAL} = ");
let payload = script
.strip_prefix(assignment.as_str())
.and_then(|rest| rest.strip_suffix(';'))
.expect("script is one global assignment");
serde_json::from_str(payload).expect("payload is json")
}
#[test]
fn session_navigation_script_assigns_the_session_target_to_the_shared_global() {
assert_eq!(
session_navigation_script("session &/?#", None).unwrap(),
r#"globalThis.__DSH_NAVIGATION__ = {"sessionId":"session &/?#"};"#
);
}
#[test]
fn session_navigation_script_escapes_values_through_json_serialization() {
assert_eq!(
session_navigation_script("a\"b\\c\nd", None).unwrap(),
r#"globalThis.__DSH_NAVIGATION__ = {"sessionId":"a\"b\\c\nd"};"#
);
}
#[test]
fn session_navigation_script_carries_the_full_sidebar_presentation() {
let payload = payload_of(
&session_navigation_script("session-1", Some(PRESENTATION_FULL_SIDEBAR)).unwrap(),
);
assert_eq!(payload["sessionId"], "session-1");
assert_eq!(payload["presentation"], PRESENTATION_FULL_SIDEBAR);
}
#[test]
fn session_navigation_script_rejects_unknown_presentations() {
assert_eq!(
session_navigation_script("session-1", Some("detached")),
Err("WINDOW_CREATE_FAILED: unsupported presentation".into())
);
}
#[test]
fn session_navigation_script_rejects_empty_blank_or_oversized_identifiers() {
for id in ["", " ", " \t\n", &"s".repeat(513)] {
assert_eq!(
session_navigation_script(id, None),
Err("WINDOW_CREATE_FAILED: invalid sessionId".into())
);
}
assert!(session_navigation_script(&"s".repeat(512), None).is_ok());
}
}
/// 壳层导航栏「文件 → 退出」:与托盘「退出」同语义,走 `exit(0)` 完整退出
/// (触发 `RunEvent::ExitRequested` 的主窗口几何保存与 `RunEvent::Exit` 的进程回收)。
#[tauri::command]
pub fn quit_app(app_handle: AppHandle<Wry>) {
app_handle.exit(0);
}
/// 壳层「帮助 → 切换开发者工具」:开/关调用方所在窗口的 WebView 检查器。
///
/// 「切换」只能做到近似:只有 macOS 的 wkwebview 如实回报检查器状态;
/// Windows 侧(wry 0.57 + WebView2)`is_devtools_open()` 恒为 false 且
/// `close_devtools()` 是空实现,重复调用等价于再次打开/聚焦,不会误关。
#[tauri::command]
pub fn toggle_devtools(window: WebviewWindow<Wry>) {
if window.is_devtools_open() {
window.close_devtools();
} else {
window.open_devtools();
}
}