中文 | English
以一条可配置的状态栏替换 DSH 桌面端对话区底部的统计行：字段、顺序、模型单价与计价单位均可配置，费用按官方峰谷口径实时估算。  ## 功能 - **9 个可选字段 + 栏首上下文圆环**：上下文占用（栏首圆环）、峰谷判断、轮次＆步数、缓存命中率、输出速度、首字平均、运行用时、本轮费用、总计费用、余额 - **点击字段可查看详情**： | 字段 | 内容 | | --- | --- | | 上下文占用（栏首圆环） | 系统提示词 / 工具定义 / 对话消息 | | 峰谷判断 | 日 / 周 / 月 / 年数据统计热力图 | | 轮次＆步数 | 上下文压缩 / 技能注入 / 工具调用 | | 综合命中 | 本轮 / 最高 / 最低缓存命中率 | | 综合速度 | 本轮 / 最快 / 最慢速度 | | 首字平均 | 本轮 / 最快 / 最慢首字延迟 | | 运行用时 | 等待用时 / 模型用时 / 工具调用 | | 本轮费用 | 本轮会话的 token 明细 | | 总计费用 | 当前会话的累计 token 明细 | | 余额 | 充值余额 / 赠金余额 / 剩余配额 | - **会话数据下钻**：上下文压缩逐次标注发生节点，技能注入统计当前会话注入的技能，工具调用列出会话使用的所有工具与各自次数；点击标题返回上一层 - **版本自检与更新**：DSH 启动时自动检测最新版本，发现新版时在「状态栏」导航项旁显示提示，并在设置页提供一键更新按钮 - **费用估算**：按官方峰谷口径计价，每条调用按其发生时刻与所用模型分别计算 - **价格库**：自定义单价、峰谷分档、CNY / USD 计价单位 - **GitHub支持**：用户的支持是开发者持续开发的最大动力！点击按钮转跳GitHub项目页，帮忙点亮Star支持一下，感谢各位！ - **其他**：节假日日历一键更新、账户余额每分钟刷新、中英双语 ## 安装 在 DSH 桌面端打开 **插件 → 添加插件**，输入包名后安装： ``` dsh-desktop-statusbar ``` 网络受限时，可在同一对话框内将安装源切换为「中国大陆镜像源」。亦支持 GitHub 仓库地址： ``` https://github.com/raphael-y7/dsh-desktop-statusbar ``` 命令行方式： ```powershell dsh plugin --profile desktop add dsh-desktop-statusbar ``` ### 从 npm 安装 插件面板与命令行两种方式，安装源默认都是 npm registry，包名为 `dsh-desktop-statusbar`。想确认 npm 上的当前版本： ```powershell npm view dsh-desktop-statusbar version ``` ### 插件自带的更新失效时 插件里那个一键更新按钮，在某些桌面端版本上会失败（点了没反应、或者直接显示失败）。这时不要反复点，改用官方安装入口、**在包名后面加上 `@版本号`** 指定到具体版本，就能精确装上： ```powershell dsh plugin --profile desktop add dsh-desktop-statusbar@3.0.0 ``` 插件面板里同样可以这样填 —— 在「添加插件」的输入框里写 `dsh-desktop-statusbar@3.0.0`。 版本号填你看到的最新版本即可（发布页右侧的版本号，或上面那条 `npm view` 命令的输出）。带上版本号还有一个好处：**装上的就是你想要的那一版**，不会因为缓存拿到旧包。 本插件亦收录于 [dshmarket](https://awesome-dsh-plugin.com/p/raphael-y7/dsh-desktop-statusbar/)、[dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) 与 [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar)。 ## 使用 打开 **设置 → 状态栏**：  - **上下文占用**：栏首圆环，进度表示上下文占用比例，缺口表示上下文压缩阈值，颜色表示运行状态（空闲灰 / 运行绿 / 报错红 / 待审批黄） - **统计字段**：勾选控制显示，取消勾选仅隐藏、不改变位置；拖动右侧把手调整顺序；「恢复默认设置」恢复出厂顺序并全选 - **自定义模型价格**：输入模型名并「添加」以新增条目；「修改」展开编辑区，保存后写入；需区分峰谷时段时勾选「峰谷计价」，否则按全天同价计算 - **计价单位**：价格编辑区右上角可选 CNY 或 USD。切换时内置的两款模型改用对应币种的官方参考价（已修改的条目保留），费用段的符号随之变化；余额按接口返回的币种显示 - **节假日**：点击「更新节假峰谷」获取并写入下一年的放假安排 - **余额**：每分钟自动刷新 ### 计费口径 高峰时段为**北京时间周一至周五 9:00-12:00、14:00-18:00**，空闲价为高峰价的一半；法定节假日与周末全天按空闲价计费（与[官方文档](https://api-docs.deepseek.com/zh-cn/quick_start/pricing)一致，2026-09 核对）。  ## 已知限制 - 最快 / 最慢首字与速度来自 host 新增的投影，**升级后需完全退出并重启 DSH** 才开始统计 - 价格库中缺少单价的模型不计费，补充单价后自动补算 - 一键更新依赖 pnpm 可执行文件：桌面端用宿主随包提供的 pnpm，命令行 / 网页端需要系统里有 `pnpm`。都找不到时会明确提示「找不到 pnpm」，并把**尝试过的每个位置**一并写进日志；也可以用环境变量 `DSH_DESKTOP_STATUSBAR_PNPM` 直接指定要用的命令 ## 开发 每个测试都是独立脚本，直接用 node 跑，不需要任何测试框架。 ```powershell 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](LICENSE)：可自由使用、修改与再分发；保留版权与许可声明即可。