dsh-status-bar
English | 中文
A live execution status bar plugin for the DeepSeek Harness web GUI. While the agent works on a long task, a compact strip above the composer shows what it is doing right now — and an LLM-distilled achievement line tells you what it has accomplished, expandable into a structured progress report.
中文
DSH Web GUI 的执行状态栏插件。agent 执行长任务时，输入框上方的状态栏实时显示它在做什么，并由 LLM 蒸馏出一行「当前成果」，可展开查看结构化详细报告。
┌───────────────────────────────────────────────┐
│ [成果] 正在修复构建错误，已定位两处语法问题 14:32 ▾ │ ← 一行速览（可展开）
│ ─────────────────────────────────────────── │
│ 已完成： │ ← 展开态：结构化详细报告
│ - 读取 3 个配置文件，定位到 JSON 语法错误 │
│ - 修复 lib/config.ts 两处语法错误 │
│ 正在进行： │
│ - 运行 pnpm build 验证修复 │
│ 下一步： │
│ - 构建通过后运行测试套件 │
│ 问题/风险： │
│ - 无 生成于 14:32 [刷新] │
└───────────────────────────────────────────────┘
│ ⏳ 03:12 · T1/S2 · bash · pnpm build │ ← 过程行
│ 💭 ……先检查 tsconfig 的引用路径再重试…… │ ← 思考尾部（悬停看全文）
空闲且无总结时渲染为空，不占布局。
刷新是事件驱动的，不是固定轮询
总结节奏自适应任务的真实进度：
| 触发 | 行为 |
|---|
| 工具调用/结果、step 边界 | 短去抖（1~2.5s）后总结，爆发期自动合并 |
| 长时间思考（只有 token 流） | 兜底上限（默认 30s）保底更新 |
| turn 开始 | ~3s 快速首报，短任务也能有一读 |
| 用户新输入 / steering | 立即强制刷新单行总结 |
| turn 结束 | 强制刷新单行 + 全新详细报告 |
| 详情页展开中 | 新进展出现后自动跟随刷新（8s 去抖） |
安装
方式一：plugin CLI（推荐）
dsh plugin --profile web add github:OuYangxin12/dsh-status-bar
重启 dsh web 即生效。
方式二：任意 profile 手动挂载
把仓库软链进 profile 的 node_modules，再 insert：
ln -sfn /path/to/dsh-status-bar ~/.dsh/profiles/<profile>/node_modules/dsh-status-bar
# ~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
- id: dsh-status-bar
name: 'dsh-status-bar'
注意：insert 必须用包名（client bundle 扫描按 require.resolve(<名字>/package.json) 解析包根），绝对路径文件名只能挂载 host 半。
配置（环境变量，均可选）
| 变量 | 默认 | 说明 |
|---|
DSH_STATUS_BAR_PROVIDER / DSH_STATUS_BAR_MODEL | 第一个已注册 provider 中优先 "flash/mini/lite" 等便宜模型 | 总结用的模型路由 |
DSH_STATUS_BAR_MIN_GAP_MS | 10000 | 两次自动总结的最小间隔（强制触发不受限） |
DSH_STATUS_BAR_MAX_AGE_MS | 30000 | 连续思考流下的兜底刷新上限 |
DSH_STATUS_BAR_MAX_TOKENS | 160 | 单行总结的输出上限 |
DSH_STATUS_BAR_DETAIL_MAX_TOKENS | 700 | 详细报告的输出上限 |
HTTP 面（调试用）
GET /status-bar/stream — SSE，NDJSON 帧（summary/detail/活动状态）GET /status-bar/state — 当前全部会话总结快照GET /status-bar/detail?session=<id>[&force=1] — 请求生成/刷新详细报告（结果经 SSE 推送）
工作原理
- 数据源（client）：插件注册进
conversation.input.dock 插槽（与内置 GoalBar 同机制），
直接读取框架传入的 ConversationSnapshot 点时快照——partial.blocks（含 reasoning
思考块）、runningCalls、running 都是现成可观察数据，浏览器半零 RPC
- 数据源（host）：
ctx.on('session/event') 把工具调用/结果、思考/文本尾部、turn/step
边界聚合为滚动活动日志（上限 40 条）
- 总结：事件驱动调度（去抖 + 最小间隔 + 兜底上限 + 强制触发），
ctx.llm.stream()
一次性调用（手写 message 字面量，无 @deepseek-ai 运行时依赖），结果经 SSE 广播
- 双面插件：
lib/index.js 为 host 半（纯 ESM JS，无构建）；lib/client.js 为浏览器半
（esbuild 打包成 window.__ModuleLoader__ 工厂闭包格式，构建产物已提交，安装免构建）
开发
node build.mjs # 重建浏览器 bundle（esbuild 自动从 DSH checkout 解析）
node smoke-test.mjs # host 半冒烟测试（mock ctx + fake LLM，六项断言）
改浏览器半后 node build.mjs + 刷新页面即可；改 host 半需重启 DSH 进程。
License
MIT
