Skip to content

DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.

11.0 KB
Raw Blame
#[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();
    }
}