前言¶
在 DSH 的“一切皆插件”思路下,DeepSeek Harness 官方 WebUI 已經提供了主要的業務界面能力。如果希望它更貼近日常桌面使用,常見需求是:想要原生窗口按鈕、托盤和快捷入口,又不想單獨安裝 MSI、DMG 或 AppImage,也不想複製、分叉或重新實現官方 WebUI。
下面介紹 @anestis271/dsh-desktop。它先保留官方 WebUI 的能力,再在外面加一層桌面應用外殼,讓入口和系統集成更接近傳統桌面程序。
這是什麼¶
@anestis271/dsh-desktop 是一個面向 DSH 的 npm 插件,定位是“讓 DeepSeek Harness 官方 WebUI 自然地成爲一個桌面應用”。它通過 dsh plugin 安裝,不要求單獨下載桌面安裝包。
它解決的核心問題是:不新增一套獨立桌面安裝物,也不把官方 WebUI 複製成另一套客戶端;安裝後通過 --profile desktop 啓動,即可獲得桌面窗口、托盤和可選快捷入口。
核心功能¶
- 將 DeepSeek Harness 官方 WebUI 包裝爲桌面應用外殼。
- 保留官方 WebUI 能力,不復制、不分叉、不重新實現界面。
- 提供系統托盤、原生窗口按鈕、協調一致的標題欄和可選快捷入口。
- 關閉窗口時可收起到系統托盤。
- 托盤菜單支持顯示/隱藏、刷新、打開 profile 目錄和退出。
- 托盤菜單跟隨 dsh 的中英文設置即時切換。
- 同一 profile 始終只保留一個窗口和一個托盤實例。
- 支持 Windows、macOS 和 Linux 的用戶級快捷入口。
- 再次點擊快捷方式時直接喚起現有窗口,不重複創建 dsh 和 WebUI 實例。
- 快捷入口只啓動
dsh --profile desktop,不安裝另一份 Electron,也不需要管理員權限。 - 插件只負責窗口與系統集成,不增加第二套業務狀態、賬號體系或後臺服務。
安裝與啓用¶
先檢查環境¶
先確認 Node.js、pnpm 和 dsh 都可用。Node.js 版本需要滿足:
^22.19.0 或 >=24.0.0
在終端中執行:
pnpm --version
如果命令可以正常返回版本,說明 pnpm 可執行。同時確認 dsh 已安裝,並可以在終端中正常運行。
安裝插件¶
檢查完成後,執行下面命令把插件安裝到 desktop profile:
dsh plugin --profile desktop add @anestis271/dsh-desktop
經過上面的步驟後,插件已加入對應的 dsh profile。
啓動桌面外殼¶
運行下面命令啓動:
dsh --profile desktop
首次啓動時,插件會下載並解壓當前平臺所需的 Electron 運行環境。下載大小和耗時取決於平臺與網絡狀況。下載進度到達 100% 後仍可能需要等待片刻完成解壓,不要中斷進程。準備完成後,後續啓動會直接複用 profile 中的 Electron 緩存。
典型用法¶
啓動 dsh Desktop 後,可在官方 WebUI 的“設置 → 通用設置”中按需創建桌面快捷方式和應用菜單入口。
登錄時啓動默認關閉,可在同一位置開啓。創建入口後,這些入口仍然只啓動:
dsh --profile desktop
也就是說,它不會安裝另一份 Electron,也不需要管理員權限。macOS 使用系統自帶的 osacompile 生成本地 AppleScript 快捷應用。登錄啓動關閉後,插件只會移除由它自己創建的入口。
適用場景與注意¶
適合需要把 DeepSeek Harness 官方 WebUI 當作桌面入口使用的人,尤其是希望保留官方界面能力,同時獲得托盤、快捷入口和重複啓動喚起現有窗口的人。
使用前注意:
- 插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
- 許可證爲 MIT。
- Node.js 版本要求是
^22.19.0或>=24.0.0。 - 需要已安裝 pnpm,並可在終端中正常執行。
- 需要 dsh 已安裝,並可在終端正常運行。
- 首次啓動會下載並解壓 Electron 運行環境,下載期間不要中斷進程。
- 快捷入口不需要管理員權限。
- 社區目錄是獨立站點,與 DeepSeek / 幻方沒有官方從屬關係,不應把它理解爲官方應用商店。
結尾¶
@anestis271/dsh-desktop 的價值在於:用 dsh 插件的方式補齊桌面外殼能力,而不另起一套客戶端或桌面安裝包。業務界面仍由 DeepSeek Harness 官方 WebUI 提供,插件只負責窗口、托盤、快捷入口和系統集成。
已覈實資料未給出目錄頁 URL,因此這裏給出 GitHub 倉庫地址:
https://github.com/Anestis271/dsh-desktop