DeepSeek Harness (DSH) 默認通過瀏覽器訪問其 Web UI。對於習慣本地應用的開發者來說,每次啓動都打開標籤頁略顯繁瑣。dsh-plugin-desktop 插件提供了一種替代方案,它允許 DSH 的 Web 界面在本地原生窗口中運行,而不是作爲瀏覽器標籤頁。
這是一個由 kkaktus463 維護的插件。它的核心作用是攔截 DSH 的 Web 啓動請求,將其呈現爲桌面窗口。它不會啓動新的 Harness 進程,而是將現有進程附加到窗口上。所有權保持在一個地方:Harness 的生命週期長於窗口,關閉窗口永遠不會停止服務器。
核心功能¶
該插件提供以下能力:
- 在原生窗口中打開 DeepSeek Harness Web UI。
- 將現有服務器進程附加到窗口。
- 允許配置 host、port 和 executable。
- 檢查並啓動 DSH Desktop 應用程序。
安裝與啓用¶
使用官方 CLI 安裝插件:
dsh plugin --profile web add dsh-plugin-desktop
如果使用本地目錄,可以使用:
dsh plugin --profile web add ./dsh-plugin-desktop
安裝後,檢查配置是否生效(不啓動 Harness):
dsh --profile web --dump-config
典型用法¶
默認情況下,插件會從環境變量或搜索路徑中查找 dsh-desktop.exe。如果自動查找失敗,可以在配置文件中指定路徑。
配置文件位置通常爲 $DSH_HOME/profiles/web/cordis.patch.yml:
- id: desktop
config:
executable: 'C:\Tools\DSH Desktop\dsh-desktop.exe'
注意:補丁會替換整行 config,因此覆蓋必須重申它需要的每個字段,而不僅僅是更改的字段。
適用場景與注意¶
- 系統要求:目前僅支持 Windows 系統。
- 依賴:需要安裝 DSH Desktop 應用程序,否則會顯示警告,界面將回退到瀏覽器。
- 權限與行爲:插件以當前 DSH 進程的權限運行。關閉原生窗口不會停止 DeepSeek Harness 服務器,服務器生命週期獨立於窗口。
- 網絡綁定:如果服務器綁定到非環回地址(如 0.0.0.0 或局域網 IP),窗口不會打開,因爲此時瀏覽器是更合適的訪問入口。
通過這個插件,可以將 DSH 的開發體驗更貼近桌面應用。該插件遵循 MIT 許可證。更多細節可查閱 GitHub 倉庫:https://github.com/kkaktus463/dsh-plugin-desktop