前言¶
在 DeepSeek Harness（DSH）里配置 Qwen 模型时，推理用的 API Key 只能调用接口，读不到 Token Plan 的套餐配额。想确认本月、5 小时或每周额度还剩多少，往往要单独打开 Qwen Cloud 控制台对照。社区插件 dsh-qwen-plan-usage（维护者 alvinlui-hk）把控制台返回的用量展示到 DSH Web UI 的 Settings → Models 页面底部，减少来回切换。
这是什么¶
dsh-qwen-plan-usage 是 DSH 社区目录中的「联网工具」类插件（目录页：skillhub.cn/plugins/alvinlui-hk/dsh-qwen-plan-usage）。它在 Harness 内显示 Qwen Cloud Token Plan 用量，且不依赖推理 API Key 去读配额。插件为非官方实现，与 Alibaba、Qwen、DeepSeek 无隶属关系；所调用的用量接口属于未公开的控制台 API，可能随时变更。
核心功能¶
安装并登录后，设置页会出现 Qwen Token Plan usage 卡片，展示 Qwen 实际返回的配额数据。README 说明：月配额、5 小时、每周等字段仅在接口返回对应项时才会显示。
登录方式与 API Key 不同：推理 Key 无法读取 Plan 配额，需在插件里选择 Sign in to Qwen Cloud。登录会打开专用的 Microsoft Edge 或 Google Chrome 窗口（不是日常浏览器），插件只读取 qwencloud.com 相关 Cookie，再向 Qwen 拉取用量。
环境与依赖¶
使用前请确认：
- DeepSeek Harness 0.2.1 或更高版本，且当前 profile 带 Web UI（README 在 DSH Desktop
0.2.1-rc.2/0.2.1-rc.3与 Windows Edge 上验证过）。 - 本机已安装 Edge 或 Chrome。
- 拥有带 Token Plan 的 Qwen Cloud 账号；仅有推理 API Key 不够。
安装与启用¶
在 DSH 会话中可让智能体安装该仓库，或在终端执行（需 git 在 PATH 上）：
dsh plugin --profile desktop add github:alvinlui-hk/dsh-qwen-plan-usage
若未安装 Git，可用 tarball，无需 Git：
dsh plugin --profile desktop add https://codeload.github.com/alvinlui-hk/dsh-qwen-plan-usage/tar.gz/refs/heads/main
若你常用 Web UI 的 profile，将 --profile desktop 换成 --profile web。
安装完成后重启 DeepSeek Harness。打开 Settings → Models，滚动到页面底部找到 Qwen Token Plan usage，点击 Sign in to Qwen Cloud 完成登录。
典型用法¶
1、按上一节命令把插件装进当前 profile，并重启 DSH。
2、进入 Settings → Models，在底部 Qwen Token Plan usage 区域选择登录 Qwen Cloud。
3、在专用浏览器窗口完成 Qwen Cloud 登录；关闭窗口后，卡片应显示当前 Token Plan 用量（具体字段以 Qwen 返回为准）。
也可在 DSH 对话中粘贴 README 提供的中文安装说明，由智能体代为安装（安装提示中要求不要代为登录或读取 Cookie/API Key，登录仍须你在设置页自行完成）。
隐私与安全¶
登录会话使用的浏览器 profile 位于 ~/.dsh/qwen-plan-usage/edge-profile，请勿对外分享该目录。登录窗口打开期间，调试器仅监听 127.0.0.1。Cookie 保存在 DSH 凭证记录 qwen-plan-usage/session 中，界面不会再次明文展示。登出会删除该凭证记录，不会删除你已配置的推理 API Key。更多说明见仓库 SECURITY.md。
适用场景与注意¶
适合在 DSH 里长期用 Qwen Cloud Token Plan、需要随时对照配额而不想反复打开控制台的开发者。插件以当前 DSH 进程权限运行，安装前建议阅读 GitHub 源码 与 MIT 许可证，自行评估风险。
DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，并非 DeepSeek 或幻方官方应用商店。用量展示依赖未文档化接口，若 Qwen 侧变更，插件可能需要更新后才能继续正常工作。
结尾¶
dsh-qwen-plan-usage 把 Qwen Cloud Token Plan 用量收敛到 Settings → Models 一页，弥补推理 API Key 无法反映套餐配额的问题。需要安装命令、隐私说明与 issue 跟踪时，可查阅目录页与仓库：
