dsh-plan-usage

dsh-plan-usage

在 DeepSeek Harness 的 Web 对话框右下角显示套餐用量角标，持续展示每个套餐的三个用量窗口：

• 5小时（滚动窗口）
• 周限
• 月限

当前支持四个套餐（渠道）：OpenCode Go（5小时 $12 滚动 / 周 $30 / 月 $60）、GLM Z.AI（GLM Coding Plan 国际版）、GLM 智谱（GLM Coding Plan 国内版，5小时 token 窗口 / 周 token 窗口 / 月 MCP 工具额度）与 Kimi Code（Kimi 会员套餐额度：5小时频限窗口 / 7 天周限；月度会员额度可经可选的 kimi-auth Cookie 增强）。

胶囊为多行样式：每个套餐一行，依次列出 5小时/周限/月限 三个窗口的百分比（缺失的窗口按 0% 计，如 Z.AI 套餐无周限、Kimi Code 未配 Cookie 时无月限）；每行前一颗状态圆点按该套餐最差窗口分级（ 用量角标**：该套餐的开关，关闭后该套餐不再取数、不再显示。

• \ API Key（可选）：该套餐专用的 API Key 输入框（write-only 密钥，只显示「已配置 / 未配置」，可一键清除）。
• Kimi Code kimi-auth Cookie（可选）：Kimi 专属，用于增强显示月度会员额度（见下方 Kimi 说明）。

每个套餐的 API Key 解析优先级相同：

1. 插件配置卡片里填入的该套餐 API Key（最高）；
2. 进程环境变量（同名凭据名，只读）；
3. 「设置 → 模型」里保存的该套餐凭据（$DSH_HOME/.credentials.yaml）；
4. 项目 .env / $DSH_HOME/.env 中的同名条目（回退）。

凭据名如下（OpenCode Go：OPENCODE_GO_API_KEY / OPENCODE_API_KEY；GLM Z.AI：ZAI_API_KEY / Z_AI_API_KEY / GLM_ZAI_API_KEY；GLM 智谱：ZHIPU_API_KEY / ZHIPUAI_API_KEY / GLM_API_KEY / BIGMODEL_API_KEY；Kimi Code：KIMI_CODE_API_KEY / KIMI_API_KEY；Kimi Cookie：KIMI_AUTH_TOKEN），在第 2–4 层都生效。

注意：进程环境变量优先于凭据库。若启动 harness 的进程环境里已有同名变量，「设置 → 模型」保存该凭据会被拒绝（该凭据名由启动环境提供、只读）；插件配置卡片不受影响（它永远是最高优先级）。

卡片里的 Key 留空时回退到上面的 2/3/4；如果全都没设置，该套餐在胶囊与面板中会提示配置。

GLM 说明

GLM 有两个渠道，各自独立开关与 API Key：

• GLM Z.AI（国际版）：https://api.z.ai/api/monitor/usage/quota/limit
• GLM 智谱（国内版）：https://open.bigmodel.cn/api/monitor/usage/quota/limit

两者都来自 GLM Coding Plan 的 monitor 接口（配额端点不需要查询参数，Authorization 头直接携带 Key、不带 Bearer 前缀），响应结构相同（TOKENS_LIMIT(3,5) → 5小时、(6,1) → 周限、TIME_LIMIT → 月限，另有套餐等级 level）。v0.2 里旧键 glmEnabled / glmApiKey 归为 Z.AI 渠道（v0.2 单个 GLM 入口实测为国际版 Key）。

「设置 → 模型」里的 GLM 提供方路由若使用 llm-pi-ai 自定义提供方（如 providers: { 'z-ai': { apiKeyEnv: ZAI_API_KEY, … } }、providers: { zhipu: { apiKeyEnv: ZHIPU_API_KEY, … } }），模型页保存的 Key 即写入对应凭据名，插件会自动识别。

Kimi 说明

Kimi Code 套餐（Kimi 会员权益）的用量接口是官方支持的：

• 用量端点：GET https://api.kimi.com/coding/v1/usages（Bearer 鉴权），返回 7 天周限（usage，订阅日起每 7 天刷新、不累积）、5 小时频限窗口（limits[] 中 300 分钟窗口）与会员等级（user.membership.level）。
• API Key 需要在 Kimi Code 控制台（https://www.kimi.com/code/console）创建，格式 sk-kimi-xxx。注意区分：Kimi 开放平台（platform.kimi.com / api.moonshot.cn）的 sk-xxx 按量付费 Key 不通用，两者 Base URL 与计费方式都不同。

月度会员额度（可选增强）：Kimi 会员订阅的月总额度不在上面的官方接口里，需要 kimi-auth 网页会话 Cookie（浏览器开发者工具 → Application → Cookies → www.kimi.com → 复制 kimi-auth 值，是 JWT）。在配置卡片填入（或导出环境变量 KIMI_AUTH_TOKEN）后，插件会调用网页端 MembershipService/GetSubscriptionStats 接口显示月限窗口。注意：

• 该接口是逆向的、非官方，可能随时变更；获取失败只影响月限一行，不影响周限 / 5 小时。
• Cookie 会过期，过期后在面板中会提示「月度会员额度获取失败」。
• 所有登录设备与 API Key 共享同一套额度：CLI、VS Code、第三方工具与网页端消耗的都是同一个账户的额度。