前言¶

DeepSeek Harness（DSH）的插件化设计让 Agent 开发更灵活，但单个 Harness 难以在执行过程中持续自我优化。本文介绍 dsh-plugin-harness2，它为 DSH 注入 Harness² 递归自化能力，在模型权重不变的前提下，通过 Base → INV/DOM 候选 → Probe → Compose 的流程比较行为差异，将更有执行证据的经验纳入后续任务。

插件定位¶

dsh-plugin-harness2 是一个面向 DeepSeek Harness 0.2.1-alpha.4 的第三方插件，由社区开发者 WangHaiLongWang 维护。它参考 Google Research 的 Harness² 研究设计，在 DSH 基础上增加递归执行框架，支持并行与顺序两种模式，内置 Web 可视化面板与自动化评估工具。

核心能力¶

• 内置 DSH Web 可视化面板，展示 Base → INV/DOM → Compose 流程与文件/行级 Harness Diff。
• Parallel 和 Sequential 两种递归模式；一种模式约执行 4k 个 rollout 和 3k 个编辑/合成阶段。
• INV（通用执行能力）与 DOM（领域能力）分工、匹配 Probe、选择性 Compose、匿名最终选择。
• C1–C7 Harness 组件：system prompt、guardrails、memory、tool guidance、subagents、skills、scripts。
• Token/显式价格预算、超时、取消、失败回退、运行状态和脱敏生命周期事件。
• 按 tenant/project/domain 隔离的经验库，以及 Base 配对评估和 CI 发布门槛。
• 32 项自动化测试、真实 DSH AgentLoop 集成测试和 k=1 实机冒烟。

安全默认值¶

• 普通任务不会自动触发，只有显式调用 harness2_run 才执行递归。
• Bundle 默认禁用，安装本身不产生模型调用。
• k=1、libraryMode=off、enableScripts=false。
• C8 middleware plugin 禁止自动生成或加载。
• C7 只支持固定的 scripts/.py 工具，且默认关闭。DSH 当前 sandbox 不承诺网络隔离，不应把 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 安装¶

本仓库已经包含 npm 发布元数据，但只有发布到 registry 后下列命令才可使用：

pnpm dsh plugin --profile web add dsh-plugin-harness2

典型用法¶

预检预算¶

首先运行零成本预检，查看调用拓扑和预算：

harness2_plan
  mode: parallel
  k: 1

执行递归 Harness 改进¶

确认预算后执行：

harness2_run
  domain: office
  mode: parallel
  k: 1
  task: <完整任务描述>

运维工具¶

配置示例¶

完整字段和风险说明见配置参考。推荐起点：

- 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 后运行相同测试。

文档包括：
- DSH 可视化面板与 Web Harness Diff
- 架构说明
- 配置参考
- 部署与运维
- 安全模型
- 评估指南
- 实施状态
- 完整开发计划
- 贡献指南
- 变更日志

适用场景与注意¶

dsh-plugin-harness2 适合希望在 DSH 中实现 Harness² 递归自化能力的开发者，尤其是需要比较 Base 与候选方法行为差异、积累领域经验、在 CI 中评估上线门槛的场景。

使用时请注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- 依赖 DeepSeek Harness 0.2.1-alpha.4，其他版本需先更新 peer dependency、重新构建并运行原生 AgentLoop 契约测试。
- DSH API 尚未稳定，其他 DSH 版本需要先更新 peer dependency、重新构建并运行原生 AgentLoop 契约测试。

结尾¶

dsh-plugin-harness2 在不修改模型权重的前提下，为 DeepSeek Harness 提供递归自化能力与可视化调整工具，适合需要持续优化 Harness 行为、积累领域经验的 Agent 开发场景。

目录页：https://www.skillhub.cn/plugins/WangHaiLongWang/dsh-harness2
GitHub：https://github.com/WangHaiLongWang/dsh-harness2