前言¶
在 DSH 的插件化扩展里，侧边栏、设置页和数据源展示都可以通过插件补充。实际使用时，一个常见问题是：额度信息分散在不同服务商的控制台里，DeepSeek 余额、OpenCode Go 的月 / 周 / 5h 额度、国家超算中心 scnet 的 Credits 需要分别查看。
dsh-plugin-quota-monitor 解决的就是这个问题：把额度与余额状态放到 DSH 侧边栏底部，并在设置页里提供完整配置。
这是什么¶
dsh-plugin-quota-monitor 是一个 DSH（DeepSeek Harness）侧边栏底部的额度与余额监控插件，由 DoggyHU 维护，许可证为 MIT。
它的定位比较明确：在 DSH 侧边栏底部显示一条怒气条和各服务商状态条，并在“设置 → 插件管理 → 余额监控”里提供完整配置页。
适合在 DSH 中使用 DeepSeek、OpenCode Go 或国家超算中心 scnet，并希望减少切换到外部控制台查看余额的人。
核心功能¶
DeepSeek 余额¶
DeepSeek 怒气条 Rage 为金色，始终显示。
它读取 DeepSeek 官方接口的实时余额：
api.deepseek.com/user/balance
界面上显示 ¥ 剩余金额。
OpenCode Go 额度¶
数据源标识为 opencode-go。
它读取 OpenCode Go 官方用量接口，把三个窗口映射为 RPG 风格的状态条：
月额度 = HP
周额度 = MP
5h 额度 = SP
界面上显示剩余 $ 与细条。
国家超算中心 scnet Credits¶
scnet 展示的是 Token Plan Credits 剩余。
scnet 没有公开的用量 / 余额查询接口，用量只能从网页控制台查看。插件改为基于 DSH 本地会话日志估算本月 scnet 消耗，再按 scnet 官方费率表折算成 Credits。
这部分估算只覆盖 DSH 实际记录的 token 消耗，不包含只在 DSH 之外使用的 scnet 用量。
侧边栏行为¶
- 60 秒轮询一次。
- 切回页面时即时刷新。
- 窄侧栏下折叠为圆形小徽标。
数据源选择¶
数据源默认是 auto。
自动识别会从 DSH 的 settings.yaml 中读取：
agent-default-model.provider
可选值包括 opencode-go 和 scnet。也可以在设置页手动指定数据源。
设置页¶
进入路径：
设置 → 插件管理 → 余额监控
可配置项包括：
1、数据源切换：自动、OpenCode Go、国家超算中心。
2、OpenCode 显示的条：
月额度 HP
周额度 MP
5h 额度 SP
可以分别开关。
3、国家超算 Credits：
- 月度额度，默认 60,000（基础版）。
- 每月重置日，范围为 1-28。
- 模型费率表，JSON 可编辑。
4、DeepSeek 怒气条始终显示。
资料中提到模型费率表包含 DeepSeek-V4-Flash-0731、GLM-5、Kimi-K3、MiniMax-M3、Qwen3.8-Max 等官方费率；完整清单未列全。
配置保存在：
$DSH_HOME/storages/quota-monitor-config.json
安装与启用¶
安装¶
从 npm 安装：
dsh plugin --profile web add dsh-plugin-quota-monitor
也可以使用本地 tarball：
dsh plugin --profile web add dsh-plugin-quota-monitor-<version>.tgz
示例命令里的 <version> 是本地 tarball 的版本占位符。资料中 package.json 的版本字段为 0.3.5。
重启¶
安装后需要重启 dsh web 进程。
client bundle 与 host 都需要重启进程，仅刷新页面不够。
密钥¶
视数据源而定：
DEEPSEEK_API_KEY
OPENCODE_GO_API_KEY
密钥可以从环境变量或 ~/.dsh/.credentials.yaml 读取，环境变量优先。
scnet Credits 走本地会话日志估算，无需密钥。
典型用法¶
1、先安装插件：
dsh plugin --profile web add dsh-plugin-quota-monitor
2、重启 dsh web 进程。
3、打开：
设置 → 插件管理 → 余额监控
4、选择数据源。如果 DSH 默认模型 provider 已经是 opencode-go 或 scnet，可以先用 auto。
5、如果使用 OpenCode Go，勾选需要显示的额度条：
HP / MP / SP
6、如果使用 scnet，填写月度额度和每月重置日，并按需编辑模型费率表。
7、回到 DSH 侧边栏底部查看状态。
本地构建替换¶
开发或替换本地构建时，可以这样做：
npm pack
dsh plugin --profile web remove dsh-plugin-quota-monitor
dsh plugin --profile web add ./dsh-plugin-quota-monitor-<version>.tgz
重新启用后，仍需重启 dsh web 进程。
适用场景与注意¶
适合：
- 在 DSH 中使用 DeepSeek，希望直接在侧边栏看 ¥ 余额。
- 使用 OpenCode Go，希望查看月 / 周 / 5h 三个额度窗口。
- 使用国家超算中心 scnet，并希望根据 DSH 会话日志估算本月 Credits。
- 希望在一个设置页里管理数据源、条目开关、月度额度和模型费率表。
注意：
- scnet 没有公开的用量 / 余额查询 API，插件只能基于 DSH 本地会话日志估算。
- 只在 DSH 之外使用的 scnet 用量不包含在估算结果里。
- Token Plan 按计费周期重置，不一定每月 1 号。需要填写控制台显示的额度重置日，范围为 1-28。插件按“上次重置日到今天”统计。
- 表外模型如果没有官方公开费率，会用默认费率近似；可以在设置页补充费率或调整默认值。
- 插件会读取本机配置、密钥和会话日志，并通过
dsh插件机制在dsh web进程中启用。建议把它当作使用当前 dsh 进程权限运行的代码，安装前检查源码与许可证。 - 项目许可证为 MIT。资料说明本项目由
jelly-000/dsh-balance-monitor大幅扩展而来，原项目许可证也为 MIT。
结尾¶
dsh-plugin-quota-monitor 的价值比较直接：把 DeepSeek 余额、OpenCode Go 额度窗口和 scnet Credits 放进 DSH 侧边栏，并提供一个设置页管理数据源、条目开关、月度额度和模型费率表。
GitHub 仓库：
https://github.com/DoggyHU/dsh-plugin-quota-monitor
社区目录页地址未包含在已核实资料中，无法给出可靠链接；查找插件目录时，请以项目说明或目录站点给出的地址为准。
