DeepSeek Harness 外掛程式詳解：安裝、新增，並以「Everything Is a Plugin」代理執行環境為基礎進行建構

一句話回答：DeepSeek Harness 不是一個模型。它是 DeepSeek 於 2026 年 8 月 13 日以 MIT 授權釋出的開源代理執行環境，其核心主張是：代理所需的一切能力——模型、工具、技能、會話狀態、使用者介面，甚至主迴圈——都應該是可替換的外掛。你在其中執行的模型是 DeepSeek V4 Flash 和 DeepSeek V4 Pro，而且你不需要相信任何行銷宣傳就能感受到差異：執行 npx @deepseek-ai/dsh web，開啟 127.0.0.1:3080，不到一分鐘你就會得到一個本機編碼代理，它的終端機、側邊欄、網路搜尋與記憶體全都是外掛，你可以新增、移除或改寫，而完全不必碰觸框架原始碼。發布此專案的 GitHub 儲存庫在上線頭 12 小時內就獲得 50,000 顆星，截至 2026 年 8 月 16 日已累積 125,959 顆星。本文是第一頁搜尋結果略過的實戰外掛指南：DSH 究竟是什麼、目前外掛生態系有哪些內容、如何安裝與撰寫外掛，以及這個預覽版真正不足之處。

DeepSeek Harness 實際上是什麼（以及它不是什麼）

DeepSeek 的內部公式（已在官方 Harness 頁面確認）是 Model + Harness = Agent：模型負責思考與推理，harness 則賦予智能體理解環境、使用工具，以及在真實任務中持續運作的能力。Anthropic 推廣了這個術語，而 Claude Code 是參考實作；DeepSeek 的版本是開源的，完全在你自己的機器上運行，目標與 Claude Code 和 OpenAI Codex 相同。正因為這樣的定位，把 DSH 稱作「模型」是錯誤的，這篇文章也不是模型評測：harness 是連接模型與工具、檔案、終端機和 Web UI 的層級——在 DeepSeek 的設計中，每一條這類連接都是一個外掛程式。

發布事實，均於2026年8月16日核實：deepseek-ai/deepseek-harness 儲存庫於北京時間8月13日晚間以 MIT 授權的 v0.1 開發者預覽版形式公開。它在不到兩小時內突破10,000顆星，十二小時內達到50,000顆——約為先前增長最快的 GitHub 儲存庫 OpenClaw 的80倍速——後續報告指出它在42小時內突破100,000顆。今日 GitHub API 顯示 125,959 顆星與 12,526 個 fork。這不是雲端服務：安裝 Node.js，執行 npx @deepseek-ai/dsh web，Web UI 會運行於 http://127.0.0.1:3080，你的工作階段、日誌與資料皆保留在本機。npm 上的版本為 0.1.0-rc.6，README 說明該專案處於開發者預覽階段且「快速迭代中」，預期會有破壞相容性的變更。

「Everything is a plugin」——這個口號的真正含義

該框架以 Cordis 為基礎建構，Cordis 是從 Koishi 機器人生態系中提取出來的插件元框架。Cordis 刻意保持單純：它只負責載入、卸載插件並解析插件之間的依賴關係，不承載代理（agent）的任何實際能力。其上的所有一切——模型適配器、工具、技能、會話、沙箱、儲存、驅動代理的迴圈、排程與網頁介面——本身都是 Cordis 插件，插件之間透過 Cordis 服務與事件協同運作。您可以在設定層選用、替換或擴充任何能力，而無需修改原始碼。

這包括模型本身。模型只是一個帶有 OpenAI 相容端點的外掛程式，因此框架中沒有任何部分強迫你留在 DeepSeek 的產品線內——「更換模型」這一步只是變更設定，而不是分叉。同樣的原則也說明了為什麼四個內建預設實際上是四個外掛程式組合。

• Standard——完整的編碼代理：檔案編輯、Shell、檔案與網路檢索、Skills、計畫、目標、子代理與工作流程。

