前言¶

DeepSeek 在 2026 年 8 月開源了 DeepSeek Harness（dsh）。它的核心設計是「一切皆插件」：模型適配、工具、會話、權限，連界面本身都是可替換的插件。官方入口很直接，裝好 Node.js 之後執行：

npx @deepseek-ai/dsh web

本地會在 http://127.0.0.1:3080 起一個 Web UI。對已經熟悉 Node 和終端的人來說，這條路足夠用。但對只想在 Windows 上雙擊啓動的人，先裝運行時、再記端口、再一條條執行插件命令，門檻就高了。

deepseek-harness-desktop 的做法是：不重寫頁面，把官方 @deepseek-ai/dsh 本地主機放進 Electron 窗口，再原樣加載 Web 界面以及隨倉庫提供的插件和皮膚。本文按社區插件目錄頁、GitHub 倉庫 README、docs/desktop.md 和 desktop-v2.0.0 Release 說明交叉覈對後整理。需要先說清楚：社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係；Release 說明也寫明這是社區構建，不是 DeepSeek、OpenAI 或騰訊的官方發行版。

這是什麼¶

deepseek-harness-desktop 由 ningbainb 維護，託管在 GitHub 倉庫 ningbainb/deepseek-harness-desktop。社區目錄把它歸在「主題與外觀」，2026-08-15 收錄；倉庫許可證以 LICENSE 文件和 GitHub 登記爲準，爲 BSD-3-Clause。截至 2026-08-17，GitHub 顯示 66 星。當前穩定版是 2.0.0，對應標籤 desktop-v2.0.0，發佈於 2026-08-16。

它解決的問題可以壓成一句話：在 Windows 上得到一份和瀏覽器版能力對齊的桌面客戶端，同時不必自己安裝 Node.js、pnpm 或 DSH。

技術說明裏的啓動方式是：Electron 以 --profile desktop --port 0 拉起官方 @deepseek-ai/dsh，等到迴環地址就緒，再把這個 URL 載入主窗口。Web 應用、協議、數據路徑、工具和插件系統仍是 DSH 自己的實現。桌面端只用獨立的 desktop profile（目錄爲 ~/.dsh/profiles/desktop），不改寫已有默認配置；運行時只監聽迴環地址。

倉庫 NOTICE.md 還標明：界面插件和皮膚集合原先版權屬於 zhu1090093659，桌面殼和後續貢獻來自本項目貢獻者；@deepseek-ai/dsh 是第三方依賴，按各自許可證分發。

核心功能¶

原樣託管，而不是重做一套 UI¶

README 反覆強調：桌面版不是縮水重寫。會話、工具調用、模型選擇、權限和插件界面都保留。2.0 隨包裝了 dsh-web-ui 0.1.15 套件，預裝任務看板、Git 圖譜、右側文件/預覽面板、SSH、移動端遠程、即時令牌統計、鯨魚娘寵物、Codex Connect、推理強度滑塊、插件市場和皮膚中心。下載安裝 EXE 後即可使用，不需要再執行插件安裝命令。

主界面來自倉庫文檔中的截圖：

獨立 profile 與內置運行時¶

安裝包自帶官方 DSH、pnpm 和原生依賴。產品頁寫明當前提供 Windows 10 / 11 的 x64 安裝包，不需要另外配置 Node.js。

desktop profile 會組合 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app、@linxin666/dsh-web-ui-all、@tencent-connect/dsh-qqbot、dshmarket、dsh-codex-connect 和 reasoning-slider，並保留已經加進該 profile 的社區 bundle。打包進去的插件目錄是鏈接到 profile 的 node_modules，用來做運行時解析，不是第二套配置庫。

2.0 裏和日常使用直接相關的幾項¶

倉庫把 desktop-v2.0.0 標爲當前穩定版，和桌面使用關係比較大的變化如下。

1. 排隊消息按 FIFO 續傳：智能體工作時繼續發送的消息會排隊；取消當前執行後，隊列自動恢復，不丟失、不重複、不亂序。已知的取消結果會顯示爲「當前執行已停止，排隊消息將繼續發送。」
2. 對話欄 Skills 技能庫：輸入框左下角可搜索已安裝技能，支持最近使用、來源與描述、方向鍵導航、Enter 插入和 Esc 關閉。
3. 模型 API 有界重試：對限流、超時、斷網和可恢復的服務端錯誤做退避重試；Release 說明寫的是最多四次。恢復後繼續當前請求，手動取消仍然立即生效。SSH 或插件操作不會被重放。
4. SSH 即時監控：每三秒刷新 CPU、內存、磁盤、負載、進程與失敗服務；經過確認後可以終止進程或重啓 systemd 服務。
5. 長思考摺疊條吸頂：思考區展開後，摺疊控制會吸附在會話頂部，不必滾回起點。
6. 運行時完整性預檢：啓動前檢查關鍵文件。安裝不完整時停止重啓循環，並提示重新安裝。
7. 後臺更新：發現新版後後臺下載，完成後再由用戶閱讀說明並確認「重啓並安裝」。退出時回收完整 DSH 進程樹，減少安裝器誤報文件佔用。

