前言¶

在 DSH 里让智能体代你操作电脑时，鼠标、键盘和会改状态的命令往往在后台连续执行。你很难单从对话区判断「现在做到哪一步、是否还在跑」。DeepSeek 的 API 定价还分峰时与谷时，峰时 token 单价约为谷时的两倍；若模型在峰时发起一次预估 token 很大的读写或分析，成本会明显抬高，而默认流程未必会先停下来问你。

下面介绍社区插件 dsh-control-bar（维护者 JianGuo396，分类：客户端）。它在屏幕顶部常驻一条置顶状态栏，跟随宿主每一轮 agent turn 显示「正在操控」类文案与单调递增的进度；同时标出当前属于 DeepSeek 峰时还是谷时，并在系统提示里写入守门规则：峰时超过阈值的大额 token 操作需你确认后再继续，谷时则直接执行。

这是什么¶

dsh-control-bar 是 DeepSeek Harness 的 Cordis 插件包（当前版本 0.1.1，许可证 MIT）。宿主侧通过 bundle patch 接入；状态栏由独立的 Electron 覆盖层进程绘制，不依赖浏览器半侧页面。

它解决两类问题：一是可见性——模型在驱动桌面时，顶部进度条同步展示当前动作标签与百分比；二是成本意识——按北京时间峰谷窗口与 2026 年法定节假日表（内置、无需联网）判断时段，配合可配置的 token 阈值，在峰时对「大额」操作要求模型先向你确认。

核心功能¶

置顶操控状态栏¶

安装并满足 Electron 可用条件后，覆盖层会在 agent 回合中自动出现与消失，无需模型额外记忆调用方式（与 Codex 状态行类似，跟随 turn）：

被中断、失败或遗忘的回合不应再留下悬挂的状态栏。模型仍可通过 control_bar 的 start / update / finish / hide 上报精确百分比。

覆盖层渲染进程为沙箱、不可聚焦、点击穿透，不挡住你正在操作的窗口。插件不发起网络请求、无遥测；覆盖层仅读取本地 state.json（一个数字与一段字符串）。

DeepSeek 峰谷标识与守门¶

状态栏会显示当前处于 peak 或 off-peak。默认定价窗口（北京时间，法定节假日除外）：

2026 年中国法定节假日表已打包在插件内，校验无需联网。若账户 schedule 不同，可在配置中覆盖 pricing.windows / pricing.holidays。

写入系统提示的守门规则概要：峰时，预估 token 超过阈值（默认约 200000）的大操作须输出 text:"峰时大额操作，等你确认"，并提供三种选择（立即执行 / 等到谷时 / 缩小范围），你选定后再继续；谷时直接执行；小额读取不受限。

安装与启用¶

在 DSH Desktop 中：Plugins → Plugin Market，搜索 dsh-control-bar，安装后重启。

或使用 CLI（desktop 替换为你的 profile 名称）：

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

在 npm 发布前也可直接从仓库安装（无构建步骤）：

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

状态栏为独立 Electron 进程，需要本机存在 Electron 可执行文件。查找顺序：overlay.electronPath → 环境变量 DSH_CONTROL_BAR_ELECTRON → DSH_ELECTRON_PATH → $DSH_HOME/electron → ~/.dsh/electron（安装 dsh-pet 时会在后者路径提供）。若均未找到，覆盖层不启动，其余插件逻辑仍工作，宿主日志会出现 overlay not running (electron-not-found)。

package.json 中声明与 DSH 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.3 兼容；运行环境要求 Node >= 22.12.0。

典型用法¶

安装后一般无需额外操作，状态栏随 turn 自动联动。

脚本或手动控制时，可使用包内 CLI：

dsh-control-bar 35 "opening the browser to search"
dsh-control-bar hide
dsh-control-bar peek
dsh-control-bar overlay start|stop|status

peek 用于查看当前阶段与下一次切换信息；overlay 子命令可启停或查询覆盖层进程。

配置示例（字段以仓库 README 为准）：

- id: dsh-control-bar
  name: dsh-control-bar
  config:
    overlay:
      enabled: true
      height: 34
      electronPath: ''
      staleMs: 300000
    pricing:
      timezone: Asia/Shanghai
      windows: '09:00-12:00,14:00-18:00'
      holidays: cn-2026
    gate:
      enabled: true
      tokenThreshold: 200000
    dataDir: ''

适用场景与注意¶

适合经常在 DSH 里让 agent 驱动本机（命令、文件、浏览器等）的开发者：需要一眼看到「是否仍在操控」以及当前动作，并希望在 DeepSeek 峰时对高 token 操作多一道确认。

请注意：插件与当前 dsh 进程权限一致，安装前请自行查看 GitHub 源码 与 MIT 许可证。社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本包仅为社区贡献的客户端类插件。

无 Electron 时仅缺少顶部条，峰谷守门与 Cordis 侧逻辑仍可依赖配置与系统提示生效；若你依赖视觉反馈，请先准备好 Electron 路径或 dsh-pet。

结尾¶

dsh-control-bar 把 agent 操控桌面时的进度拉到屏幕顶端，并把 DeepSeek 峰谷时段与大额 token 确认策略写进同一套体验：看得见进度，峰时大额操作先问你一句。

• 目录页：https://www.skillhub.cn/plugins/JianGuo396/dsh-control-bar
• 仓库：https://github.com/JianGuo396/dsh-control-bar