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：可自由使用、修改与再分发；保留版权与许可声明即可。
