前言¶

在 DSH 中配置多個模型提供商後，用量、配額和窗口重置時間往往分散在不同提供商的控制檯裏。開發或調試時，如果每次都要切到外部頁面查看餘額和額度，會打斷當前工作流。

dsh-provider-usage 是一個 DSH Web 插件：在頁面右下角以小氣泡展示所有已配置模型提供商的即時用量/配額。氣泡支持懸浮展開提供商詳情，跟隨應用主題，顯示設備本地時間，並可在對話中通過 provider_usage 工具查詢用量。

這是什麼¶

dsh-provider-usage 由 Lwc-LiuWenCheng 維護，許可證爲 MIT。

它解決的問題是：在 DSH Web 頁面內直接查看已配置模型提供商的用量/配額，減少跳轉外部控制檯的步驟。插件當前 package.json 聲明版本爲 0.2.2，engines 要求 node >=20。

核心功能¶

右下角氣泡¶

• 在頁面右下角以小氣泡顯示精簡用量。
• 支持懸浮展開提供商詳情。
• 跟隨應用主題，使用設計令牌着色，亮/暗主題自動適配。
• 顯示設備本地時間；窗口重置時間只顯示月日。

提供商發現¶

插件自動發現提供商，支持 OpenCodeGo、OpenRouter、OpenAI、DeepSeek，並自動探測未知提供商。

更新策略¶

插件支持可配置的更新策略：

on-request
steps
interval
reset
hover

其中，on-request 和每 N 個步驟的策略不直接輪詢提供商 API，而是基於 session/event 中的消息事件計數。

設置與工具¶

• 提供設置頁，可選擇策略與參數，更改立即生效。
• 通過 locale 服務註冊 provider-usage 命名空間詞典，支持 zh / en。
• 註冊 provider_usage 模型工具，可在對話中直接查詢用量。

安裝與啓用¶

如果使用已發佈版本，可執行：

dsh plugin --profile web add dsh-provider-usage@latest

如果從本地源碼安裝，可使用倉庫提供的安裝腳本。

Windows PowerShell：

powershell -ExecutionPolicy Bypass -File scripts\install.ps1

macOS / Linux：

./scripts/install.sh

安裝後需重啓 DSH，使新的 bundle 層生效。若同一會話仍在運行動態開發副本，重啓前可能出現兩個氣泡；重啓後動態副本消失。

配置¶

可在 profile 的 cordis.patch.yml 配置行中覆蓋參數，也可以在應用內設置頁中修改：

- id: provider-usage
  name: 'dsh-provider-usage'
  config:
    updatePolicy: on-request   # on-request | steps | interval | reset | hover
    updateIntervalSeconds: 60
    updateEverySteps: 1

其中：

• updatePolicy：選擇更新策略。
• updateIntervalSeconds：用於間隔類參數。
• updateEverySteps：用於按步驟計數策略。

典型用法¶

1、安裝插件。

dsh plugin --profile web add dsh-provider-usage@latest

2、重啓 DSH。

3、在頁面右下角查看用量氣泡，鼠標移入氣泡查看提供商詳情。

4、在應用內設置頁選擇 updatePolicy、updateIntervalSeconds、updateEverySteps 等參數。

5、在對話中使用 provider_usage 工具查詢用量。

適用場景與注意¶

適合在 DSH 中維護多個模型提供商、需要在界面內快速查看用量/配額的開發者或運維人員。

使用前需要注意：

• 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
• Provider keys 按查詢通過 credentials service 解析。
• node -e helper 在調用會話的沙箱策略下運行。
• pwsh-local executor 將命令字符串傳給 pwsh -Command 時僅使用單引號。
• package.json 聲明的依賴約束如下：

node >=20

peerDependencies:
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-llm ^0.1.0-rc.6
@deepseek-ai/dsh-settings ^0.1.0-rc.6
@deepseek-ai/dsh-tools ^0.1.0-rc.6
react ^18.2.0

結尾¶

dsh-provider-usage 把提供商用量聚合到 DSH 頁面內，減少跳轉控制檯的步驟，也方便在對話中直接查詢用量。

倉庫地址：

https://github.com/Lwc-LiuWenCheng/dsh-provider-usage