baiyuscc13724-max / dsh-progress-reporter

DSH Progress Reporter

English

让 DeepSeek Harness 在长任务中采用 Codex 式进度沟通：按时间和有意义的工作状态汇报，而不是按工具调用次数机械报数。

功能

• 会话开始时注入进度沟通规则：完成有意义的阶段、遇到阻塞、需要用户决定或准备开始较长工作时主动汇报。
• 超过约 60 秒没有可见文字时，在下一个官方步骤边界请求一次进度汇报。
• 不按固定工具调用次数触发，也不逐条播报常规操作。
• 要求模型用当前会话语言简短说明“已完成、正在做、下一步或阻塞”。
• 汇报后继续自动工作，不打断官方 Goal 机制。
• 默认只作用于主代理，避免多个子代理同时刷屏。
• 完全本地运行，不联网、不保存会话、不需要 API Key。

插件只在模型进入下一步前插入进度检查点，不伪造模型消息，也不修改 DeepSeek Harness 核心代码。

安装

本插件不是 Harness Desktop 默认插件，仅在用户主动选择时安装。

在 Harness Desktop 中打开：

1. 设置 → DSH 插件市场。
2. 搜索 dsh-progress-reporter。
3. 点击安装并重启 Harness。

本仓库带有 GitHub topic dsh-plugin 后，会被社区市场定时自动收录。

配置

默认配置位于 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 或更高兼容版本。

隐私与安全

• 网络请求：无
• 云端服务：无
• 凭据：无
• 持久化：无
• 权限：只读取代理生命周期事件，并注入模型可见的进度检查点

开发

npm install
npm test

许可证

MIT