前言¶

DSH 的理念是「一切皆插件」；社區目錄是獨立站點，不是官方應用商店，與 DeepSeek / 幻方沒有官方從屬關係。如果你已經有可運行的 DSH Web，又不想爲桌面端新建 profile、重裝插件和配置，可以看一下 Icather 維護的 dsh-clean-desktop-shell。下面介紹它的定位、能力、安裝方式和注意事項。

這是什麼¶

dsh-clean-desktop-shell 是 DeepSeek Harness（DSH）的一個 DSH 插件。它給已經配置好的 DSH Web 套一層原生桌面窗口，提供系統托盤和單實例行爲。它不做視覺改造：不加毛玻璃、不改界面，也不在主窗口添加控件。

它默認連接本地地址：

127.0.0.1:3080

也可以配置遠程 DSH 地址。許可證爲 MIT。當前 package.json 版本爲 0.1.7；0.1.7 修復了插件形態在 macOS 上無法定位 Electron.app 路徑的問題。

核心功能¶

• DSH 插件形態：可掛載進現有 web profile，複用現有 profile，零遷移。
• 原生桌面窗口殼：提供系統托盤和單實例；雙擊啓動立即出窗，不等後端就緒；重複雙擊只聚焦已有窗口。
• 後端活性監測：後端被關閉、崩潰或手動停止時立即切到離線頁；後端恢復後自動重連。
• 托盤後端管理：一鍵啓動、重啓、關閉後端，帶進度彈窗；關閉後端會真正停掉 3080 端口上的服務，包括外部啓動的實例。
• 托盤輔助操作：自動探測後端、設置後端安裝文件夾、刷新窗口、創建桌面快捷方式、檢查更新、打開倉庫主頁。
• 桌面快捷方式：安裝包自動創建；插件形態首次運行可詢問創建，並支持托盤一鍵補建。
• 兩種分發形態：安裝包版與 DSH 插件版，共用 Electron 殼代碼。
• 平臺狀態：Windows 已發佈 NSIS 安裝包，支持 electron-updater 自動更新；macOS 已發佈 Intel 與 Apple Silicon DMG，爲手動下載；Linux 不做；手機 / 平板由內核 headless / PWA 遠程訪問支持。

安裝與啓用¶

DSH 插件形態¶

先確認本機已有可用的 dsh web 服務，或準備配置遠程 DSH 地址。插件安裝命令爲：

dsh plugin --profile web add dsh-clean-desktop-shell

重啓 dsh web 後，桌面殼窗口會自動彈出。插件形態首次運行需要聯網準備 Electron 運行時，約 1-2 分鐘。

安裝包形態¶

從 Release 下載對應安裝包：

Windows: DSH-Clean-Desktop-Shell-Setup-<版本>.exe
macOS Intel: DSH-Clean-Desktop-Shell-<版本>.dmg
macOS Apple Silicon: DSH-Clean-Desktop-Shell-<版本>-arm64.dmg

安裝包會自動創建桌面快捷方式。Windows 安裝包支持自動更新；macOS 需要手動下載。

典型用法¶

1. 安裝插件後，在命令行啓動 dsh，桌面窗口自動彈出；也可以雙擊插件或安裝包創建的桌面快捷方式啓動。
2. 在窗口中使用 DSH Web 原有功能。主窗口保持純殼，不添加控件。
3. 後端相關操作放在托盤右鍵：啓動 / 重啓 / 關閉後端、自動探測後端、設置後端安裝文件夾、刷新窗口、創建桌面快捷方式、檢查更新、打開倉庫主頁。
4. 後端未連接時，窗口會顯示離線頁。可以在離線頁中執行重新加載、啓動後端、自動探測後端、設置後端安裝文件夾。

適用場景與注意¶

適合已經配置好 DSH Web、希望以桌面窗口方式使用，並需要托盤管理本地後端的場景。它只是 DSH Web 之外的桌面殼，不替代 dsh web 服務本身。

使用與安裝前需要注意：

• 插件會以當前 dsh 進程權限運行。安裝前建議先檢查源碼、許可證和依賴；本項目許可證爲 MIT。
• 安裝包未代碼簽名。Windows 可能觸發 SmartScreen：Edge 下載時選擇「保留 / 仍要保留」；雙擊安裝時選擇「更多信息 / 仍要運行」；也可以右鍵安裝包屬性並選擇「解除鎖定」。
• macOS .dmg 未簽名、未公證，首次打開可能觸發 Gatekeeper，提示已損壞或無法驗證開發者。可執行：

xattr -cr "/Applications/DSH Clean Desktop Shell.app"

然後右鍵應用 → 打開。

• 當前開發者沒有 Mac 實機；macOS 安裝驗證、簽名 / 公證、Electron.app 可執行位和 quarantine 擴展屬性等行爲，仍依賴 Mac 用戶驗證或貢獻。
• 代碼簽名證書需要付費，個人開源維護者暫未購買。
• 托盤中的「關閉後端」會真正停掉 3080 端口上的服務，包括外部啓動的實例。

結尾¶

dsh-clean-desktop-shell 做的事情比較集中：把 DSH Web 包進一個乾淨的桌面窗口，複用現有 profile，並把托盤、單實例、後端啓停和離線重連放到桌面側。如果要繼續評估，可以先看目錄頁和代碼倉庫：

• 目錄頁：https://www.skillhub.cn/plugins/Icather/dsh-clean-desktop-shell
• GitHub：https://github.com/Icather/dsh-clean-desktop-shell