DeepSeek Harness (DSH) 是用於開發智能體的工具，其 Web UI 默認在瀏覽器中運行。在長期開發或調試過程中，瀏覽器標籤頁容易堆積，且日常瀏覽記錄可能會與開發環境混雜。dsh-desktop-window 插件通過在獨立應用窗口中打開 DSH Web UI，解決了這個問題。該窗口不包含標籤欄和地址欄，且使用獨立的瀏覽器配置文件，確保了與日常瀏覽的隔離。
核心功能¶
該插件提供以下功能：
- 自動打開：啓動時默認自動打開獨立窗口。
- 手動切換：在會話標題欄提供開關按鈕，可隨時打開或關閉窗口。
- 設置項控制：在設置 -> 常規中提供自動開啓的開關，配置持久化。
- 品牌標識：注入官方鯨魚圖標和 Web Manifest，使窗口標題欄和安裝爲應用後顯示 DeepSeek 圖標。
- 環境隔離：使用獨立的瀏覽器配置文件，位於
%TEMP%目錄，日常瀏覽不受影響。 - 跨平臺支持：支持 Windows 10/11、macOS 11+ 和 Linux。
- 進程管理：關閉窗口時會同步狀態並釋放進程樹。
安裝與啓用¶
安裝前請確保 DeepSeek Harness 版本不低於 0.1.0-rc.6。
運行以下命令安裝插件：
dsh plugin --profile web add github:fengzhiyushui/dsh-desktop-window
安裝完成後，必須重啓 dsh web 進程，配置纔會生效。
使用方法¶
安裝插件後，運行 dsh web 即可啓動服務器。一旦服務器就緒，獨立窗口會自動打開。
- 切換窗口：在會話標題欄點擊窗口按鈕。
- 控制自動打開：進入設置 -> 常規 -> 自動打開，開啓或關閉此功能。
- 調整瀏覽器偏好：編輯
lib/window-spec.js文件中的browserCandidates()方法，改變瀏覽器選擇邏輯。 - Windows 快捷方式：在 Windows 上，運行
<plugin-dir>\scripts\create-shortcut.ps1腳本可創建桌面快捷方式。
配置與注意事項¶
插件配置文件位於 $DSH_HOME/desktop-window.json（默認爲 %USERPROFILE%\.dsh\desktop-window.json）。你可以直接編輯此 JSON 文件，也可以在設置界面中修改。
{
"autoOpen": true,
"cleanProfileOnUnload": false
}
autoOpen：啓動時是否自動打開窗口。cleanProfileOnUnload：插件卸載時是否刪除專用瀏覽器配置文件。設爲false時，配置文件會持久化，下次打開窗口會更快。
重要注意事項：
- 任務欄圖標：由於該窗口以 Chromium
--app模式運行，Windows 任務欄或 macOS Dock 默認顯示的是瀏覽器圖標而非鯨魚圖標。若要顯示鯨魚圖標，需將頁面安裝爲應用（Edge 菜單 -> Apps -> Install this site as an app）。 - 進程狀態：關閉獨立窗口不會停止
dsh進程，兩者是獨立的。 - 運行機制：這是一個瀏覽器窗口，而非嵌入的 WebView。
- 身份驗證：打開窗口不進行身份驗證，跨站點請求需檢查 Origin 頭。
生態背景¶
DeepSeek Harness (DSH) 採用了“一切皆插件”的理念，旨在通過插件擴展工具能力。dsh-desktop-window 是社區維護的插件之一，由開發者 fengzhiyushui 創建，遵循 MIT 許可證。更多詳情與源碼，請訪問 GitHub 倉庫 或 SkillHub 插件目錄。
