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 个值得优先安装的插件,覆盖各个分类。
