ds-balance-card

中文 | English

DeepSeek Harness 常驻额度卡片插件:在界面右下角持续显示各模型平台的账户余额与 Coding Plan 套餐额度。只要在 DSH 凭证库中配置了对应平台的 API Key,插件会自动识别并逐平台查询。

功能

• 🪟 右下角常驻卡片,跨会话始终可见(挂在 shell.overlay 全帧浮动层)
• 🔍 多平台自动识别:扫描凭证库,已配置 Key 的平台自动查询并逐行显示
• 💰 余额与 Coding Plan 额度分行区分显示
• ⚠️ 预警:余额低于阈值(⚙ 可调,默认 10)变黄、余额为 0/不可用变红;套餐剩余低于 20% 变黄、耗尽变红;预警状态圆点脉冲闪烁、刷新加速到 1 分钟
• ⏱️ 每 5 分钟自动刷新
• 🖱️ 可拖拽移动(带视口边缘保护,拖不出屏幕)、双击标题栏复位、可收起为最小条
• 🔒 安全:API Key 永不进入浏览器。Host 半通过 DSH credentials 服务解析各平台 Key,经环境变量传给 curl,仅把解析后的余额/配额字段发往页面

平台支持矩阵

平台	凭证名	余额	Coding Plan / 套餐额度
DeepSeek	DEEPSEEK_API_KEY	✅ GET /user/balance	—(无套餐)
Moonshot Kimi	MOONSHOT_API_KEY	✅(USD,含现金/赠送拆分)	—
阶跃星辰 StepFun	STEPFUN_API_KEY	✅(含总充值/总赠送)	—
MiniMax	MINIMAX_API_KEY	—	✅ Coding Plan(国内)/ Token Plan(国际),5h + 周窗口剩余 %
智谱 Z.ai	ZAI_API_KEY / ZHIPU_API_KEY / BIGMODEL_API_KEY	—	✅ Coding Plan,5h 窗口 / 周配额 / 工具额度剩余 %,含套餐档位
OpenAI / Anthropic / Google Gemini / xAI / 火山方舟 / 阿里云百炼 / 百度千帆 / 腾讯混元 / 讯飞星火	见源码 PLATFORMS	❌	❌ 配置了 Key 会显示「暂不支持查询」

配置了 Key 但平台暂无官方查询接口时,卡片会明确标注「暂不支持查询」,不会静默忽略。

安装

插件本体放进任意位置,链接到 profile 的 node_modules,再在 cordis.patch.yml 里插入一行即可。

# 1. 克隆插件(以 web profile 为例)
mkdir -p "$DSH_HOME/profiles/web/plugins"
git clone https://github.com/jasonsun29/ds-balance-card.git "$DSH_HOME/profiles/web/plugins/ds-balance-card"

# 2. 链接到 profile 的 node_modules(无 node_modules 目录会自动创建)
mkdir -p "$DSH_HOME/profiles/web/node_modules"
ln -sfn ../plugins/ds-balance-card "$DSH_HOME/profiles/web/node_modules/ds-balance-card"