前言¶
在 DeepSeek Harness（DSH）里跑长会话时，算力与赠送额度会随调用消耗。若只在设置页的账户面板里偶尔查看余额，容易在任务进行中才发现额度不足。本插件把余额做成标题栏旁的一枚小芯片，主数字与赠送额度并排显示，并定期自动刷新，减少来回切页面的次数。
这是什么¶
dsh-plugin-balance-chip 是由维护者 boy1141 发布的 DSH 客户端插件。它在 Web GUI 的会话标题栏、与其他标题栏操作并排，展示剩余账户余额、尚未用完的赠送额度，以及最近一次读取余额的时间（悬停可见）。数据每 20 秒刷新一次。
插件在 SkillHub 社区目录中的分类为客户端；仓库当前星标为 0。DSH 生态主张「一切皆插件」；SkillHub 等为社区独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
下面介绍插件在 README 中明确说明的行为。
数据来源与安全边界¶
插件通过 Host 侧调用 ctx.remote.account.getBalance() 读取余额，与 Settings → Account 面板使用的是同一套平台查询。浏览器端不持有账户 token。
刷新策略¶
- 页面可见时每 20 秒自动刷新。
- 窗口重新获得焦点或标签页再次可见时立即刷新。
- 点击芯片可立刻手动刷新。
展示与异常¶
- 主数字为账户余额，
+后为未用完的赠送额度。 - 未登录时隐藏芯片。
- 读取失败时显示红点与 “balance unavailable”，点击可重试。
- 界面语言跟随 DSH（zh / en），样式跟随主题的 CSS 变量。
包结构（便于对照源码）¶
| 文件 | 作用 |
|---|---|
lib/index.js |
Host 侧：空 mount，供 Loader 登记启用项 |
lib/client.js |
浏览器侧：插槽注册、轮询 store、芯片组件 |
cordis.patch.yml |
Loader 插入行，id: balance-chip |
当前发布包版本为 1.0.0，许可证为 MIT（见仓库 package.json）。
安装与启用¶
先从 GitHub 安装，命令如下（与仓库 README 一致）：
dsh plugin add github:boy1141/dsh-plugin-balance-chip
也可从 最新 Release 下载 dsh-plugin-balance-chip.tgz 后安装该压缩包。若条目已出现在插件市场，亦可在 Settings → Plugins 中搜索安装。
安装前建议通读仓库源码与 LICENSE。插件在当前 DSH 进程权限下运行，安装第三方插件前应自行评估风险。
典型用法¶
安装并启用后无需额外配置项（README 未列出专用配置字段）。在已登录 DSH Web 界面打开任意会话，标题栏旁应出现余额芯片：
- 查看主数字与
+后的赠送额度。 - 将指针悬停在芯片上，查看上次更新时间。
- 需要即时数据时单击芯片刷新。
若已登出，芯片不显示；若请求失败，按界面提示点击重试。
适用场景与注意¶
适合： 经常在 DSH Web GUI 中长时间使用模型、希望在不离开会话的前提下盯余额与赠送额度的开发者或运维者。
注意：
- 余额展示依赖 Host 侧账户接口；网络或平台侧异常时会进入不可用状态，属插件设计行为而非本地缓存。
- 自动刷新仅在页面可见时进行，切换标签或最小化窗口后再回来会触发立即刷新。
- 文档未描述除安装外的 CLI 子命令；开发与冒烟测试在贡献者工作区通过
tools/smoke-client.mjs完成，普通用户以安装使用为主。
结尾¶
dsh-plugin-balance-chip 把 Settings → Account 同源余额查询搬到会话标题栏，并以 20 秒轮询与焦点/点击刷新降低打断感。进一步了解可访问社区目录页与 GitHub 仓库：
- 目录页：https://www.skillhub.cn/plugins/boy1141/dsh-plugin-balance-chip
- GitHub：https://github.com/boy1141/dsh-plugin-balance-chip
