操控进度条 JianGuo396/dsh-control-bar

dsh-control-bar

模型开始直接操作你的电脑（点鼠标、敲键盘、跑命令）时，屏幕顶部常驻一条状态栏： 正在操控 + 一句正在做什么 + 真实百分比进度，右侧还标出此刻是 DeepSeek 峰时还是谷时。

因为峰时单价是谷时的两倍，这个包同时带一条行为约束：要烧大量 token 的操作，峰时先问你一句，谷时直接干。

安装

在 DSH Desktop 里打开 插件 → 插件市场，搜索 dsh-control-bar 安装，重启应用。
命令行等价写法（web/desktop 换成你实际用的 profile）：

dsh plugin --profile desktop add dsh-control-bar

也可以直接从仓库装（没发 npm 时的等价写法，本包没有构建步骤，装完即用）：

dsh plugin --profile desktop add github:JianGuo396/dsh-control-bar

状态栏是一个独立 Electron 进程，不占用 DSH 自己的窗口。它在启动时按这个顺序找可用的 Electron：overlay.electronPath → DSH_CONTROL_BAR_ELECTRON → DSH_ELECTRON_PATH → $DSH_HOME/electron → ~/.dsh/electron（dsh-pet 装过 Electron 的话这里就有）。都找不到时状态栏不显示，插件其余功能照常工作，并在日志里给出 overlay not running (electron-not-found)。

用法

装上之后不需要你要模型记得做什么——状态栏跟着 agent 的回合开合，和 codex 那条状态行一个逻辑：

| 宿主事件 | 状态栏 |
| turn/start | 自动亮起：「正在工作」+「正在处理你的请求」，4% |
| 每次 tool/call | 文案换成正在做的事（执行命令／读写文件／查资料／操作浏览器…），进度沿单调曲线前进 |
| turn/end / agent/error | 补到 100%「完成」，停 1.2 秒后自动收起 |

模型被中断、报错、忘了收尾，都不会留下一条挂着的进度条——这正是上一版的问题。
只用 control_bar 时它仍然可用（start/update/finish/hide），用于模型直接操控界面时补一条更准确的中文进度。

也可以手动控制，或让脚本/其它 Agent 用：

dsh-control-bar 35 "正在打开浏览器搜索" # 设置进度与文案 dsh-control-bar hide # 立刻收起 dsh-control-bar peek # 看当前峰谷与下次切换时间 dsh-control-bar overlay start|stop|status # 手动起停顶栏进程

峰谷口径

| | 时间（北京时间） | 单价 |
| 峰时 | 周一至周五 09:00–12:00、14:00–18:00（UTC 01:00–04:00、06:00–10:00），法定节假日除外 | ×2 |
| 谷时 | 其余全部时间（含周末、法定节假日整天） | ×1 |

官方定价说明里「峰时 = UTC 01:00–04:00 与 06:00–10:00，周一至周五，排除中国法定节假日；谷时单价为峰时一半」。本包把 2026 年国办放假安排内置成节假日表，判断时不依赖任何网络请求。
需要改口径就改配置里的 pricing.windows / pricing.holidays。

守门规则（写进系统提示，模型据此执行）：

- 峰时 + 预计 token 量很大（默认参考 20 万 tokens 量级）：先写一条进度 text:"峰时大额操作，等你确认"，再用 ask_user_question 给出「现在就做 / 等谷时再做 / 缩小范围」三选一，你点了才继续；
- 谷时：大额操作不为了省钱额外确认，直接做；
- 小操作（读几个文件、查一条命令、看一眼页面）任何时候都不问。

阈值与开关都在配置里；peak_valley 工具返回 tokenThreshold 与 largeTokenNeedsConfirmation，脚本也能据此判断。

配置

写进 profile 的 cordis.patch.yml（或用宿主提供的任意配置入口）：

- id: dsh-control-bar
name: dsh-control-bar
config:
overlay:
enabled: true # false = 不弹状态栏，只保留工具与峰谷判断 height: 34 # 状态栏高度（DIP），18–120 electronPath: '' # 指定 Electron 可执行文件；留空自动探测 staleMs: 300000 # 这么久没更新就当陈旧，自动收起 pricing: timezone: Asia/Shanghai windows: '09:00-12:00,14:00-18:00' holidays: cn-2026 # cn-2026 | none | 2026-10-01,2026-10-02 gate: enabled: true tokenThreshold: 200000 dataDir: '' # 默认 $DSH_HOME/control-bar

排障

- 屏幕上没有条：看日志里的 overlay not running (...)。最常见是没找到 Electron，按上面的顺序装 dsh-pet 或写 electronPath；其次是 overlay.enabled=false。
- 条卡住不动：状态文件半小时没更新会自己隐藏；dsh-control-bar hide 立刻收起。
- 多显示器：默认只挂主屏顶部。状态文件在 $DSH_HOME/control-bar/state.json， probe.json（DSH_CONTROL_BAR_PROBE=1 时生成）里有真实几何，便于排查 DPI 问题。

隐私

不联网、不上报。状态栏只读本地 state.json（一个进度数字和一句话），渲染进程无 Node 权限、无键盘焦点、鼠标事件穿透，不会挡住你正在操作的窗口。

License

MIT