dsh-desktop-statusbar

dsh-desktop-statusbar

中文 | English

以一条可配置的状态栏替换 DSH 桌面端对话区底部的统计行：字段、顺序、模型单价与计价单位均可配置，费用按官方峰谷口径实时估算。

功能

• 9 个可选字段 + 栏首上下文圆环：上下文占用（栏首圆环）、峰谷判断、轮次＆步数、缓存命中率、输出速度、首字平均、运行用时、本轮费用、总计费用、余额

• 点击字段可查看详情：

  字段	内容
  上下文占用（栏首圆环）	系统提示词 / 工具定义 / 对话消息
  峰谷判断	日 / 周 / 月 / 年数据统计热力图
  轮次＆步数	上下文压缩 / 技能注入 / 工具调用
  综合命中	本轮 / 最高 / 最低缓存命中率
  综合速度	本轮 / 最快 / 最慢速度
  首字平均	本轮 / 最快 / 最慢首字延迟
  运行用时	等待用时 / 模型用时 / 工具调用
  本轮费用	本轮会话的 token 明细
  总计费用	当前会话的累计 token 明细
  余额	充值余额 / 赠金余额 / 剩余配额

• 会话数据下钻：上下文压缩逐次标注发生节点，技能注入统计当前会话注入的技能，工具调用列出会话使用的所有工具与各自次数；点击标题返回上一层

• 版本自检与更新：DSH 启动时自动检测最新版本，发现新版时在「状态栏」导航项旁显示提示，并在设置页提供一键更新按钮

• 费用估算：按官方峰谷口径计价，每条调用按其发生时刻与所用模型分别计算

• 价格库：自定义单价、峰谷分档、CNY / USD 计价单位

• GitHub支持：用户的支持是开发者持续开发的最大动力！点击按钮转跳GitHub项目页，帮忙点亮Star支持一下，感谢各位！

• 其他：节假日日历一键更新、账户余额每分钟刷新、中英双语

安装

在 DSH 桌面端打开 插件 → 添加插件，输入包名后安装：

dsh-desktop-statusbar

网络受限时，可在同一对话框内将安装源切换为「中国大陆镜像源」。亦支持 GitHub 仓库地址：

https://github.com/raphael-y7/dsh-desktop-statusbar

命令行方式：

dsh plugin --profile desktop add dsh-desktop-statusbar

从 npm 安装

插件面板与命令行两种方式，安装源默认都是 npm registry，包名为 dsh-desktop-statusbar。想确认 npm 上的当前版本：

npm view dsh-desktop-statusbar version

插件自带的更新失效时

插件里那个一键更新按钮，在某些桌面端版本上会失败（点了没反应、或者直接显示失败）。这时不要反复点，改用官方安装入口、在包名后面加上 @版本号 指定到具体版本，就能精确装上：

dsh plugin --profile desktop add dsh-desktop-statusbar@3.0.0

插件面板里同样可以这样填 —— 在「添加插件」的输入框里写 dsh-desktop-statusbar@3.0.0。

版本号填你看到的最新版本即可（发布页右侧的版本号，或上面那条 npm view 命令的输出）。带上版本号还有一个好处：装上的就是你想要的那一版，不会因为缓存拿到旧包。

本插件亦收录于 dshmarket、dshfind 与 1024Store。

使用

打开 设置 → 状态栏：

• 上下文占用：栏首圆环，进度表示上下文占用比例，缺口表示上下文压缩阈值，颜色表示运行状态（空闲灰 / 运行绿 / 报错红 / 待审批黄）
• 统计字段：勾选控制显示，取消勾选仅隐藏、不改变位置；拖动右侧把手调整顺序；「恢复默认设置」恢复出厂顺序并全选
• 自定义模型价格：输入模型名并「添加」以新增条目；「修改」展开编辑区，保存后写入；需区分峰谷时段时勾选「峰谷计价」，否则按全天同价计算
• 计价单位：价格编辑区右上角可选 CNY 或 USD。切换时内置的两款模型改用对应币种的官方参考价（已修改的条目保留），费用段的符号随之变化；余额按接口返回的币种显示
• 节假日：点击「更新节假峰谷」获取并写入下一年的放假安排
• 余额：每分钟自动刷新

计费口径

高峰时段为北京时间周一至周五 9:00-12:00、14:00-18:00，空闲价为高峰价的一半；法定节假日与周末全天按空闲价计费（与官方文档一致，2026-09 核对）。

已知限制

• 最快 / 最慢首字与速度来自 host 新增的投影，升级后需完全退出并重启 DSH 才开始统计
• 价格库中缺少单价的模型不计费，补充单价后自动补算
• 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端需要系统里有 pnpm。都找不到时会明确提示「找不到 pnpm」，并把尝试过的每个位置一并写进日志；也可以用环境变量 DSH_DESKTOP_STATUSBAR_PNPM 直接指定要用的命令

开发

每个测试都是独立脚本，直接用 node 跑，不需要任何测试框架。

npm test          # runs every verify*.js under tests/, then checks project vs installed plugin dir
npm run sync      # copies lib/ into the installed plugin dir

tools/ 下的开发脚本随包一起发布（files 里有它），克隆仓库或装 npm 包都能拿到：

脚本	作用
tools/test.cjs	全量测试 + 一致性守卫
tools/sync-to-plugin.cjs	项目 lib/ → 已安装插件目录
tools/sync-from-plugin.cjs	已安装插件目录 → 项目 lib/
tools/plugin-dir.cjs	自动定位插件目录
tools/shot.cjs	生成 README 截图

它们只在开发时用，插件运行时不会加载。npm test 需要仓库里的 tests/ 目录， 所以从 npm 装的包只能跑 sync-* / shot 这几个。

插件目录的位置自动探测，顺序是：环境变量 DSH_STATUS_BAR_PLUGIN_DIR → ~/.dsh 下的已知安装布局 （local-plugins/、各 profiles/*/node_modules/）→ 由 tools/ 位置推导。换机器、换用户名都不用改代码。

许可

MIT：可自由使用、修改与再分发；保留版权与许可声明即可。