前言¶
DSH 的理念是「一切皆插件」，擴展能力通常以插件方式掛到 dsh 進程上。對於已經在用 dsh Web UI、但希望以桌面窗口方式使用的場景，ahikl/dsh-desktop 提供了一個桌面端插件：使用 Electron 包裝 dsh Web UI，並提供系統托盤與自定義標題欄。
這是什麼¶
dsh-desktop 是 ahikl 維護的 DeepSeek Harness 桌面端插件。它是一個 out-of-tree 插件，不修改 dsh 源碼，也不把 Electron 引入 dsh 依賴樹。許可證爲 MIT。
核心功能¶
下面介紹幾個桌面端能力。
- 使用 Electron 加載 dsh Web UI。
- 無邊框窗口 + dsh 風格標題欄，自動跟隨主題。
- 系統托盤：顯示主窗口、打開瀏覽器、退出。
- 關閉窗口時最小化到托盤。
- URL 解析優先級：
--url> Web Server 端口 > 自動啓動dsh web。
安裝與啓用¶
先安裝插件，再運行 desktop 命令：
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop
如果要顯式指定 Web UI 地址，使用 --url：
dsh --profile desktop desktop --url http://127.0.0.1:3080
0.3.1 及以下版本已廢棄，請使用最新版。
典型用法¶
沒有安裝 dsh-web-app 時，桌面插件會自動啓動官方 Web UI：
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop
已經安裝 dsh-web-app 時，可以按下面的組合安裝，再運行：
dsh plugin --profile desktop add @ahikl/dsh-desktop @deepseek-ai/dsh-web-app electron
dsh --profile desktop desktop
經過上面的步驟，桌面端會按 --url、Web Server 端口、自動啓動 dsh web 的順序解析目標地址。
適用場景與注意¶
適合希望把 dsh Web UI 放到桌面窗口中使用、需要托盤入口和標題欄的開發者。
注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
package.json聲明electron爲可選 peerDependency。- 該插件不修改 dsh 源碼，也不把 Electron 引入 dsh 依賴樹。
鏈接¶
- GitHub：https://github.com/ahikl/dsh-desktop
- 目錄頁：https://www.skillhub.cn/plugins/ahikl/dsh-desktop
