前言¶

在 DeepSeek Harness（DSH）裏寫對話時，推理檔位往往藏在模型或會話配置裏，換模型還要重新找；不同 API 供應商的用量又各自在控制台或文檔裏查，和當前選中的 provider 對不上號。社區插件 dsh-usage-quota（維護者 s17765152890-gif）把 Codex 風格的思考強度（推理等級） 和 跟隨當前供應商的額度查詢 放到輸入框與底欄附近，無需改 DSH 自帶插件，兩個控件都以新增條目註冊進 Web UI 的既有插槽。分類爲「模型推理」，倉庫 s17765152890-gif/dsh-usage-quota，目錄頁見 SkillHub。

這是什麼¶

一句話：DSH 插件，在 Composer 區域提供推理等級膠囊與 provider 感知的用量/額度展示。依賴 DSH 客戶端的 modelDirectories 與插槽 conversation.composer.dock、conversation.input.right；宿主側依賴 webServer、connection、credentials。要求 DSH 0.2.0-rc.2 或更高（Web / 桌面端），Node 20.3+（宿主僅用 Node 內置模塊與 Web 標準 API）。當前 package 版本 1.0.1，許可證 MIT。

思考強度（Codex 風格）¶

模型選擇器右側新增一個小膠囊，直接顯示當前推理等級。點開後是一張緊湊卡片：

1. 大字顯示當前檔位：Low / Medium / High / Extra High / Ultra。
2. 分檔滑條與檔位標籤，鬆手即應用。
3. 右上角 ↺ 恢復模型默認強度。
4. 支持「關閉思考」的模型會多一個「關閉思考」按鈕；不支持關閉的模型（例如要求自適應思考的 Claude 系列）按鈕置灰並註明原因，而不是假裝可用。

檔位來自 DSH 模型目錄中的 reasoningEfforts，跟隨每個模型的能力，不做猜測。

額度查詢（自動跟隨當前供應商）¶

底欄顯示當前模型供應商的額度；切換供應商會自動換卡片；沒有額度接口的供應商直接不顯示。

OpenCode Go（內置）：展示 5 小時 / 每週 / 每月三個窗口的剩餘百分比；點開可見進度條，用量接近上限時數字變橙色，並顯示「幾小時後重置 / 幾天後重置」。默認零配置即可使用：宿主從憑據服務讀取 OPENCODE_GO_API_KEY（或同名環境變量）。

通用餘額（需配置）：對任意返回 balance、remaining 或 quota.remaining 的兼容 HTTPS（或本機迴環）接口，顯示餘額與當日消費。

密鑰只由 DSH 宿主進程讀取，絕不進入頁面腳本；接口調用都發生在宿主側。瀏覽器側通過同源、經 DSH 連接鑑權的 GET /x-usage?provider=<id> 獲取額度數字；未登錄請求會被拒絕。插件不含遙測、上報或第三方統計。

安裝與啓用¶

要求 DSH 0.2.0-rc.2 或更高。

方式 A：作爲 bundle 安裝（推薦）¶

下面命令來自倉庫 README，將 <本倉庫的絕對路徑或已發佈的包名> 換成實際路徑或包名：

plugin_manager action=install_bundle target=<本倉庫的絕對路徑或已發佈的包名>

安裝後會在當前 profile 裏插入一行 usage-quota。這是標準 DSH bundle：package.json 聲明 dsh.bundle.patch 與 dsh.client，並導出 locale/*.json（meta.title / meta.description）與 icon.svg，在「插件」頁顯示爲 用量與思考強度 及對應圖標，而不是裸路徑行。

方式 B：手動加入 profile 的 cordis.patch.yml¶

- insert:
    - id: usage-quota
      name: file:///<本倉庫絕對路徑>/lib/index.js

路徑中的空格與中文需按 URL 編碼規則處理。改完無需重啓，DSH 會熱加載配置。

配置¶

除 OpenCode Go 默認可用外，可在插件自己的 cordis.patch.yml 對應行上追加 config：

- insert:
    - id: usage-quota
      name: dsh-usage-quota
      config:
        refreshSeconds: 60
        providers:
          my-relay:
            kind: balance
            label: My Relay
            endpoint: https://relay.example.com/v1/usage
            apiKeyRef: MY_RELAY_API_KEY

加載時會校驗配置：未知 kind、缺少 endpoint、非 HTTPS 的遠程地址、非法憑據引用名會直接報錯，而不是運行期靜默失敗。刷新間隔偏好寫在 $DSH_HOME/dsh-usage-quota.json，不寫進安裝包目錄。

典型用法¶

1. 安裝 bundle 或手動插入 profile 後，在 Web UI 打開對話 Composer。
2. 在模型選擇器右側點擊推理等級膠囊，用滑條切換 Low～Ultra 或恢復默認；若模型支持，使用「關閉思考」。
3. 選用帶額度能力的 provider（如 OpenCode Go 或已配置的 balance 接口）：底欄自動顯示對應卡片，點擊可查看進度與重置時間。
4. 需要自定義中轉用量時，在 config.providers 裏按 provider id 配置 kind: balance 與 endpoint、apiKeyRef。

適用場景與注意¶

適合經常在 DSH 裏切換模型與供應商、希望在輸入區附近統一控推理強度並一眼看剩餘額度的開發者。插件以當前 DSH 進程權限運行，安裝前應閱讀 GitHub 源碼 與 MIT 許可證，自行確認憑據引用與遠程 endpoint 是否符合你的安全策略。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-usage-quota 把推理檔位和 provider 額度收進 Composer dock，不改核心插件、默認即可對接 OpenCode Go，擴展餘額接口也可配置。進一步瞭解與安裝見 目錄頁 與 GitHub 倉庫。