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_CODING_API_KEY
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 登录态自动发现。

安全

• 凭证只在宿主进程解析,绝不进入浏览器或日志;余额/额度查询只发往各自官方固定域名
• 看板数据经同源 /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)。