DeepSeek Harness 插件：dsh-progress-reporter（长任务进度汇报）

前言¶

DeepSeek Harness 的核心设计理念是「一切皆插件」。在实际开发长链路任务时，模型可能陷入长时间的静默计算或工具调用，仅依赖工具调用日志往往无法直观反映当前进度。本插件引入 Codex 式的进度汇报机制，不再机械统计工具调用次数，而是按时间和有意义的工作状态与用户沟通。

是什么¶

dsh-progress-reporter 是一个本地运行的 DSH 客户端插件，由 baiyuscc13724-max 维护。它通过注入沟通规则和静默检测，在任务的关键节点（步骤边界）触发进度汇报，帮助用户掌握长任务的当前状态。

核心功能¶

规则注入与主动汇报
会话开始时，插件会将 Codex 风格的沟通规则注入模型上下文。当完成有意义阶段、遇到阻塞或需要用户决策时，模型会主动汇报。
时间触发机制
超过约 60 秒没有可见文字时，插件会在下一个官方步骤边界插入检查点，要求模型说明状态。
精准控制
不按固定工具调用次数触发，也不逐条播报常规操作。汇报后继续工作，不破坏官方 Goal 机制。
避免干扰
默认仅作用于主代理，防止多个子代理同时刷屏。
隐私安全
完全本地运行，不联网、不保存会话、不需要 API Key。

安装与启用¶

本插件默认未集成，需在 Harness Desktop 中手动安装。

# 在 Harness Desktop 中操作
# 1. 打开 设置
# 2. 进入 DSH 插件市场
# 3. 搜索 dsh-progress-reporter
# 4. 点击安装并重启 Harness

配置¶

默认配置位于 cordis.patch.yml：

config:
  enabled: true
  intervalSeconds: 60
  includeSubagents: false

配置项	说明
`intervalSeconds`	最长无可见文字时间，范围 15–3600 秒
`includeSubagents`	是否也要求子代理汇报

修改配置后需要重启 DSH Web。

典型用法¶

使用时无需额外命令。插件监听官方 agent/session-start、agent/pre-step 与 session/event 扩展点。会话开始时，它把 Codex 式沟通规则作为模型上下文注入；达到静默时间后，在下一步前追加一条折叠的插件 notice。检测到可见 assistant 文本后，静默计时立即重置。模型只需用当前会话语言简短说明“已完成、正在做、下一步或阻塞”。

适用场景与注意¶

版本要求：需要 DeepSeek Harness 0.1.0-rc.7 或更高兼容版本。
边界限制：进度检查只能发生在步骤边界。单次模型请求或单个工具调用本身持续很久时，插件不会强行中断它。
模型依赖：汇报内容由当前模型生成；极少数不遵循指令的模型可能延迟，插件会在下一次完整静默间隔后再次提醒。
隐私与权限：插件只读取代理生命周期事件，并注入模型可见的进度检查点。不进行网络请求、云端服务调用或保存会话。

结尾¶

对于需要长时间运行的任务，这个插件能提供比单纯工具调用日志更清晰的进度反馈。安装后记得根据实际需求调整 intervalSeconds。

插件目录：https://www.skillhub.cn/plugins/baiyuscc13724-max/dsh-progress-reporter
源码仓库：https://github.com/baiyuscc13724-max/dsh-progress-reporter