dsh-provider-usage

A DSH web plugin that shows the live usage/quota of every configured LLM model provider in a small bubble at the bottom-right of the page. The bubble shows a minimal summary (the worst usage percent, color-coded) and expands into per-provider detail on hover — percent bars per usage window, reset times, numeric values, and a refresh button. Styling follows the app theme, times are rendered in device-local time (resets as month+day), and text follows the app language (zh / en).

一个 DSH Web 插件：在页面右下角以小气泡展示所有已配置模型提供商的实时用量/配额。气泡默认精简显示（最差窗口百分比，按状态着色），悬浮展开每个提供商的详情（各用量窗口百分比条、重置时间、数值与刷新按钮）。样式跟随应用主题，时间按设备本地时区显示（重置时间只显示月日），文字跟随系统语言（中/英）。

Features / 功能

Bottom-right bubble / 右下角小气泡：精简显示 + 悬浮详情（shell.overlay）；悬浮容器覆盖气泡与浮层，鼠标可自由移入。
Theme-aware / 跟随主题：使用 --dsw-alias-* 设计令牌着色，亮/暗主题自动适配。
Local times / 本地时间：更新于 显示设备本地完整时间；窗口 重置 只显示本地月日。
Auto-discovery / 自动发现提供商：从 llm-pi-ai / llm-deepseek 设置枚举；内置 OpenCodeGo（/v1/usage，rolling/weekly/monthly 百分比 + 重置时间）、OpenRouter（/auth/key）、OpenAI（billing subscription + usage）、DeepSeek（/user/balance）；未知提供商自动探测 /usage、/user/balance、/dashboard/billing/subscription。
Update policy / 更新策略（可配置，含默认值）：
- on-request（默认）：用户发起请求时更新（宿主监听 session/event 计数）；
- steps：每隔 N 个消息步更新（N 可配，默认 1）；
- interval：固定间隔（10–3600 秒，默认 60）；
- reset：最早用量窗口重置后更新（智能调度）；
- hover：仅查看/手动刷新。
Settings page / 设置页（settings.section）：选择策略与参数，更改立即生效。
i18n：通过 locale 服务注册 provider-usage 命名空间词典（zh/en）。
Model tool：注册 provider_usage 工具，对话中可直接询问用量。

Install / 安装

一键安装（推荐）

包内自带安装脚本（本地源码构建 → 打包 → 官方 CLI 安装 → bundle 自动注册）：

Windows（PowerShell 5.1 / pwsh）：

powershell -ExecutionPolicy Bypass -File scripts\install.ps1            # 默认 web profile
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -Restart   # 装完自动 pm2 重启
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -DryRun    # 只预览

macOS / Linux（bash）：

./scripts/install.sh
./scripts/install.sh -r          # 装完尝试 pm2 restart

脚本会自动：检出并构建缺失的 lib/ → pnpm pack → dsh plugin --profile web add → 校验 dsh.profile.bundles 已包含 dsh-provider-usage。

已发布版本（registry）

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

## Configuration / 配置

Composition defaults (overridable in the profile's `cordis.patch.yml` row or
through the in-app settings page; in-app changes win for the plugin lifetime):

```yaml
- id: provider-usage
  name: 'dsh-provider-usage'
  config:
    updatePolicy: on-request   # on-request | steps | interval | reset | hover
    updateIntervalSeconds: 60  # used by the interval policy
    updateEverySteps: 1        # used by the steps policy

dsh-provider-usage

同名包的其他仓库

安装

说明文档