前言¶
用 DeepSeek Harness（DSH）做多会话、多工作区开发时，钱包余额和单次对话花了多少，往往要切到别处查看；工作区维度更是缺少汇总。Spendwatch 是 awychoi 维护的客户端插件，在同一界面展示 DeepSeek 余额、当前会话花费，以及每个工作区累计花费（含已归档会话），读取与 DSH 相同的 DeepSeek 账户，无需额外登录或单独配置页。
这是什么¶
Spendwatch（dsh-spendwatch）面向 DSH 0.2.x，分类为客户端插件：通过 cordis.patch.yml 注入侧边栏与会话输入区 UI，在浏览器端展示花费信息；余额数据由 Host 侧已登录账户或 DEEPSEEK_API_KEY 读取，密钥与账户 token 留在 Host，不进入浏览器。
维护者：awychoi。许可证：MIT。当前 package 版本：1.6.0。与 DeepSeek 无隶属关系。
核心功能¶
余额（左侧边栏）¶
展示 DeepSeek 钱包最近一次返回的真实余额；附带峰谷时段标记，以及距离下一次计价切换的倒计时。峰谷规则与 Host 使用同一价目表，每 10 秒重算，包含北京工作日规则与中国法定节假日（资料注明节假日覆盖至 2026，2027 日期需官方公布后自行补充）。
刷新时机：当前对话产生新的花费时、回到窗口时、或点击余额时；空闲时不轮询。
工作区合计（工作区列表行）¶
每个工作区行显示该工作区全部会话的累计花费，包含已归档会话，不是仅统计当前打开的对话。实现上把工作区合计挂在 Host 工作区行的 data-row-key="workspace:<id>" 上；若 Host 布局变更，该展示可能消失。
会话花费（输入框下方 pill）¶
消息框下方显示当前对话的估算花费，含 subagent。Fork 后的对话只对 fork 之后产生的用量计费；Host 折叠事件时会跳过低于 inheritedEventCount 的事件，避免继承历史重复计费。
数据如何更新¶
会话合计跟随各次 model call 上报的 usage；工作区合计在持久化折叠值之上叠加活跃会话。搜索相关：web/deepseek-search-llm-request 事件按查询计数，并用 search.estimatedInputTokens / search.estimatedOutputTokens 按搜索模型费率估算（真实辅助用量未写入 session log）；Search/Fetch API 按成功请求 $0.75/1K 的计费在本插件使用的 Messages search + 本地 HTTP fetch 路径下未建模。
准确度说明¶
- 余额：DeepSeek 接口返回的真实钱包值。
- 花费：估算值，为 tokens × 公开价目（含峰谷、cache hit/miss）；未定价模型跳过。不要用 Spendwatch 对账发票，DeepSeek 账本可能事后结算。
可在 Host 侧维护 pricing.json（启动时校验，异常时回退内置副本）调整 token 费率、搜索 token 估计或节假日；修改后需重启 DSH。
安装与启用¶
在 DSH 中按下列步骤安装（命令与仓库 URL 以 README 为准，勿自行拼接 CLI 插件名）：
- 打开 Plugins → Install。
- 选择 Git repository，填入：
https://github.com/awychoi/dsh-spendwatch
- 按提示 重启 DSH。
钱包通过已登录 DeepSeek 账户读取；若使用 API Key，则通过环境变量 DEEPSEEK_API_KEY（由 Host 使用，不暴露给浏览器）。
典型用法¶
安装并重启后无需单独设置页：侧边栏可见余额与峰谷倒计时；切换或浏览工作区列表时可见各行工作区合计；在任意对话中发送消息后，输入框下方会出现当前会话花费 pill。需要更新价目或节假日时，编辑 Host 可用的 pricing.json 并重启 DSH。
卸载：在 DSH 插件列表移除 Spendwatch 并重启；插件不额外持久化本地数据。
适用场景与注意¶
适合：长期在 DSH 里跑多工作区、多会话，希望一眼看到余额、当前对话成本及各工作区总花费的开发者。
注意：
- 插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，自行评估信任边界。
- 与 Host 存在耦合（工作区行 DOM、价目表、session 折叠与搜索事件语义）；升级 DSH 大版本后若 UI 或 Host API 变化，部分展示可能失效，需关注 README 中的 host-coupling 说明。
- 侧边栏与 composer 各带 crash boundary；缺少
sessionQuery、workspaceRegistry或deepseekAccount时对应块降级，不会用 API Key 冒充账户余额展示。
社区插件目录见 SkillHub，与 DeepSeek / 幻方无官方从属关系。
链接¶
- 目录页：https://www.skillhub.cn/plugins/awychoi/dsh-spendwatch
- 源码与说明：https://github.com/awychoi/dsh-spendwatch
Spendwatch 把钱包、当前会话与工作区维度的花费放在 DSH 常用界面里，减少切页查账；花费数字为价目表估算，余额以 DeepSeek 返回为准，适合日常控费参考而非财务对账。
