前言¶

DSH 的理念是「一切皆插件」，開發者可以把常用能力以插件形式接入 DSH 會話環境。dsh-usage 是面向 DSH 的供應商用量查詢插件，用來即時查詢各 LLM 供應商的套餐/餘額用量，並在會話界面顯示用量讀數條。適合需要同時使用 Kimi、智譜、DeepSeek、火山方舟等多供應商 API 的開發者。

下面介紹它的功能、安裝、配置與注意項。

這是什麼¶

dsh-usage 由 heekei 維護，許可證爲 MIT。它是標準 bundle 型插件，聲明 dsh.bundle.patch，安裝到 DSH Web profile 後自動啓用。

它主要解決兩個問題：

• 把供應商套餐/餘額用量查詢集中到 DSH；
• 在會話界面和設置頁提供用量讀數與配置入口。

README 對用量讀數條位置存在「輸入框上方 / 輸入框下方」的描述不一致，本文不把它作爲固定位置描述。

核心功能¶

自動識別供應商¶

插件按 vendor base URL 自動識別 Kimi / 智譜 / DeepSeek / 火山方舟。新增同類供應商時，可零配置啓用用量查詢。

自定義查詢¶

對中轉站、自建服務或特殊接口，可配置：

• url
• method
• headers
• body
• extractor

查詢兼容 access token 與 access key/secret。extractor 是本地 JS 表達式（new Function），僅自己的配置可寫。

火山方舟 AK/SK¶

火山方舟支持控制面 AccessKeyId / SecretAccessKey（簽名 V4）。accessKeyId / secretAccessKey 爲 secret 字段，跨 wire 傳輸時被脫敏。

用量讀數條¶

插件顯示用量讀數條，顏色分級爲：

• 剩餘 ≥50%：綠
• 剩餘 ≥20%：橙
• 剩餘 <20%：紅

設置頁配置¶

設置頁提供「用量查詢」分節，可按供應商配置啓用/類型/展示名/憑據引用/自定義API/AK·SK，保存即熱加載生效。

數據接口與刷新¶

插件提供數據接口：

GET /api/dsh-usage.json

該接口與 DSH 同源，無需獨立端口。用量自動刷新，刷新間隔默認 5 分鐘。

默認規格¶

無 dsh-usage 分節時，使用內置默認規格（Kimi×2 / DeepSeek / GLM / 方舟×2）。

安裝與啓用¶

先確認 DSH Web 環境滿足插件依賴：

• peerDependencies：@deepseek-ai/schemastery ^3.18.1、react ^18.2.0
• engines：node >=18
• dsh.client.platform：web

使用 GitHub 地址安裝：

dsh plugin --profile web add github:heekei/dsh-usage

或使用 git 地址安裝：

dsh plugin --profile web add git+https://github.com/heekei/dsh-usage.git

插件聲明 dsh.bundle.patch，安裝後自動啓用。安裝完成後重啓 DSH Web 生效。

典型用法¶

在設置頁配置¶

進入：

設置 → 用量查詢

按供應商配置啓用/類型/展示名/憑據引用/自定義API/AK·SK，保存即生效。

在 settings.yaml 配置¶

可在 settings.yaml 的 dsh-usage.providers 下按供應商名配置，例如：

dsh-usage:
  providers:
    kimi-coding:
      # 內置 Kimi 查詢
    ark-coding-mine:
      # 火山方舟 AK/SK
    my-gateway:
      # 自定義 API
    glm-zk:
      # 顯式配置或關閉

配置裏只寫憑據引用，憑據統一放在：

~/.dsh/.credentials.yaml

配置刷新間隔¶

刷新間隔可在以下位置配置：

1、設置 → 用量查詢 → 用量刷新間隔
2、settings.yaml 的 dsh-usage.interval
3、環境變量 DSH_USAGE_INTERVAL_MS

默認刷新間隔爲 5 分鐘。

適用場景與注意¶

適合以下場景：

• 在 DSH Web 中使用多個供應商 API；
• 希望查看套餐/餘額用量，而不是頻繁打開供應商後臺；
• 需要把自定義網關/自建服務的用量納入 DSH 顯示。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• extractor 是本地 JS 表達式（new Function），只使用自己可信任的配置。
• accessKeyId / secretAccessKey 爲 secret 字段，跨 wire 傳輸時被脫敏。
• README 對用量讀數條位置存在上方/下方描述不一致，實際以安裝後界面爲準。

鏈接¶

GitHub：

https://github.com/heekei/dsh-usage

目錄頁線索（社區目錄，非官方應用商店）：

https://www.skillhub.cn/plugins/heekei/dsh-usage