前言¶

在 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