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