前言¶
在 DeepSeek Harness（DSH）里跑会话时，充值余额和赠金往往要切到官方账号页才能确认。侧边栏底部本来就有设置和账号入口，但那里不会直接给出 Platform 钱包合计。若你希望在写代码、调智能体的同一界面里一眼看到「还能用多少」，又不想额外开页面或接第三方统计，社区客户端插件 dsh-quota-usage（维护者 lbqcgza）针对的就是这个缺口：把总余额（含赠金拆分）固定在用户名正上方，并支持点击刷新与会话用量估算。
这是什么¶
dsh-quota-usage 是 DSH 的 Web 客户端插件（分类：客户端）。它挂在 sidebar.footer.action 槽位，在侧边栏底部、用户名 / 头像那一行的上方 显示一行「额度」，必要时下方再跟一行「本会话」用量副标题。余额数据来自官方 Remote 接口 remote.account.getBalance，与「设置 → 账号」页同源；插件自述 零遥测（不落盘上报、不接触 token，除一个本地显示偏好键外不写浏览器存储）。
仓库：https://github.com/lbqcgza/dsh-quota-usage
目录页：https://www.skillhub.cn/plugins/lbqcgza/dsh-quota-usage
许可证：MIT（见仓库 package.json）。
核心功能¶
下面介绍 README 中已说明、且与实现描述一致的能力。
额度主行¶
- 总余额：Platform 的充值余额（
normal_wallets）与赠金余额（bonus_wallets）在当前币种下的合计；括号内为赠金部分。赠金不足 1 分（含为 0）时，括号与对应展示一并不渲染，避免<0.01等噪声。 - 状态文案：读取中、读取失败、未连接、未登录均有明确提示，组件不会静默空白。
- 点击刷新：点整行立即重读；读取期间金额右侧出现转圈，后台轮询与窗口焦点变化触发的刷新不会闪转圈。
- 自动刷新：挂载时读一次；在
remote.account就绪前每 5 秒重试，就绪后改为每 60 秒；页面可见、获焦、连接重置、账号登录/登出（account.watch）也会触发重读；并发刷新会去重为单次 Remote 调用。
本会话用量副标题（可选）¶
有打开的会话时，额度下方可显示当前会话的 token 用量 与 估算金额区间（如 约¥1.20–2.40）。金额由官方价目表推算，日志无金额字段，且无法还原历史请求是否处于高峰时段，故显示区间；token 数在悬停提示中给出，口径与 DSH tokenUsage 投影一致。
可在 设置 → 通用 → 本会话用量显示 关闭；开关状态存于 localStorage 键 dsh-quota-usage:show-usage（插件唯一写入的本地键）。仅覆盖当前会话，不做全工作区汇总。
布局与语言¶
展开侧边栏时为两行列表式布局（标签左对齐、金额贴右）；收起为 56px 轨道时变为 36px 圆形按钮（轨道态不显示用量副标题）。界面文案随 DSH 语言在中英之间切换。
环境与限制¶
- 需要 DSH 0.2.0-rc.2 或更新的 Web 版（桌面 App 或
dsh web）。依赖sidebar.footer.action与remote.account；headless / SDK / ACP 等无 Web 客户端的 profile 不适用。 - 只读展示，不提供充值或跳转官方账号 overlay 的替代入口。
- 多币种时优先 CNY，否则取第一个钱包币种。
- 用量金额为估算，不是账单；价格变动需更新插件内价目常量（见仓库说明）。
安装与启用¶
在 DSH 内通过 plugin_manager 安装（Creator 模式或设置里的插件页）。安装命令以仓库 README 为准：
plugin_manager install_bundle target = github:lbqcgza/dsh-quota-usage
若使用本地仓库路径：
plugin_manager install_bundle target = <本仓库绝对路径>
桌面 App 装完后需重启一次：客户端模块启动图只在宿主进程启动时生成，仅刷新页面拿不到新插件；dsh web 浏览器模式刷新页面即可。装好后侧边栏底部、设置与用户名行上面会出现「额度」一行。
插件以当前 DSH 进程权限运行；安装前请自行查阅源码与 MIT 许可证，确认符合你的安全与合规要求。
典型用法¶
- 完成安装并按环境重启或刷新（见上节）。
- 登录 DeepSeek 账号后，展开侧边栏，在用户名上方查看
额度与右侧金额；悬停可看充值/赠金拆分、更新时间、自动刷新间隔及本会话 token 与估算区间。 - 需要即时更新时，点击额度整行触发手动刷新。
- 若不需要会话用量行，在 设置 → 通用 → 本会话用量显示 关闭即可。
侧边栏展开时的示意（来自 README）：
额度 ¥13.34（赠¥1.00）
本会话 约¥1.20–2.40
⚙ 设置
(头像) 张三
开发者在改 lib/client.js 后，可在插件页 停用再启用 该插件以重新加载页面模块，无需重启 App（与「首次新装客户端插件」不同）。
隐私与安全（摘要）¶
- 不持有凭据；仅调用
remote.account.getBalance，请求元数据为version、locale、timezoneOffsetSeconds，与官方账号页一致。 - Host 半侧为空
apply，不注册 HTTP 路由，不执行命令、不读文件。 - 无
fetch/ XHR / WebSocket 等遥测出口；安全问题可通过 GitHub 私密漏洞报告渠道提交（见仓库SECURITY.md）。
结尾¶
dsh-quota-usage 把 Platform 钱包合计和可选的本会话用量估算放进侧边栏固定位置，适合长期在 DSH Web 客户端里工作、又不想频繁切账号页的用户。社区插件目录与 DeepSeek / 幻方无官方从属关系，安装与使用以你本地 DSH 版本与仓库说明为准。
