前言¶
在 DSH 里调用 DeepSeek API 时，账户余额、峰谷计价时段、当前会话大概花费了多少费用，通常会分散在接口、控制台和计价规则里。dsh-balance-monitor 是 Rainronin 维护的一个 DSH 插件，目标是把这些信息放进 dsh 会话和侧边栏。
它是社区目录里的 DSH 插件，不是 DeepSeek 或幻方的官方应用商店产品。DSH 的理念是「一切皆插件」，这个插件也按社区插件的方式安装和组合到 profile 中。
插件定位¶
dsh-balance-monitor 是一个 DeepSeek API 余额实时监测插件，许可证为 MIT。
它提供以下能力：
- 官方
/user/balance接口余额快照 ds_balance会话内查询工具- 北京时间峰谷计价状态
- 单会话费用估算
- dsh 原生风格侧边栏徽章
核心能力¶
余额快照与会话内查询¶
插件使用官方 /user/balance 接口获取余额快照，并提供 ds_balance 工具，让 agent 在会话内查询余额。
ds_balance 支持穿透缓存：
force: true
侧边栏徽章¶
插件提供 dsh 原生风格的侧边栏徽章：
- 徽章位于侧栏底部 Settings 旁
- 支持刷新按钮，点击后强制穿透缓存
- 默认 30s 自动轮询
- 折叠态显示状态灯
- 支持多币种显示，CNY/USD 全列且 CNY 优先
状态灯含义：
- 绿色：连接正常
- 黄色：降级
峰谷计价状态¶
插件会显示北京时间峰谷计价状态：
- 高峰：显示
高峰 HH:MM:SS，并可倒计时到空闲阶段 - 空闲：显示
空闲
官方峰谷计价自 2026-08-17 00:00 北京时间生效，此前为预览。
单会话费用估算¶
插件会基于 DeepSeek V4 峰谷计价进行单会话费用估算。
密钥与请求策略¶
插件复用 DEEPSEEK_API_KEY，不需要单独配置密钥。相关资料宣称其不落盘、不打印、不缓存。
请求策略包括：
- 30s TTL 缓存
- 请求串行
- 5s 超时
插件还支持可选的每轮注入：把余额注入到模型上下文中。该能力默认关闭，开启后只读缓存，且宣称不阻塞对话。
安装与启用¶
在 web profile 中安装：
dsh plugin --profile web add @rainronin/dsh-balance-monitor
安装后，插件会自动加入 dsh.profile.bundles。可以查看组合配置：
dsh --profile web --dump-config
从 GitHub 安装时，如果 pnpm 阻止 prepare 构建脚本，需要按提示在 $DSH_HOME/profiles/<profile>/pnpm-workspace.yaml 中添加 allowBuilds 并重试。
典型用法¶
在会话里查询余额¶
可以直接对 agent 提问：
查一下 DeepSeek 余额
或者：
check my DeepSeek balance
查看侧边栏徽章¶
侧边栏徽章会显示余额和状态。
- 点击刷新按钮，可以强制穿透缓存
- 折叠态显示单个状态灯：绿色表示连接正常，黄色表示降级
- 高峰状态显示
高峰 HH:MM:SS，并倒计时到空闲阶段 - 空闲状态显示
空闲
覆盖配置¶
可以在 profile 的 cordis.patch.yml 中覆盖配置，例如 cacheTtlMs 和 pollIntervalMs：
- id: balance-monitor
config:
cacheTtlMs: 10000
pollIntervalMs: 10000
上面示例把缓存 TTL 和轮询间隔都设为 10000 ms。
异常状态¶
未配置密钥时：
- 工具返回中文提示
- 徽章显示未配置密钥
API 失败且有旧缓存时：
- 返回上次快照
- 标记为过期
API 失败且无缓存时：
- 展示真实失败原因
- 徽章显示无信号
适用场景与注意¶
这个插件适合在 DSH 中调用 DeepSeek API，并希望查看余额、峰谷计价状态和单会话费用估算的人。
使用前注意：
- 插件以当前 dsh 进程权限运行
- 安装前应检查源码与许可证；当前资料显示许可证为 MIT
- 未配置
DEEPSEEK_API_KEY时，无法获得真实余额 - 每轮注入默认关闭，默认主要通过徽章和
ds_balance工具查询 - DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系
相关链接¶
- GitHub：https://github.com/Rainronin/dsh-balance-monitor
- 目录页：https://www.skillhub.cn/plugins/Rainronin/dsh-balance-monitor，来自插件线索。