• PTC：包含 Standard 的所有功能，外加 Code Mode SDK，可讓模型撰寫一個 TypeScript 程式來串連多步驟工具呼叫，而不是逐一發出呼叫。

• 極簡 — 正好兩個工具（一個持久化的 bash 和一個 str_replace_editor），專為在極簡環境中進行模型基準測試而構建。這是 DeepSeek 在 V4 Flash 代理基準測試運行中所使用的模式，其 API 文檔中引用了這些運行。

• 建立 — 一種用於製作新預設的模式：具備標準版的完整功能，加上執行時期檢查與記憶體中的外掛程式實驗，專為外掛程式開發者而設計。

外掛程式生態系統，以數字呈現

社群外掛開發始於內部測試期間——最初幾天就建置了大約300個外掛，包括一個Windows XP復古外觀和一個迷因外掛——自公開發布以來，數量持續攀升。重要的數字取決於你計算的方式：

• 288 個外掛程式儲存庫：根據36Kr的調查，中國科技媒體在發布當晚已將其收錄。

• 1,000+ 個儲存庫帶有公開的 GitHub 主題標籤dsh-plugin，在最初幾天內；有些統計數字回報為 700+。

• 1,117 個精選外掛程式，涵蓋 1,521 個受監控的生態系儲存庫，截至 2026 年 8 月 15 日，於社群維護的 Oh-My-DSH 目錄中共獲得 301,295 個 GitHub 星標。

• 2,600+ 個儲存庫收錄於涵蓋整個 dsh-plugin 主題的自動更新 awesome-dsh 目錄中，而368 條橫跨 18 個類別的人工精選條目則收錄於 0xsline awesome-deepseek-harness 清單中。

那些清單中的分類法顯示了社群最初投入的方向——而這正是代理執行環境（agent runtime）所需的對外介面。網頁搜尋：dsh-web-search-exa（以 Exa 為後端，提供免金鑰後備方案）和 dsh-web-search-pro（跨 DeepSeek、Exa、DuckDuckGo、Bing、Jina、GitHub、Bilibili 和 YouTube 的多引擎路由）。RSS 與新聞：dsh-news-plugin 將 10 多個中英文資訊源彙整成結構化條目。Office 檔案：dsh-office 讓模型編輯 Office 文件，並在網頁用戶端提供 docx/pdf 預覽。聊天歷史匯入：dsh-chat-import 可從 13 種編碼代理——Claude Code、OpenAI Codex、ChatGPT、Cursor、Gemini 等——還原完整保真的對話，成為可續接的 DSH 工作階段。行動裝置：dsh-mobile 和 dsh-mobileweb-adapter 可將 UI 放到手機上。飛書與 Lark：dsh-feishu-bot 和 dsh-feishu-notify 將工作階段事件推送至飛書，dsh-im-hub 則是一個多平台閘道（飛書 WebSocket、企業微信、Telegram）。語音：dsh-voice 加入 Edge 神經 TTS 朗讀與語音轉文字功能，而 dsh-voice-webspeech 無需伺服器、也無需 API 金鑰。圍繞這些的是記憶外掛（dsh-memento、dsh-memory-evolve、dsh-recall）、官方工具套件（dsh-toolkit）、IDE 風格的側邊欄（dsh-better-sidebar、deepseek-harness-workbench-plugin）、為純文字模型增添視覺能力的視覺外掛，甚至還有一個 Tauri 桌面封裝 deepseek-harness-desktop。

如何安裝 DSH 並新增外掛程式

安裝路徑很短，而且外掛指令值得完全弄對，因為有幾個教學會把它弄錯。標準形式是 dsh plugin --profile web add <package> — 這個 --profile web 旗標很重要，因為設定檔是 DSH 判斷某個工作階段要執行哪個外掛套件的方式，而 web 設定檔就是 Web UI 背後所用的那一個。

