前言¶

DeepSeek Harness（簡稱 DSH，命令行入口是 dsh）把模型、工具、技能、會話和 UI 都做成插件，官方推薦的起步方式是先裝 Node.js，再執行 npx @deepseek-ai/dsh web，用瀏覽器打開本機迴環地址。這條路徑對已經熟悉 Node 環境的人並不複雜，但對只想在 Windows 或 Linux 桌面上直接用 Web 界面的人，成本會疊在運行時安裝、端口選擇、瀏覽器標籤頁和插件管理上。

社區項目 Deepseek-Harness-EAC 把官方 @deepseek-ai/dsh 封進 Electron 桌面殼：內置獨立 Node 運行時和 npm CLI，雙擊啓動本地 dsh web，再把界面加載到原生窗口。EAC 是 Embracing All Creation 的縮寫，倉庫把它譯成「攬盡萬象」，指的是皮膚、插件、工具和記憶可以在客戶端裏一鍵安裝，而不是改官方內核。它由 GitHub 用戶 zouyuxuan122 維護，社區插件目錄把它歸在「主題與外觀」分類。本文依據該目錄詳情頁、倉庫 README / package.json、GitHub Releases 以及官方 DeepSeek Harness 說明交叉覈對後整理。

需要先分清兩層關係。DeepSeek Harness 本身是 DeepSeek AI 開源的 Agent Harness，口號是「一切皆插件」。Deepseek-Harness-EAC 是社區封裝的桌面客戶端，不是官方應用；deepseek-harness-plugin.com 是獨立的社區目錄，和 DeepSeek / 幻方沒有官方從屬關係，收錄不等於安全背書。

這是什麼¶

Deepseek-Harness-EAC 是一個開源的 Windows / Linux 桌面客戶端，倉庫地址是 zouyuxuan122/Deepseek-Harness-EAC。截至 2026-08-17，GitHub API 顯示該倉庫約 564 星；社區目錄頁上的星標是 78，與 GitHub 一手數據不一致，下文以 GitHub 爲準。dsh-desktop/package.json 聲明許可證爲 MIT，並依賴 @deepseek-ai/dsh@0.1.0-rc.6；倉庫根目錄沒有單獨的 LICENSE 文件，GitHub 元數據裏也未自動識別到許可證，安裝前仍應自行覈對源碼與第三方皮膚許可。

它要解決的問題可以概括成三件事：

1. 目標機器不必預裝 Node.js，也能跑官方 dsh web。
2. 把瀏覽器標籤頁換成原生無邊框窗口和系統托盤，關閉窗口默認不打斷正在跑的任務。
3. 在官方默認外觀之外，內置 10 套 Web UI 皮膚，並附帶插件市場、會話文件追蹤、會話內終端等配套能力。

README 強調「內核零改動」：EAC 直接運行官方 dsh web，完整保留「一切皆插件」架構；默認沿用 DSH_HOME（通常是 ~/.dsh），已有會話和 API Key 可以直接生效。桌面端使用專屬 web-desktop profile，插件樹與原生 CLI 隔離，會話和密鑰仍然共享。

核心功能¶

免裝運行時與一鍵啓動¶

官方起步命令是：

npx @deepseek-ai/dsh web

這要求本機已有 Node.js。EAC 把獨立 Node 運行時、npm CLI 以及 @deepseek-ai/dsh（含官方插件）打進安裝包，目標機器不需要再裝運行時。啓動流程按倉庫架構圖是：

1. Electron 主進程做單實例鎖、窗口和生命週期管理。
2. 用內置 node.exe 執行 dsh web --host 127.0.0.1 --port 0，自動挑空閒端口。
3. 解析輸出裏的 dsh web: http://127.0.0.1:<port>，輪詢到 HTTP 200 後，把 Web UI 加載進原生窗口。
4. 界面只走本機迴環，不把服務暴露到局域網。

便攜版數據目錄在 exe 旁的 data\；安裝版在 %APPDATA%\Deepseek Harness EAC\。若要指定 DSH 配置目錄，啓動前設置環境變量 DSH_HOME 即可，行爲和 CLI 一致。

10 套內置皮膚¶

設置頁「皮膚」標籤以卡片網格展示 10 款 Web UI 皮膚，默認不啓用任何一套，保持官方原生外觀。選中某一款後其餘自動禁用（互斥切換），「恢復默認皮膚」可還原；切換後會自動重啓 Web 服務。皮膚是 browser-only 的 dsh client 插件，由桌面端同步進 web profile，並冪等寫入 cordis.patch.yml。

9 款來自社區倉庫 dsh-web-ui（BSD-3-Clause），1 款來自 dsh-deep-whale 的深海女僕工坊（CC BY-NC-SA 4.0，禁止商用）：

完整版權署名隨包裝分發。設置頁還有「外觀 · 字體與顏色」，可改界面/代碼字體、字號以及文字與代碼顏色，數據存在 localStorage。

桌面窗口與更新¶

窗口沒有系統原生標題欄和菜單欄，而是自繪玻璃欄（圓角圖標、菜單、窗口控制），Windows 11 下帶圓角。關閉默認隱藏到托盤，agent 任務完成時會彈 Windows 系統通知，點擊回到窗口。退出應用會結束整個 dsh 進程樹，避免留下孤兒進程。

