打开 dsh 设置（齿轮）→ 余额监控 / Balance Monitor，可编辑卡片行为参数，保存后写入 ~/.dsh/settings.yaml 的 dsh-balance-monitor: 段，即时生效（个别参数重启后生效）：

分组	字段	默认	说明
显示	`ui.showCard`	`true`	关闭后不显示任何渠道卡片
显示	`ui.warnThreshold`	`30`	用量 ≥ 该百分比进度条变黄
显示	`ui.dangerThreshold`	`70`	用量 ≥ 该百分比进度条变红
刷新	`ui.pollMs`	`60` 秒	卡片刷新间隔（面板以秒显示，内部存毫秒）
网络	`network.cacheMs`	`40` 秒	服务端配额缓存，建议保持低于卡片刷新间隔
网络	`network.timeoutMs`	`20` 秒	上游超时（火山方舟 / Command Code / DeepSeek 官方用量 / CPA 管理接口）
网络	`network.cpaBaseUrl`	留空	你自己的 CLIProxyAPI 管理地址（Google AI Pro 渠道的配额来源）；留空则该渠道显示「未配置 CPA 地址」，见下文搭建指南
网络	`network.cpaStaleMs`	`1200` 秒	CPA 快照超过该时长即视为过期，插件自动补一次探测（建议大于 CPA 侧的定时探测周期）
凭证	`credentials.file`	`.credentials.yaml`	凭证文档文件名（相对 `$DSH_HOME`）

设置面板的 「渠道凭证」分组 显示每个渠道展示余额/用量需要的凭证及其配置状态，按是否已被 DSH 模型配置引用区分只读/可写：

渠道	凭证	交互
DeepSeek 官方	`DEEPSEEK_API_KEY`	只读（DSH 模型配置已引用），显示 ✅/⚠️ 状态
DeepSeek 官方	`DEEPSEEK_PLATFORM_TOKEN`	可写密码框（官方花费需要，会过期），带三段说明：它是什么 / 怎么取（platform.deepseek.com → F12 → Console → `JSON.parse(localStorage.getItem('userToken')).value`）/ 用来干什么
火山方舟	`ARK_ACCESS_KEY_ID`	可写密码框（插件专属，DSH 模型用的是 `HUOSHAN_API_KEY`，两套不同凭证）
火山方舟	`ARK_SECRET_ACCESS_KEY`	可写密码框
火山方舟	区域	只读，自动跟随 DSH 模型配置（从 huoshan provider 的 `baseURL` 解析，如 `cn-beijing`）
Command Code	`COMMANDCODE_API_KEY`	只读（DSH 模型配置已引用），显示 ✅/⚠️ 状态
Google AI Pro	`CPA_BASIC_AUTH`	可写密码框，格式 `user:pass` —— CPA 服务器上 nginx 的 Basic 认证（第二把锁）
Google AI Pro	`CPA_MANAGEMENT_KEY`	可写密码框 —— CPA 的 management key（第三把锁）；插件把它放在 `X-CPA-Key` 头里，由 nginx 改写成上游的 `Authorization: Bearer`

可写框保存时走官方 ctx.credentials.set() 写入 $DSH_HOME/.credentials.yaml（refs: 段，带锁 + 原子写），插件自身不写文件。

凭证存于 $DSH_HOME/.credentials.yaml（Web 界面 Models 页写入，或直接编辑文件；插件通过官方 ctx.credentials 服务读取，环境变量优先）：

凭证	必需	用途
`DEEPSEEK_API_KEY`	✅	查询余额 `api.deepseek.com/user/balance`
`DEEPSEEK_PLATFORM_TOKEN`	可选	查询官方用量（今日/7日/30日）。获取：登录 platform.deepseek.com → DevTools Console 执行 `JSON.parse(localStorage.getItem('userToken')).value`，把输出写入凭证

⚠️ DEEPSEEK_PLATFORM_TOKEN 是网页会话 token，会过期（官方返回 code 40002/40003 即过期）。过期时卡片显示红色提示并回退余额差值估算；在设置面板凭证组粘贴新 token 即可恢复，余额查询不受影响。

凭证	必需	用途
`ARK_ACCESS_KEY_ID`	火山方舟渠道时需要	火山方舟控制面 API 签名（AK/SK），查询 Agent Plan 套餐额度
`ARK_SECRET_ACCESS_KEY`	火山方舟渠道时需要	同上，Secret Access Key
`COMMANDCODE_API_KEY`	Command Code 渠道时需要	Command Code API key（`user_...`），查询 5h/周/月用量
`CPA_BASIC_AUTH`	Google AI Pro 渠道时需要	CPA 前置 nginx 的 Basic 认证，格式 `user:pass`
`CPA_MANAGEMENT_KEY`	Google AI Pro 渠道时需要	CPA management key，用于读取 `antigravity-priority` 插件探测到的配额快照

火山方舟 AK/SK 获取：登录 console.volcengine.com → 访问控制 → API 访问密钥 → 新建密钥。注意：AK/SK 是 IAM 账号级凭证，能操作所有资源，请妥善保管。

@alanzhao/dsh-balance-monitor

安装