• Install Node.js (reports indicate 22.19 or newer), then start the Web UI: npx @deepseek-ai/dsh web — it serves at http://127.0.0.1:3080.

• 透過 npm 套件名稱新增外掛：dsh plugin --profile web add <package-name>，例如 dsh plugin --profile web add @nanmicoder/dsh-agent-teams。

• 從 GitHub 儲存庫新增：dsh plugin --profile web add "github:owner/repo#ref"（#ref 可固定分支、標籤或提交）。

• 無需全域安裝 dsh： npx -p @deepseek-ai/dsh dsh plugin --profile web add <package-name>。

• 安裝 bundle 外掛程式後，請重新啟動 dsh web 並重新整理頁面；使用 dsh plugin --profile web list 驗證，或在 Web UI 中使用「設定 → 外掛程式」。

有一個會讓初學者困惑的微妙之處：只有宣告了dsh.bundle.patch欄位的套件，才會成為有效的設定檔圖層。普通的相依套件會安裝，但不會生效——bundle 宣告才是告訴 DSH 該套件是 harness 外掛、以及它要在何處修補的關鍵。dsh plugin 命令會將套件操作轉發給 pnpm，因此 npm 套件、GitHub 規格、本機路徑、file: 和 link: 來源都受支援；重新執行相同的 add 命令即可升級該外掛。

如何撰寫自己的外掛程式

由於一切都是外掛程式，撰寫一個外掛程式，其實就是撰寫一個宣告 DSH bundle 的 Cordis 外掛程式——而社群所提供的脚手架，讓它成為一個乾淨的起點。外掛程式註冊表與開發工具（plugin-registry、dsh-plugin-starter、create-dsh-plugin，以及 dsh-plugin-check 健康檢查工具）雖然屬於社群基礎設施，但其契約已經足夠穩定，可以如此描述：你的套件必須宣告 dsh.bundle.patch 才能成為啟用的設定檔層；它會以 Cordis 服務與事件的形式暴露其能力；執行時期則會在載入時決定它如何修補進你所選擇的設定檔。

在本地開發中，循環流程是：複製並建置你的外掛程式，然後用以下指令新增：dsh plugin --profile web add "link:$(pwd)"，接著反覆迭代——用戶端變更需要重新整理頁面，主機端變更則需要重新啟動 dsh 服務。這種本機連結工作流程，正是生態系中最初 1,000 個外掛程式大多數的建置方式，也值得仿效這些專案所實踐的紀律：鎖定版本。預覽迭代速度夠快，因此針對某個 rc 版本撰寫的外掛程式，可能在下一個 rc 版本就出問題——例如社群中的 ModLens 視覺外掛程式，其文件就記載需要鎖定版本才能可靠運作。

軌跡與 MCP —— 評論者一再提及的這兩項功能

在決定 DSH 是否適合你之前，有兩項能力值得了解，因為它們是「外掛清單式文章」不會告訴你的設計重點。第一項是軌跡（trajectory）。每次執行都可追溯：模型的完整經歷——系統提示詞、思維鏈、每次工具呼叫及其結果、子代理排程，以及每次上下文注入——都會寫入僅附加（append-only）的會話日誌，而還原、分支、檢索與重播全都基於同一事件串流運作。Hacker News 上的開發者將此視為殺手級功能，並指出封閉式 agent 產品正是隱藏了這類資料。第二項是 MCP。DSH 隨附官方 MCP 用戶端，提供 /mcp 指令與用於伺服器的 Settings 分頁，而生態系也已經在此基礎上發展——dsh-chatgpt-bridge 以 MCP 伺服器形式將 DSH 會話暴露給 ChatGPT，dsh-mcp-panel 則是該用戶端的可觀測性面板。如果你的 agent 技術棧已經依賴 MCP 伺服器，DSH 可以將它們掛載為外掛。

模型的來源

