dsh-quota-panel DSH 插件

该插件为每个配置的 provider 注册一个服务端代理路由，通过凭据接缝解析 API 密钥，不暴露给浏览器。它注入一个 Harness 原生状态小部件（右下角），以折叠胶囊（精简状态点+数值）或展开卡片（带进度条的完整信息）显示配额/余额信息，并支持自动刷新。

ui-productivity

如何安装 dsh-quota-panel DSH 插件

dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-quota-panel

复制不会执行命令。安装 dsh-quota-panel DSH 插件前请核对仓库和版本。

dsh-quota-panel DSH 插件数据来源

dsh-quota-panel DSH 插件快照日期：2026年8月16日

discovered

dsh-quota-panel DSH 插件能做什么

为每个 provider 注册服务端代理路由 `/api/quota/<id>`，API 密钥仅保留在服务端。
注入两种尺寸的 Harness 原生小部件：折叠胶囊（每个账户的状态点+数值）和展开卡片（带进度条的结构化行）。
以可配置的时间间隔（默认 60 秒）自动刷新数据，页面隐藏时暂停刷新。
使用 Harness 设计令牌（`--dsw-alias-*`、`--dsw-static-*` 等），跟随产品主题（浅色/深色），无需自定义调色板。
支持两种内置渲染格式：`deepseek-balance`（余额显示与层级）和 `opencode-usage`（使用百分比与进度条）。
可针对每个 provider 配置刷新间隔、余额层级、使用量警告/错误阈值和自定义标签。

dsh-quota-panel DSH 插件适合哪些场景

在 DSH 网页界面直接监控 DeepSeek 账户余额和充值状态。
跟踪 OpenCode 使用配额（滚动、周、月），并查看可视化进度条。
在不离开页面的情况下，通过紧凑胶囊快速查看多个 provider 的配额/余额状态。
通过颜色编码的状态点（绿/黄/红）了解 provider 余额不足或使用量过高的情况。
通过 DSH 凭据接缝集中管理 API 密钥，避免暴露给浏览器。

dsh-quota-panel DSH 插件适合谁

使用 DSH 且需要监控 API provider 配额和余额的开发者。
管理多个 DeepSeek 或 OpenCode 账户并希望统一查看状态的团队。

dsh-quota-panel DSH 插件的限制

仅适用于 DSH 网页界面（需要运行 `dsh web`）。
目前仅支持两种渲染格式：`deepseek-balance` 和 `opencode-usage`；其他配额 API 需要自定义配置或未来添加格式。
每个 provider 必须手动配置其凭据引用和端点 URL。
小部件注入到页面中，如果 DSH 网页界面被修改或存在布局冲突，可能无法正常显示。

dsh-quota-panel DSH 插件的仓库 README 摘录

以下文字摘自 dsh-quota-panel DSH 插件的上游仓库 brittanistrehlowll-oss/dsh-quota-panel 的 README，版权归原作者，仅作引用。

English | [中文](README.zh.md) Provider quota / balance status widget for the **dsh web surface** (DeepSeek Harness). A zero-dependency host plugin: for every configured provider it registers one server-side proxy route `/api/quota/<id>` — the API key is resolved through the credentials seam and **never reaches the browser** — then injects a small Harness-native status widget (bottom-right) with two sizes: - **Collapsed (default)** — a minimal glanceable capsule: one independent "status dot + value" pair per account (e.g. `● ¥58.36 · ● 45%`), no text labels — only the affected account's dot changes color. Click to expand. - **Expanded** — the full card: "模型额度" header with refresh/collapse buttons, then one structured row per provider (status dot, name, primary value, secondary line, progress bar for usage-style providers). The collapse button shrinks it back. Both sizes auto-refresh (paused while the page is hidden; the refresh button spins while a manual refresh runs and re-entrant clicks are ignored). In the capsule, usage percentages are battery-colored (green when healthy, amber when tight, red when critical), matching their independent dot; balance values are tint

阅读完整 README仓库许可: MIT

dsh-quota-panel DSH 插件常见问题

如何安装 dsh-quota-panel？

运行 `dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-quota-panel"`，然后重启 `dsh web`。插件会自动作为配置文件层激活。

如何配置一个新的 provider？

编辑你的配置文件 `cordis.patch.yml`，在 `providers` 下添加一个条目，包含必要字段：`id`、`label`、`credential`、`endpoint` 和 `format`。具体示例请参考 README 中的配置章节。

可以同时监控多个 provider 吗？

可以。你可以在配置中 `providers` 下添加多个条目。每个 provider 都会在展开卡片中显示为单独的一行，折叠胶囊则会用独立的状态点显示所有账户的状况。

插件会暴露我的 API 密钥吗？

不会。API 密钥在服务端通过 `ctx.credentials` 解析，浏览器只与 DSH 服务器上的 `/api/quota/<id>` 通信。响应中不包含原始密钥。

安装后小部件没有出现，应该检查什么？

确保添加插件后已重启 `dsh web`。同时检查 `cordis.patch.yml` 中插件配置是否正确，以及 provider 的端点是否可以从 DSH 服务器访问。