前言¶

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