OuYangxin12/dsh-status-bar

dsh-status-bar

一个用于 DeepSeek Harness Web GUI 的实时执行状态栏插件。当 agent 处理长任务时，输入框上方的一条紧凑状态栏会显示它当前正在做什么——并由 LLM 蒸馏出一行「成果」信息，告诉你它已经完成了什么，可展开为结构化的进度报告。

中文

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//node_modules/dsh-status-bar

~/.dsh/profiles//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=[&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