@kermanx/dsh-progress-check
为正在运行的 DSH 会话提供定期的上下文进度报告
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kermanx/dsh-progress-check#688bf928ce25a6e73ac873546c3ba7c77a54465cProgress Check 以 @kermanx/dsh-progress-check 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为正在工作的 DeepSeek Harness（DSH）会话定期生成一张进展卡片：把「当前进度 / 尚未确认 / 需要你确认」整理成几句话放进对话，让你不必翻完整轨迹就能知道任务走到了哪一步、有没有需要你拍板的事。
这不是 DSH 官方插件。
本项目是第三方独立开发的社区插件，与 DeepSeek Harness 官方团队无关，不随官方发行版交付，也不属于官方仓库。
- 官方不提供支持，也不承诺兼容；问题反馈与修复由本项目维护者负责。
- 它使用 DSH 的插件接口，DSH 升级后可能需要同步更新；版本不一致时 DSH 会直接拒绝安装（见「环境要求」）。
- 遇到问题请提到本仓库，不要提给 DSH 官方。
只显示「当前进度」一组的进展卡片，以及运行中「用时…」文字后面的「生成进展」入口
图中这张卡片只有「当前进度」一组：当时「尚未确认」和「需要你确认」都没有内容，这两组就不会出现。右上角图标可折叠或展开本会话的全部卡片；运行中的「深度求索中，用时…」后面有「生成进展」，可随时手工生成一张。
当前进度 概括任务现状，尚未确认 列出确实拿不准的问题或技术决策，排除模型能自行查明或验证的客观事实，需要你确认 列出你可以并行推进的事项；没有内容的那一组不会出现在卡片里（两组都为空时卡片只显示「当前进度」）。DSH 版本：0.2.1-alpha.2。版本不一致时 dsh plugin add 会直接拒绝安装（不会安装任何内容，命令以非零状态退出）。确需在别的版本上试用，可按命令输出的提示逐版本豁免，风险自负：
dsh plugin --profile web allow-version @kermanx/dsh-progress-check@<插件版本> --dsh-version <DSH 版本> --accept-risk
界面：Web 客户端（dsh web 等加载 Web 界面的 profile）。纯终端、无界面运行不会显示卡片。
pnpm：安装插件需要 pnpm（dsh plugin 会把包管理转发给 pnpm）。本仓库固定 pnpm@10.16.1，本机版本不同会让命令直接报错退出。
从源码构建：需要一份 DSH 源码 checkout，默认与本仓库同级（../deepseek-harness）；如果放在别处，需要相应调整本仓库的本地依赖指向。
语言：卡片标签跟随 DSH 界面语言；生成报告使用英文提示词，并在每次请求时读取 DSH 保存的语言选择，动态指定报告语言。切换语言后新生成的报告使用新选择；未保存明确选择时沿用对话中用户的语言。
每个版本都会把构建好的包附在 GitHub Release 里；安装时不需要 npm，也不需要在本机构建或授权构建脚本：
dsh plugin --profile web add https://github.com/kermanx/dsh-progress-check/releases/latest/download/dsh-progress-check.tgz
安装完成后启动（或重启）该 profile，例如 dsh web。可以用下面的命令确认插件所在的配置层已经生效：
dsh --profile web --dump-config
插件安装并保存在该 profile 中，只对使用这个 profile 的 DSH 进程生效；其他 profile 需要分别安装。
改代码或本地调试时，克隆仓库后构建，再把目录本身装进 profile：
git clone https://github.com/kermanx/dsh-progress-check
cd dsh-progress-check
pnpm install
pnpm run build
dsh plugin --profile web add "$PWD"
这条路径需要一份 DSH 源码 checkout（默认同级 ../deepseek-harness）；只用上面的 Release 安装则不需要。
会话运行期间，同时满足下面两个条件时自动生成一张卡片：
intervalMs 的工作时间（会话闲置时暂停计时，继续工作时接着计）；toolCallThreshold。任一条件不满足都会顺延到下一个间隔，不会打断或延迟主任务。会话停止工作时不再生成；生成失败不弹提示，下个间隔自行重试。
运行中的会话在「深度求索中，用时…」旁边显示「生成进展」：
默认值随插件提供，无需任何配置即可使用。要调整时，在所用 profile 的 patch 层里按插件 id progress-check 覆盖，例如 Web 默认 profile：
# ~/.dsh/profiles/web/cordis.patch.yml
- id: progress-check
config:
intervalMs: 30000 # 例：改为 30 秒
toolCallThreshold: 5
maxConcurrent: 2
timeoutMs: 120000
maxResponseBytes: 262144
maxParseRetries: 3
includeSubagents: true
DSH 的 patch 按 id 整段替换该行的
config，不会逐键合并。请把你需要保留的键一起写出来；没有写出的键回到插件内置默认值（即下表中的默认值）。
| 字段 | 默认值 | 说明 |
|---|---|---|
intervalMs | 60000 | 两次自动生成之间累计的工作时间（毫秒）。会话闲置时暂停计时，重新开始工作后接着计；手工生成完成后也重新开始计时。最小 1。 |
toolCallThreshold | 5 | 新增工具调用数严格超过此值才自动生成；默认表示至少 6 次。设为 0 表示只要新增调用就满足。 |
maxConcurrent | 2 | 同一个 DSH 进程内同时进行的生成数上限；同一会话同时最多进行一次生成。最小 1。 |
timeoutMs | 120000 | 一次生成从进入队列到结束（含排队等待与重试）的超时（毫秒），超时按失败处理。最小 1。 |
maxResponseBytes | 262144 | 每次生成尝试接受的响应大小上限（字节，默认 256 KiB），超出按失败处理。最小 1。 |
maxParseRetries | 3 | 生成结果格式不合格时的重试次数，允许 0–3；加上首次请求最多共 4 次尝试。 |
includeSubagents | true | 是否也为子智能体自己的会话生成卡片；每个会话独立计时和计数。 |
数值键都必须写整数（步长 1），例如 intervalMs: 1500.5 会被拒绝。改完保存后，重新加载 profile 生效：重启 dsh web 即可；如果该 profile 开启了配置热重载（patchReload: live），插件会直接重载。
dsh plugin --profile web remove @kermanx/dsh-progress-check
重启 profile 后不再生成新卡片，已有卡片也不再显示。卸载不会删除已经写入会话的进展数据，重新安装后会再次出现。
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run smoke:web 会在隔离环境中启动一次真实 Web 界面自检，用于检查卡片生成与交互；加 --manual 可验证手工生成入口。
MIT，见 package.json 的 license 字段。