前言¶
用 DSH 跑智能体，有两种成本是事后才看得见的：余额还剩多少，以及这一轮用量落在峰价还是谷价。前者要切到网页登录翻，后者要自己记价格窗口。bingomu 维护的客户端插件 dsh-usage-printer 把这两件事压进了侧栏底部：静止时是一块点阵数字屏，鼠标悬停才出纸显示明细。
下面介绍它的能力边界、数据来源和安装方式，最后说清它适合谁、有什么坑。
这是什么¶
一句话：dsh-usage-printer 是装在 DSH 侧栏底部的用量卡，只负责显示两件事——余额水位，和当前用量在峰谷价格窗口里的位置。
它由 bingomu 维护，分类在客户端，许可证 MIT。解决的问题很具体：开发者不想在写代码和看日志之间反复切到浏览器查余额。
核心功能¶
静止态和悬停态是它唯一的交互模型，共三层信息：
- 静止态：点阵拼出余额金额，元位大、角分位小，位数多时自动缩一档；下方是一条峰谷台阶带，淡黄表示谷价、淡红表示峰价；底纹点阵按用量亮起。
- 悬停态：纸从槽口升出来，列出余额、已充值、时段、倒计时、可用天数、今日与本月花费、单价，并带一个直达官方充值页的入口。点一下可以固定，Esc 或点外部收起。
- 主题：深浅色跟随 DSH 主题（
--dsw-alias-*），窄栏时自动收成一个点阵小方块。
数据从哪来¶
三个显示字段对应三个来源，README 里列得很清楚：
- 余额：DeepSeek
GET /user/balance，凭证用 DSH 账号登录留下的 grant 记录（deepseek-account-platform/default，请求头x-dsh-auth-token）。 - 峰谷：按官方价格表的窗口判定，北京时间工作日 09–12、14–18 为峰价。
- 单价：官方 2026-09-10 价格快照（元 / 百万 token），表里没有的模型显示
--。
插件分 Host 和 Client 两半：Host 半只注册一个本机路由 GET /api/usage-printer，30 秒缓存；Client 半 30 秒拉一次。README 明确写了「余额不出本机」——路由只接受 localhost 和绑定主机名，响应不带任何跨域头。
安装与启用¶
安装走官方命令，不要凭名称拼接。README 给了三种方式，推荐第一种：
# GitHub（推荐，和你其它插件一致）
dsh plugin add github:bingomu/dsh-usage-printer#v1.0.3
# npm（可选）
npm i -g @bingomu/dsh-usage-printer
本地目录方式走 plugin_manager → install_bundle，target 指向插件目录。
版本要求有两条：
- 适配 DSH
0.2.1-rc.5（engines.dsh已声明）。 - 必须装 v1.0.2 及以上。v1.0.0 / v1.0.1 的客户端模块 id 写错，装上后侧栏不显示卡片。
典型用法¶
这个插件没有配置文件，装完即用，实际使用就是三步：
- 用上面的命令安装，确认版本在 v1.0.2 以上。
- 启动 DSH，侧栏底部出现点阵数字屏，鼠标悬停即出小票。
- 需要充值时点小票里的入口，跳到官方充值页。
如果小票里金额和预期对不上，先核对单价快照是否过期：官方调价后需要更新 index.js 里的 PRICES。
适用场景与注意¶
适合两类人：
- 想随时看到余额和当日花销，但不想手动开网页的 DSH 开发者。
- 想在同一侧栏里同时确认「还剩多少」和「现在算不算峰价」的人。
需要注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT），不要安装来路不明的分支。
- 节假日未接法定节假日表，调休日会算错峰谷档位。
- 「已充值」不是流水，而是插件第一次读到的余额；装插件之前就有的余额会让这个数偏低，百分比偏高。
- 「可用天数 / 今日 / 本月花费」由余额采样差分推出，间隔超过 30 分钟的时段算「未观测」，该天数字会带
~前缀。 - 会话级花费尚未接会话日志，当前不会按
assistant/message事件的usage计价。
结尾¶
这个插件的价值不在功能多，而在把余额和峰谷压进侧栏，让用量保持在视线内。它只做显示，不做扣费判断，余额也不出本机。
- 目录页：https://www.skillhub.cn/plugins/bingomu/dsh-usage-printer
- GitHub：https://github.com/bingomu/dsh-usage-printer
