前言¶

在 DSH web 的 todo 流程里，官方 todo 面板通常只服务当前轮次的任务展示。如果还希望未完成任务跨轮次、跨会话和重启后保留，同时对已完成项附一个证据路径，就需要一个不改动官方面板的审阅层。dsh-todo-guard 是 DSH web 的社区插件：官方 todo 面板保持原样，插件在官方面板下方挂载 review dock，用于保留未完成任务并标注完成证据。

它由 a903067276-rgb 维护，是 community project，不是 DeepSeek 产品，许可证为 MIT。DSH 的生态理念是“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应把它当成官方应用商店。

这是什么¶

dsh-todo-guard 是 DeepSeek Harness web 的 todo 审阅插件。它的定位是：官方 todo 面板不被修改或替换，插件通过额外 conversation.input.dock 在官方 todo 面板下方挂载 review dock。

它主要解决两件事：

• 保留未完成任务：跨轮次、会话切换和 dsh 重启仍然保留。
• 核验完成证据：对 todo 项中给出的路径做存在性标注，并让人确认 finalize。

整个逻辑是纯本地逻辑：zero model calls、zero token cost。

核心功能¶

保留未完成任务¶

插件通过 checkpoint resume 保留未完成任务。官方面板重启后渲染失败时，review dock 可作为 fallback。

证据状态标注¶

strictMode 默认开启。开启后，todo 项会根据证据路径标注三种状态：

• 证据路径存在：verified。
• 已写路径或锚点，但路径缺失：evidence missing。
• 无可验证轨迹：unverified。

证据路径仅做存在性检查，host 只做 stat，不读取内容。因此“路径存在”不等于“任务实际完成”。

strictMode 可以在 Settings → todo strict mode 关闭。关闭后，review dock 变成普通列表，不再有标注和确认，但 resume 仍可用。

非阻塞提示¶

证据缺失或伪造不会阻塞任务写入，也不会报错。插件只在工具结果文本中给 nudge 提示。

一次检查 2 个及以上项目时，会触发逐步检查提示，也就是 incremental check nudge。

如果 host 支持 official tools/post-execute，插件会在成功写入后追加非阻塞文本提示；旧 host 没有该 hook 时，降级为面板标注。

审阅与 finalize¶

review dock 默认折叠。折叠时显示 pending 数量，并保留 finalize 按钮。

如果所有项都 checked 且全部 auto-verified，review dock 会自动隐藏。仍有 pending 时，需要点击 Confirm finalize；确认状态按会话保存在浏览器。

安装与启用¶

先安装插件，再重启 dsh web：

dsh plugin --profile web add "github:a903067276-rgb/dsh-todo-guard#main"
# restart dsh web

版本兼容是 best-effort，不保证每个 DSH 版本都兼容。已核实的兼容关系如下：

• DSH 0.1.1-rc.1+：使用 main。
• DSH 0.1.0-rc.7 / rc.8：review dock 数据不保证，建议使用 v0.1.6 fallback。
• DSH 0.1.0-rc.6：frozen rc6-compat，不再维护。

旧版本 fallback：

dsh plugin add github:a903067276-rgb/dsh-todo-guard#v0.1.6

package engines 要求 dsh >=0.0.1；peerDependencies 包括 @deepseek-ai/cordis ^4.0.1-rc.1 和 @deepseek-ai/schemastery ^3.18.1。

典型用法¶

在 todo 项内写 （证据：path）。一个 todo 项可以写多个证据路径。

Fix the button（证据：lib/index.js）
Run tests（证据：test/run.log）（证据：docs/result.md）

相对路径按 session working directory 解析；绝对路径和 ~/ 原样支持。

适用场景与注意¶

dsh-todo-guard 适合使用 DSH web 管理 todo、并且希望保留未完成任务和证据标注的场景。

使用前注意：

• 它是 community project，不是 DeepSeek 产品。
• 版本兼容是 best-effort，不保证每个 DSH 版本都兼容。
• 证据路径仅做存在性检查，host 只做 stat，不读取内容；路径存在不等于实际完成。
• strictMode 关闭后，dock 变为普通列表，无标注和确认，但 resume 仍可用。
• 插件会以当前 dsh 进程权限运行，并会注册 dock、检查证据路径、追加提示。安装前建议检查 GitHub 源码、MIT 许可证和依赖声明。

结尾¶

dsh-todo-guard 的价值在于：不动官方 todo 面板，给 DSH web 的 todo 流增加一层轻量审阅：保留未完成任务、标注证据状态、让人确认 finalize。它不替代实际完成验证，但适合作为本地 todo 审阅辅助。

GitHub：https://github.com/a903067276-rgb/dsh-todo-guard

目录页：https://www.skillhub.cn/plugins/a903067276-rgb/dsh-todo-guard