GeekRicardo
947c64a447
- 新增 kimi-coding provider 支持：KIMI_CODING_API_KEY 查询 api.kimi.com/coding/v1/usages， 展示 5小时/7天 已用百分比 + 重置倒计时 + 刷新时间（对齐 cc-switch SubscriptionQuotaFooter） - 判断依据从 model 前缀改为 agentDefaultModel.currentSelection()，切换模型/对话实时更新 - client 轮询从 60s 降到 2s；余额/用量 host 端按 provider 缓存 5 分钟，切走再切回强制刷新 - 非 deepseek/kimi-coding provider 不再展示，避免 opencode-go 等网关模型误显示官方余额
deepseek-balance
DeepSeek Harness web 插件：在输入框下方状态栏展示当前供应商的余额/用量，按 provider 实时切换。
| 当前模型 provider | 展示内容 | 数据源 |
|---|---|---|
deepseek（DeepSeek 官方） |
● 本会话 ¥X.XX · ● 余额 ¥465.xx |
DEEPSEEK_API_KEY → GET api.deepseek.com/user/balance |
kimi-coding（Kimi For Coding） |
5小时 3% 4h15m · 7天 31% 6d0h · 5分钟前 |
KIMI_CODING_API_KEY → GET api.kimi.com/coding/v1/usages |
| 其他 provider | 不显示（返回 null） | — |
实时性（v2+ 优化）
- 2 秒轮询：切换模型/切换对话后最多 2 秒更新，不再等 60 秒。
- 按 provider 判断：用
agentDefaultModel.currentSelection()（当前选中，切换即更新），不再用「最近一次请求的模型」，避免切了模型但没发消息时读数停留在旧模型。 - 5 分钟缓存：余额/用量实际查询每 5 分钟一次（host 端按 provider 缓存），切走再切回强制刷新一次。
- 切换对话：client 按
sessionId变化重新加载，DeepSeek 的本会话花费按 session 分别累计。
一键安装
curl -fsSL https://raw.githubusercontent.com/GeekRicardo/deepseek-balance/main/install.sh | bash
脚本做的事（可先 --dry-run 预览）：
- 在
~/.dsh/profiles/web/package.json写入依赖"deepseek-balance": "github:GeekRicardo/deepseek-balance"； - 把
deepseek-balance追加进dsh.profile.bundles； cd ~/.dsh/profiles/web && pnpm install；- 校验 bundles 已注册，提示重启。
重启 DSH 并硬刷新页面后生效：
pm2 restart dsh-web # 若用 pm2 托管；否则用你的启动方式重启
卸载
# 1. 从 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 移除 "deepseek-balance"
# 2. 移除 dependencies 里的 "deepseek-balance"
# 3. cd ~/.dsh/profiles/web && pnpm install
# 4. 重启 DSH
前置条件
- DeepSeek Harness 已初始化 web profile（
~/.dsh/profiles/web存在）。 ~/.dsh/.credentials.yaml里配置对应供应商的密钥：- DeepSeek：
DEEPSEEK_API_KEY - Kimi Coding：
KIMI_CODING_API_KEY（也兼容KIMI_CODE_API_KEY/KIMI_API_KEY，可选KIMI_CODE_BASE_URL覆盖）
- DeepSeek：
- Node.js ≥ 20、pnpm 可用。
工作原理
| 半区 | 职责 |
|---|---|
| Host | 监听 llm/stream 按 session 累计 DeepSeek 官方模型的 token；经 credentials 读密钥，按 provider 查对应接口（DeepSeek /user/balance、Kimi /coding/v1/usages）；5 分钟缓存；注册 /deepseek-balance/status HTTP route |
| Client | 在 conversation.composer.dock 槽位渲染状态栏，fetch 轮询该 route（2s），按 provider 分发渲染 |
DeepSeek 计费口径（重要）
- DeepSeek 官方 API 不返回金额，只返回 token 数。金额是
token × 单价的估算，不是账单。 - 单价来自第三方 models.dev（USD/百万 token），按模型前缀匹配；拉取失败回落到内置单价；汇率固定 7.2。
- 本会话花费是内存态，从插件加载后的下一次模型调用开始累计，重启清零，不持久化。
Kimi Coding 用量口径（重要）
- Kimi Code 是订阅制，「余额」= 每周请求配额与 5 小时滚动窗口的已用百分比，接口不返回金额。
- 展示格式对齐 cc-switch 的
SubscriptionQuotaFooter：5小时 X% 倒计时 · 7天 Y% 倒计时 · N分钟前，百分比 <70% 绿 / 70-90% 橙 / ≥90% 红。 - 仅当 provider 为
kimi-coding（api.kimi.com/coding）时展示；通过 opencode-go 等网关跑的 kimi 模型不属于此账户，不展示。
License
MIT