啓動頁換成粒子鯨魚，標題欄、擴展塢和啓動頁做了視覺統一。這些是界面變化，不影響上面的工作流。

擴展塢、QQ Bot 和 Codex¶

原生菜單 Tools > Extension Dock 打開擴展塢。社區插件安裝接受 npm 包名，例如 @scope/dsh-bundle@1.2.3；URL、本地路徑、空白、shell 元字符和選項式輸入會被拒絕。包必須聲明 DSH bundle patch。打開擴展塢時才檢查社區包更新；兼容版本可直接更新，已知不兼容會攔截並說明原因，元數據不足的版本需要明確確認。安裝會先預取，再離線切到精確版本；校驗或重啓失敗則回滾清單、鎖文件和運行時。

QQ Bot 默認禁用。在擴展塢打開卡片獲取二維碼，用手機 QQ 掃碼後，私聊和羣聊可以接到本機 Harness。AppSecret 用 Electron safeStorage 結合 Windows 憑據保護加密，不會送到渲染頁面、寫入日誌或明文進入 cordis.patch.yml，運行時只通過子進程環境注入。

Codex 相關能力來自內置的 dsh-codex-connect：設置頁通過系統瀏覽器完成 ChatGPT OAuth，啓用 OpenAI Codex 模型。它不會默認替換當前模型。檢測到已有 Codex Provider 時會保留現有配置，OAuth 憑據只保存在本機 DSH home。推理強度滑塊只展示當前模型實際支持的檔位。

皮膚中心¶

皮膚中心提供 11 款皮膚，支持先試穿再應用：試穿即時生效，退出完全還原，確認後再一鍵應用。README 點名的包括 Windows XP（Luna）、Minecraft、Blue Fantasy、鯨吟、初音未來、交易終端，以及 QQ2008、同花順風格、龍的傳人等。11 款都適配右側面板。

安裝與啓用¶

社區目錄頁給出的標準安裝命令是：

dsh plugin add github:ningbainb/deepseek-harness-desktop

dsh CLI 會從 GitHub 解析該倉庫並安裝到當前配置。需要可復現安裝時，按目錄頁的寫法固定 commit 哈希：

dsh plugin add github:ningbainb/deepseek-harness-desktop#commit

把 #commit 換成實際提交哈希。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前應檢查源代碼倉庫和許可證。

這條命令面向已經在用 dsh CLI 的環境。若目標是 Windows 桌面客戶端本身，倉庫 README 和產品頁給出的主路徑是下載安裝包，而不是再執行插件命令。

1. 打開 GitHub Releases，下載最新 Windows x64 安裝包。2.0.0 的文件名是 DeepSeek-Harness-Desktop-Setup-2.0.0-x64.exe（Release 頁標註約 146.2 MB）。
2. 同一 Release 裏下載 SHA256SUMS.txt，比對安裝包 SHA-256。
3. 運行安裝程序。推薦使用默認的按用戶安裝路徑；自定義根目錄應儘量短，因爲部分原生工具仍受傳統 Win32 的 260 字符路徑限制。
4. 啓動應用。DSH、插件、皮膚、pnpm 和原生依賴已隨包提供。

當前安裝包沒有商業代碼簽名，Windows SmartScreen 可能顯示「未知發佈者」。Release 說明要求只從本項目 Release 頁面下載，並覈對校驗和。

覆蓋升級不會刪除既有 DSH_HOME、桌面 profile、社區 bundle、桌寵狀態、皮膚配置或已加密的 QQ Bot 憑據。應用啓動後以及每六小時會檢查穩定版 GitHub Release；菜單 Help > Check for Updates 可立即檢查。下載完成後仍需用戶確認纔會重啓安裝。

從源碼打包時，文檔要求 Node.js 24 和 pnpm 11.21.0：

corepack enable
pnpm install --frozen-lockfile
pnpm desktop:test
$env:CSC_IDENTITY_AUTO_DISCOVERY = 'false'
pnpm desktop:pack
pnpm --filter @deepseek-ai/dsh-desktop pack:verify

安裝器輸出到 apps/dsh-desktop/dist。

典型用法¶

下面的操作都來自倉庫 README 和 docs/desktop.md，可以按原文復現。

1. 換皮膚¶

打開皮膚中心，先試穿再應用。試穿會立刻改界面，退出後還原；確認滿意再點應用。亮色 / 暗色模式都保留。

2. 用擴展塢裝社區插件或導入技能¶