更新分兩路，都要用戶同意：

• 客戶端本體：啓動後檢查 GitHub Releases，便攜版原地替換並重啓，安裝版引導新安裝包；失敗則保留當前版本。
• 官方 agent：檢測 @deepseek-ai/dsh 新版本後裝到數據目錄 overlay，原子切換；新版啓動失敗可回退到內置版本。

截至 2026-08-17，GitHub 上標記爲 latest 的 Windows 發行版是 v3.0.1（2026-08-16 發佈）。倉庫 main 分支的 package.json 版本號是 4.0.0，與 latest Release 標籤並不相同，下載安裝包時應以 Releases 頁面爲準，不要把源碼版本號當成已發佈安裝包版本。

配套效率能力¶

README 把下面這些寫成桌面殼附帶的配套插件，而不是改官方 dsh 源碼：

• 插件市場（dsh-webui-market）：設置 → 插件 → 市場，瀏覽 awesome-dsh-plugin.com 收錄的插件並一鍵安裝/卸載；任務在服務重啓窗口期排隊，不打斷當前會話。
• 插件保護中心：融合社區快照回滾、安裝守衛和靜態體檢三類能力。安裝與啓動前自動快照（保留 10 份）；啓動失敗則體檢 → 修復 → 重試 → 回滾到最後良好快照，並留下事故報告。設置頁可手動快照、回滾、體檢和修復。
• 餘額小部件：對話底部顯示「本輪 ¥X · 餘額 ¥Y」，點擊跳轉充值，約 15 分鐘刷新一次。
• 文件更改追蹤：會話「文件」標籤查看新建/修改/刪除和行級 diff，支持逐文件或全部還原；數據只讀複用會話日誌。
• 會話內終端：在當前會話項目目錄啓動持久 PowerShell，SSE 流式輸出，帶命令歷史和斷線重連。
• 自動壓縮：接近上下文上限（默認 80%，可調）時自動執行官方 /compact。
• 人設卡：6 張內置預設、卡片庫，以及 soul.md 熱重載。
• MCP / skills 遷移：可從 Claude Code / Codex 的配置目錄導入 MCP，並一鍵遷移 skills、MCP 與記憶。
• 外置視覺模型（dsh-tool-vision）：inspect_image 把本地圖片或 URL 發給 OpenAI 兼容視覺端點。
• 長期記憶（dsh-tdai-memory）：移植騰訊雲 Agent Memory 的分層記憶，複用已有 ~/.memory-tencentdb/memory-tdai 數據。

以上條目均來自倉庫 README 對當前源碼樹的說明。若你安裝的是某個歷史 Release，功能集合可能少於這份清單，以對應版本的說明爲準。

安裝與啓用¶

社區目錄給出的標準插件安裝命令如下。在已經裝好 DeepSeek Harness 的終端裏運行：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC

如需可復現安裝，按目錄頁說明固定 commit 哈希：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC#<commit>

把 <commit> 換成倉庫裏實際的提交哈希。插件以當前 dsh 進程的權限運行，安裝時可能執行代碼，裝前應檢查源碼和許可證。

需要注意：這個倉庫的主體是 Electron 桌面客戶端（dsh-desktop/），不是一份只往現有 Web UI 打補丁的皮膚包。倉庫 README 把 GitHub Releases 下載安裝包 寫成推薦部署方式。已經在用 npx @deepseek-ai/dsh web 的人，目錄裏的 dsh plugin add 適合對照社區收錄信息；若目標是「雙擊出一個桌面窗口」，應按 README 下載客戶端。

Windows：從 Releases 安裝¶

系統要求：Windows 10/11（x64），無需預裝 Node.js。latest 資源名如下（大小約 167 MB）：

直接下載入口：

• 便攜版：https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/latest/download/Deepseek-Harness-EAC-Portable-x64.exe
• 安裝版：https://github.com/zouyuxuan122/Deepseek-Harness-EAC/releases/latest/download/Deepseek-Harness-EAC-Setup-x64.exe

路徑必須是純英文。README 寫明：中文路徑（例如 D:\迅雷下載\）會觸發 Chromium 渲染進程原生崩潰，窗口彈出數十秒後自動退出。默認安裝到 C:\Users\<用戶名>\AppData\Local\Programs\ 即可。

v3.0.1 的 Release 說明還寫了一次手動升級：若從 v3.0.0 / v2.0.x 點「立即重啓」沒有反應，需先完全退出（托盤右鍵退出），再到 %APPDATA%\Deepseek Harness EAC\updates\ 運行已下載的 Setup，或直接從 Releases 下載安裝包。這是該版本要修的更新腳本 bug，裝上 v3.0.1 之後才生效。

Linux：社區打包¶

中文 README 寫明 Linux x86_64 打包由 @Luoye-hb 在 PR #12 貢獻，隨 v3.0.1-linux 發佈，支持 Arch / Ubuntu / Debian / Fedora 以及通用 AppImage。包名示例：

