前言¶

用 Command Code 跑模型時，很多人會反覆打開官網，確認本月剩餘額度、5 小時窗口用了多少、本週窗口還剩多少。人在 DSH 裏寫 agent、調插件，卻要把注意力切到瀏覽器另一頁，既打斷節奏，也不容易和本地會話狀態對照。

DeepSeek Harness（DSH）支持用插件擴展界面與後臺能力。@yumiku/dsh-commandcode-quota（倉庫 miko-cn/dsh-commandcode-quota）把 Command Code 的用量信息搬進 DSH：設置頁裏集中展示，桌面還可掛一個可拖動的浮窗膠囊。維護者爲 miko-cn，分類爲客戶端插件，依賴 DSH ≥0.2.0，MIT 許可。

下面介紹插件做什麼、如何安裝，以及面板裏各數字的含義。

這是什麼¶

插件全稱在 npm 上爲 @yumiku/dsh-commandcode-quota（當前 package 版本 1.1.1）。它不改變 Command Code 的計費規則，只做數據看板：通過 DSH 後臺用 API key 調用 Command Code 內部接口（與 cmd CLI 的 /usage 同源），把額度、兩道限速窗口、本期請求彙總整理後展示在 Web UI。

核心入口有兩處：

• 設置 → Command Code：額度、窗口、本期請求、套餐檔位、API key 編輯；
• 浮窗膠囊：雙行進度條與倒計時，點擊展開完整面板，可拖到屏幕任意位置。

未配置 key 時，若你已 cmd login、或 DSH 本身以 Command Code 爲模型供應商，插件會嘗試自動複用憑據，多數情況不必再填一次 key。

核心功能¶

套餐額度¶

面板顯示「剩餘 / 總額度 credits」、已用百分比，以及本期起止時間與距離續費剩餘時間（例如「本期 11/3 – 12/3 · 還剩 25 天 1 小時」）。月額度按計費週期重置、不結轉；額外購買或贈送額度會單獨列出。

5 小時與每週窗口¶

除月額度外，Command Code 還有兩道限速：任意連續 5 小時內、任意連續 7 天內可消耗的 credits 上限。窗口從第一筆請求開始滾動計時，而非按自然日重置。浮窗與面板上的兩行進度條對應這兩道窗口，右側爲實時倒計時（例如 3h 12m 45s、2d 3h 12m）。

本期請求¶

按計費週期統計請求數、成功率、花費、輸入與輸出 token。打開面板時強制刷新一次，之後約每分鐘自動更新；底部會顯示「更新於 X 秒前」。

套餐檔位¶

插件會識別 Go / GOAT / Pro / Max / Ultra / Teams Pro 等檔位，窗口上限以 Command Code 返回爲準。設置頁可手動切換檔位，僅影響顯示與換算，不會改動訂閱。

浮窗行爲¶

位置可拖動並會記住；啓動時先顯示骨架再加載數據；從其他窗口切回 DSH 時會自動刷新。可在設置中關閉「顯示桌面浮窗」。界面文案跟隨 DSH 語言設置（中 / 英）。

安裝與啓用¶

DSH 要求本機已安裝可用 profile。安裝命令以 README 爲準：

dsh plugin --profile <profile> add @yumiku/dsh-commandcode-quota

也可以在 DSH 會話裏讓 agent 通過 plugin_manager 的 install_bundle 安裝同名包 @yumiku/dsh-commandcode-quota。

其他方式（可選）：

• GitHub Release 預構建包：https://github.com/miko-cn/dsh-commandcode-quota/releases/latest/download/dsh-commandcode-quota.tgz
• 若啓用自定義插件索引，可將 https://raw.githubusercontent.com/miko-cn/dsh-commandcode-quota/main/market/index.json 加入 Plugins → Discover → Manage index sources，再在 Discover 中搜索安裝。

安裝後刷新 DSH 頁面。設置中會出現「Command Code」；默認會在桌面右下角出現浮窗膠囊。

API key¶

若無法自動找到憑據：設置 → Command Code → API key，粘貼 Command Code API key 並保存。key 只寫入 DSH 憑據庫，不寫配置文件，也不會把 key 本身發給瀏覽器頁面。

查找順序（摘要）：設置頁保存的 key（優先於環境變量）→ 環境變量 COMMAND_CODE_API_KEY（可在配置裏用 apiKeyEnv 改名）→ COMMANDCODE_API_KEY、COMMAND_API_KEY → ~/.commandcode/auth.json → ~/.dsh/.credentials.yaml。

典型用法與配置¶

日常無需改配置。需要調整刷新間隔、超時或 API 基址時，可在 profile 的 cordis.patch.yml 中增加：

- id: commandcode-quota
  name: '@yumiku/dsh-commandcode-quota'
  config:
    apiKey: ''                 # 留空則自動查找；推薦用設置頁寫入憑據庫
    apiKeyEnv: COMMAND_CODE_API_KEY
    apiBase: https://api.commandcode.ai
    planOverride: ''           # 默認檔位，頁面上的手動選擇優先生效
    cacheMs: 45000             # 後臺緩存時長（打開面板時會強制刷新）
    timeoutMs: 12000

浮窗後臺默認約每 5 分鐘拉取一次（設置裏可調 1–10 分鐘）；頁面不可見時不請求。每輪會調用 Command Code 的 4 個接口。同源路由包括：

適用場景與注意¶

適合誰：長期在 DSH 裏用 Command Code 作模型或工具鏈，希望在本機一眼看到 credits 與兩道窗口，而不反覆登錄官網的用戶。

運行方式：插件以當前 DSH 進程權限運行，安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認與自身環境一致。插件與 Command Code 官方無隸屬關係；/alpha/* 爲 CLI 內部接口，字段缺失時面板會降級顯示而非直接報錯。逐條請求明細僅存在於需要網頁 cookie 的 Studio 會話接口，API key 無法獲取，故面板只做本期彙總。

常見問題：數字與官網可能有幾分鐘偏差，可點擊刷新或重開面板；浮窗消失時在設置中重新打開「顯示桌面浮窗」。1.0.2 曾出現 Failed to load plugins（客戶端未聲明 inject），1.0.4 起已修復，宜保持 npm 最新版。

結尾¶

經過上面的步驟，你可以在 DSH 內完成 Command Code 額度與窗口的日常盯盤，並把 API key 留在後臺憑據庫。社區目錄頁：skillhub.cn/plugins/miko-cn/dsh-commandcode-quota；源碼與說明：github.com/miko-cn/dsh-commandcode-quota。