前言¶

用 DSH 开发或日常跑智能体时，一个常见的诉求是随时知道账户还剩多少、当前这一档单价是多少、今天花了多少。常见做法是切到「设置 → 账号与余额」或者另开一个计费工具，每次都要离开当前上下文。dsh-simple-balance 把这件事压缩到侧栏一行，不用切页面，余光就能看到。

下面介绍它的定位、安装方式，以及它实际读取的数据口径。

这是什么¶

dsh-simple-balance（中文名「简便余额」）由 ZKY172 维护，分类属于客户端。它解决的问题很窄：在 DSH 侧栏面板列表里增加一行，显示账户余额、当前时段的输入单价和今日已用金额；点开这一行再看明细。

这一行的摆放位置是「新建会话」下方、「工作区」上方，与「插件」「插件市场」同一列。

核心功能¶

侧栏那一行是两行小字，格式如下：

余额 ¥23.02 · 今日用量 ¥0.03
谷价 ¥1.00/M —峰价 09:00

• 第一行：账户余额、今日已用金额。
• 第二行：当前时段的输入单价（谷价绿色 / 峰价红色），以及下次峰谷切换的时刻。

点开这一行进入明细页，能看到账户余额、今日用量、当前时段与单价，以及缓存命中 / 未命中 / 输出三项的价目表，页内还有一个手动刷新按钮。

刷新策略是每 30 秒一次；窗口重新获得焦点时也会立刻刷新一次。

安装与启用¶

用 dsh 的插件命令安装，指定 web profile：

dsh plugin --profile web add dsh-simple-balance

如果需要从指定仓库安装，用 GitHub 源形式：

dsh plugin --profile web add github:<owner>/dsh-simple-balance

这里的 <owner> 替换为实际仓库所有者，对应本插件为 ZKY172。

数据来源与价格口径¶

插件有三处来源，分别对应余额、用量和单价。

余额优先读 dsh 的 deepseekAccount 服务，与「设置 → 账号与余额」同源。这个服务是可选的：宿主没有时插件会自动回退到底层的账本文件，不会因此加载失败。

今日已用读 ~/.dsh/.dshw-usage.json。该文件由另一插件 dsh-cost-meter 维护，实时落盘。

单价采用官方人民币价目。谷时每百万 token：缓存命中 ¥0.02、未命中 ¥1.00、输出 ¥4.00；峰时翻倍。

峰谷规则按北京时间：周一至周五 09:00–12:00、14:00–18:00 为峰时，其余时间（含周末与法定节假日）为谷时。2026 年的法定节假日已经内置，之后每年国务院公布次年安排后需要更新一次。

权限与隐私¶

插件声明的能力如下：

• 读文件：~/.dsh/.dshw-usage.json
• 调用宿主服务：deepseekAccount（可选）
• 注册一条只读 HTTP 路由：GET /plugins/dsh-simple-balance/summary
• 无 shell、无网络出站、无凭据访问

也就是说，它只读本机账本文件和宿主提供的余额接口，不发网络请求，不上报数据，不读取凭据。宿主的余额接口由 dsh 自己鉴权，插件只是调用它。

卸载¶

dsh plugin --profile web remove dsh-simple-balance

适用场景与注意¶

适合这类情况：主要使用 DSH Web 客户端、希望随时看到余额和时段单价，但又不想切到账号页面或外部计费工具。它只做展示和汇总，不负责扣费，也不控制模型调用。

需要注意三点。一是插件以当前 dsh 进程权限运行，安装前应先查看源码和许可证（本插件为 MIT）。二是余额和用量分别依赖宿主的 deepseekAccount 服务与 dsh-cost-meter 的账本，这两个来源都不存在时，明细页相应位置可能拿不到数据。三是单价里的节假日表只内置了 2026 年，之后需要手动更新。

结语¶

dsh-simple-balance 的价值在于把余额、时段价和今日用量压进侧栏一行，代价是一个很小的客户端插件，不增加网络出站。源码与安装说明见 GitHub，社区目录页也有收录。

• GitHub：https://github.com/ZKY172/dsh-simple-balance
• 社区目录：https://www.skillhub.cn/plugins/ZKY172/dsh-simple-balance