dsh-quota-panel

English | 中文

dsh-quota-panel 是 DeepSeek Harness（DSH）网页端的提供方额度/余额状态组件插件。

零依赖宿主端插件：为每个配置的提供方注册一条服务端代理路由 /api/quota/<id> —— API Key 通过凭据系统在服务端解析，绝不进入浏览器 —— 然后在页面注入右下角的 Harness 原生风格状态组件，支持两种尺寸：

• 收起（默认） —— 极简胶囊：每个账户一个「独立状态点 + 数值」对 （如 ● ¥58.36 · ● 45%），互不干扰——哪个账户紧张只有它的点变色， 不用文字标签，一眼扫过即可；点击展开。
• 展开 —— 完整卡片：「模型额度」标题栏（刷新/收起按钮）+ 每个提供方一行 结构化信息（状态点、名称、主数值、次级信息，用量型提供方还有进度条）， 点收起按钮缩回胶囊。

两种尺寸都自动刷新（页面隐藏时暂停）；刷新按钮旋转反馈，重复点击不会并发请求。

胶囊里的用量百分比按手机电量式三色着色：健康绿、紧张琥珀、告急红， 与状态点独立对应；余额数值仅在其状态告警时着色。

组件完全使用 Harness 设计 Token（--dsw-alias-*、--dsw-static-*、 --dsw-shadow-*、--dsw-font-*）驱动，token 缺失时有合理的 fallback， 因此自动跟随产品主题（浅色/深色），不携带自己的配色。

效果图

收起胶囊（浅色 / 深色）：

展开卡片（浅色 / 深色）：

完整页面（小胶囊状态，浅色 / 深色）：

安装

dsh plugin --profile web add "github:brittanistrehlowll-oss/dsh-quota-panel"
# 重启 `dsh web`（bundle 层在启动时生效）

包声明了 dsh.bundle.patch，因此 dsh plugin add 会把它自动激活为 profile 层。

配置

每个提供方是 providers 下的一项，内置两种渲染器：

format	接口返回形态	行显示
deepseek-balance	{ "balance_infos": [{ "currency", "total_balance", "granted_balance", "topped_up_balance" }] }	¥58.36 + 余额充足/正常/紧张/建议充值
opencode-usage	{ "usage": { "rolling"|"weekly"|"monthly": { "percent", "resetsAt" } } }	五 10% · 周 45% · 月 22% + 进度条 + 当前最高占用

在 profile 的 cordis.patch.yml 中覆盖默认配置：

- id: quota-panel
  config:
    refreshMs: 30000
    providers:
      - id: deepseek
        label: DeepSeek
        credential: DEEPSEEK_API_KEY
        endpoint: https://api.deepseek.com/user/balance
        format: deepseek-balance
        balanceTiers: { critical: 10, warn: 20, healthy: 50 }
      - id: opencode-go
        label: OpenCode Go
        credential: OPENCODE_GO_API_KEY
        endpoint: https://opencode.ai/zen/go/v1/usage
        format: opencode-usage
        windowLabels: { rolling: 五, weekly: 周, monthly: 月 }
        warnPercent: 70
        errorPercent: 90

字段说明：

字段	含义	默认值
id	路由 id（/api/quota/<id>），^[a-z0-9-]+$	必填
label	卡片上的提供方名称	必填
credential	凭据引用（$DSH_HOME/.credentials.yaml 或环境变量）	必填
endpoint	额度 JSON 接口，GET + Authorization: Bearer <key>	必填
format	行渲染器	deepseek-balance
balanceTiers	（deepseek-balance）{critical, warn, healthy} 分级阈值	{10, 20, 50}
lowBalance	旧版别名，等价于 balanceTiers.warn	—
windowLabels	（opencode-usage）三个窗口的标签	{滚, 周, 月}
warnPercent / errorPercent	（opencode-usage）阈值	70 / 90
refreshMs	自动刷新间隔	60000

DeepSeek 余额分级

默认 balanceTiers {critical: 10, warn: 20, healthy: 50}：

余额	状态	次级信息
<= 10	error（红点 + 红数值）	建议充值
10 < x <= 20	warn（琥珀色）	余额紧张
20 < x <= 50	ok	余额正常
> 50	ok	余额充足

OpenCode 用量状态

high = max(滚动, 每周, 每月)：

用量	状态
< warnPercent	ok（绿点，DeepSeek 蓝进度条）
>= warnPercent	warn（琥珀点 + 进度条）
>= errorPercent	error（红点 + 进度条）

更新日志

• v0.3.0 — 双尺寸：收起为极简胶囊（每账户独立状态点 + 电量式三色数值），点击展开完整卡片。
• v0.2.0 — Harness 原生卡片：设计 Token 驱动、余额分级阈值、用量进度条。
• v0.1.0 — 初版悬浮面板：服务端额度代理 + 页面角标。

安全

• API Key 仅由服务端通过 ctx.credentials 解析，只用于服务端到提供方的请求； 浏览器只访问 /api/quota/<id>。
• 注入的卡片只使用 createElement/textContent 构建 DOM，API 返回值绝不经过 innerHTML；技术错误（401、超时、凭据缺失）只写入 title 悬停提示，不进卡片 正文。

本地开发

# 重新生成演示页 docs/demo.html + docs/demo-dark.html
node scripts/gen-demo.mjs
# 通过 Chrome DevTools Protocol 无头截图
node scripts/shoot.mjs both
# 验证演示页渲染出的 DOM
node scripts/verify.mjs [dark]
# 注入脚本的语法与内容检查
node scripts/test-page-script.mjs

License

MIT