前言¶
使用 DSH 时，如果同时配置了多个套餐渠道，额度窗口往往分散在不同服务里。dsh-plan-usage 是一个 DSH 插件，把 OpenCode Go、GLM Z.AI、GLM 智谱与 Kimi Code 的 5小时、周限、月限 窗口集中显示在 Web 对话框右下角，减少手动切换控制台的步骤。
插件定位¶
dsh-plan-usage 由 chendefine 提供，许可证为 MIT。它安装到 DSH 后，在 Web 对话框右下角显示套餐用量角标，并在「设置 → 插件 → 插件配置」中提供「套餐用量」配置卡片。
核心能力¶
- 在 Web 对话框右下角显示套餐用量角标。
- 持续展示每个套餐的
5小时、周限、月限三个用量窗口。 - 当前支持四个套餐（渠道）：OpenCode Go、GLM Z.AI、GLM 智谱、Kimi Code。
- 角标为多行样式：每个套餐一行，依次列出
5小时/周限/月限百分比；缺失窗口按0%计。 - 每行前状态圆点按该套餐最差窗口分级：
<50%绿、50–89%黄、≥90%红。 - 点击角标展开面板，按套餐分区展示进度条与重置倒计时，并每 60 秒自动刷新。
- 在「设置 → 插件 → 插件配置」中出现「套餐用量」卡片，提供全局开关、各套餐开关、API Key 输入框与 Kimi Code
kimi-authCookie 输入。 - API Key 解析优先级为：插件配置卡片 > 进程环境变量 > 「设置 → 模型」凭据库 > 项目
.env或$DSH_HOME下的.env。 - 支持 GLM Z.AI 国际版与 GLM 智谱国内版对应的
monitor接口。 - 支持 Kimi Code 官方
/usages接口，并可用kimi-authCookie 增强月度会员额度。 - 纯 JS、零构建；GitHub 源码安装不需要在
pnpm-workspace.yaml配置allowBuilds。 - 安装本插件无需修改 harness 源码；密钥
write-only，接口响应不回传密钥值。
安装¶
从 GitHub 源码安装到 web profile：
dsh plugin --profile web add "github:chendefine/dsh-plugins-plan-usage"
如果希望使用 npm 包并锁定版本，也可以使用：
dsh plugin --profile web add dsh-plan-usage@0.2.1
安装后检查配置层：
dsh --profile web --dump-config
确认输出中出现了 # == dsh-plan-usage 层后，启动 Web：
dsh web
如果是在源码目录中调试，也可以用 patch 方式启动：
dsh web --patch ./cordis.patch.yml
启用与配置¶
打开「设置 → 插件 → 插件配置」，找到「套餐用量」卡片，通常先做三件事：
- 打开「启用套餐用量角标」全局开关。
- 打开需要显示的套餐开关。
- 为对应套餐填写 API Key；如需要 Kimi Code 月度会员额度，再填写
kimi-authCookie。
API Key 的放置位置可以是：
- 插件配置卡片；
- 进程环境变量；
- 「设置 → 模型」凭据库；
- 项目
.env或$DSH_HOME下的.env。
其中插件配置卡片优先级最高。如果所有渠道都未配置可用 Key，角标和面板中会提示配置。
套餐说明¶
- OpenCode Go：作为独立套餐渠道显示
5小时、周限、月限窗口；缺失窗口按0%计。 - GLM Z.AI：国际版渠道，使用
monitor接口取数。 - GLM 智谱：国内版渠道，使用
monitor接口取数；与 GLM Z.AI 独立配置。 - Kimi Code：使用官方
/usages接口；kimi-authCookie 仅用于增强月度会员额度。
Kimi Code 注意¶
- Kimi Code 的
sk-kimi-xxxKey 与 Kimi 开放平台的sk-xxx按量付费 Key 不通用。 kimi-authCookie 对应的月度会员额度接口是逆向的、非官方接口，可能随时变更。- 获取失败只影响月限一行，不影响
周限和5小时窗口。 - Cookie 会过期，过期后面板会提示「月度会员额度获取失败」。
- 所有登录设备与 API Key 共享同一套额度。
环境变量与密钥注意¶
进程环境变量优先于「设置 → 模型」凭据库。如果启动 harness 的进程环境里已有同名变量，模型页保存该凭据会被拒绝；插件配置卡片中的 Key 优先级最高，不受凭据库保存限制。
密钥一律 write-only：接口响应不会回传密钥值，浏览器侧只能看到「已配置 / 未配置」。
适用场景与安装检查¶
适合同时使用 OpenCode Go、GLM Z.AI、GLM 智谱或 Kimi Code，并希望在不离开 DSH Web 对话框的情况下查看额度窗口的开发者。使用前需要一个可用的套餐 API Key。
作为 DSH 插件，它会随当前 dsh 进程权限运行。安装前建议检查源码与 MIT 许可证。
相关资源¶
GitHub 仓库：
https://github.com/chendefine/dsh-plugins-plan-usage
