FengHuoLinShan/dsh-plugin-llm-balance

dsh-plugin-llm-balance

Name: dsh-plugin-llm-balance
Author: FengHuoLinShan

UIWeb UI4 GitHub stars· updated 2026-08-21

Draggable API balance/quota card for DeepSeek Harness

Install

npx @deepseek-ai/dsh plugin --profile web add dsh-codex-connect@alpha`，最低兼容

Restart `dsh web` after install. Bundle APIs can change during the developer preview.

[![DSH Hub](https://dshhub.dev/badge/dsh-plugin-llm-balance.svg)](https://dshhub.dev/plugins/dsh-plugin-llm-balance)

Paste this into your README. The star count updates with every catalog sync.

Excerpt from FengHuoLinShan/dsh-plugin-llm-balance, cleaned of badges and images.

🏷️ DSH 官方插件生态收录项目（git tag: dsh-official-plugin；GitHub topics: dsh-plugin · deepseek-harness）。

English | 中文

DSH（DeepSeek Harness）的余额与配额悬浮卡片。它会在 Web GUI 中常驻显示最近使用的最多 3 个 provider，让余额、套餐余量和重置时间一眼可见。

自动跟随最近使用的 provider：只记录插件启用后成功完成的模型调用，显示最近 3 个不同 provider；已有项目保持槽位稳定，新项目只替换被淘汰项。
同时支持余额与配额：金额余额按数值显示；套餐配额同时展示 5 小时、周等可用窗口及重置时间，状态颜色按最紧张的窗口计算。
DeepSeek 峰谷电价徽标：DeepSeek 余额行尾部显示「☾ 低谷 / ☀ 高峰」小药丸——2026-08-17 起高峰为北京时间每日 09:00–12:00、14:00–18:00，含午间 12:00–14:00 在内的其余时段均为低谷半价；纯时钟计算不发请求，tooltip 显示时段表与距切换的倒计时，徽标随现有余额轮询及标签页恢复刷新；未配置 Key 的行不挂徽标。
自动发现配置：合并内置 provider、llm-pi-ai.providers.* 和本插件配置，无需逐个添加。
轻量交互：卡片可拖动并记忆位置；点击即可刷新；默认每 60 秒自动刷新，页面隐藏时暂停、恢复可见时立即更新。
凭据不出服务端：API Key 和 OAuth token 不会发送到浏览器；余额查询通过仅允许 loopback 权限的 Connection RPC 完成。

Provider	展示内容	凭据来源
DeepSeek / DeepSeek Official	CNY 余额	DSH credentials
Moonshot / Moonshot CN	CNY 余额	DSH credentials
Kimi For Coding	5h、周配额与套餐等级	DSH credentials
OpenAI Codex	5h、周、可选月配额与 Credits	Codex Connect 的 ChatGPT OAuth
OpenCode Go	5h、周配额	DSH credentials

余额颜色：绿 >=100，黄 20–99，红 1–19，灰 <1。配额颜色：绿 >=50%，黄 20–49%，红 5–19%，灰 <5%；加载或查询失败同样显示灰色。

服务端（lib/index.js）：记录最近使用的 provider，通过 loopback-only Connection RPC 代理余额查询、解析凭据并对同源请求去重。
浏览器端（lib/client.js）：聚合最近 3 个 provider，只请求当前需要展示的数据，并负责刷新、着色、拖动和位置记忆。

支持的 provider 接口：

provider id	接口	口径
deepseek / deepseek-official	`GET https://api.deepseek.com/user/balance`	余额（CNY；官方 `total_balance` 为字符串，数字同样兼容）
moonshotai / moonshotai-cn	`GET https://api.moonshot.cn/v1/users/me/balance`	余额（CNY）
kimi-coding	`GET https://api.kimi.com/coding/v1/usages`	套餐配额（顶层 usage=周限额 + limits 窗口明细（5h 限流等，window 对象归一化为 5h/周），含套餐等级）
openai-codex	`dsh-codex-connect`（`GET https://chatgpt.com/backend-api/wham/usage`）	Codex Connect 配额（rateLimits 主 bucket（id `codex`，回退首个）窗口 = 剩余百分比（limit=100，18000s → 5h、604800s → 周，其余稳定时长标签）；可选 individualLimit → 月配额、credits → USD 余额或 Credits 段（`credits.unlimited=true` 时仅因百分比 UI 显示为有限 100/100——绿色 100% 而非灰色 ∞/∞，账户本身仍无限））
opencode-go	`GET https://opencode.ai/zen/go/v1/usage`	OpenCode Go 套餐配额（`usage.rolling` → 5h、`usage.weekly` → 周：`percent` 为已用百分比 → amount=100-percent、limit=100，`resetsAt` → 重置时间；monthly 忽略；单个窗口无效只跳过该窗口，至少一个窗口有效才成功。⚠️ 端点目前无官方公开文档，可能变化）

llm-pi-ai 中声明的其他路由若无内置接口表，如实报告 no_balance_api，不误报配置错误。

前置条件：单独安装并启用 dsh-codex-connect（dsh plugin --profile web add dsh-codex-connect@alpha，最低兼容 0.1.0-alpha.4.5），并在其界面完成 ChatGPT OAuth 登录。本插件把它声明为可选 peer 依赖：不安装也照常运行，只是 openai-codex 如实显示未配置。
无 API Key：Codex 走 ChatGPT OAuth，不需要 DEEPSEEK_API_KEY 之类的凭证；登录态与配额查询全部经由 codex-connect 的 OpenAICodexCredentialStore 封装完成。本插件在 openai-codex 被查询时才动态 import codex-connect；模块缺失/不兼容或未登录 → configured:false（安全 ref，不含凭据）；已登录但配额查询失败 → status:error / error:unavailable；成功 → 把无密钥的 OpenAICodexUsage 映射为现有 quota 口径。
显示：5h/周限额以剩余百分比呈现（如 5h 74% · 周 68%）；若账户有月支出上限则追加「月」窗口；无限额度账户（credits.unlimited=true）显示「Credits」段——仅因现有百分比 UI 才以有限 100/100 呈现（绿色 100% 而非灰色 ∞/∞），账户本身仍无限。
安全：本插件从不直接读取或复制 OAuth 文档（.openai-codex-auth.json），token 不会出现在任何响应、日志或页面中。