dsh-runstat
DeepSeek Harness 运行状态与任务复盘插件。 在输入框下方实时显示 Agent 在干什么，任务结束后把执行日志交给当前模型，复盘出值得沉淀的优化建议。
┌────────────────────────────────────────────────────────────┐
│ 帮我整理本周资料 │
└────────────────────────────────────────────────────────────┘
● 活动 ● 用量 ◐ 思考 1.2k 字 8.0s
▶ 运行测试 npm test 2/5 12s
└──────────── 本插件 ────────────┘
能做什么
- 看得见模型在干什么：接入实时分片，区分等首包、思考、输出回复、生成工具调用和流停顿，不再一律显示“等待模型”。
- 看得懂工具在干什么：每次调用按规则生成一句话描述与结果摘要，例如“运行测试 npm test → 退出码 0「131 项通过」”“读取 fold.js 第 600–800 行”。
- 时间算得清：每轮、每步都给出“总时长 = 模型 + 工具 + 审批等待”的等式。
- 建议由模型判断：本地规则只产出「线索」（体检项，绝不下结论），成型建议全部由当前模型给出。
- 实时部分不花 Token：胶囊、计时、计数与时间等式全部由本地规则生成；只有点「生成优化建议」才调用一次模型（摘要上限 40,000 字），这次调用的耗时与 Token 单列、不计入任务。
优化建议按「去向」分为四类沉淀：固化到技能 / 固化成新技能 / 配置建议 / 可复用提示词。每条带位置、依据、改法、改动草稿和 P0/P1/P2 收益标签，点「复制全部」可把全部建议复制成一份 Markdown，直接发给 Agent 去改。
安装
需要 macOS 上的 DeepSeek Harness 0.2.1-rc.2 或兼容版本，以及 Node.js 20 或更新版本。无运行时依赖、无需构建；保持目录结构完整即可。
DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$DSH" plugin --profile desktop add /path/to/dsh-runstat
卸载：
"$DSH" plugin --profile desktop remove @local/dsh-runstat
浏览器端（client.js）改动刷新页面即可生效；宿主端（index.js、lib/）改动需重启 Harness。
快速上手
- 正常发起任务，输入框下方的胶囊实时显示当前动作与计时。
- 点击胶囊打开详情面板，查看当前状态、时长等式、用量和过程日志。
- 任务做完点「生成优化建议」（或输入
/runstat done），模型给出建议，结果显示在面板的「优化建议」板块。
- 想知道发出去的是什么，先输入
/runstat digest：只报分段字数与裁剪情况，并把摘要全文写到磁盘供逐字核对（不花 Token）。
- 发送下一条消息时开始新任务，统计与上一个任务分开。
命令
| 命令 | 作用 |
|---|
/runstat 或 /runstat status | 输出当前状态 |
/runstat done | 确认当前任务完成，生成复盘与优化建议 |
/runstat done <备注> | 同上，备注写进复盘与历史 |
/runstat digest | 预览将发给模型的摘要：分段字数、裁剪情况，并把全文写到磁盘（不花 Token） |
配置项
在 profile 的插件配置中设置，全部可选。校验失败不会阻止启动，会回退到默认值并输出警告。
| 配置 | 默认值 | 说明 |
|---|
maxSteps | 200 | 过程日志保留的模型步骤数（1 至 1000），超出的最早步骤丢弃并计数 |
maxTimeline | 400 | 保留的调用记录条数（1 至 2000），供本地线索判断使用 |
history | true | 是否在本地保存跨次执行的脚本结构哈希，用于识别固定套路 |
trackSubagents | true | 是否统计子 Agent |
includeModelAssist | true | 点「生成优化建议」时把摘要发给当前模型分析。设为 false 则不发送摘要，只保留本地规则线索（无成型建议） |
adviceWindowTurns | 5 | 普通会话/一次性任务下，「盘点最近几轮」的窗口大小（1 至 10） |
reportLanguage | 'zh' | 报告框架语言，'zh' 或 'en'；建议正文只有中文 |
slowModelMs / slowToolMs | 60000 / 30000 | 口径说明里“偏慢”的阈值 |
隐私提示
- 点「生成优化建议」时会向当前模型发送一次本地组装的摘要：任务统计、本地线索、每轮用户要求的开头（80 字以内）、逐步日志的调用说明与结果摘要、待办；不含模型的思考与回复正文、文件内容或完整工具输出。
- 处理敏感任务时设
includeModelAssist: false（只留本地线索、不发摘要）；发送前可用 /runstat digest 逐字核对要发的内容。
- 本地只在
$DSH_HOME/runstat/ 保存分析结果（最近 40 条）和跨次脚本结构哈希（不存脚本正文、参数原文与路径）。
