额度余额（Quota Balance）
在输入框下方的官方用量行左侧，显示当前登录账户的余额（¥）。旨在以一种简约，舒适的设计完善DSH的功能，直观的看到余额的存量。
效果对比
图 1 — 原始状态（未启用本插件）：用量行只有「轮次 · 步数 / 采样速度」「Token 用量 · 缓存命中」「上下文占用」三组。
图 2 — 启用后：用量行最左侧多出一个账户余额 ¥8.84，与官方数字同一行、同一字号、同一灰度，不额外占位。
图 3 — 点击余额：原地展开明细浮层——账户余额、普通余额、赠送额度、更新时间，以及「刷新」与「去充值」。
> 三张图的背景（玻璃质感与壁纸）来自 dsh-plugin-wallpaper-engine 插件，不是本插件绘制的。本插件的徽标与浮层只读取宿主暴露的表面 token，因此会随壁纸引擎的玻璃参数、明暗主题和壁纸切换自动变化；未安装壁纸引擎时，它们就是普通的深色浮层。
安装
需要 DSH 桌面版（Host 侧要有 deepseekAccount 服务）并已登录 DeepSeek 账号。
- 把本仓库克隆或下载到本地任意目录；
- 在 DSH 的插件管理里安装该目录：
install_bundle指向仓库路径； - 安装后即时生效，输入框下方的用量行最左侧会出现余额；点它展开明细。
卸载：在插件管理里移除 quota-balance 即可。
结构
| 文件 | 作用 |
|---|---|
index.js |
Host 半边：注册 GET /plugin/quota-balance/status，通过 deepseekAccount.getBalance() 读取余额并做 30s（失败 5s）缓存 |
client.js |
Client 半边：往 conversation.composer.dock 注册一个 order: -10 的单元格（最左侧），每 60s、以及窗口重新可见时刷新 |
cordis.patch.yml |
安装时插入 quota-balance 这一行 |
locale/*.json |
插件在「插件」列表里的标题与描述 |
显示规则
- 同一币种的多个钱包（普通余额 + 赠送额度）合并求和，例如
¥10.47；多币种时用·连接。 - 点一下徽标在原地弹出一张小卡片（不跳转网页）：总余额、钱包分项、更新时间、「刷新」按钮；Host 侧返回
normal/bonus后自动改成分「普通余额 / 赠送额度」两行，并出现「去充值」。 Esc、点击卡片外部、再点一次徽标都会收起卡片。- 卡片底边对齐徽标上方 6px，因此直接盖在输入框上（和官方 tok 浮层同一套读法），窗口缩放时重新贴靠。
- 未登录 / 读取失败时整块隐藏，不占位。
- 字体、颜色跟随用量行：
font: inherit、12px、--dsw-alias-label-tertiary。 - 鼠标悬停时浮出一层浅色圆角底（与官方用量胶囊同款），按下更深、
focus-visible有强调色描边；底衬靠「内边距 + 等量负外边距」实现，悬停时文字不会位移。 - 卡片挂在
document.body上（z-index最高）并用独立样式表，因为输入框卡片自带裁剪与层叠上下文，放在插槽里的悬浮层会被它盖住。
适配壁纸引擎（dsh-plugin-wallpaper-engine）
壁纸引擎不是给插件一套"浮层样式"，而是把宿主自己的表面 token 就地改写成玻璃配方（--dsw-alias-bg-layer-*、--dsw-alias-bg-overlay、--dsw-alias-border-* 全部重映射）。官方那些浮层（Token 用量、会话统计）读的就是这些 token，所以「抄壁纸插件的参数」最省事也最稳的做法是：直接读同一个宿主 token，让壁纸引擎自己去决定长什么样。
| 用途 | 取值 |
|---|---|
| 面板底色 | var(--dsw-alias-bg-overlay, #26272b)（与官方浮层同源，原样照抄） |
| 毛玻璃 | backdrop-filter: blur(var(--we-blur, 13px)) saturate(var(--we-saturate, 1.3)) |
| 边框 | --dsw-alias-border-l2（壁纸引擎会同步重映射） |
| 文字 | --dsw-alias-label-primary/secondary/tertiary |
| 强调色（去充值） | var(--we-accent, var(--dsw-alias-brand-primary, #7db3ff)) |
--dsw-alias-bg-overlay 单独用只有约 23% 的遮罩，所以卡片会把输入框里的文字淡淡透出来——按需求「数据原样照抄」，这里不做额外加暗。若哪天觉得碍眼，在 background 上垫一层 linear-gradient(rgba(0,0,0,.22), rgba(0,0,0,.22)) 即可。
两个坑值记：--dsw-alias-bg-base 在壁纸引擎下是 transparent、--dsw-alias-border-l1 的 alpha 是 0；--we-panel-color 这类实色拿去铺底会变成不透明板子。
壁纸引擎未启用时 --we-* 回落、--dsw-* 回到宿主默认值，卡片就是普通深色浮层。
> 调试备忘：样式是注入到 ` 的，热更新时旧节点还在页面上——injectPanelCss()必须**覆盖textContent** 而不是发现节点就 return，否则改样式永远只生效第一版（这一坑排查了很久）。
>
> 第二个坑：这张样式表原先只在**浮层首次展开**时注入，于是刷新页面后徽标完全没有样式（hover 也就无从谈起）。现在在ctx.slots.inject(...)里先调一次injectPanelCss()`，徽标一出现样式表就已经在页面上了。
接口
GET /plugin/quota-balance/status
{"ok":true,"wallets":[{"currency":"CNY","balance":"5.40"},...],"normal":[...],"bonus":[...],"links":{"usageUrl":"...","topUpUrl":"..."},"fetchedAt":1793627086526}
{"ok":false,"reason":"unavailable"|"signed-out"|"failed"}
余额只在本地回环地址上暴露，且响应不带 CORS 头，网页无法跨源读取。
改动后如何生效
- 改
client.js：保存后页面会热更新（本插件实测即时生效）。 - 改
index.js：在插件管理里把本插件禁用再启用即可重载 Host 模块，不必重启应用（已实测）；之后点卡片里的「刷新」取一次新数据。
收录到插件市场
DSH 的插件市场（dshmarket）不自己维护目录，列表来自 awesome-dsh-plugin：往那里交一个 YAML 条目，站点与市场会自动读入。本插件提交的条目是 data/plugins/dxxo77__dsh-plugin-quota-balance.yml，分类 usage（Usage & Billing）：
url: https://github.com/dxxo77/dsh-plugin-quota-balance
name: dxxo77/dsh-plugin-quota-balance
category: usage
description:
en: "Quota Balance (余额显示quota-balance) — shows the DeepSeek account balance at the left of the composer status row; clicking it opens a panel with the normal and bonus wallet split, the refresh time and a top-up link. The chip and panel read the host surface tokens, so they follow the dsh-plugin-wallpaper-engine glass settings, theme and wallpaper changes."
zh: "余额显示quota-balance：在输入框下方的用量行最左侧显示账户余额，点开可查看普通余额与赠送额度的分项、更新时间，并可跳转充值；徽标与浮层读取宿主表面 token，可跟随 dsh-plugin-wallpaper-engine 的玻璃参数、明暗主题与壁纸切换。"
市场详情页的截图来自本仓库的 screenshots.json（按顺序引用 docs/ 下的三张实拍图），改图只需推本仓库，不必再动列表。
许可证
MIT © 2026 dxxo77
