Skip to main content
O

dsh-research-harness

oseas031/dsh-research-harness

Research workbench with evidence-bound findings, guard receipts, completion gates, a CLI, ten bundled skills, and paired skill-evolution evaluation.

Install

dsh plugin --profile web add github:oseas031/dsh-research-harness

README

dsh-research-harness

面向 DSH 的科研工作台:把证据守卫、追加式台账、完成门禁、最短路径路由和 10 个科研技能装进独立「科研 Harness」预设。技能是库存,证据契约是产品。

当前仓库版本:v0.5.0。版本变化见 CHANGELOG,机制与文件契约见 docs/README。

v0.5.0 能做什么

  • 证据入账:研究发现必须带 provenance 与 confidence(observed / inferred / unknown),支持 task 标签和验证状态。
  • 完成门禁:未决 blocker 阻止直接 complete;软门禁跳过必须留下原因、风险与补偿动作。
  • 最短路径路由:route 根据台账给出 record-findings、resolve-blockers、continue-recording、run-acceptance 或 BLOCKED,并落 route-check 检查点。
  • 证据收据:机制写入台账时同步写 SHA-256 收据;verify 可发现改行、删行和缺失收据。
  • 报告入账与复验:把报告中的 findings 代码块结构化导入,区分 agent-reported 与 lead-verified。
  • 技能进化闭环:冻结评估资产,生成随机 A/B 配对评审包,依据 verdict 选择 keep/revert,并保存进化谱系、回滚副本、archive 收据和 champion 记录。
  • 任务级验收计数:acceptance.task 将 minFindings 与 minObservedRatio 的统计限定到当前 REQ-xxxx / TASK-xxxx,便于共享台账。

环境与实测边界

  • Node.js >= 22,并使用支持该插件包与 bundle patch 的 DSH。
  • 当前项目实测范围是 Windows + DSH;macOS、Linux、其他 DSH 版本以及其他安装布局需要在对应环境重新验收。
  • harness-lab 用真实 cordis boot、ToolsService 和 SystemPrompt 验证插件契约层,但它不是完整的 DSH UI 端到端测试。
  • persona、工具面、技能根等预设组合层在真实 DSH 中变更后,需要完全退出并重启 DSH 再验收。

安装

npm

把 v0.5.0 安装进 DSH 的 web profile(使用其他 profile 时替换名称):

dsh plugin --profile web add dsh-research-harness@0.5.0

只需要独立 CLI 时,也可以全局安装:

npm install -g dsh-research-harness@0.5.0

GitHub

dsh plugin --profile web add github:Oseas031/dsh-research-harness#v0.5.0

也可以从源码安装 CLI:

git clone https://github.com/Oseas031/dsh-research-harness.git
cd dsh-research-harness
npm install
npm link

dsh plugin add 会把包安装进指定 profile,并处理包声明的 dsh.bundle patch。安装、更新或修改预设组合后,完全退出并重启 DSH,再选择「科研 Harness」。只使用独立 CLI 时不需要重启 DSH。

重启后检查 findings.record、findings.status、findings.route、findings.verify 是否可用,并确认技能 provider 已注册 10 个技能。未全局安装 CLI 时,可在仓库根目录把下文中的 research-harness 换成 node bin/research-harness.mjs。

CLI Quickstart

以下命令在源码仓库根目录执行,示例台账为当前目录下的 .research:

# 初始化台账
research-harness init --ledger .research

# 记录一条带来源的发现
research-harness record --claim "README 提供 v0.5.0 使用说明" --provenance "README.md:1" --confidence observed --task REQ-0005 --verified-by agent-reported --ledger .research

# 查看统计、未决 blocker 和 route-check 数
research-harness status --ledger .research

# 重算每行 SHA-256 并核对机制收据
research-harness verify --ledger .research

# 根据当前台账决定下一步,并写入 route-check
research-harness route --scale delegate --ledger .research

可用 --acceptance acceptance.json 给 route 传入验收充分性规格,例如:

{
  "minFindings": 1,
  "minObservedRatio": 1,
  "requiredRouteChecks": 1,
  "task": "REQ-0005"
}

技能进化 Quickstart

先在源码仓库根目录创建实验并计算父本哈希。--root . 明确把实验写入当前仓库,而不是全局安装目录:

research-harness evolve init --name EXP --surface "skills/validate-data/**" --root .
research-harness evolve hash --file skills/validate-data/SKILL.md --root .

按 v0.5.0 进化契约 准备 proposal.json、生成配对 packet 并填写 verdict 后,再执行:

research-harness evolve apply --name EXP --candidate proposal.json --root .
research-harness evolve select --name EXP --root . --ledger .research
research-harness evolve verify --name EXP --root .
research-harness evolve log --name EXP --root .
research-harness evolve champion --name EXP --root .

apply 前后及 select 前会复核冻结的 evaluator_id;发生漂移时拒绝或回滚。候选是完整文件替换,机制不会 import 或执行候选代码。

默认数据位置

使用方式默认位置覆盖方式
DSH 插件~/.dsh/research-harness/(Windows 通常为 %USERPROFILE%/.dsh/research-harness/)插件配置 ledgerRoot;无法取得 DSH home 时回退到 ./.research
独立 CLI当前工作目录的 ./.research--ledger DIR,其次 RESEARCH_LEDGER 环境变量
技能进化<root>/.evolve/<name>/--root DIR;缺省为 CLI 所在包根目录

主要产物:

  • ledger.jsonl:追加式证据、unknown、route-check、完成尝试和 champion 事件。
  • ledger-receipts.jsonl:与机制写入行对应的 SHA-256 收据。
  • guard-log.jsonl:守卫拒绝与接线自检留痕。
  • .evolve/<name>/:contract.json、archive.jsonl、archive-receipts.jsonl、gens/、packets/、verdicts/ 和 backups/。

收据用于发现台账漂移,不证明研究结论为真。旧台账中没有收据的行会计为 unverified,不会仅因此被误判为漂移。

内置 10 个技能

技能用途
expectation-alignment研究开工前的六层预期对齐、探针与未知项治理
humanizer-paper中英文学术稿件保真润色与 AI 痕迹检查
latex-paper-en英文 LaTeX 论文编译、结构、引用、逻辑与格式修复
latex-thesis-zh中文 LaTeX 学位论文编译、规范、结构与一致性检查
literature-search-arxivarXiv 检索及 PDF、HTML、LaTeX 源码获取
nature-polishing学术论文保真润色、翻译、精简与 LaTeX 布局修正
qu-ai-wei简体中文保真改写与自然化表达
sci-figure代码生成、可复现、可迭代的科研图件
scientific-problem-selection科研选题、风险评估与研究路线决策
validate-data分享前复核分析方法、计算、偏差与结论

技能说明以各自 skills/<name>/SKILL.md 为准。

限制

  • v0.5.0 的进化评审是对「技能文本能否引导目标行为」的配对文本行为评审,不是运行时 benchmark,也不证明统计意义上的能力增益。
  • 进化对象是技能文本;evals/**、机制代码、台账与进化谱系等受保护路径不属于可修改 surface。
  • 自动长跑、operator 算法库、容器化运行、novelty、多父本合并和 viewer 不在当前版本范围内。
  • 本地单测或 harness-lab 结果只代表对应环境,不等同于 npm 发布状态或远端 CI 状态。

文档与开发

License

MIT © 2026 YG

Related plugins