前言¶
使用 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
