额度总览看板 CyBerKitTen0009/dsh-quota-dashboard

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 许可与致谢）：
- ruby1304/dsh-quota-status — Kimi For Coding / DeepSeek 余额解析
- wuyan19/dsh-plugin-zquota — GLM Coding Plan 额度端点与响应形态
- lordqyxz/dsh-ark-quota — 火山方舟 SigV4 签名与响应解析

功能

继承自 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:/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）。