余额消耗条 mantou2nd/dsh-plugin-account-balance

dsh-plugin-account-balance

给 DeepSeek Harness（DSH）的会话输入框下面加一条余额统计：余额 · 会话消耗 · 本轮估算，点一下展开明细面板。

统计行

明细面板

截图是示意图，数字为虚构值。

功能

- 余额：ctx.remote.account.getBalance，与「设置 → 账号与余额」同一个 Host 接口，金额为充值余额 + 赠金余额的合计。
- 会话：这个会话累计消耗，按「余额相对打开本会话时的减少量」计算；基线按 sessionId 存在 localStorage，切换会话、刷新窗口都不串不清零，充值会把基线抬高，不会出现负数。
- 本轮：本轮 token ÷ 全会话 token × 会话消耗。Host 没有逐轮账单，这一项是分摊估算；分母用全日志的 tokenUsage 投影，翻页和压缩都不会让比例跑偏。
- 低余额变红：低于 5（LOW_BALANCE_CENTS = 500，按各币种最小单位，即 ¥5 / $5）时「余额」那一段变红，用的是 DSH 自己的 --dsw-alias-state-error-primary。
- 点击面板：真 + portal，Escape / 点面板外 / 再点一次关闭；面板里能刷新，并跳到「查询用量 / 去充值」（链接与设置页同源）。
- 未登录、接口失败或没有钱包时整条隐藏，不留空占位。

安装

方式一：插件页

1. 下载 dsh-plugin-account-balance-1.0.0.tgz（或直接 git clone 本仓库）。
2. DSH → 侧栏 插件 → 添加插件 → 选这个包 / 本地目录。
3. 安装完成后点 立即启用，刷新一次窗口。

方式二：命令行

node install.mjs # 装到 ~/.dsh/profiles/desktop
node install.mjs --profile web # 装到指定 profile
node install.mjs --uninstall # 卸载

脚本会把包复制进 profile 的 node_modules，把包名写进 dsh.profile.bundles，并清掉早期手工安装留在 cordis.patch.yml 里的那一行（避免同一入口装两次）。

两种方式不要叠加：包已经在 dsh.profile.bundles 里后，就不要再往 cordis.patch.yml 加 ui-account-balance 行。

配置

| 想改什么 | 改哪里 |
| 变红的阈值 | lib/client.js 的 LOW_BALANCE_CENTS（500 = ¥5） |
| 刷新频率 | lib/client.js 的 REFRESH_MS（默认 60000） |
| 文案 | lib/client.js 里的 t("中文", "English") |
| 上报的客户端版本 | lib/client.js 的 CLIENT_VERSION |

改完跑一次 node install.mjs，再刷新窗口（profile 配置会热加载，但浏览器 bundle 不会自己热更）。
不想刷新可以在插件页把这一项关掉再打开，让条目重新挂载。

开发

node test/client.test.mjs # 11 项单测：注册、渲染、面板、金额格式化、低余额、未登录降级

结构：

| 路径 | 作用 |
| package.json | dsh.bundle.patch（bundle 层）+ dsh.client（web 客户端半侧） |
| cordis.patch.yml | bundle 层插入 ui-account-balance 行 |
| lib/index.js | Host 半侧，无行为 |
| lib/client.js | 浏览器 bundle：注册 conversation.composer.dock 条目、读余额、算会话/本轮、渲染面板 |
| test/client.test.mjs | 用 Node 跑的最小渲染测试 |
| install.mjs | 命令行安装/卸载 |

兼容性

在 DSH 0.2.1-rc.2（桌面版）上验证。插件依赖 remote.account 服务，只对 DeepSeek 账号模式生效。
包里硬编码了 CLIENT_VERSION；如果 DSH 大版本变化后连「设置 → 账号与余额」都打不开，把它改成对应版本再试。

已知限制

- 「会话」是余额差，不是账单：同一时间跑的其它会话、后台任务、子代理的消耗也算在当前这条里。
- 「本轮」按 token 占比分摊：cache 命中、未缓存输入、输出单价不同，均摊会抹平差异，适合看量级不适合对账。
- 打开旧会话时基线从此刻起算，历史消耗不追溯。

License

MIT