模型额度用量 PonyDevAI/dsh-model-usage

dsh-model-usage

DeepSeek Harness（DSH）Web UI 插件：实时显示模型供应商的额度与用量。

- 侧边栏底部：当前供应商的额度/余额卡片，点击打开全部供应商弹窗（Codex 式）
- 官方 Logo：DeepSeek / GLM(Z.ai) / Kimi / OpenRouter / MiniMax / OpenCode / OpenAI / Anthropic / Gemini / xAI / Qwen / Mistral / Groq / GitHub Copilot 等 25+
- 设置 → 模型用量：KPI、趋势图、供应商/模型聚合、请求日志、CSV 导出
- 设置 → 模型：页面底部显示各供应商额度
- 版本检查：设置 → 模型用量 右上角「检查更新」（对比 npm 最新版，可复制更新命令）
- 只用真实数据：额度来自服务商接口，用量来自本机会话日志（逐 token 一致），不做金额估算

截图：当前不提供。此前的截图含真实模型名、余额与 token 用量，已在 2026-10 隐私清理时全部移除；恢复时必须由离线 harness + 假数据生成并登记，见 docs/screenshots/MANIFEST.md。

安装

要求 DSH >= 0.2.0-rc.2 < 0.3.0。

CLI
dsh plugin --profile web add @ponydev/dsh-model-usage

或在 Web「插件」页搜索安装

安装后重启宿主（launchctl kickstart -k gui/$(id -u)/local.deepseek-harness.web）并刷新页面。

本地开发：

dsh plugin --profile web add link:/path/to/dsh-model-usage

供应商支持（完整矩阵见 docs/providers.md）

| 供应商 | 数据接口 | 凭据引用 |
| DeepSeek API | api.deepseek.com/user/balance | DEEPSEEK_API_KEY |
| DeepSeek 账号 | Host deepseekAccount 服务（登录态） | — |
| GLM Coding Plan（国内 / 国际） | open.bigmodel.cn / api.z.ai 额度接口（5 小时 / 每周 / 每月 MCP 工具次数） | ZAI_CODING_CN_API_KEY / ZAI_API_KEY |
| OpenRouter | openrouter.ai/api/v1/credits（兜底 /api/v1/key） | OPENROUTER_API_KEY |
| Kimi Coding Plan | api.kimi.com/coding/v1/usages | KIMI_CODING_API_KEY / KIMI_API_KEY / MOONSHOT_API_KEY |
| Moonshot / Kimi 平台 | api.moonshot.{ai,cn}/v1/users/me/balance | MOONSHOT_API_KEY / MOONSHOT_CN_API_KEY |
| MiniMax Token Plan | api.minimax.io / api.minimaxi.com /v1/token_plan/remains | MINIMAX_API_KEY / MINIMAX_CN_API_KEY |
| OpenCode Go | opencode.ai/zen/go/v1/usage | OPENCODE_API_KEY |
| Xiaomi MiMo | platform.xiaomimimo.com/api/v1/balance | XIAOMI_API_KEY |
| GitHub Copilot | api.github.com/copilot_internal/user | GITHUB_TOKEN |
| sub2api 中转站 / 多账号 | {baseUrl}/v1/usage（余额或 5h/1d/7d 限额） | 该路由 apiKeyEnv / keyRef |
| 其他任意供应商 | customQuota 配置（URL + JSON 路径映射） | 自定义 keyRef |

customQuota 示例（余额式）：

config:
customQuota:
mycoder:
url: https://api.example.com/quota
auth: bearer # bearer | raw | x-api-key | none
keyRef: MYCODER_API_KEY
balance:
path: data.balance
currency: CNY

窗口式：

config:
customQuota:
mycoder:
url: https://api.example.com/quota
windows:
- key: rolling
label: 5h
usedPath: data.used
limitPath: data.limit
resetAtPath: data.resetAt # ms | s | iso
resetAtUnit: ms

配置

cordis.patch.yml 中 model-usage 行的 config：

| 键 | 默认 | 说明 |
| refreshSeconds | 60 | 额度刷新间隔（秒） |
| footer | true | 是否显示侧边栏底部入口 |
| credentials | {} | 按路由覆盖凭据引用，如 { "deepseek-official": "MY_DEEPSEEK_KEY" } |
| glm | {} | GLM 组织/项目/套餐类型：organization / project / planType |
| customQuota | {} | 通用额度适配器（见上） |
| sub2api | {} | 中转站/多账号：{ "<route>": { "baseUrl": "https://…", "keyRef": "…" } } |
| footer | true | 侧边栏底部额度卡片是否显示（也可在设置 → 模型 → 显示设置里切换） |
| headerIcon | false | 会话头部右上角圆形统计图标是否显示 |
| bottomBar | false | 输入框底部状态栏额度入口是否显示 |

数据口径

- 用量：assistant/message 事件中的服务商回传 usage（input / cacheRead / cacheWrite / output），与本机会话日志逐 token 一致
- 额度/余额：服务商接口返回的真实值（DeepSeek 余额、GLM 5h/周剩余、Kimi 周/滚动窗口、OpenRouter credits）
- 真实消耗观测：每次刷新比对余额/套餐额度变动，得到当日实际支出（余额下降）与充值（余额上升，分开记录不冲抵）
- 不做金额估算：订阅套餐按套餐额度计费而不是按 API 逐次扣费，任何估算都会误导
- 统计范围：本机、安装后写入会话日志的调用；旁路调用（标题生成/压缩摘要）与其他设备不计
- 账本文件：$DSH_HOME/model-usage/ledger.json（按日聚合，保留 120 天；首次启动回填近 30 天）

安全

- API Key 只在 Host 内存中解析使用，不进入浏览器，任何 RPC 响应都不包含密钥
- 只请求写死的白名单接口域名；客户端不能指定 URL
- 账本只存用量聚合（token 数、窗口百分比），不含对话内容
- 错误信息脱敏（sk- / Bearer 会被打码）

开发与发布

- 开发环境、联调方式、提交前检查：CONTRIBUTING.md
- 项目级规范（AI/自动化代理必读）：AGENTS.md
- 发布流程（tag 触发自动发布，OIDC 无 token）：RELEASE.md
- 架构设计：docs/architecture.md

本地渲染台（离线验证 UI，不依赖宿主） open test-render.html

发版（自动发布到 npm + GitHub Release）
npm version patch && git push --follow-tags

License

MIT