让 Coding Agent 在宣布完成之前，用可验证证据证明自己的工作。
Make coding agents prove their work before they declare it done.
Coding Agent 会理解任务、修改代码，然后说“完成了”。但“完成”首先只是模型对上下文的判断，不等于工程上的真实状态。
Agent 的完成声明
≠
代码已经满足任务结束条件
真实世界仍需要回答：代码能否构建？测试是否通过？改动是否引入回归？当前代码是否仍对应那次验证？
DSH Quality 处理的正是这段差距：把 Agent 的主观完成声明，变成基于当前代码状态的可验证结论。
DSH Quality 不试图定义“什么是优秀代码”。它只判断：当前项目声明的结束条件，是否已经由足够的验证事实满足。
Agent 声明完成
↓
当前改动需要哪些证明？
↓
执行真实验证，得到可追溯结果
↓
这些结果对当前代码是否仍有效？
↓
满足条件 → 允许完成
不满足 → 给出修复反馈，继续工作
一项可信证明至少要具备：
- 相关：与当前改动及其风险有关。
- 真实执行：来自实际命令、工具或受信任的外部验证，而非模型猜测。
- 新鲜：验证后相关代码没有再变化。
- 可追溯：能知道验证了什么、针对哪个代码状态、由谁执行、结果如何。
因此，“之前跑过测试”不够；它必须能证明现在这份代码满足所需条件。
用户要求 → 期望状态
↓
Agent → 代码改动 → 所需证明 → 验证结果 → 完成判断
│
不足 ← 修复反馈 ←┘
当验证不足或失败时，DSH Quality 不只报告问题，还将可操作的反馈交给 Agent。Agent 修复后重新验证；重复失败则会停止自动循环，避免无止境消耗。
这就是项目的产品边界：增强 Agent “完成声明”的可信度。它不是代码生成器、CI/CD 平台、通用日志系统、Agent Benchmark 或聊天界面。
当前仓库实现了这条闭环的 v0.2 核心，并保留 v0.1 CLI 作为兼容入口：
- 基于 Git 工作区差异、未跟踪文件和工具观察结果识别当前改动。
- 对文档、源代码、测试和构建改动生成确定性的验证要求；无法可靠归因时保守处理。
- 支持 Maven、Gradle、Python/pytest、Node/npm 的测试验证。
- 将验证结果与输入摘要、计划摘要、执行来源和时间绑定；相关代码改变后结果自动失效。
- 仅在 Agent 准备结束时做判断；缺失验证会按需执行，失败时最多自动反馈两次。
- 运行命令支持取消、超时后的进程组终止，以及运行时日志截断。
当前尚未提供真实 DeepSeek Harness 的安装/注册包，也没有 affected-test、Lint、Coverage、安全扫描、持久化结果或 Dashboard。它也不是隔离沙箱：项目测试脚本仍在本机执行。
完整的架构、边界和路线图见 v0.2 Evidence-driven Quality Gate 设计。
npm install --ignore-scripts
npm run build
node dist/src/cli.js run --root examples/node预期结果：Quality Gate: PASS。故障示例会以退出码 1 结束：
node dist/src/cli.js run --root examples/node-failDSH Quality turns an agent’s subjective “done” into a verifiable completion decision. It asks one question: does the current code have enough trustworthy proof to satisfy this project’s declared completion criteria?
Claim completion → determine required proof → run verification
→ bind results to the current code state → allow completion or request repair
Proof must be relevant to the change, produced by real execution, fresh for the current code state, and traceable to its source and result. DSH Quality is a feedback loop for coding agents—not a code generator, CI/CD platform, generic log system, agent benchmark, or chat UI.
- Git-aware change snapshots with conservative fallback when attribution is uncertain.
- Deterministic verification planning and fresh-result reuse.
- Maven, Gradle, pytest, and npm test execution.
- Bounded repair feedback at the terminal completion checkpoint.
- Cancellation, timeout escalation, and bounded command output.
The repository currently exposes a v0.1-compatible CLI and v0.2 core library. A production DeepSeek Harness adapter, affected-test analysis, lint, coverage, security, durable storage, and a dashboard are future work.
npm install --ignore-scripts
npm run build
node dist/src/cli.js run --root examples/nodeThe CLI writes quality-report.md and exits with code 1 when the gate fails.
dsh-quality run [--root path] [--timeout seconds] [--report-file path]
HarnessHook accepts generic tool-result and terminal events. Map your host events to it, then connect its steering callback to the host’s actual continuation mechanism.
const coordinator = createDefaultQualityCoordinator(config);
const hook = new HarnessHook(
coordinator,
(feedback) => logger.info(feedback),
(feedback) => host.steerAgent(agent, feedback)
);
await hook.handle({
type: "tools/result",
success: true,
changedFiles: ["src/user.ts"],
projectRoot: process.cwd(),
mayHaveMutated: true
});
await hook.handle({ type: "agent/turn-stopping", success: true, changedFiles: [], projectRoot: process.cwd() });npm run typecheck
npm test
node dist/src/cli.js run --root examples/node