DSH 是一個 harness（工具框架），而非模型提供者，所以你必須自行提供的唯一東西就是模型端點——而這正是 DeepSeek 自家組合最為契合之處。DeepSeek V4 Flash（總參數 284B / 啟用 13B 的高效 MoE，大約每百萬輸入 token 0.15 美元、每百萬輸出 token 0.29 美元）是經濟實惠的預設選擇；DeepSeek V4 Pro（總參數 1.6T / 啟用 49B 的旗艦模型，大約 0.44 美元 / 0.88 美元）則是高算力引擎。兩者皆託管於 OrcaRouter，以 DeepSeek 的定價零加價供應，並透過一把 OpenAI 相容的 API 金鑰即可存取——這與 DSH 的模型外掛程式完美契合：將模型外掛程式指向 OrcaRouter 端點，你就能在同一個 DSH 框架內於 Flash 與 Pro 之間路由，若其中一個供應商停滯，還能自動故障轉移至第二個供應商。這是真實且誠實的使用案例：OrcaRouter 本身並不託管 DSH——DSH 運行在你的機器上，而 OrcaRouter 是你所指向的模型層。

它失敗的地方 — 誠實的部分

三天內產生125,000顆恆星的能量，也正是產生這些粗糙邊緣的能量。請在安裝前閱讀這些，而非安裝後：

• 這是開發者預覽版，而且它自己也如此說明。README 自身的警告是「將會有破壞相容性的變更」。npm 版本是發行候選版（0.1.0-rc.6），核心外掛程式與基礎 API 仍在持續迭代，啟動介面本身也顯示了針對 Harness 開發者的通知。請勿將生產環境依賴建立在隨時可能變動的版本號碼上。

• 評測框架的選擇會消耗真實的 token。 中國媒體引用的第三方比較發現，在相同的 DeepSeek V4 Flash 任務上，另一個開源評測框架所使用的 token 約為 DeepSeek Harness 的 30%；而 Composio 的一項對照測試在 30 個任務上以相同的 V4 Flash 跑遍八個評測框架，完成次數介於 14 到 20 之間——模型完全相同，結果卻相差三分之一。評測框架並非中立的包裝層；它決定了模型運作的效率。

• 它感覺像一個框架，而不是完成品。 評論者的原話：介面對不會寫程式的人不友善，粗糙之處比比皆是。官方沒有提供 CLI 或 TUI——社群打造了 dsh-TUI 和 dsh-tianshu-tui 來填補這個缺口——而「一切都是外掛」的自由，正是讓預設功能感覺未完成的原因。

• 它能用，但你得盯著它。實測報告——包括首創「一夜五萬顆星」標題的那篇——描述了能完成多步驟任務的代理程式（以不同設計語言重建網站、抓取 GitHub API 資料並渲染圖表），但仍需監督，結果帶有輕微的格式與互動錯誤。

• 以本地優先（Local-first）為原則，代表你自行提供運算資源。 DSH 在你的機器上運行，並使用你的模型金鑰。如果你想要的是受管代理，那這個東西並不適合你。

底線

DeepSeek Harness 是 2026 年成長最快的開源專案，不是因為它是更好的模型——它根本不是模型——而是因為它讓代理本身成為平台。外掛生態系才是真正的重點：官方套件提供 100+ 項能力，發布三天後就收錄了 1,100+ 個社群外掛，而評估這整個賭注最快的方式，就是執行 npx @deepseek-ai/dsh web 並添加幾個外掛。對於想要本機端、可完整檢視的代理執行環境，且願意在變動中的預覽版上鎖定版本的開發者來說，DSH 今天就很值得安裝——透過 OrcaRouter 以 DeepSeek 的定價搭配 DeepSeek V4 Flash 和 DeepSeek V4 Pro，你就能以單純的 token 成本獲得完整技術棧。至於需要生產環境穩定性、無法隨時照看預覽版、或想要受管代理的人，它還沒準備好——請等待相容性介面穩定下來。該框架的主張——價值累積在 harness 而非模型上——是值得下注或辯論的事——而現在，多虧了 1,000+ 個開放外掛，你可以親自驗證。