前言¶
在 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：
