前言¶
DeepSeek Harness（dsh）把模型、工具、技能、會話和界面都做成可替換插件。官方倉庫的說法是「一切皆插件」：開發者不必改 Harness 源碼，就能在配置層組合 Agent 能力。實際用起來，會話、項目文件、網頁資料、Git 工作區和 Word / Excel 產物往往還是散落在瀏覽器標籤、終端和外部編輯器裏。
社區項目 deepseek-harness-desktop-app 走的是另一條路：不另寫一套 Agent 運行時，而是在 DSH 同一條運行鏈上加一層 Electron 桌面外殼，把 Session、項目、文件、聯網研究、插件和 Office 產物收進同一個本地應用。
本文按社區目錄頁、GitHub 倉庫 README / package.json / PRIVACY.md，以及 DeepSeek Harness 官方倉庫覈對後整理：它是什麼、現在能做什麼、目錄頁怎麼裝、倉庫推薦怎麼啓動，以及平臺和功能邊界。社區目錄站點與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。
這是什麼¶
deepseek-harness-desktop-app 是一款由 vibeinging 維護的開源項目，社區目錄把它歸在「會話與消息」分類，許可證爲 MIT，主要語言是 JavaScript。產品名是 DeepSeek Harness Desktop App，根目錄 package.json 裏的包名是 dsh-desktop，版本號爲 0.0.1，入口是 electron/main.js。截至 2026-08-17，目錄頁和 GitHub 倉庫的星標均爲 216。倉庫默認分支是 dev，最近一次推送時間爲 2026-08-15。
README 的定位很明確：它是建立在 DeepSeek Harness 之上的本地 AI 工作桌面，把 DSH 的 Session、Agent、Tool、Skill、MCP 和 Profile Bundle，與項目、文件、網頁、Git Worktree、Canvas、Site 和 Office 產物組織在同一個桌面應用中。
它不是 DSH Web 的 iframe，也沒有複製一套 Agent 運行時。Electron 啓動 DSH Web Profile，繼續使用同一套 Session、Agent、Tool、Skill、MCP、Settings、Profile Bundle 和 Client Loader。桌面外殼負責項目管理、文件授權、Browser Workspace、Git Worktree、Canvas、Site 和 Office 產物；需要模型參與的能力仍通過綁定的 Session 和 DSH Tool 接入。當前項目使用 DSH 0.1.0-rc.6。
核心功能¶
README 用一張功能表列出當前能力，下面按工作流歸併。下列內容均來自倉庫 README，不是使用評價。
對話、權限與軌跡¶
一個項目對話對應一個 DSH Session。對話側支持流式回答、思考過程、工具調用、停止、繼續、重試、消息分支和重啓恢復。模型側可以選 Provider、模型和推理強度，並管理憑據引用、Session 權限、工具審批和模型提問。當前 Profile 裏的工具、技能、MCP、Hook、子 Agent 和 Workflow 都可以直接用。
右側「結果與證據」直接讀取當前綁定 Session 的 session.history。用戶消息、請求上下文、模型輸出、工具調用、工具結果、權限變化和最終回答都在同一條可回放軌跡裏，倉庫明確寫了：不另維護第二套運行中心。
輸入時可以用 @ 引用文件、用 # 引用對話，也可以粘貼圖片和大段文本附件。項目上下文包括應用指令、項目指令、授權源碼目錄、寫入目標，以及全局或項目記憶。
三列工作臺與項目文件¶
桌面外殼是三列工作臺，左右欄可摺疊，帶全局搜索、縮放快捷鍵和更新檢查。設置項覆蓋語言、網絡、通知、終端和隱私。
項目側可以創建項目，以及全局或臨時對話，並支持置頂、排序、重命名、歸檔、恢復和刪除。右側工作臺可以掛上結果與證據、瀏覽器、文件、產物和 Site 標籤。項目文件樹、Agent 工作目錄、當前 Diff 和行編輯都跟隨當前項目權限與活動 Worktree。
編碼工作區可以查看 Diff、逐行評論和編輯、在外部編輯器打開、發起 AI Review，並安全撤銷模型產生的文件修改。文件面板能瀏覽項目文件、任務和產物，預覽文本、代碼、圖片和 Office 內容，也可以按文件名或正文搜索。
Git Worktree、瀏覽器與產物¶
Git Worktree 用來隔離開發：爲項目創建獨立分支和工作目錄，同一時間只啓用一個。啓用後，新建對話的 Agent、DSH Session、Diff 和行編輯走這個 Worktree，主檢出保持不變。切換工作目錄不會遷移已有對話；刪除前必須切回主檢出，刪除工作目錄後仍保留 Git 分支。非 Git 目錄、重複分支、越界路徑和異常符號鏈接會被拒絕。
Browser Workspace 提供多標籤瀏覽、歷史、頁內查找、縮放、下載、打印、開發者工具、站點權限、網頁快照和「使用此頁」。
Canvas 保存不可變版本，支持正文編輯、版本比較、精確行內建議和衝突處理。Site 使用同一套版本能力，並在隔離沙箱中提供桌面、平板和手機預覽。Office 產物覆蓋 Markdown、DOCX、XLSX、PPTX 和 PDF 的創建、查看、定點編輯和版本保留。
主題與插件中心¶
主題來自 @deepseek-ai/dsh-theme-pack Profile Bundle，默認是 professional-blue，可選 anime-blue。應用也支持本地自定義主題的新建、導入、預覽、編輯、導出和刪除。本地主題只能改安全的顏色與外觀，不能注入原始 CSS、遠程圖片或修改應用名稱。明暗模式、背景和透明度可以單獨調。
插件中心面向普通用戶：在左側「插件」頁安裝 DSH Profile Bundle。Host Bundle（Tool、Skill、MCP、Hook 等）可以進入 DSH 運行時；包含第三方 Client UI 的 Bundle 目前不會進入擁有 Electron 權限的主窗口，隨應用提供並經過審覈的 Client Bundle 不受此限制。
安裝與啓用¶
社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行：
dsh plugin add github:vibeinging/deepseek-harness-desktop-app
需要可復現安裝時，目錄頁要求固定 commit 哈希：
dsh plugin add github:vibeinging/deepseek-harness-desktop-app#commit
把 commit 換成實際哈希即可。目錄頁同時寫明：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前應檢查源代碼倉庫和許可證。
倉庫 README 的主路徑不是把這段倉庫當作普通 Web Profile 插件掛進去，而是在本地啓動桌面應用。本地開發要求 Node.js 24 或更高版本（.node-version 也是 24）。克隆後執行：
npm install
npm run doctor
npm run dev
切換 Node.js 大版本、CPU 架構或操作系統後，需要再跑一次 npm run setup 重新準備依賴。要用完整的三列工作臺、Browser Workspace 和 Office 產物，應按 README 這條路徑啓動，不要默認 dsh plugin add 就會彈出 Electron 窗口。
典型用法¶
下面幾步都來自倉庫 README，可以按同樣順序覈對界面。
- 用
npm run dev打開桌面應用後，創建一個項目，再開一個項目對話。這個對話會綁定一個 DSH Session。 - 在右側工作臺加上「結果與證據」。發一條會觸發工具調用的消息，軌跡裏應能看到用戶消息、模型輸出、工具輸入輸出、耗時、Token 和最終回答。
- 需要改代碼時，先在項目設置裏創建並啓用一個 Git Worktree，再新建對話。已有對話不會跟着切換工作目錄遷過去。
- 用
@引用項目文件，或在文件面板裏預覽文本、代碼、圖片和 Office 內容。項目源碼目錄默認只讀，Agent 要寫入，需要先明確授權。 - 要裝額外能力時，打開左側「插件」頁：輸入帶精確版本的 npm 包，或帶完整 commit 的
dsh-external倉庫地址；先跑兼容性檢查，只有結果爲「可以安裝」時才寫入當前 Profile。裝完後可以查看來源、版本、加載順序和能力，用戶安裝的 Bundle 可以卸載。
適用場景與注意事項¶
適合已經在用 DeepSeek Harness，又希望把會話、項目文件、網頁資料和 Office 產物放在同一個本地窗口裏的人。也適合需要 Git Worktree 隔離實驗、又想保留主檢出不動的編碼工作流。數據默認保存在本機 ~/.dsh，也可以用 DSH_DATA_ROOT 改根目錄；PRIVACY.md 寫明：打開應用或查看歷史記錄不會自動上傳項目和會話。
平臺狀態以 README 表格爲準：
- macOS Apple Silicon：開發與目錄包已驗證
- macOS Intel：Rosetta 檢查通過，仍需 Intel 實機驗收
- Windows x64：已接入構建流程，仍需安裝包實機驗收
- Windows arm64：暫不支持
- Linux：暫無桌面打包配置
當前明確沒有的能力包括：五列任務看板、獨立定時任務頁面、Git 圖譜、stage/unstage 面板、獨立終端頁；本地 Site 只提供預覽和單文件導出，沒有部署服務，公開分享目前只有只讀查看；也沒有移動端遠程控制、二維碼配對、公網隧道、SSH、SFTP 或端口轉發。子 Agent 可以執行並出現在對話與軌跡中，但還沒有完整的獨立管理頁。
無論是走目錄頁的 dsh plugin add，還是按 README 本地啓動，安裝和運行都會在本機執行代碼。安裝前應檢查源碼與 MIT 許可證，以及 THIRD_PARTY_NOTICES.md 裏第三方依賴和二進制的分發限制。不要把社區目錄或這個桌面應用寫成 DeepSeek 官方產品。
小結¶
deepseek-harness-desktop-app 把 DSH 的 Session 和插件體系留在原處，額外提供項目管理、文件授權、瀏覽器工作區、Git Worktree 和 Office 產物。目錄頁按插件慣例給出了安裝命令；要得到 README 裏的完整工作臺，需要 Node.js 24，並按倉庫說明本地啓動。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-app/
GitHub：https://github.com/vibeinging/deepseek-harness-desktop-app
