MIT 授權的 TypeScript 外掛程式,把 DeepSeek Harness 的 agent 能力公開為 MCP server:5 個工具、結構化結果、依 cwd 重複使用工作階段——預設只監聽本機,且不帶驗證。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-16
授權條款
MIT
01它能幫你完成什麼?
從外部 MCP 使用者端把一項真實編碼任務交給 Harness agent,並在同一次呼叫中取回結構化結果
帶 `sessionId`、`assistantText`、`toolCalls`、`toolResults`、`changes`、`verification`、`leftovers` 的結果,使用者端可據此判斷並記住這次執行
把負責規劃的大腦(如 Hermes)留在使用者端、把 Harness 的 agent 與完整工具集當作動手的手臂來用的團隊
不阻塞使用者端地把任務排進佇列,之後再取結果
一筆帶任務文字、記憶脈絡與工作目錄的排隊任務,以及透過 `task_result` 輪詢回來的同一份結構化結果
需要在大規模重構或多項無關任務平行執行時仍保持使用者端可回應的情境
讓使用者端自己的長期記憶與 Harness 的編碼過程在多次執行之間形成閉環
記憶以 `context` 注入每個任務,執行產出的 `changes` / `verification` / `leftovers` 再寫回使用者端記憶,供下一次任務使用
具備長期專案記憶、希望每次 Harness 執行都帶著脈絡開始並留下紀錄的 agent
把龐大的重構或多項無關任務卸載給 Harness,避免撐爆主 agent 的脈絡
在 Harness 自己的 agent 工作階段裡完成的工作,且工作階段依 cwd 重複使用——README 估計比一次性 `dsh headless` 便宜約 15–20 倍
遇到主 agent 脈絡上限的人,或希望無關任務平行執行的人
02如何將外掛接入 DeepSeek Harness?
先決條件
- 一個 DeepSeek Harness 工作區——npm 套件是以 Harness 外掛程式的形式、透過 `cordis.yml` patch 載入,README 要求你在該工作區裡引用它
- 啟動 Harness 的 shell 中已匯出 `DEEPSEEK_API_KEY`(`export DEEPSEEK_API_KEY=...`)
- 當 agent 的 bash 指令需要寫入檔案時,主機需安裝 `bubblewrap`——`workspace-write` 沙箱缺少它時會拒絕寫入指令
- 若選擇原始碼方式:把儲存庫複製到 Harness 工作區的 `packages/mcp/harness-mcp-server/`(pnpm workspace 比對 `packages/*/*`),並在 `tsconfig.host.json` / `tsconfig.base.json` 中登錄
安裝步驟
- 01
執行 `npm install @chushixixin/dsh-harness-mcp-server`——README 推薦的 npm 方式
$ npm install @chushixixin/dsh-harness-mcp-server
- 02
在 Harness 工作區透過 `cordis.yml` patch 引用此外掛程式:插入 `id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'`,設定 `http: true`、`port: 8090`、`host: 127.0.0.1`
- 03
帶著該 patch 啟動 Harness:`corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml`
- 04
改用原始碼方式:複製到 `packages/mcp/harness-mcp-server/`,執行 `corepack pnpm install`,在 `tsconfig.host.json` references 與 `tsconfig.base.json` paths 中登錄該套件,然後 `corepack pnpm exec tsc -b packages/mcp/harness-mcp-server` 與 `corepack pnpm run build:lib:host`
- 05
把 MCP 使用者端指向 `http://127.0.0.1:8090/mcp`;Hermes 對應的指令是 `printf 'n\nY\n' | hermes mcp add harness_plugin --url http://127.0.0.1:8090/mcp`
驗證整合成功
- README 提供的啟動指標是 MCP server 監聽在 `127.0.0.1:8090`(StreamableHTTP)
- 呼叫 `echo` 工具——README 將它列為驗證 MCP 連線的方式
- `harness_list_tools` 應回傳 Harness 已註冊的工具名稱清單
03DSH 整合程度與能力邊界
DSH(Cordis)外掛程式——透過 `cordis.yml` patch 註冊進 Harness 工作區(`id: harness-mcp-server`、`name: '@chushixixin/dsh-harness-mcp-server'`),並以 `corepack pnpm dsh web --patch …/cordis.yml` 啟動;在 Harness 內部執行一個 StreamableHTTP MCP server(`127.0.0.1:8090`),橋接 `ctx.agents` / `ctx.agentPresets` / `ctx.tools`,讓外部 MCP 使用者端驅動真正的 Harness agent
StreamableHTTP 上的 5 個 MCP 工具
指向 `http://127.0.0.1:8090/mcp` 的 MCP 使用者端(README 以 Hermes 為例)→`echo`、`harness_list_tools`、`agent_run`、`task_inbox`、`task_result`
依設定的 `host` / `port` 開啟 HTTP 監聽(patch 預設 `127.0.0.1:8090`)該監聽預設沒有驗證——README 直言這就是未經驗證的遠端程式碼執行同步執行 agent 任務
交給 `agent_run` 的一項任務→Harness 以 `standard` preset 建立 agent,並回傳這次執行的結構化結果
會實際啟動一個帶完整工具集(`bash`、`fs`、`todo`、`web`)的 Harness agent,在你傳入的 cwd 上作業非同步任務佇列
透過 `task_inbox` 推入的任務文字、記憶脈絡與 cwd→一筆排隊任務,其結構化結果由 `task_result` 輪詢取回
任務在 Harness 內部等待,直到有使用者端輪詢與呼叫端之間的記憶交接
隨每個任務一起送出的記憶脈絡→每次結果中的 `changes`、`verification`、`leftovers`,可直接寫回使用者端記憶
沙箱化 bash 與依 cwd 重複使用工作階段
Harness agent 決定執行的 bash 指令→寫入受 `workspace-write` 沙箱限制,且 agent 工作階段依 cwd 在多次呼叫間重複使用
主機沒有 `bubblewrap` 時沙箱會拒絕寫入指令每個新的 MCP 工作階段都各自擁有 `McpServer` + transport,因為一個 MCP `McpServer` 只連一個 transport
04適合誰?何時不該用?
適合
- 把負責規劃的大腦(如 Hermes)留在使用者端、把 Harness 的 agent 與完整工具集當作動手的手臂來用的團隊
- 需要在大規模重構或多項無關任務平行執行時仍保持使用者端可回應的情境
- 具備長期專案記憶、希望每次 Harness 執行都帶著脈絡開始並留下紀錄的 agent
- 遇到主 agent 脈絡上限的人,或希望無關任務平行執行的人
不適合
- 該監聽埠等同未經驗證的遠端程式碼執行:README 明確禁止把它綁定到 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。
- 驗證與 cwd 白名單都是選用項——`cordis.yml` 範例中的 `authToken` 與 `workspaceRoots` 是註解狀態,原樣使用則兩者都沒有。
- bash 執行在 `workspace-write` 沙箱裡;主機未安裝 `bubblewrap` 時沙箱拒絕寫入指令,需要變更檔案的任務就無法完成。
05相容性、維護與安全提醒
- 該監聽埠等同未經驗證的遠端程式碼執行:README 明確禁止把它綁定到 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。
- 驗證與 cwd 白名單都是選用項——`cordis.yml` 範例中的 `authToken` 與 `workspaceRoots` 是註解狀態,原樣使用則兩者都沒有。
- bash 執行在 `workspace-write` 沙箱裡;主機未安裝 `bubblewrap` 時沙箱拒絕寫入指令,需要變更檔案的任務就無法完成。
- 作者將它定位為備援工具而非日常主力;另外每個新的 MCP 工作階段都會取得自己的 `McpServer` + transport,一個 server 只對應一個 transport。
MIT · 最新發布 v0.1.8(2026-08-15T11:47:03Z)· 早期外掛程式,5 個 MCP 工具
06常見問題
怎麼把 dsh-harness-mcp-server 裝進 DeepSeek Harness 工作區?
先用 `npm install @chushixixin/dsh-harness-mcp-server` 安裝,再依 README 提供的 `cordis.yml` patch 在 Harness 工作區裡引用它——patch 會插入外掛程式 `harness-mcp-server`,並寫上 `name: '@chushixixin/dsh-harness-mcp-server'`。README 沒有 `dsh plugin add` 這一步,啟動指令是 `corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml`。
Harness 內部實際執行的是什麼?
一個監聽 `127.0.0.1:8090` 的 StreamableHTTP MCP server,橋接 Harness 的 `ctx.agents`、`ctx.agentPresets` 與 `ctx.tools`。外部使用者端呼叫 `agent_run` 或 `task_inbox`,Harness 便以 `standard` preset 啟動一個帶完整工具集(`bash`、`fs`、`todo`、`web`)的 agent 執行任務。
把 MCP 連接埠暴露出去安全嗎?
不安全。README 說明該 server 暴露的是未經驗證的遠端程式碼執行,禁止綁定 `0.0.0.0`,也禁止在未加入驗證、TLS 與反向代理之前暴露到網際網路或區域網路。`authToken`(Bearer)與 `workspaceRoots`(cwd 白名單)都是選用項,在隨附的 patch 中是註解狀態。
為什麼作者稱它為備援工具?
日常修改程式碼時他建議直接驅動主 agent,只在需要脈絡隔離(會撐爆使用者端脈絡的超大重構)或平行執行無關任務時才用它。agent 工作階段依 cwd 重複使用,README 估計比一次性 `dsh headless` 便宜約 15–20 倍。
執行需要寫入檔案的任務前,主機要準備什麼?
需要為 Harness 匯出 `DEEPSEEK_API_KEY`,並安裝 `bubblewrap`——bash 執行在 `workspace-write` 沙箱裡,缺少它會拒絕寫入指令。另外注意每個新的 MCP 工作階段都會各自建立 `McpServer` 與 transport。
07相關的 DSH 工作流程
dsh-our-free-model
作者 ebony-vinyl
在 dsh 裡裝上這個外掛即可,無需登入、註冊或填 API Key,就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在內的前沿模型——完全免費,不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness(dsh)路由套件:先裝執行時注入器,再載入任務感知的推理模式路由預設(已實測 P1-P23)。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底層操作工具外掛,旨在減少 Token 消耗與任務耗時
dsh-connect-workbuddy
作者 dingminhua
將本地登入的 WorkBuddy 模型接入 DeepSeek Harness,並提供只讀額度概覽與模型管理。
08資料與來源
but it is a **Cordis app**, not something another agent can call.
This plugin turns Harness inside-out: it starts a real **MCP server** (StreamableHTTP) *inside* Harness
bridges Harness's core services — `ctx.agents`, `ctx.agentPresets`, `ctx.tools`
corepack pnpm dsh web --patch ./packages/mcp/harness-mcp-server/cordis.yml
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
