dsh-done-check
Verifieddsh-done-check · v0.2.0 · MIT
Executable acceptance checklists for DeepSeek Harness coding tasks: every "done" has a recorded check result, and results go stale when the code changes.
Install
dsh plugin add dsh-done-check Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-done-check
English | 中文
为 DeepSeek Harness 编码任务保存可执行的验收清单:每条"已完成"都有真实执行的检查结果,代码变化后旧结果自动标记为需要重验。
它能说明什么,不能说明什么
- "3 项验收中,2 项通过、1 项待人工确认"只表示约定的检查的结果,不表示需求已完整实现。插件不显示百分比或"完成度"。
- 防的是 Agent 随手改写结论:自己宣布测试通过、偷改检查命令、删掉失败项、伪造确认记录。不防拥有不受限 shell 的恶意 Agent,它可以改测试本身,也可以改 DSH home 下的文件。
- 确认清单不等于授权执行其中的命令。检查命令由当前 DSH 组合的 shell 执行器运行;
bash-local/pwsh-local不做任何隔离,需要隔离请组合对应的 sandbox 执行器。watch是你声明的范围,不是自动分析出的依赖关系。
演示
真实的 DSH Web 会话,使用 v0.2(DSH 0.1.5-rc.1,一个 CSV 导出示例仓库,全程只用命令)。
/done-check预览清单:会执行哪些命令,哪项需要你亲自确认。/done-check 确认:确认不等于授权,命令仍按你的权限设置执行。/done-check执行检查,第一次就抓到真实问题:含逗号的字段没有加引号。测试报告按原文摘录。- 修好
toCsv后再输入/done-check:两项自动检查通过,只剩人工项。 /done-check ok记录你的结论:3 项全部通过。

最后一帧可以看到,不展开任何一行,折叠标题本身就能读出每一步的结论。
状态
v0.2.0,早期版本。v0.2 只重做了你看到和输入的这一层,验证规则没有改动。新输出已在真实的 DSH Web 宿主(0.1.5-rc.1 和 0.2.1-rc.5)上验证,检查由真实的 pwsh 工具在沙箱中执行。支持的 DSH 版本:>=0.1.5-rc.1 <0.3.0。设计见 docs/DESIGN.md。
安装
dsh plugin --profile <你的 profile> add dsh-done-check
从源码安装:先 pnpm install && pnpm build,再 dsh plugin --profile <你的 profile> add /path/to/dsh-done-check。
命令与工具
主路径只需要一个命令:/done-check 按当前状态做下一件该做的事——预览清单、执行检查或给出结论。
| 谁用 | 作用 | |
|---|---|---|
/done-check |
你 | 清单还没确认 → 展示清单和将要执行的命令,不执行任何东西。已确认 → 执行"还没检查"或"代码已更新"的自动项,再给摘要。 |
/done-check 确认(confirm) |
仅你 | 确认你刚看过的清单。只对最近一次预览的那份清单生效,否则重新展示预览。 |
/done-check ok [序号] / no [序号] [备注] |
仅你 | 记录人工项结论。只有一个人工项在等你时可以不写序号。 |
/done-check 详情 [序号](details) |
你 | 命令、退出码、执行时间、输出末尾、变化的文件 |
/done-check 全部(all) |
你 | 每一项的状态和详情(含已通过的) |
/done-check 技术详情 [序号](tech) |
你 | 执行器与沙箱模式、完整指纹、定义哈希、日志路径 |
/done-check 重新检查(run) |
你 | 强制重跑全部自动检查 |
done_check_draft |
Agent | 校验起草的清单(由 Agent 用自己的文件工具保存) |
done_check_run |
Agent | 执行已确认的自动检查 |
done_check_status |
Agent | 读取状态(返回 verdict 和 nextStep) |
序号是摘要里的排列顺序,内部 ID 仍然可用。show、pass、fail 作为旧别名再保留一个版本。
输出只回答三个问题:检查了什么、还有什么问题、现在该做什么。第一行永远是一句完整结论,例如 ❌ CSV 导出还有 1 项检查未通过。检查未通过时,会原文摘录测试自己输出的最多三行,标为"测试报告",插件不做任何推断。没能运行的检查(权限拒绝、超时、执行环境出错)显示为 ⚠️ 没能运行,既不当作失败,也绝不当作通过。
确认不等于授权执行。 确认之后输入 /done-check 就会执行已确认的命令,仍按你当前会话的权限规则。每条命令都交给你的 DSH 组合中已注册的 shell 工具(pwsh/bash)执行,所以你的审批提示都会生效;被拒绝的命令不记录证据。
工作方式
在项目根目录写
done-check.yaml(或让 Agent 起草)。检查名称用你能判断的行为来写,人工项写上how:version: 1 task: CSV 导出 checks: - id: export-tests name: 导出内容与所选数据一致 run: node test/export.test.mjs watch: ["src/**", "test/**"] - id: escape-tests name: 含逗号和换行的数据能正确导出 run: node test/escape.test.mjs watch: ["src/**", "test/**"] - id: zh-filename name: 中文文件名可以正常下载 manual: true how: 在浏览器里导出一个名为“报表”的文件,确认文件名没有乱码输入
/done-check预览,用/done-check 确认确认。确认和人工结论只能由你完成,Agent 做不到。检查经由 DSH 的 shell 工具真实运行,记录退出码、输出、耗时和当时的工作区指纹。
工作区内容一变(包括未提交的修改),绑定旧内容的结果就显示为
🔄 代码已更新,需要重新检查,详情里列出变化的文件;清单里某项被改,该项显示✏️并要求你重新确认;增删检查项或改任务描述,整份清单要求重新确认。执行期间工作区或定义发生变化的结果显示为
🔄 检查时代码正在变化,结果不可信,把文件改回去也不能恢复。
开发
pnpm install
pnpm test
需要 Node.js ≥ 22.19 和 git。
许可证
MIT