前言¶
在 DeepSeek Harness（DSH）桌面端里查看账号余额，通常要打开「设置 → 账户」，而且只能看到一个总数。跑多个会话、子代理并行时，很难回答「这笔钱是哪个会话花掉的」。社区插件 dsh-balance-ledger（维护者 Harua79，分类：记忆）针对的是这个缺口：在输入区附近常驻显示余额，并用本地台账把观察到的余额下降归到当时正在运行的会话上。
下面介绍它的定位、金额口径、安装方式和使用时注意点。事实以 GitHub 仓库 README 为准；目录页见 SkillHub。
这是什么¶
dsh-balance-ledger 是 DSH 桌面端的客户端插件（MIT 许可证）。它不估算 token × 单价——DSH 本地的 dsh-token-meter 在文档里说明其数字「不是计费记录」，真实扣费发生在 Platform 侧。插件只用账号余额的实际下降作为金额信号，并把每次下降记到「当时正在运行的会话」；子代理 / 子会话的消费并入所属主会话。台账保存在浏览器 localStorage，插件不上传数据，也不读取设置页的 DOM。
核心功能¶
余额常驻¶
输入框下方那一排（运行统计 / 上下文条旁边）显示「余额 ¥xx.xx」，有赠金时会一并显示。点击可打开「余额去向」小窗。未登录 DeepSeek 账号时贴片会自动隐藏。
按会话记账¶
小窗按主会话列出消费、占比、最近扣费时间。子会话消费归并到主会话，展开后可看「本体 + 各子会话」明细。支持按时间 / 消费、正序 / 倒序排序。
归属规则¶
- 每次读到余额比上一次低，把这段下降记到当时正在运行的会话上。
- 没有会话在运行时发生的下降 → 记为「未归属」，不会硬塞给某个会话。
- 多个会话并发 → 均摊并打「均摊」标签。
- 应用关闭期间的消费无法观察，也会落到「未归属」。
台账键名为 dsh-balance-chip.ledger.v1（插件改名前的历史键，故意保留以免升级后丢失已有记录）。
实现上的几个要点¶
- 数据来源：
ctx.remote.account.watch()订阅账号状态，getBalance()读钱包，与「设置 → 账户」同一份数据。 - 实时性：通过
api-session/status转发事件标记 agent 回合的开始 / 结束；回合内约每 2s 轮询余额，空闲时约 20s，页面隐藏时停止轮询。 - 失败降级：读取失败时保留上一次数字，不会闪成 0 或「不可用」。
- 子会话归并：按会话摘要的
parentId向上找到顶层主会话，记账时把 owner 冻结进台账，避免会话列表变化后分组错乱。
安装与启用¶
要求：DSH 桌面版 0.2.x，并已登录 DeepSeek 账号。
先做本地或远程添加，再在 profile 中启用 bundle。官方 README 给出的命令如下：
# 本地目录
dsh plugin --profile <your-profile> add "C:\path\to\dsh-balance-ledger"
# 或 git 地址
dsh plugin --profile <your-profile> add https://github.com/<owner>/dsh-balance-ledger
也可以在 DSH 的「设置 → 插件」里通过管理页面安装。
安装后，该 profile 的 package.json 会多一条依赖，并在 dsh.profile.bundles 里追加 @local/dsh-balance-ledger。
典型用法¶
经过上面的步骤安装并重启或刷新客户端后：
- 在 composer 下方确认出现余额贴片；需要明细时点击贴片，打开「余额去向」弹窗。
- 在弹窗里切换排序（时间 / 金额、正序 / 倒序），展开主会话行查看子会话明细。
- 若轮询频率需要调整，可在
client.js顶部修改POLL_RUNNING_MS/POLL_IDLE_MS（余额接口被限流时贴片仍沿用上一次数字）。
开发与冒烟测试（维护者侧）：
node test/smoke.mjs # 或 npm test
适用场景与注意¶
适合谁：经常在 DSH 里开多个会话、需要一眼看到余额、并想按会话理解「钱大概花在哪」的开发者。台账从安装之后才开始记录，没有历史回填。
务必知晓的限制：
- 归属是「看到下降时谁在跑」的推断，不是 Platform 官方账单；同一时刻的多笔扣费可能被合并成一次下降。
- 若某子会话的父会话已从列表彻底消失，且台账是早期版本记录的（未冻结
root），该子会话可能暂时单独占一行。 - 插件以当前 DSH 进程权限在本地浏览器环境运行；安装前应自行查看源码与 MIT 许可证，确认符合你的安全与合规要求。
兼容性：README 记载在 DSH 桌面版 0.2.0-rc.2 ~ 0.2.1-rc.2（Windows）上验证。
结尾¶
dsh-balance-ledger 用余额下降这一唯一本地可观测的真实金额信号，补上「总数之外、按会话看去向」这一层信息，且数据只留在本机 localStorage。若要安装或看更新说明，可访问 SkillHub 目录页 与 GitHub：Harua79/dsh-balance-ledger。
