前言¶
在 DSH 的插件化场景里，余额和用量展示是一个比较具体的问题：官方接口可以查余额，Harness 会话日志里可以看到调用，但侧边栏缺少一个能同时看当前余额、刷新状态和用量趋势的入口。dsh-quota-badge 是一个 DSH 插件，用于在 DeepSeek Harness 侧边栏实时显示 DeepSeek 账户余额，并在设置页提供余额监控和用量统计。下面介绍它的能力、安装方式和日常使用注意点。
这是什么¶
dsh-quota-badge 是一个 DSH 插件，GitHub 仓库为 yoiizesdev-crypto/DSH-Balance-display，许可证为 MIT。
它从 DeepSeek 官方余额 API 获取数据：
GET https://api.deepseek.com/user/balance
在 DeepSeek Harness 侧边栏显示余额徽章，并在 设置 → 余额监控 页面展示币种明细、余额趋势和用量统计。
核心功能¶
侧边栏余额徽章¶
在 DeepSeek Harness 侧边栏底部实时显示 DeepSeek 账户余额，支持账户内全部币种：
CNY / USD / 其他
刷新方式包括自动刷新和手动刷新。余额变化时，数字会播放滚轮动画；手动刷新时，上升显示绿色，下降显示红色。
设置页：余额监控¶
在 设置 → 余额监控 页面可以看到：
- 余额卡片
- 币种明细
- 余额趋势 Sparkline
页面上还可以调整余额显示和刷新相关参数。参数、历史与用量数据保存在：
~/.dsh/.quota-badge.json
用量统计¶
用量统计提供以下能力：
- 历史回填
- 分 Key 统计
- 汇总卡片
- 每日消费折线
- 模型明细表
用量统计基于 Harness 会话日志和 DeepSeek 官方峰谷定价本地估算，不是官方账单接口返回的计费结果。
峰谷定价坐标系¶
悬停余额徽章 3 秒，会展示 DeepSeek 峰谷定价坐标系。坐标系用于查看当前时段对应的峰谷价格。
其中，周末（周六/周日）全天低谷价，2026-08-23 起生效。
安装与启用¶
要求：
- DeepSeek Harness 桌面版或 Web 版
- Node.js >= 18
安装步骤如下：
- 进入 Harness profile 目录：
cd ~/.dsh/profiles/desktop
- 安装插件包：
npm install <git仓库地址>
- 编辑
~/.dsh/profiles/desktop/package.json，把dsh.profile.bundles数组加上dsh-quota-badge：
{
"dsh": {
"profile": {
"bundles": [
"dsh-quota-badge"
]
}
}
}
- 确保
~/.dsh/.credentials.yaml里有 DeepSeek API Key：
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxx
-
完全退出并重新打开 DeepSeek Harness。
-
在
设置 → 余额监控页面查看趋势、调整参数。
典型用法¶
- 查看当前余额：看侧边栏底部的余额徽章。
- 手动刷新：点击徽章上的手动刷新入口，触发余额查询和数字滚轮动画。
- 查看多币种余额：在
设置 → 余额监控页面查看账户内全部币种明细。 - 查看余额趋势：在余额趋势 Sparkline 中查看采样数据。
- 查看用量统计：在用量统计区域查看历史回填、分 Key 统计、汇总卡片、每日消费折线和模型明细表。
- 自动检查更新：默认开启，启动后及每 6 小时自动检查 GitHub 新版本。
适用场景与注意¶
适合以下场景：
- 在 DeepSeek Harness 中频繁发起任务，需要随时查看账户余额。
- 需要查看 CNY、USD 和其他币种的余额明细。
- 需要按 Key、按天、按模型查看本地用量统计。
- 需要对照峰谷定价查看当前时段价格。
使用前注意：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与
MIT许可证。 - 用量统计是基于 Harness 会话日志和 DeepSeek 官方峰谷定价的本地估算。
- 插件运行期间会隐藏默认
cordis插件管理按钮，卸载后恢复。 - 余额接口依赖
DEEPSEEK_API_KEY，需要确认配置文件已正确写入。 - 周末（周六/周日）全天低谷价，2026-08-23 起生效。
结尾¶
dsh-quota-badge 解决的是一个具体问题：把 DeepSeek 账户余额、币种明细、余额趋势和用量统计放进 DeepSeek Harness 的侧边栏与设置页。安装前检查源码和许可证，按 profile 配置启用，再根据实际使用调整刷新与展示参数。
GitHub 仓库：
https://github.com/yoiizesdev-crypto/DSH-Balance-display