從原生菜單打開 Tools > Extension Dock。安裝社區 bundle 時只填 npm 包名和版本。技能發現按優先級掃描項目 .dsh/skills、項目 .agents/skills、用戶 DSH 技能和用戶 Agents 技能；導入會把通過校驗的技能文件夾複製到 ~/.dsh/skills，不會覆蓋已有同名技能。符號鏈接、覆蓋寫入、超過 50 MiB 或超過 2000 個條目的包會被拒絕。

3. 掃碼接入 QQ¶

在擴展塢打開 QQ Bot 卡片，用手機 QQ 掃碼。未綁定前插件保持禁用，不會在後臺空等終端掃碼。綁定成功後桌面端會啓用插件並重啓 DSH。取消、重新綁定和解綁都在同一張卡片裏完成。

4. 打開 Codex 與推理強度¶

在設置頁走系統瀏覽器完成 ChatGPT OAuth。啓用後可以選用 OpenAI Codex 模型；已有 Provider 不會被默認替換。模型選擇器裏的推理強度滑塊只顯示該模型支持的檔位，切換模型時會回到有效值。

5. 手機遠程接手當前工作區¶

側邊欄底部的手機圖標打開配對面板。掃碼或複製鏈接後，手機進入獨立的移動端界面，查看與新建會話、收發消息、切換模型和思考強度、調整權限預設，與桌面端同步。配對令牌一次性且限時，「停止」可吊銷全部設備。二維碼默認走局域網，也可以開 cloudflared 公網隧道。

6. SSH 運維¶

側邊欄「SSH」入口打開遠程面板。主機支持密鑰 / 密碼認證，可從 ~/.ssh/config 導入；配置存在 ~/.dsh/dsh-ssh.json。已配置主機可以開 Web 終端、SFTP 傳文件、把本地隧道指到遠程內網服務（只監聽 127.0.0.1），也可以按別名 / 環境 / 標籤對多臺主機做集羣執行。2.0 增加了 Linux 監控頁。Agent 與面板共用同一份主機配置。

適用場景與注意事項¶

適合這幾類情況：

• 在 Windows 10 / 11 x64 上使用 DSH，不想先裝 Node.js
• 需要和瀏覽器版對齊的完整 Web 界面，而不是一套重寫過的精簡殼
• 希望皮膚、插件塢、技能導入、QQ Bot、SSH、移動端遠程放在同一個桌面窗口裏
• 已有 dsh 配置，又不想被桌面版覆蓋——它使用獨立的 desktop profile

使用前需要接受這些邊界：

• 不是官方發行版。 社區目錄、倉庫 NOTICE.md 和 2.0.0 Release 都寫明：這是社區項目，不是 DeepSeek、OpenAI 或騰訊官方產品。
• 只提供 Windows x64 安裝包。 文檔沒有提供 macOS / Linux 桌面安裝器。
• 安裝包未做商業代碼簽名。 SmartScreen 可能報警；只從 GitHub Release 下載，並覈對 SHA256SUMS.txt。
• 權限模型與普通 dsh 插件相同。 目錄頁寫明插件以當前 dsh 進程權限運行，安裝時可能執行代碼。SECURITY.md 進一步說明：社區插件和技能擁有 DSH 授予的權限，安裝前應審查第三方代碼。桌面端本身把官方 DSH 綁在隨機迴環端口，渲染進程開啓沙箱和上下文隔離、關閉 Node 集成，導航限制在當前迴環源，外鏈走系統瀏覽器。
• 首次啓動可能較慢。 docs/desktop.md 在 Windows 11 開發機上測到，2.0.0 首次冷啓動文件掃描大約 25.2 秒；之後會複用已安裝文件和 profile 鏈接。這是參考數據，不是承諾值。
• 根目錄 package.json 的 license 字段寫的是 Apache-2.0，與 LICENSE 文件、GitHub 倉庫許可證和目錄頁的 BSD-3-Clause 不一致。以 LICENSE 文件和 GitHub 登記的 BSD-3-Clause 爲準，安裝前仍應自己打開倉庫覈對。

小結¶

deepseek-harness-desktop 把官方 DSH 本地主機和完整 Web 界面裝進 Windows EXE：獨立 desktop profile、迴環監聽、隨包運行時，以及皮膚、擴展塢、技能庫、QQ Bot、SSH 和移動端遠程。當前穩定版是 2.0.0。它是社區開源項目，不是 DeepSeek 官方客戶端；安裝前檢查源碼、許可證和校驗和。

• 社區目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-ningbainb/
• GitHub 倉庫：https://github.com/ningbainb/deepseek-harness-desktop
• 最新安裝包：https://github.com/ningbainb/deepseek-harness-desktop/releases/latest
• DeepSeek Harness 官方倉庫：https://github.com/deepseek-ai/deepseek-harness