dsh-plugin-harness2
用于 DSH/Cordis 的 Recursive Harness² 编排插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:WangHaiLongWang/dsh-harness2#2883c304c426092cdbae4e903e06b24bf737e555Plugin Harness2 以 dsh-plugin-harness2 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
面向 DeepSeek Harness（DSH/Cordis）的 Harness² 递归执行框架。在不修改模型权重的前提下，它针对一个明确任务运行 Base → INV/DOM 候选 → Probe → Compose，比较行为差异并返回采用结果；可选的领域经验库把有执行证据支持的经验用于后续任务。
[!IMPORTANT] 这是第三方社区项目，不是 Google 或 DeepSeek 官方产品。设计参考 Google Research 的 Harness² 与论文，当前精确适配 DeepSeek Harness
0.2.1-alpha.4。
4k 个 rollout 和 3k 个编辑/合成阶段。tenant/project/domain 隔离的经验库，以及 Base 配对评估和 CI 发布门槛。k=1 实机冒烟。harness2_run 才执行递归。k=1、libraryMode=off、enableScripts=false。scripts/<name>.py 工具，且默认关闭。DSH 当前 sandbox 不承诺网络隔离，不应把 C7 当作运行不可信 Python 的完整安全边界。| 依赖 | 支持范围 |
|---|---|
| Node.js | ^22.19.0 或 >=24.0.0 |
| DeepSeek Harness | 0.2.1-alpha.4，源码 commit 86a402200d95fecef4529d969836f1fe13c6cb0d |
| Cordis | 4.0.5-alpha.2 |
| Python | 仅开启 C7 时需要，命令名为 python |
DSH API 尚未稳定。其他 DSH 版本需要先更新 peer dependency、重新构建并运行原生 AgentLoop 契约测试。
git clone https://github.com/WangHaiLongWang/dsh-harness2.git
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd dsh-harness2
npm install
npm run link:dsh -- ../deepseek-harness
npm test
cd ../deepseek-harness
pnpm dsh plugin --profile web add "link:$(cd ../dsh-harness2 && pwd)"
Windows PowerShell 可以直接传绝对目录：
npm run link:dsh -- C:\src\deepseek-harness
cd C:\src\deepseek-harness
pnpm dsh plugin --profile web add "link:C:\src\dsh-harness2"
安装后在 DSH Plugins 页面启用 harness2，或在 profile 的 cordis.patch.yml 中添加：
- id: harness2
name: dsh-plugin-harness2
disabled: false
本仓库已经包含 npm 发布元数据，但只有发布到 registry 后下列命令才可使用：
pnpm dsh plugin --profile web add dsh-plugin-harness2
首先运行零成本预检：
harness2_plan
mode: parallel
k: 1
确认预算后执行：
harness2_run
domain: office
mode: parallel
k: 1
task: <完整任务描述>
运维工具：
| 工具 | 作用 | 模型调用 |
|---|---|---|
harness2_plan | 预览调用拓扑和预算 | 无 |
harness2_run | 执行递归 Harness 改进 | 有 |
harness2_status | 查询活跃运行 | 无 |
harness2_cancel | 按精确 run ID 取消 | 无 |
完整字段和风险说明见 配置参考。推荐起点：
- id: harness2
name: dsh-plugin-harness2
disabled: false
config:
mode: parallel
k: 1
timeoutMs: 3600000
maxParallelProposals: 2
maxParallelRollouts: 2
maxTotalTokens: 100000
libraryMode: off
enableScripts: false
tenant: default
project: default
dataDir: !!js dshHomePath('harness2')
设置货币预算时必须同时填写真实 provider 费率。插件不会猜测价格：
maxCost: 1.0
pricing:
inputPerMillion: 1.0
outputPerMillion: 4.0
cacheReadPerMillion: 0.2
cacheWritePerMillion: 1.0
以上数字只是字段示例，不是任何供应商报价。
默认数据目录位于 $DSH_HOME/harness2/：
harness2/
├── runs/<run-id>/summary.json
├── runs/<run-id>-<stage>/run.json
├── library/<tenant>/<project>/<domain>/entries.json
└── assets/ # C7 临时目录，正常结束后删除
harness2/event 只广播 run/stage 标识、状态和 usage，不广播任务正文、轨迹或交付物。详细内容只写入 Run Store；部署者应自行设置目录权限、备份和保留周期。
输入 Base 和候选方法的配对 observation JSON，可生成 Win/Tie/Loss、交付率、回退率、工具错误率、Token/费用/时延、Gain-per-Cost、bootstrap 95% CI 和上线门槛：
npm run eval:report -- observations.json harness2-k1
门槛不通过时命令返回非零退出码。格式示例见 examples/evaluation-observations.json，方法详见 评估指南。
npm install
npm run link:dsh -- ../deepseek-harness
npm run build
npm test
npm run demo
npm run check
link:dsh 只在本项目的 node_modules 中建立开发链接，不修改 DSH 源码。CI 会检出固定 DSH commit 后运行相同测试。
本项目使用 MIT License。Harness²、DeepSeek Harness 及其第三方依赖分别保留自己的许可证；本仓库没有复制 Google Harness² 的实现代码。来源与免责声明见 NOTICE。