前言¶
在 DeepSeek Harness（DSH）里长时间跑对话或智能体任务时，输入框下方会有一行官方用量信息：轮次与步数、Token 用量、上下文占用等。账户里还剩多少可用额度，通常要另开网页或进官方 API 页面才能确认。维护者 dxxo77 的 dsh-plugin-quota-balance（仓库 dxxo77/DSH_plugin）把当前登录账户的余额（¥）嵌在同一行最左侧，字号、字色与官方用量数字一致；点开可在原地查看普通余额与赠送额度分项，并跳转充值。插件分类为客户端，在 GitHub 上当前为 1 star；社区目录页见 skillhub.cn。
这是什么¶
dsh-plugin-quota-balance（npm 包名 dsh-plugin-quota-balance，版本 2.0.0）是 DSH 的 Host + Client 双端插件：Host 通过宿主 deepseekAccount 服务读余额并暴露本地 HTTP 接口；Client 在 conversation.composer.dock 注册最左侧单元格，把合并后的余额显示在用量行上。未登录或读取失败时整块隐藏，不占位。许可证为 MIT © 2026 dxxo77。
核心功能¶
用量行余额徽标¶
启用前，用量行只有官方三组信息。启用后，最左侧多出一项账户余额（例如 ¥8.84），与官方数字同一行、同一字号（12px）、同一灰度变量 --dsw-alias-label-tertiary，不额外占位。
点击展开明细¶
点一下徽标会在原地弹出小卡片（不直接跳转网页），内容包括：总余额、钱包分项、更新时间、「刷新」与「去充值」。Host 返回 normal / bonus 后，界面会分成「普通余额 / 赠送额度」两行。同一币种多个钱包合并求和显示；多币种时用 · 连接。Esc、点击卡片外部或再点一次徽标可收起。卡片底边对齐徽标上方 6px，窗口缩放时会重新贴靠。
与壁纸引擎共存¶
若同时安装 dsh-plugin-wallpaper-engine，README 说明：本插件徽标与浮层只读取宿主暴露的表面 CSS token，会随壁纸引擎的玻璃参数、明暗主题和壁纸切换变化；未安装壁纸引擎时为普通深色浮层。壁纸背景不是本插件绘制。
Host 接口与刷新策略¶
Host 注册 GET /plugin/quota-balance/status，通过 deepseekAccount.getBalance() 读取余额，成功时约 30s 缓存，失败时约 5s 缓存。Client 每 60s 以及窗口重新可见时刷新。余额仅在本地回环地址暴露，响应不带 CORS 头，网页无法跨源读取。
成功响应示例结构：
{"ok":true,"wallets":[{"currency":"CNY","balance":"5.40"}],"normal":[...],"bonus":[...],"links":{"usageUrl":"...","topUpUrl":"..."},"fetchedAt":1793627086526}
失败时：{"ok":false,"reason":"unavailable"|"signed-out"|"failed"}。
安装与启用¶
需要 DSH 桌面版（Host 侧要有 deepseekAccount 服务）并已登录 DeepSeek 账号。
- 将仓库克隆或下载到本地任意目录；
- 在 DSH 的插件管理里安装该目录，install_bundle 指向该仓库路径；
- 安装后即时生效，用量行最左侧会出现余额；点它展开明细。
卸载：在插件管理里移除 dsh-plugin-quota-balance 即可。
收录到 DSH 插件市场（dshmarket）的列表来自 awesome-dsh-plugin；本插件条目为 data/plugins/dxxo77__DSH_plugin.yml，分类 usage（Usage & Billing）。市场详情页截图来自仓库 screenshots.json，引用 docs/ 下实拍图。
典型用法¶
日常无需配置：登录 DeepSeek 后，在输入框下方用量行左侧看合并余额；需要分项或充值时，点击徽标，在卡片里点「刷新」拉最新数据，或点「去充值」使用 Host 返回的 topUpUrl。若需打开官方用量相关页面，可使用响应里的 usageUrl（由 Host 在 status 中一并返回）。
开发调试时，改 client.js 保存后页面热更新即可；改 index.js 后在插件管理里禁用再启用本插件以重载 Host 模块，再点卡片「刷新」取新数据。
适用场景与注意¶
适合已在 DSH 桌面版长期使用、希望在不离开对话界面的前提下扫一眼余额、必要时查看普通/赠送分项的用户。与官方用量行视觉对齐，并可选配合壁纸引擎插件。
安装前请自行阅读仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行，Host 会调用账户相关服务；只应从可信来源获取仓库并核对 index.js / client.js 行为。DSH 社区插件目录（如 skillhub.cn）与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。
结尾¶
dsh-plugin-quota-balance 把 DeepSeek 账户余额接到 composer 用量行左侧，点开可看分项与充值入口，并与壁纸引擎共用宿主 token。目录页：https://www.skillhub.cn/plugins/dxxo77/DSH_plugin；源码与 README：https://github.com/dxxo77/DSH_plugin。
