前言¶

在 DeepSeek Harness（DSH）里跑任务时，账户余额和实际花费往往要切到 设置 → 账户 才能看清；按会话、按天花了多少，平台侧也没有现成的细账接口。若你希望在侧边栏常驻看到余额、今日与本月消耗，并自行设定预算、估算「还能用几天」，同时把近 7 天的消耗按会话汇总在本地留档，社区插件 dsh-balance-chip-cesare（维护者 Cesare97，分类：客户端）就是围绕这一缺口做的：数据主要来自与设置页相同的 account/getBalance，消耗由余额变动推导，账本落在浏览器 localStorage，除余额读取与每周汇率查询外不上传本地统计。

这是什么¶

dsh-balance-chip-cesare 是 DSH 的侧栏「余额与消耗」插件，固定在 设置 入口上方。当前 package 版本为 0.7.2，许可证 MIT。它展示充值余额、赠送余额与各类消耗统计，并提供每日/每月预算、可用天数（runway）、多币种显示与 CNY↔USD 换算、近 7 天按会话明细，以及 JSON/CSV 导出与导入。插件在 DSH Web 客户端注入运行（dsh.client.platform: web，immediately: true），Host 半为 lib/index.js，浏览器 bundle 为 lib/client.js。

核心功能¶

侧栏与面板¶

• 余额行：充值余额、赠送余额、今日消耗；侧栏折叠时显示货币符号，悬停可看具体数字。
• 面板：余额、赠送、可用天数、今日/本月/本次会话消耗、无归属「其他」、近 7 天柱状图、会话消耗 Top 5、最近任务 4 条。

预算与超支提示¶

支持按显示币种分别设置 每日 与 每月 预算，以进度条和百分比展示；超支时面板与侧栏相关数字会变红。

可用天数（runway）¶

取最近 7 个完整日中 有花费的天数 为分母：总花费 ÷ 天数 = 日均消耗，再用当前可用余额 ÷ 日均。README 举例：5 天共花 ¥4 → 日均 ¥0.80，再据此估算余额可支撑天数。

币种与汇率¶

显示币种可选：自动 / CNY / USD / 账户持有的其他币种；USD 始终可选，CNY 余额可按缓存参考汇率换算。CNY→USD 汇率 每周 自动更新，也可在插件设置里手动刷新；请求公共 Frankfurter/ECB 接口，不消耗模型 token；刷新失败时保留上次汇率。

近 7 天明细¶

近 7 天可按会话合计，并可查看每天各会话分别花费。自 0.7.0 起为精确记录；更早日期会依保留的任务记录还原并标注「估算」。无法归属到任务的消耗归入「其他」，只计入日总额。

语言与刷新¶

界面语言可跟随系统，或选中文 / English / Italiano，插件内立即生效。余额读取间隔可选 15 / 30 / 60 秒或暂停；此外在启动、任务结束结算、凭据变化、页面重新可见、手动刷新时也会读取。

数据从哪来、有多大误差¶

余额来自 Remote 命令 account/getBalance，与 设置 → 账户 一致。DSH Host 没有 按会话计费的查询接口，因此消耗由总可用余额（充值 + 赠送）变化推导：

1. 每次成功读取并与上次比较；下降记为消耗，优先归到正在运行的任务，或 20 秒结算窗口内刚结束的任务；上升视为充值/赠送。
2. 没有任何任务可归属的下降进入「其他」，只计入日总额。
3. 超过 6 小时未读取时，账本基线视为过期，下次读取只重置基线，不补记未知变动。

这是近似账本：重叠运行的任务消耗会算给最近开始的那个；任务结束超过 20 秒才到账的费用可能无法归到该会话。使用时宜把数字当作 趋势与自检，而非与官方账单逐分对齐。

存储与隐私¶

统计账本键前缀 dsh-balance-chip/stats/v1，含 days（约 60 天）、sessions（约 120 个）、sessionDays（0.7.0 起）、runs（约 50 个）、last、unattributed。偏好在 settings/v1，汇率缓存在 fx/v1。除 account/getBalance 与周期性的汇率 GET 外，插件 README 说明不发起其他请求，本地统计数据不上传。导出、导入、清除统计在面板 设置 中操作。

安装与启用¶

在 DSH 项目依赖中安装（命令以仓库 README 为准）：

pnpm add github:Cesare97/dsh-balance-chip-cesare

安装后将其加入 profile 的 dsh.profile.bundles，或在客户端 设置 → 插件 中启用。本地开发时可用 link: 指向源码目录，无需把 git clone 当作官方安装步骤。

插件以当前 DSH 进程的权限运行；安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境与合规要求。

典型用法¶

1. 安装并启用后，在侧栏 设置 上方打开余额行，点开面板查看今日、本月与本会话消耗及 7 天趋势。
2. 在面板 设置 中配置每日/每月预算与显示币种；需要美元参考价时确认汇率已更新（或手动刷新）。
3. 关注「可用天数」与预算进度条，超支时侧栏与面板会标红。
4. 查看近 7 天按会话明细；对标注「估算」的历史日期的数字保持谨慎。
5. 定期在 设置 中导出 JSON/CSV 备份；换浏览器或清站点数据前可先导出再在目标环境导入。

刷新策略可在 15 / 30 / 60 秒与暂停之间切换；频繁任务结束时插件也会在结算相关时机触发读取。

适用场景与注意¶

适合：长期在 DSH Web 端跑 Agent、希望侧栏常驻余额与消耗、需要自制预算与 runway、要在本机保留 7 天会话级消耗趋势的开发者和个人用户。

注意：

• 消耗归属是客户端推导，Parallel 任务、长时间未打开页面等情况会放大误差。
• 数据仅存于当前浏览器 localStorage；清缓存、换设备会导致账本丢失，除非先导出。
• 社区目录 SkillHub 插件页 与 GitHub 为独立生态信息源，与 DeepSeek / 幻方无官方从属关系。

维护者提供离线检查脚本，供改包或贡献时使用：

node scripts/check.mjs

结尾¶

dsh-balance-chip-cesare 把账户余额、推导消耗、预算、runway 和多币种换算收到侧栏一处，并用本地账本补齐近 7 天会话视图；在认清「无官方按会话账单、数字为近似」的前提下，适合作为日常用量的自控面板。更多信息见 SkillHub 目录 与 GitHub：Cesare97/dsh-balance-chip-cesare。