Usage Panel · 用量面板

非官方 DeepSeek Harness 社区插件。 本项目由社区独立维护，不代表 DeepSeek、智谱或 Moonshot/Kimi 的官方产品、审核或推荐。

English · DeepSeek Harness

按当前选中的模型，在 Harness 右侧栏只显示对应服务商的 Coding Plan 套餐额度、重置时间或 DeepSeek API 余额。展示更简洁，切换模型时同步切换用量卡片。

支持什么

服务商	展示数据
DeepSeek API	总可用余额、充值余额、赠送余额、API 余额是否可调用；CNY/USD 分别显示
GLM Coding Plan	服务商返回的 5 小时、7 天及其他套餐窗口，已用比例，重置时间与倒计时
Kimi Code	服务商返回的 5 小时、7 天、月度总量、月度编程等窗口，已用比例，重置时间与倒计时

• 每 60 秒自动刷新，支持手动刷新。
• 中英文界面随 Harness 语言设置切换。
• 只显示当前所选模型对应的服务商；未选择模型时显示选择提示，不支持的服务商显示明确状态。
• 套餐窗口只保留已用比例、进度条、重置时间与倒计时；不再重复展示剩余比例和原始计数。
• 不再展示会话 Token、上下文压力、轮次和耗时。额度/余额属于配置账号的整体用量，不是单个模型的独立消耗。
• 查询失败、缺少凭据、未提供的数据均有明确状态。

示例（演示数据）：

离线交互演示：下载后用浏览器打开，可切换 GLM/Kimi/DeepSeek 示例、中英文和模拟刷新。预览图与演示均为界面示意，使用虚构数值，不是实际账号截图。

选择 Kimi 模型 → 只显示 Kimi Code
5 小时窗口    已用 18%
重置时间      服务商返回的时间 · 距重置 2 小时 15 分

安装

在已初始化的 Harness profile 中安装。Desktop 用户先正常退出 Harness，再运行：

dsh plugin --profile desktop add github:Lirunhua/dsh-model-meter#v0.5.3

Web profile 使用：

dsh plugin --profile web add github:Lirunhua/dsh-model-meter#v0.5.3

macOS Desktop 没有配置 dsh 命令时，可用应用自带的 CLI：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add github:Lirunhua/dsh-model-meter#v0.5.3

也可下载发布页的预构建 .tgz 后本地安装：

dsh plugin --profile desktop add ./dsh-model-meter-0.5.3.tgz

重新打开 Harness，通过右侧栏 + 添加 用量（英文界面为 Usage），然后选择所用模型。技术包名和仓库地址继续使用 dsh-model-meter，以兼容已有安装与升级；公开名称为 Usage Panel · 用量面板。

本版本使用 Harness 0.2.1-rc.3 的插件接口；package.json 声明最低版本，后续版本的兼容性以实际测试为准。插件已包含可运行的 lib/，安装时无需编译。

从旧的本地用量面板迁移

如果 profile 里已启用早期的 dsh-usage-panel 本地版本，先禁用或移除该组合包，再启用 Usage Panel，避免两个面板注册同一扩展点。本项目保留早期面板的内部标签标识，方便已有侧栏恢复。

配置账号

插件复用 Harness 模型设置中的凭据存储；同名环境变量由 Harness 原生凭据服务处理。

服务商	默认凭据引用	默认区域
GLM Coding Plan	ZAI_API_KEY	Z.ai 国际站
Kimi Code	KIMI_CODING_API_KEY	Kimi 国内站
DeepSeek API	DEEPSEEK_API_KEY	DeepSeek 官方 API

先在 Harness 的 Models/模型设置中配置对应账号。密钥留在宿主侧，不写入插件源码或浏览器页面。

需要改区域或凭据名称时，在所用 profile 的 cordis.patch.yml 中覆盖：

- 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

更改后重启 Harness。只向选定区域的官方地址查询，不自动跨站尝试同一个密钥。

数据含义与限制

• DeepSeek 仅查询 API Key 模型的 API 余额；账号登录模型的额度暂不支持查询。本插件不为它推算套餐使用百分比或重置时间；不同币种不相加，金额按十进制字符串保留精度。
• GLM/Kimi 的窗口是否存在、是否返回重置时间取决于服务商。缺失时显示“未提供”，不按零使用量处理。
• Kimi 同时返回新旧统计且同一窗口数值冲突时，优先采用有效原始计数。
• 当前模型只决定查询哪个服务商。查询使用本插件配置的服务商凭据；结果是该账号的套餐额度或余额，不是当前模型的专属额度。
• 这是用量查询插件，不提供充值、支付或账户修改操作。

官方数据来源

• DeepSeek 余额接口：GET https://api.deepseek.com/user/balance
• GLM 官方查询实现：GET /api/monitor/usage/quota/limit，区域为 api.z.ai 或 open.bigmodel.cn
• GLM 套餐说明
• Kimi 官方查询实现：GET /coding/v1/usages，区域为 api.kimi.com 或 api.kimi.ai
• Kimi Server API 文档

隐私与请求

所有服务商查询都在 Harness 宿主进程执行，使用固定的官方只读接口、超时和缓存，并拒绝重定向。认证头、密钥和远端原始错误正文不会返回前端。本插件不发送模型推理请求，不向额外的统计服务上传账号信息。

开发与验证

需要 Node.js 22 或更高版本：

npm ci --ignore-scripts
npm test
npm pack --ignore-scripts

测试使用显式假凭据与模拟服务商响应，覆盖余额精度、多币种、缺失字段、真实 Cordis 挂载/清理、缓存、取消、超时、所选服务商过滤、界面显示与刷新生命周期。真实 Cordis 测试使用开发依赖，不因缺依赖而跳过。诊断其他运行时时可显式设置 DSH_CORDIS_MODULE 为可导入的 Cordis 模块地址。

问题与反馈：GitHub Issues。报告问题时请删除密钥、认证头、个人余额和会话内容。

License

MIT