前言¶
DeepSeek Harness（dsh）是 DeepSeek AI 開源的智能體框架，官方倉庫把架構概括成一句話：一切皆插件。打開網頁界面的官方路徑也很直接——先裝 Node.js，再執行 npx @deepseek-ai/dsh web，瀏覽器訪問 http://127.0.0.1:3080。
這條路徑對已經在用 CLI 的人足夠，在 Windows 上卻不一定順手。每次開終端、等 npx、再切瀏覽器，窗口一關還容易把還在跑的會話弄丟。社區裏因此出現了一批桌面殼，把官方 Web UI 裝進獨立窗口。
deepseek-harness-desktop 就是其中之一。它由 chyra-moon 維護，MIT 開源，被社區插件目錄歸在「界面增強」。倉庫 README 置頂寫了：這是社區項目，不是官方出品；DeepSeek Harness 本體和 @deepseek-ai/* 軟件包的版權仍歸 deepseek-ai。社區目錄 https://deepseek-harness-plugin.com 也是獨立站點，和 DeepSeek / 幻方沒有官方從屬關係。
這是什麼¶
一句話定位：這是一個 Windows x64 上的 Electron 桌面殼，把官方 dsh 網頁界面 1:1 加載進獨立窗口，並順帶託管或複用官方 dsh 服務器。
它要解決的是「怎麼在 Windows 上雙擊打開官方界面」，而不是另做一套仿製皮膚。目錄頁簡介和 GitHub 描述一致：Windows 桌面殼，與官方網頁界面 1:1 復刻。截至 2026-08-18，目錄頁與 GitHub 倉庫均顯示 11 顆星；當前發佈版本是 v0.1.0，主要語言是 JavaScript，打包目標只有 Windows x64。
核心功能¶
根據倉庫 README、v0.1.0 Release 說明和 src/main.js 源碼，可以覈對到下面這些能力。
1、零配置啓動。安裝包自帶 Electron 運行時和依賴，README 寫明不用單獨裝 Node.js、不用敲命令，裝完雙擊就是官方界面。界面本身加載的是官方前端，不是仿製皮膚。
2、服務器內置，也能複用現有實例。應用先探測 127.0.0.1:3080：若網頁版或 CLI 已經在跑，就直接複用，會話數據互通；否則用內置的 @deepseek-ai/dsh 自建。當前 package.json 把該依賴鎖在 0.1.0-rc.6。內置入口缺失或失敗時，會自動回退到 npx -y @deepseek-ai/dsh web。
3、斷線自愈。運行期間每 5 秒探活；外部服務器被關掉後，應用會在約 5 秒內接管並重啓，然後自動重載頁面。源碼註釋寫的目標是避免「界面還在但發不了消息」。
4、桌面殼行爲。托盤駐留、窗口位置記憶、單實例鎖、崩潰後自動重啓、無菜單欄的純淨窗口。關閉窗口默認進托盤，托盤右鍵可以退出或查看關於信息。
5、啓動時的鯨魚加載動畫。README 說明按官方鯨魚圖標做藍/白光點，肚皮、眼睛、水花三處細節對齊，並帶呼吸式起伏。v0.1.0 的 Release 還提到側邊欄懸停：打開後自動收起，鼠標移入展開、移出收起。
快捷鍵在 README 和主進程裏都能對上：
Ctrl+Shift+I：開發者工具Ctrl+R/F5：重載Ctrl+Shift+O：在系統瀏覽器裏打開當前服務器地址
安裝與啓用¶
社區目錄給出的安裝命令如下，在 DeepSeek Harness 終端中運行即可：
dsh plugin add github:chyra-moon/deepseek-harness-desktop
如需可復現安裝，按目錄頁說明固定 commit 哈希：
dsh plugin add github:chyra-moon/deepseek-harness-desktop#commit
目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。
就本倉庫的實際形態來說，README 把日常路徑寫成「下載 Windows 安裝包、雙擊啓動」。倉庫根目錄是 Electron 應用（入口是 src/main.js），並不是往現有 dsh web 裏再掛一層皮膚。若目標是獨立桌面窗口，按 GitHub Releases 安裝更貼近項目說明。
v0.1.0 提供三種包，都只覆蓋 Windows x64：
1、安裝版（README 推薦）：DeepSeek.Harness-0.1.0-x64.exe，會創建桌面和開始菜單快捷方式。
2、解壓版：DeepSeek.Harness-0.1.0-win32-x64.zip，解壓即用，解壓過程帶進度。
3、免安裝便攜版：DeepSeek.Harness-0.1.0-portable-x64.exe，單文件；首次啓動要後臺解壓數分鐘，且沒有進度提示。
下載入口：https://github.com/chyra-moon/deepseek-harness-desktop/releases/latest
從源碼運行需要本機已有 Node.js 與 npm。README 註明首次使用前要先生成圖標：
npm run icon
npm install && npm start
打包可用 npm run dist。官方 dsh 發新版後，倉庫用 Dependabot 開升級 PR，合併後再跑 npm run update:dsh 即可重新出包。
典型用法¶
1、安裝並雙擊啓動。窗口會先顯示狀態頁，後臺探測或拉起 dsh 服務器，就緒後再加載官方前端。源碼提示首次啓動或複用外部服務器時，可能需要幾秒到幾十秒。
2、已經在用網頁版或 CLI 時，可以先照常執行官方命令：
npx @deepseek-ai/dsh web
再打開桌面版。應用會複用 127.0.0.1:3080 上已有的官方服務器，兩邊會話數據互通。README 也寫了：若想跟官方最新版走，跑最新的 npx @deepseek-ai/dsh web，桌面版會自動複用。
3、關窗口不等於退出。默認會駐留托盤；要從托盤徹底退出，用托盤右鍵菜單裏的「退出」。
4、不想關窗口駐留托盤時，在應用數據目錄的 settings.json 裏改：
{
"closeToTray": false
}
5、遠程桌面環境下工作區選擇器打不開時，把同一文件改成應用內瀏覽選擇器：
{
"directoryPicker": "browse"
}
默認值是 "native"，走 Windows 原生對話框。源碼裏這個開關會讓 dsh 掛上應用內選擇器，用來規避遠程桌面會話下原生對話框 worker 崩潰。
適用場景與注意事項¶
適合 Windows x64 上想雙擊打開官方 dsh 網頁界面的人，也適合已經在用 dsh web / CLI、希望桌面窗口和現有會話共用一份數據的人。走安裝包路徑時，不必先配 Node.js。
當前倉庫徽章和打包配置都只寫了 Windows x64，macOS、Linux 和 Windows ARM 不在說明範圍內。也不適合把它理解成官方客戶端——README 置頂寫了社區項目、非官方出品。
使用前建議覈對這幾件事：
1、安裝前檢查源碼和許可證。本項目採用 MIT 許可證。社區目錄寫明：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。桌面版會在本機拉起或複用 dsh 服務器，權限邊界與官方網頁版相當，不要把它當成沙箱。
2、殺毒軟件可能報毒。README 把它歸爲社區未簽名應用的常見誤報，並建議自行審計源碼或從源碼構建。
3、內置 dsh 版本會落後於官方最新。package.json 當前依賴 @deepseek-ai/dsh 的 0.1.0-rc.6。官方倉庫說明 DeepSeek Harness 仍處於開發者預覽，可能出現破壞兼容性的變更。跟最新官方版的辦法是先跑 npx @deepseek-ai/dsh web，讓桌面殼複用外部服務器。
4、便攜版首次啓動較慢且無進度，README 寫明這是正常現象；更透明的是解壓版。
小結¶
deepseek-harness-desktop 做的事情很具體：在 Windows 上給官方網頁界面加一層可雙擊的殼，服務器能自建也能複用，斷線後會嘗試自己拉起來。它不替代 dsh 的插件生態，也不改官方前端。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-chyra-moon/
GitHub：https://github.com/chyra-moon/deepseek-harness-desktop
