DeepSeek Harness (DSH) 的 Web 模式通常在瀏覽器中運行。如果你需要桌面客戶端,同時希望複用現有的 Web 配置、插件和會話狀態,dsh-web-desktop 提供了一個非侵入式的 Electron 啓動方案。
插件介紹¶
該插件由 ningbonb 維護,定位爲 Electron launcher for an existing Web profile。它通過定位打包的 overlay,使用相同的 Web profile 啓動 Electron,不修改 DSH 核心。
核心功能¶
- 保持對齊:Web 入口和 Electron 啓動器共享同一個 Web profile,包括已安裝的插件、會話、模型設置以及
cordis.patch.yml配置。 - 非侵入式擴展:僅作爲 profile bundle 和 launcher 安裝,不改變 DSH 核心代碼、agent loop 或 Web UI 代碼。
- 跟隨更新:啓動器通過當前的
pnpm dsh啓動 Web profile,因此 DSH 更新後,它會自動複用更新後的 Web 實現和已安裝的插件。
安裝與啓用¶
安裝該插件到現有的 Web profile:
pnpm dsh plugin --profile web add dsh-web-desktop
安裝後,DSH 會將此 bundle 追加到 Web profile 中,且在正常的 dsh web 啓動過程中保持禁用狀態。
典型用法¶
通過命令行啓動 Electron 窗口:
pnpm dsh plugin --profile web exec dsh-web-desktop
pnpm dsh web 繼續使用瀏覽器,而 dsh-web-desktop 命令使用 Electron,兩者共享同一個 Web profile。
若需要指定端口,可以使用 -- 將參數轉發給 Web profile:
pnpm dsh plugin --profile web exec dsh-web-desktop -- --port 8080
適用場景與注意事項¶
該插件適合需要在桌面端使用 DeepSeek Harness,但又希望與瀏覽器端配置保持一致的開發者。安裝前應檢查源碼與許可證。
注意事項如下:
- 不創建配置:該插件不會創建或複製 profile,它僅定位已存在的 profile。
- 運行模式:首個版本爲桌面模式包,不是原生 IPC 客戶端。DSH Web Host 繼續提供現有的 HTTP 和 WebSocket carrier。
- 進程管理:關閉 Electron 窗口不會停止 Web Host 的運行,這與關閉普通瀏覽器標籤頁的行爲一致。
- 兼容性:Electron 必須與當前安裝的 DeepSeek Harness 保持兼容。