# Arch
sudo pacman -U ./Deepseek-Harness-EAC-3.0.1-x64.pacman

# Ubuntu / Debian
sudo apt install ./Deepseek-Harness-EAC-3.0.1-amd64.deb

# Fedora
sudo dnf install ./Deepseek-Harness-EAC-3.0.1.x86_64.rpm

AppImage 需先 chmod +x 再運行。卸載命令分別是 pacman -Rns dsh-desktop、apt remove dsh-desktop、dnf remove dsh-desktop。Linux 版由系統包管理器升級，不走應用內自更新；數據目錄仍是 ~/.dsh（DSH_HOME）。英文 README 仍只寫 Windows，與中文 README、倉庫 description（Windows / Linux）不一致，本文以中文 README 和 Releases 標籤爲準。倉庫沒有列出 macOS 安裝包。

從源碼構建¶

在已安裝 Node.js 的開發機上：

cd dsh-desktop
npm install
npm run fetch-runtime    # 內置 node.exe + npm CLI
npm run dist             # 構建 portable + NSIS 安裝包 → dist/

網絡受限時可設置鏡像：

$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
$env:ELECTRON_BUILDER_BINARIES_MIRROR='https://npmmirror.com/mirrors/electron-builder-binaries/'

測試命令是 npm test（node --test test/*.test.mjs）。

典型用法¶

按 README 的「首次使用」：

1. 雙擊運行，先看到啓動動畫，隨後自動加載 DeepSeek Harness Web UI（僅本機迴環）。
2. 若尚未配置 API Key，在界面「設置」裏填寫，方式和命令行 dsh 相同。
3. 常用入口：設置 → 皮膚（10 款切換）/ 插件市場 / 模型一鍵選擇；對話區 → 終端 / 文件標籤頁。

換皮膚時保持默認即可繼續用官方外觀；需要懷舊或主題化界面時，在皮膚頁點選一張卡片，等 Web 服務重啓。maid-atelier 是 CC BY-NC-SA 4.0，商用場景不要啓用這一套。

已經在用官方 CLI 的人，只要 DSH_HOME 指向同一目錄，桌面端可以讀到已有密鑰和會話。v3.1 起 README 把桌面端放到 web-desktop profile，避免和 npx dsh 搶同一套插件樹；共享模塊 junction 的歸屬由桌面端巡檢修復。

從 Claude Code 或 Codex 遷過來時，可在設置頁勾選導入 ~/.claude.json 與 ~/.codex/config.toml 裏的 MCP 服務器，並遷移 skills 與記憶，而不必先手改 YAML。

適用場景與注意事項¶

比較適合：

• 不想先裝 Node.js，只想在 Windows 10/11 x64 或 Linux x86_64 上雙擊使用官方 Web UI 的人。
• 需要托盤常駐、任務完成通知、便攜目錄或 U 盤攜帶的人。
• 希望在官方外觀和 10 套社區皮膚之間切換，並在客戶端內瀏覽、安裝社區插件的人。

不太適合：

• 只要命令行 / TUI、不需要桌面窗口的人，直接用官方 dsh 即可。
• 需要 macOS 安裝包的人：當前 README 與 Releases 均未提供。
• 把社區目錄當成官方應用商店、或把 EAC 當成 DeepSeek 官方客戶端的人。同類桌面封裝還有其他社區項目，EAC 的差異主要在內置皮膚、插件市場和配套保護/效率插件，而不是「官方唯一桌面版」。

使用前建議覈對這幾條：

• 權限與來源：無論走 dsh plugin add 還是運行 exe，代碼都以當前用戶權限執行。安裝前閱讀倉庫源碼、許可證和第三方皮膚許可。maid-atelier 禁止商用。
• 路徑：Windows 下不要放在中文或含非 ASCII 字符的目錄。
• 版本：以 GitHub Releases 的 tag 爲準。latest Windows 包是 v3.0.1；Linux 另有 v3.0.1-linux；源碼 package.json 的 4.0.0 不代表你下載到的安裝包版本。
• 與官方 CLI 共存：默認共享 DSH_HOME。若插件樹出現異常，優先看桌面端的插件保護中心和 web-desktop profile 隔離說明，而不是同時改兩套配置。
• 社區目錄：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-eac/ 只是收錄頁，不代表 DeepSeek 官方認證。

小結¶

Deepseek-Harness-EAC 把官方 DeepSeek Harness 的 dsh web 封進 Electron 窗口：免裝 Node、托盤常駐、10 套可切換皮膚，並帶插件市場和若干配套工具。它不修改官方內核，會話和 API Key 仍走 DSH_HOME。維護者是 zouyuxuan122，Linux 打包由 Luoye-hb 貢獻。若要在現有 dsh 裏按社區目錄安裝，使用：

dsh plugin add github:zouyuxuan122/Deepseek-Harness-EAC

若要桌面客戶端，從 GitHub Releases 下載對應系統的安裝包或便攜版，並避開中文路徑。

• 社區目錄：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-eac/
• GitHub：https://github.com/zouyuxuan122/Deepseek-Harness-EAC
• 官方 Harness：https://github.com/deepseek-ai/deepseek-harness