dsh-spend-receipt

DeepSeek 的 token 账单往往只给出一个最终数字，中间发生了什么、缓存命中了几条、哪次调用落在峰期还是谷期，全凭黑箱。dsh-spend-receipt 把每一次 provider 实际报告的 token 事件落成一条追加式 JSONL 记录：input 多少、cache hit 多少、适用哪张日期锁定的费率表、峰谷哪一档、时间戳来源是事件自带还是写入时刻，全部写明，读者可以独立复算，无需信任任何中间层。遇到无法定价的情况——未知模型、缺少缓存拆分、时间戳缺失——插件只保留 token 数并将 usd 置为 null，绝不用零填充或猜测凑出数字。

定价环节全程使用整数 nano-USD 运算，从单行到千行汇总都不经过浮点，消除累积漂移。峰期窗口（UTC 工作日 01:00–04:00 与 06:00–10:00）和谷期各对应一套费率，窗口判定只认 UTC 时刻，不受本地时区书写方式影响。spend_receipt 工具一次调用即可返回最近 N 行明细、全量与局部合计、缓存命中率及其统计基数，以及解析异常行的计数，全程只读本地文件，无需 API key。CLI 侧还提供独立于 harness 的 shell 用法，harness 本身故障时收据查询依然可用。

适合需要逐调用审计 DeepSeek 费用、追踪缓存命中率、或在 CI 与日常开发之间保持计费口径一致的团队和个人开发者。如果你受够了对着账单倒推哪次调用花了多少钱，这个插件让每一步都有据可查。