dsh-progress-reporter

Readme

# DSH Progress Reporter

[English](README.en.md)

让 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`：

```yaml
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` 或更高兼容版本。

## 隐私与安全

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

## 开发

```bash
npm install
npm test
```

## 许可证

MIT