deepseekplugins

DeepSeek Harness 插件

dsh-todo-guard

Reliable todo panel for DSH: survives restarts, verifies completion evidence（英文原文）

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
a903067276-rgb/dsh-todo-guard
最近更新
2026年8月22日
分类
插件开发工具
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/a903067276-rgb/dsh-todo-guard
插件名：dsh-todo-guard
作者：a903067276-rgb

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh-CN.md来源说明 · 只读预览
README 语言

dsh-todo-guard ✅

English | 简体中文

!License: MIT

DeepSeek Harness（dsh）web 的可靠 todo 面板插件：重启后照常显示（绕过官方面板重启后不显示的 bug），勾"完成"时自动校验证据。

非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。

截图

![dsh-todo-guard 任务面板](assets/todo-panel.png)

运行要求

  • DSH web（≥ 0.1.0-rc.6）（npx @deepseek-ai/dsh web 启动）
  • 版本兼容（尽力兼容——设置卡片用双字段 key+id 注册，同满足 rc.6（id 契约）与 rc.7+（key 契约）；已在本地实测 rc.6/rc.8/0.1.1-rc.2，不保证每个 DSH 版本）：

- DSH 0.1.0-rc.6 及以上（含 0.1.1-rc.1/rc.2）：装 main（默认）。 - 保守回退（升级前的最后版本）：DSH 0.1.0-rc.7/rc.8 → v0.1.4（dsh plugin add github:a903067276-rgb/dsh-todo-guard#v0.1.4）；DSH 0.1.0-rc.6 → 冻结 rc6-compat（不再维护）。

  • 维护策略：本插件将持续跟随 DSH 最新版本演进；对旧版 DSH 的兼容仅是尽力而为、不保证长期有效。

功能

  • 重启不丢显示——顶替官方 todo 面板（conversation.input.dock 格子，priority: -1 shadow）；重启 dsh 后重新打开会话，todo 列表照常显示
  • 完成校验三态——agent 勾"完成"时自动检查证据：

- （证据：路径） 且文件存在 → ✅ 绿勾（已验证） - （证据：路径） 但查无此物 → 🚫 拦截，agent 收到明确报错并需修正 - 无证据标记 → ⚠️ 放行，面板黄标"未验证"（不误伤"做了但忘写证据"；未验证项肉眼可查）

证据写法

todo 条目内容里写 （证据：路径）（支持多条）。相对路径按会话工作目录解析，绝对路径直接用：

改完按钮（证据：lib/index.js）
跑通测试（证据：test/run.log）（证据：docs/结果.md）

安装

dsh plugin --profile web add "github:a903067276-rgb/dsh-todo-guard#main"
# 重启 dsh web 生效

工作原理（为什么重启后能显示）

  • 数据：todo 存于会话事件流（官方 todo/write，last-wins 全量），dsh 重启后仍在磁盘——官方面板只是重启后没重新渲染
  • 面板：官方 useProjection('todos') 投影 + 槽位同 id 顶替（priority: -1，最低者渲染）——纯官方接口
  • 校验：官方 tools/pre-execute 瀑布在写入前拦截 todo_write；证据不过则拒绝写入并给出可读原因

说明

  • 纯本地逻辑：零模型调用，零 token 成本
  • "伪造文件"是校验边界：证据文件存在 ≠ 真做了，但黄标体系让未验证项肉眼可查
  • 严格模式（无证据也拦截）预留 v2

License

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类