dsh-quota-dashboard
dsh-cost-meter 的 fork:会话费用 / Token 缓存统计 + 统一额度看板——DeepSeek 余额、OpenCode GO、Kimi For Coding、GLM Coding Plan(智谱)、火山方舟订阅额度一屏尽览。
本项目是 Han-1413141/dsh-cost-meter(MIT) 的 fork,并合并了以下插件的额度查询能力(均保留 MIT 许可与致谢):
功能
继承自 dsh-cost-meter(原样保留)
- 会话费用徽章(输入/缓存/输出 Token 分列 + 费用),位置可配(输入区下方 / 会话标题栏)
- 当日费用、预算图框(预算 / 已用% / 进度条)、官方账户余额、历史记录
- 峰谷计价(DeepSeek 2026-08-17 起两档)、官方价格一键同步
- 26 周 Token 用量热图、按模型 Token 桶拆分、中英双语
新增:统一额度看板(设置 → 额度看板 · Quota)
| Provider | 展示内容 | 凭证(DSH 凭据库 / 环境变量) |
|---|
| DeepSeek 余额 | 总余额 / 充值 / 赠送,分档着色 | DEEPSEEK_API_KEY |
| OpenCode GO | 滚动5小时 / 本周 / 本月用量% + 重置时间 | OPENCODE_GO_API_KEY(或 opencode auth.json 自动发现) |
| Kimi For Coding | 周限 + 5小时窗口:剩余 / 已用 / 重置倒计时 | KIMI_FOR_CODING_API_KEY / KIMI_CODING_API_KEY / KIMI_API_KEY / Kimi Code 登录态自动发现 |
| GLM Coding Plan | 5小时 / 每周 / MCP 月度:剩余 / 已用% / 重置 | ZAI_CODING_CN_API_KEY(国际版端点 https://api.z.ai) |
| 火山方舟 | Coding Plan / Agent Plan:各档已用% + 重置 | ARK_ACCESS_KEY_ID + ARK_SECRET_ACCESS_KEY(可配 region/version) |
- 每行可展开查看全部窗口的进度条与重置倒计时;自动刷新(默认 5 分钟,可配),页面隐藏时暂停
- 未配置凭证的行显示中性提示,不阻塞其他 Provider;失败行红色标注错误信息
- 全部 Provider 并行查询,单行失败互不影响
安装
# 本地源码(link 安装)
dsh plugin --profile web add link:/absolute/path/to/dsh-quota-dashboard
# 或发布到 GitHub / npm 后
dsh plugin --profile web add github:<you>/dsh-quota-dashboard
安装后重启 dsh web 生效。设置 → 额度看板 · Quota 查看看板。
配置
额度看板配置存于账本配置(设置页可改),默认即含上述 5 个 Provider,可按需启用/禁用或修改。配置形如:
quotaDashboard: {
enabled: true, refreshMinutes: 5, timeoutMs: 15000,
providers: [
{ id: 'deepseek', label: 'DeepSeek 余额', kind: 'deepseek-balance', credential: 'DEEPSEEK_API_KEY', endpoint: 'https://api.deepseek.com/user/balance', enabled: true },
{ id: 'opencode-go', label: 'OpenCode GO', kind: 'opencode-go', credential: 'OPENCODE_GO_API_KEY', endpoint: 'https://opencode.ai/zen/go/v1/usage', enabled: true },
{ id: 'kimi-coding', label: 'Kimi For Coding', kind: 'kimi-usage', credential: 'KIMI_CODING_API_KEY', endpoint: 'https://api.kimi.com/coding/v1/usages', enabled: true },
{ id: 'glm-coding', label: 'GLM Coding Plan', kind: 'glm-usage', credential: 'ZAI_CODING_CN_API_KEY', endpoint: 'https://open.bigmodel.cn', enabled: true },
{ id: 'ark', label: '火山方舟', kind: 'ark-quota', credential: '', endpoint: '', enabled: true, extra: { accessKeyIdRef: 'ARK_ACCESS_KEY_ID', secretAccessKeyRef: 'ARK_SECRET_ACCESS_KEY', region: 'cn-beijing', version: '2024-01-01' } },
],
},
凭证解析优先序:DSH 凭据库(ctx.credentials)→ 环境变量。OpenCode GO 支持 OPENCODE_API_KEY 旧名与 opencode CLI 登录态；Kimi 支持 KIMI_API_KEY，以及 Kimi Code CLI 登录态（旧版 ~/.kimi/credentials/kimi-code.json、新版 KIMI_CODE_HOME/credentials/*.json，Windows 默认 %USERPROFILE%.kimi-code）。
安全
- 凭证只在宿主进程解析,绝不进入浏览器或日志;余额/额度查询只发往各自官方固定域名
- 看板数据经同源 /quota-dashboard-api/state(loopback Host + 自定义头双重守卫)下发
- 火山方舟 AK/SK 经火山 SigV4 签名,密钥不出现在 URL / 命令行
- 账本与配置仅写 DSH_HOME/storages/quota-dashboard/ledger.json(原子写)
- 本插件与 dsh-cost-meter 互斥:二者功能重叠(同款账本/服务),请勿同时安装
兼容性
- DeepSeek Harness >= 0.1.0-rc.5(当前 rc.6 验证通过),Node >= 20
- 依赖:@deepseek-ai/dsh-credentials、@deepseek-ai/dsh-home-paths、zod
License
MIT。上游项目版权归各自作者:Han-1413141(dsh-cost-meter)、ruby1304(dsh-quota-status)、wuyan19(dsh-plugin-zquota)、lordqyxz(dsh-ark-quota)。
