余额用量状态条 TTTimas/dsh-plugin-balance-tokens

dsh-plugin-balance-tokens

DeepSeek Harness（DSH）桌面版插件：在 Web GUI 窗口最底部显示一条状态条——左侧账户余额，右侧当前会话的 token 用量与上下文剩余。

给 DeepSeek Harness Web GUI 用的状态条：左侧账户余额，右侧当前会话的 token 用量与剩余上下文。

效果

- 左：余额 充值 ¥12.34 · 赠送 ¥3.00，点击手动刷新，每 60 秒自动刷新，页面重新可见时也会刷新。
- 余额按预警等级着色，金额前有同色圆点，悬停可看状态与阈值：

| 颜色 | CNY | USD | 含义 |
| 绿色 | ≥ ¥20 | ≥ $3 | 余额充足 |
| 黄色 | ¥5 – ¥19.99 | $1 – $2.99 | 余额偏低 |
| 红色 | < ¥5 | < $1 | 余额预警 |

等级按「充值 + 赠送」的合计余额计算；多币种时以 CNY 为主，其次 USD，其他币种沿用 CNY 阈值。
- 右：本会话 45.6k tokens · 上下文剩余 96.1k / 128k，两项同样分级，指标前有同色圆点：

| 指标 | 绿色 | 黄色 | 红色 |
| 本会话 token | < 1M | 1M – <5M | ≥ 5M |
| 上下文剩余 | ≥ 30% | 10% – <30% | < 10% |

上下文百分比按「剩余 / contextWindow」计算。
- 截图：

状态条

- 无活动会话时显示「无活动会话」，尚未有模型用量时显示「等待用量数据」，未登录时显示「账户未登录」。
- 中英文案跟随界面语言自动切换。

实现方式

- 注入点：shell.bottom——root 作用域的全宽底部插槽（ui-layout 声明），插件通过 ctx.slots.inject('shell.bottom', …) 注册。
- 余额：Host 账户服务的 account/getBalance RPC（ctx.remote.account.getBalance({ version, locale, timezoneOffsetSeconds })）。凭据只在 Host 侧，前端拿不到 token。
返回 null（未登录）、{ status: 'ready', value: [...], bonusWallets: [...] } 或 { status: 'failed' }。
- 分级阈值集中在 lib/client.js 的 BALANCE_BANDS / TOKEN_BANDS / CONTEXT_BANDS；颜色只用主题 state-success / state-warn / state-error 令牌，文字色按比例混入 label-primary，保证明暗两套主题下的小字号对比度。加载中、失败、未登录、无用量数据不显示等级圆点。
- Token：会话列表快照中 Host 计算的投影 tokenUsage / contextPressure（由会话日志重放得出）；当前会话取 retainedBy.mainView > 0 的行。
「本会话」按输入、缓存读写、输出四项合计分级；「上下文剩余」= contextWindow - projectedTokens，按剩余占比分级。

目录结构

package.json dsh.bundle.patch + dsh.client（platform: web） cordis.patch.yml bundle 补丁：insert 本包为 Loader 条目 lib/index.js node 半侧（纯 UI 插件，空 apply） lib/client.js 浏览器半侧，已构建格式，无需构建步骤 tests/smoke.cjs 无依赖冒烟测试 docs/statusbar.png 状态条截图（README 引用）

lib/client.js 直接使用 window.__ModuleLoader__.load({ id, factory }) 的已构建格式，仅依赖基线共享模块（react 等），不声明 dsh.client.external。

安装

桌面版配置档为 desktop（由 Electron 应用管理，普通 dsh --profile desktop 启动会被拒绝，但 dsh plugin 可以管理）。

本地开发安装（推荐，改动即时生效）：

dsh plugin --profile desktop add "link:E:\path\to\dsh-plugin-balance-tokens"

也可以从 Git 仓库安装：

dsh plugin --profile desktop add "git+https://github.com/TTTimas/dsh-plugin-balance-tokens.git"

安装会把依赖写入 $DSH_HOME/profiles/desktop/package.json 并登记到 dsh.profile.bundles；正在运行的界面通过 HMR 实时加载，无需重启。

测试

npm test

冒烟测试模拟 window.__ModuleLoader__、react 与 cordis ctx，断言注册到 shell.bottom、locale 字典、余额/用量渲染与点击刷新。

卸载

dsh plugin --profile desktop remove dsh-plugin-balance-tokens

备注

- 注册目标 shell.bottom 是 single 插槽。将来若有其他插件占用它（例如 experimental-inspector），两个条目在同一 priority 下会冲突；届时可通过注册的 priority 协调。
- 位置选的是全宽底部（三栏下方）；如需挪到左侧栏底部，可改为注册到 sidebar 内部座位。

License

MIT