前言¶
在 DeepSeek Harness（DSH）里跑智能体时，工具调用失败很常见：路径不存在、搜索空结果，模型往往会用同一组参数再试一次。第一次失败可以算正常探索；紧接着原样重试，往往什么也得不到，却照样消耗 token。会话很长时，这类「盲重试」很难凭感觉估出成本。
社区插件 dsh-receipt（维护者 Sevyn-Star，分类：模型推理）不做轨迹回放，也不在对话里改代理策略。它在 Web 界面左下角挂一张卡片，用本地价目把「白烧」的金额当场算出来，并可选在重复调用发生时插入一句提醒。
这是什么¶
dsh-receipt 是 DSH 的 Web 侧插件，当前版本 0.1.0（MIT 许可证）。定位可以概括为：角落一张卡片，大字只写这场会话白烧了多少钱。
卡片默认只显示一个大数字；点开可见三行：这一步花了多少、整场会话花了多少、其中有多少是盲重试浪费的（大字对应第三行）。若会话里存在同参数空转，还会多一块「这场在重复什么」，把同一件事收成一句，带上次数和大约金额。文案标明「按本地价目估算」，依据是公开单价，不是平台账单。
核心功能¶
盲重试判定¶
插件不把「话多」等同于「贵」。只有同时满足下面三条，才把某次调用记为白烧：
- 仍是同一个工具
- 仍是同一组参数（键顺序不同也算同一组）
- 上一次已失败或返回为空，且中间你没有再发新消息
典型例子：用同一路径连续两次读不存在的文件；用同一句话连续两次空搜索。若你中间说了别的话再重试、换了路径、或上次其实已成功，则不记。第一次失败本身也不记；调用还在跑、结果未回来时，先不算。
同一步里若只有部分调用属于盲重试，浪费按该步总费用和调用次数分摊。进行中的步会先反映在「这一步」金额里，结束后再决定是否计入大字。
费用展示与提醒¶
- 左下角入口文案为「白烧了」；点击黑卡片查看明细。
- 已结束的会话再次打开时，账会补上。
- 当同一组参数第二次原样重试落下时，会话里可能多一句：「上一次同样的调用已经失败，不要用同一组参数再试。」该句不拦截工具。若不需要，在插件配置里将
remind设为false。
插件不提供轨迹、回放或主题；不查账号余额，也不处理免费模型或额度绕过。
价目与模型映射¶
单价抄自 DeepSeek 公开定价（资料记载 2026-10-15 核对）。默认按闲时估算；忙时约为闲时一倍，可在配置里把 period 写成 peak。
闲时参考（每百万 token）：Flash 缓存命中 $0.003、未命中 $0.15、输出 $0.60；Pro 缓存命中 $0.022、未命中 $0.66、输出 $1.98。deepseek-flash、deepseek-v4-flash、DeepSeek-V4.1-Flash 及硅基流动等带 deepseek-ai/DeepSeek-V4.1-Flash 形式的路径，按 Flash 计价。价目表没有的模型显示「未定价」，不显示为 $0。
这是本地估算；硅基流动或其他网关的实际扣费可能与卡片不一致。缓存命中比例高时，即使 token 数很大，大字金额也可能很小（README 中以 deepseek-ai/DeepSeek-V4.1-Flash 会话为例说明）。
安装与启用¶
前提：本机已能正常打开 dsh web。在插件仓库根目录执行下列命令（须保留 -- -w，否则 Web profile 的 pnpm 工作区会拒绝安装）：
dsh plugin --profile web add "link:$(pwd)" -- -w
然后重新启动 Web：
dsh web
左下角应出现「白烧了」卡片。
典型用法¶
- 按上文安装并执行
dsh web。 - 正常与智能体对话；若出现同工具、同参数、紧接在失败或空结果之后的重试，大字会累积盲重试估算金额。
- 点击卡片查看「这一步 / 整场 / 盲重试」三行；有重复模式时阅读「这场在重复什么」摘要。
- 需要按忙时估价时配置
period: peak；不需要会话内提醒时配置remind: false（具体写法以仓库内cordis.patch.yml与 DSH 插件配置约定为准）。
适用场景与注意¶
适合：长期在 DSH Web 里调试工具链、想快速感知「原样重试」带来多少估算成本，而不想单独拉日志对账的开发者。
注意：
- 插件随当前 dsh 进程权限运行，安装前请自行审阅 GitHub 源码 与 MIT 许可证。
- DSH 生态主张「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。
- 金额仅为公开价目表的本地推算，不能替代各推理平台的真实账单。
结尾¶
dsh-receipt 把重复、无效的 tool 重试收成左下角一个数字，并可选一句会话内提醒，帮助你在开发阶段看见「白烧」大概有多少。查阅说明与安装细节见 SkillHub：dsh-receipt 与 GitHub：Sevyn-Star/dsh-receipt。
