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