GeekRicardo
a68b9a37e5
- 新增 opencode-go provider：OPENCODE_GO_API_KEY 查询 opencode.ai/zen/go/v1/usage， 展示 rolling(5h)/weekly/monthly 三窗口已用百分比 + 倒计时 + 刷新时间， 认证同时带 Authorization: Bearer 与 x-api-key（对齐 OpenCodeMonitor 官方接口） - DeepSeek 余额分支兼容 deepseek 与 deepseek-official 两条官方路由 （DSH 自带 dsh-llm-deepseek 路由名为 deepseek-official，与 pi-ai catalog 名 deepseek 并存） - 2 秒轮询 + provider 缓存 5 分钟 + 切换强制刷新（沿用统一逻辑）
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 |
opencode-go（OpenCode Go） |
5小时 2% 3h50m · 7天 9% 4d2h · 30天 26% 22d1h · 5分钟前 |
OPENCODE_GO_API_KEY → GET opencode.ai/zen/go/v1/usage |
| 其他 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覆盖） - OpenCode Go：
OPENCODE_GO_API_KEY（也兼容OPENCODE_API_KEY）
- 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 模型不属于此账户，不展示。
OpenCode Go 用量口径（重要）
- OpenCode Go 是 $10/月订阅，官方配额：5 小时 = $12、每周 = $30、每月 = $60；接口只给已用百分比与重置时间，金额为按配额换算的估算（
percent/100 × 配额）。 - 展示
5小时 X% 倒计时 · 7天 Y% 倒计时 · 30天 Z% 倒计时 · N分钟前，颜色阈值同上。 - 接口要求同时携带
Authorization: Bearer与x-api-key两个请求头（对齐 OpenCodeMonitor 的官方用量接口实现）。 - 仅当 provider 为
opencode-go（opencode.ai/zen/go）时展示。
License
MIT