DeepSeek Harness 在多轮对话中，进度往往依赖于 Agent 的主观描述，缺乏客观依据。dsh-rich-tracking 插件引入了一个停靠在对话底部的看板，将进度转化为基于工件事实的百分比，并提供了一套完整的检查点与指令注入机制。
插件定位¶
这是一个由 svgop 维护的客户端插件。它提供百分比进度记分板、基于证据的行记录、宿主抓取的 Git 检查点，以及 pursue/align/dismiss 等操作指令。
核心能力¶
- 百分比记分板：展示每行的实时进度，不依赖主观描述。
- 证据绑定：百分比必须基于工件事实，严禁“幻觉”。百分比 >= 1 的行必须携带
evidence（证据）。100% 进度要求所有项目已勾选且拥有收据。 - Git 检查点：通过
tracking_checkpoint工具，宿主可自动捕获当前分支、HEAD 和脏状态，并冻结看板。 - 操作指令注入：Pursue/Align/Dismiss 等操作会直接转化为 Agent 的下一步指令，接管执行流程。
- 行记录对话框：点击
?可查看完整详情、证据来源和 Markdown 格式的记录。 - 调研与自动执行：Scout 支持为每行任务启动子代理进行竞品研究；Play 模式可自动执行高价值待办。
- 强制同步：
/track命令可强制向 Agent 注入当前账本状态。
安装与启用¶
dsh plugin --profile web add dsh-rich-tracking
安装后必须重启 dsh web 进程，tracking_write 和 tracking_checkpoint 工具才会对所有预设生效，看板也会渲染在对话 dock 中（顺序 5，位于 todo pill 下方）。
典型用法¶
- 查看进度：重启后，看板会显示在 todo pill 下方。行数限制在 1-12（建议 3-7）。
- 查看详情：点击行左侧的
?按钮，打开包含状态、证据、详情和来源的记录对话框。 - 竞品调研：点击
Scout按钮，系统会为每行任务启动子代理，研究 3-6 个竞品或实现方案，并将结果写回detail和sources。 - 强制同步：在对话中输入
/track（或/track <message>），向 Agent 注入完整的账本和修正指令。 - 自动执行：开启
Play模式，系统会在每轮结束时自动优先处理价值最高的待办行。 - 手动写入：在任务/步骤完成后，调用
tracking_write更新状态。
注意事项¶
- 系统要求：DeepSeek Harness 版本需 >=0.1.2-alpha.1。
- 证据规则：看板不会在
turn/start时重置，直到所有行达到 100% 或被手动清除。 - Scout 依赖：Scout 功能需要持久化的研究摘要文件，位于
.docs/digest/或.docs/research/。 - 注册机制：宿主必须在
ctx.sessionEventTypes中注册tracking/write、tracking/checkpoint和tracking/decision。
dsh-rich-tracking 通过强制基于工件事实计算百分比，解决了进度不透明和缺乏可验证性的问题。配合 Git 检查点和操作指令，它让多轮任务管理变得可追踪、可审计。
