前言¶
在 DeepSeek Harness 里切换 ChatGPT 订阅、DeepSeek 账号或 API、GLM Coding Plan、Kimi Code 等模型时，额度往往分散在各服务商控制台或别的工具里。Harness 原生侧栏也不会按「当前选中的模型」只展示对应服务商的用量。Usage Panel（技术包名 dsh-model-meter）是社区维护的非官方插件，在右侧栏根据当前模型只显示该服务商的套餐窗口、重置时间或账户/API 余额，并每 60 秒自动刷新，也可手动刷新。
这是什么¶
Usage Panel · 用量面板由 Lirunhua 独立维护，归类为 Harness 社区目录中的联网工具插件。项目不代表 DeepSeek、OpenAI、智谱或 Moonshot/Kimi 的官方产品或推荐；查询在 Harness 宿主进程内完成，密钥留在宿主凭据存储，不写入插件源码或浏览器页面。
支持展示的数据¶
按 README 说明，各服务商侧栏展示内容如下。
| 服务商 | 展示数据 |
|---|---|
| ChatGPT 订阅 | 套餐类型、积分及 5 小时、7 天等额度窗口和重置时间 |
| DeepSeek 登录账号 | 充值与赠送钱包余额，按币种分别显示 |
| DeepSeek API | 总可用余额、充值余额、赠送余额、API 余额是否可调用；CNY/USD 分别显示 |
| GLM Coding Plan | 5 小时、7 天等套餐窗口，已用比例，重置时间与倒计时 |
| Kimi Code | 5 小时、7 天、月度总量、月度编程等窗口，已用比例，重置时间与倒计时 |
界面行为要点：只显示当前所选模型对应的服务商；未选模型时提示选择；不支持的服务商有明确状态。套餐窗口保留已用比例、进度条、重置时间与倒计时，不再展示会话 Token、上下文压力、轮次和耗时。金额界面统一两位小数；中英文随 Harness 语言设置切换。查询失败、缺少凭据或未返回字段均有明确状态。
安装与启用¶
在已初始化的 Harness profile 中安装。Desktop 用户先正常退出 Harness，再执行：
dsh plugin --profile desktop add github:Lirunhua/dsh-model-meter#v0.6.1
Web profile：
dsh plugin --profile web add github:Lirunhua/dsh-model-meter#v0.6.1
macOS Desktop 未配置 dsh 时，可用应用自带 CLI：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:Lirunhua/dsh-model-meter#v0.6.1
也可从发布页下载预构建 .tgz 后本地安装：
dsh plugin --profile desktop add ./dsh-model-meter-0.6.1.tgz
重新打开 Harness，在右侧栏通过 + 添加 用量（英文为 Usage），并选择所用模型。本版本面向 Harness 0.2.1-rc.3 插件接口；package.json 声明 engines.dsh 为 >=0.2.1-rc.3，插件已包含可运行的 lib/，安装时无需编译。
若 profile 里仍启用早期的 dsh-usage-panel 本地组合包，应先禁用或移除再启用 Usage Panel，避免两个面板注册同一扩展点。
配置账号¶
插件复用 Harness 模型设置中的凭据；默认可通过 Models/模型设置配置：
| 服务商 | 默认凭据引用 | 默认区域 |
|---|---|---|
| GLM Coding Plan | ZAI_API_KEY |
Z.ai 国际站 |
| Kimi Code | KIMI_CODING_API_KEY |
Kimi 国内站 |
| DeepSeek API | DEEPSEEK_API_KEY |
DeepSeek 官方 API |
ChatGPT 订阅需先通过兼容的 dsh-codex-subscription 登录；插件读取 codex-subscription/accounts 中已激活账号（version 1），仅在该记录不存在时回退旧的 OPENAI_CODEX_SUBSCRIPTION_OAUTH JSON 引用。
DeepSeek 登录账号使用 Harness 内置账号登录，读取 deepseek-account-platform/default；选账号模型查钱包，选 API Key 模型查 API 余额，两种来源独立。
需要改区域或凭据名称时，在 profile 的 cordis.patch.yml 中覆盖（示例来自 README）：
- id: usage-panel
name: dsh-model-meter
config:
glmRegion: zai # zai | bigmodel
kimiRegion: cn # cn | international
glmCredentialRef: ZAI_API_KEY
kimiCredentialRef: KIMI_CODING_API_KEY
deepseekCredentialRef: DEEPSEEK_API_KEY
chatgptCredentialRef: OPENAI_CODEX_SUBSCRIPTION_OAUTH # 仅旧格式回退
更改后重启 Harness；只向选定区域的官方地址查询，不自动跨站尝试同一密钥。
典型用法¶
1、在 Harness 中配置对应模型与凭据（及 ChatGPT 所需的 codex-subscription 登录）。
2、安装插件并在侧栏添加「用量」。
3、在模型列表选中 Kimi（或其他已支持服务商）——侧栏只显示该服务商卡片，例如 Kimi Code 的 5 小时窗口已用比例、重置时间与距重置倒计时。
4、切换模型时，用量卡片同步切换服务商；需要即时数据时可手动刷新。
仓库提供 离线交互演示（下载后用浏览器打开），可切换各服务商示例与中英文，数值均为虚构演示数据。
适用场景与注意¶
适合在 Harness 内长期切换多服务商 Coding Plan 或 DeepSeek 账号/API、又希望侧栏集中看额度与余额的开发者。插件仅做只读查询，不提供充值、支付或账户修改；当前模型只决定查哪个服务商，展示的是该账号整体套餐或余额，不是单个模型的独立消耗。
安装前应知：插件以当前 DSH 进程权限运行，会向各服务商官方只读接口发起请求；ChatGPT 与 DeepSeek 登录账号依赖宿主凭据格式及内部接口，并非稳定公开 API，变更时可能需要插件更新。OpenAI API 按量付费余额、Kimi Code 与 Moonshot API 按量账号不在支持范围内。所有查询在宿主执行，认证头与原始错误正文不会回传前端；不向额外统计服务上传账号信息。许可证为 MIT。
链接¶
- 社区目录：skillhub.cn/plugins/Lirunhua/dsh-model-meter
- 源码与说明：github.com/Lirunhua/dsh-model-meter
- 问题反馈：GitHub Issues（报告时请删除密钥与个人余额等信息）
