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 · {} · 中转站/多账号：{ "": { "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