前言¶
在 DeepSeek Harness（DSH）中，如果希望在当前会话旁边直接看到渠道余额或用量，可以安装一个侧边栏插件。dsh-balance-monitor 是一个极简的 DSH 插件，把当前会话渠道的余额/用量显示在侧边栏底部（设置上方）。下面介绍它的功能、安装方式、凭证配置与注意事项。
这是什么¶
alanzhao0128/dsh-balance-monitor 是一个 DeepSeek Harness (dsh) 插件，用于在侧边栏底部显示当前会话渠道的余额/用量。许可证为 MIT。
核心功能¶
- 在 dsh 侧边栏底部（设置上方）显示当前会话渠道的余额/用量。
- DeepSeek 官方渠道显示余额与今日/7日/30日花费窗口。
- 无平台 token 或官方接口失败时，今日花费回退为余额差值账本，7日/30日显示
—。 - 火山方舟渠道显示 Agent Plan 5小时/周/月套餐额度进度条。
- Command Code 渠道显示 5h/周/月用量窗口。
- 渠道感知自动显隐：其他渠道显示「暂不支持」占位，无会话不显示。
- 折叠态变为
36px圆形，显示紧凑余额 +tooltip。 60s轮询，切回标签页时刷新；上游失败时保留上次数据并标记stale。- 通过设置面板编辑卡片行为参数，保存后写入
~/.dsh/settings.yaml的dsh-balance-monitor段。 - 凭证通过官方
ctx.credentials服务读取，环境变量优先。
安装与启用¶
浏览器端 bundle 是手写的 classic script，无构建步骤。安装命令：
dsh plugin --profile web add "github:alanzhao0128/dsh-balance-monitor#main"
也可以从 npm 安装：
dsh plugin --profile web add @alanzhao/dsh-balance-monitor
安装后重启 Web UI：
dsh --profile web
重启后，卡片出现在展开的侧边栏底部、设置按钮上方。
典型用法¶
DeepSeek 官方渠道¶
余额查询需要配置：
DEEPSEEK_API_KEY
官方今日/7日/30日花费还需要配置：
DEEPSEEK_PLATFORM_TOKEN
获取 DEEPSEEK_PLATFORM_TOKEN：
- 登录
platform.deepseek.com。 - 打开 DevTools Console。
- 执行：
JSON.parse(localStorage.getItem('userToken')).value
- 把输出写入凭证。
注意：DEEPSEEK_PLATFORM_TOKEN 是网页会话 token，会过期。过期时卡片显示红色提示，今日花费回退为余额差值估算，7日/30日显示 —。
火山方舟渠道¶
显示 Agent Plan 额度需要配置：
ARK_ACCESS_KEY_ID
ARK_SECRET_ACCESS_KEY
配置后显示 5小时/周/月套餐额度进度条。
Command Code 渠道¶
显示用量窗口需要配置：
COMMANDCODE_API_KEY
配置后显示 5h/周/月用量窗口。
设置与状态¶
打开 dsh 设置：
余额监控 / Balance Monitor
可编辑卡片行为参数。保存后写入：
~/.dsh/settings.yaml
的 dsh-balance-monitor 段。
保存后即时生效，个别参数重启后生效。
状态文件位于：
$DSH_HOME/storages/balance-monitor.json
用于余额差值账本等状态。
凭证通过官方 ctx.credentials 服务读取，环境变量优先。可写凭证保存走官方 ctx.credentials.set() 写入：
$DSH_HOME/.credentials.yaml
的 refs 段，插件自身不写文件。
安全与注意¶
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
- API key 与平台 token 永不离开服务端；浏览器半只能通过 RPC 通道看到余额/花费数字，接触不到凭证。
- 通道走
loopback信任策略。 - 无遥测。
DEEPSEEK_PLATFORM_TOKEN会过期，过期后会影响官方花费窗口，并触发余额差值估算回退。- 火山方舟
AK/SK是 IAM 账号级凭证，能操作所有资源，请妥善保管。 - 社区目录
skillhub.cn是独立站点，与 DeepSeek / 幻方无官方从属关系。
资源¶
目录页：
https://www.skillhub.cn/plugins/alanzhao0128/dsh-balance-monitor
GitHub：
https://github.com/alanzhao0128/dsh-balance-monitor
