前言¶
在 DeepSeek Harness（DSH）里跑 Subagent-Driven Development（SDD）时，任务往往通过 todo 工具维护，进度说明写在需求目录下的 sdd/progress.md。这些信息分散在会话流和文件里，切换会话或长时间跑任务后，要在聊天里翻找或自己打开文件才能对齐「做到哪一步」。
下面介绍社区插件 dsh-sdd-progress-xc（维护者 xchannel1987）：它在 DSH Web 客户端右侧边栏增加 SDD Progress 标签页，绑定当前会话，展示该会话关联的 todo 统计与列表，并用官方 Markdown 组件渲染 sdd/progress.md 台账。数据由插件服务端从会话日志解析，一般无需手填需求根目录。
这是什么¶
dsh-sdd-progress-xc 是 DSH 的 Web 客户端插件（分类：客户端）。npm 包名与插件 id 均为 dsh-sdd-progress-xc，当前资料中的版本为 0.1.9，许可证 MIT。
一句话定位：右侧边栏 tab，展示当前会话的 SDD 任务进度（todos）与进度台账（sdd/progress.md），支持定时刷新与 Markdown 渲染。
宿主要求：README 写明 DSH ≥ 0.2.0-rc.1（engines.dsh）；0.2.0 起 @deepseek-ai/dsh-client-runtime 已从宿主移除，需使用符合要求的 DSH 版本。
核心功能¶
Tasks：任务进度¶
- 统计已完成、进行中、待办数量；列表用完成 / 进行中 / 待办等状态区分。
- 约 5 秒轮询，任务状态变化会反映到界面；页头 Refresh 可手动立即刷新。
- 数据与 当前会话绑定：切换会话后自动加载对应会话的 todo。
Progress Ledger：进度台账¶
- 从会话内容中识别
sdd/progress.md的路径（支持 Unix 与 Windows 路径，不要求固定仓库根目录）。 - 使用
@deepseek-ai/dsh-client-ui-primitives的 MarkdownText 渲染台账，支持 GFM、KaTeX、代码高亮与复制等；面向不可信内容时禁用 raw HTML、相对链接与危险协议。 - 与 Tasks 共用页头刷新与 5 秒轮询。
服务端如何取数（便于排查）¶
客户端请求：
/api/dsh-sdd-progress-xc/progress?sessionId=...
服务端读取 session.v3.jsonl.zstd（多帧 zstd），解析 cwd、最新 todo/write 事件，并扫描路径引用以匹配 sdd/progress.md，返回 requirementName、todos、ledger。DSH 会话日志为多帧 zstd 拼接时，插件会逐帧解码拼接，避免只解首帧导致内容不完整。需求名从路径形如 .../<name>/sdd/progress.md 中提取。
安装与启用¶
使用 DSH CLI（命令来自官方 README）：
dsh plugin --profile web add dsh-sdd-progress-xc
或使用 npm：
npm install dsh-sdd-progress-xc
安装后 重启 DSH，右侧边栏会出现 SDD Progress tab。
配置¶
| 选项 | 默认值 | 说明 |
|---|---|---|
| requirementsRoot | ''（空） |
可选：会话里只有相对路径时，作为根目录兜底；通常无需设置 |
默认情况下，插件从会话中的完整路径引用定位台账文件，不依赖固定 requirements 根目录。
典型用法¶
- 打开 DSH Web 右侧边栏，点击 SDD Progress。
- 默认 Tasks 页查看统计与任务列表；切换到 Progress Ledger 阅读
progress.md渲染结果。 - 需要立刻对齐状态时，点击页头 ↻ Refresh；否则等待约 5 秒自动刷新即可。
- 在另一个 SDD 会话中重复上述操作；每个会话的进度互不干扰。
适用场景与注意¶
适合谁：在 DSH 里用 SDD 工作流、且会话中会引用或写入 .../sdd/progress.md 的开发者；希望在同一界面看 todo 与台账、少切文件的人。
安全与行为（README 摘要）：Markdown 走官方安全渲染；路径只从会话内容提取，不主动扫描全盘；zstd 解码遇损坏帧会跳过而非拖垮进程；会话之间隔离。
安装前请自行核对：插件以 当前 DSH 进程权限 运行，会读取会话日志并返回台账内容。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证。社区插件目录 SkillHub 条目 与 DeepSeek / 幻方无官方从属关系，DSH 生态本身是「一切皆插件」，目录站是独立社区索引。
链接¶
- 目录页：https://www.skillhub.cn/plugins/xchannel1987/dsh-sdd-progress-xc
- GitHub：https://github.com/xchannel1987/dsh-sdd-progress-xc
- npm：https://www.npmjs.com/package/dsh-sdd-progress-xc
- 问题反馈：https://github.com/xchannel1987/dsh-sdd-progress-xc/issues
经过上面的步骤，你可以在 DSH 右侧边栏把当前会话的 SDD todo 与 progress.md 放在同一处查看，减少在聊天与文件之间来回切换。
