前言¶
在 DeepSeek Harness（DSH）里接 Qwen、Z.ai GLM、MiniMax 等 Coding Plan 做开发时，配额往往分散在各厂商控制台或网页里，很难在写 agent 的同一套环境里一眼看清「本月 / 本周 / 会话」还剩多少。dsh-coding-plan-usage 是社区维护的客户端插件，把三类 Coding Plan 的用量以卡片形式放进 Settings → Models 页面底部，减少来回切换后台的次数。
下面介绍插件定位、能力、安装方式与使用时的认证与隐私注意点。事实依据为 GitHub 仓库 README 与 npm 包 @alvinlui-hk/dsh-coding-plan-usage（当前资料版本 1.1.0）。
这是什么¶
alvinlui-hk/dsh-coding-plan-usage 由维护者 alvinlui-hk 发布，分类为 客户端 插件。简介与仓库一致：在 DeepSeek Harness 中展示 Qwen Token Plan、Z.ai GLM Coding Plan、MiniMax Coding Plan 的用量。
这是非官方插件，与 Alibaba/Qwen、Z.ai（智谱）、MiniMax 或 DeepSeek 均无隶属关系；各厂商用量接口为未公开文档的提供商 API，可能随时变更。
核心功能¶
安装并重启 DSH 后，在带 Web UI 的配置档中打开 Settings → Models，页面底部会出现三张卡片：
- Qwen Token Plan — 展示 Qwen 返回的月度、5 小时或周配额（以接口实际返回为准）。
- Z.ai GLM Coding Plan — 会话（5h）、周 Token 用量、联网搜索次数。
- MiniMax Coding Plan — 会话与周 prompt 用量。
插件通过 cordis.patch.yml 注入 DSH 客户端，依赖 @deepseek-ai/dsh-client-ui-settings-models 与 @deepseek-ai/dsh-client-locale，在 Web 平台即时加载（immediately: true）。
各提供商如何认证¶
不同厂商凭证来源不同，使用前可先确认 DSH 里是否已配好对应模型提供商。
Z.ai 与 MiniMax 使用提供商 API Key。若已在 DSH 中配置 zai / minimax 模型提供商，插件会从 DSH 凭证库自动读取 ZAI_API_KEY / MINIMAX_API_KEY，无需再粘贴。否则每张卡片提供本地粘贴框，密钥保存在本机。
Qwen 不能使用推理用 API Key 查配额。点击登录会打开专用的 Edge/Chrome 窗口（非日常浏览器），在 Qwen Cloud 登录后，插件仅读取 qwencloud.com 相关 cookie，然后关闭窗口。
安装与启用¶
要求 DeepSeek Harness 0.2.1 或更高版本，且使用带 Web UI 的 profile；README 注明已在 0.2.1-rc.2、0.2.1-rc.3、0.2.2-rc.1 上验证。Z.ai / MiniMax 需有对应 Coding Plan 及 API Key；Qwen 需有 Qwen Cloud Token Plan，并安装 Microsoft Edge 或 Google Chrome 以供登录窗口使用。
从 npm 安装（一键，会出现在应用内 Plugin Center）：
dsh plugin --profile desktop add @alvinlui-hk/dsh-coding-plan-usage
从 GitHub 安装（需在 PATH 中有 git）：
dsh plugin --profile desktop add github:alvinlui-hk/dsh-coding-plan-usage
无 Git 时可用 tarball：
dsh plugin --profile desktop add https://codeload.github.com/alvinlui-hk/dsh-coding-plan-usage/tar.gz/refs/heads/main
若实际使用 Web UI 的是 web profile，将上述命令中的 --profile desktop 换成 --profile web。安装完成后重启 DeepSeek Harness，再打开 Settings → Models 查看卡片。
典型用法¶
- 按上一节任选一种方式安装插件并重启 DSH。
- 进入 Settings → Models，滚动至页面底部。
- 对 Z.ai、MiniMax：确保 DSH 凭证库已有 API Key，或在卡片粘贴框中填入并本地保存。
- 对 Qwen：在卡片触发登录，于弹出浏览器完成 Qwen Cloud 登录；用量刷新后即可在卡片上看到配额信息。
无需额外配置文件名或环境变量列表出现在 README 中；密钥与 cookie 的处理策略见仓库 SECURITY.md（摘要：密钥留在本地 DSH 凭证库，请求仅发往各提供商自有 API；Qwen 调试监听 127.0.0.1 且拒绝浏览器来源；登出会删除本地记录）。
适用场景与注意¶
适合谁： 同时在 DSH 中使用 Qwen Token Plan、Z.ai GLM Coding Plan 或 MiniMax Coding Plan，希望在模型设置页集中查看用量的开发者。
使用注意：
- 插件在当前 DSH 进程权限下运行，安装前宜查阅源码与 MIT 许可证，确认符合你的安全与合规要求。
- 用量数据依赖各厂商未文档化接口，字段与可用性可能变化，卡片展示以实时 API 响应为准。
- DSH 生态主张「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系，勿等同于官方应用商店。
结尾¶
dsh-coding-plan-usage 把三类主流 Coding Plan 配额收拢到 DSH Settings → Models 底部，认证上尽量复用已有 API Key，Qwen 则通过隔离浏览器会话读取 cloud cookie。需要安装命令、隐私说明或 issue 时，可查目录页与 GitHub：
