前言¶
在 DeepSeek Harness（DSH）里跑 agent，界面里通常能看到「消耗」「耗时」和会话级的 token 统计。这些数字能说明用了多少，却很难直接回答两件事：人民币具体花在哪一类 token 上，以及你按建议改了用法之后，指标有没有真的变好。
DSH Cost Audit 是社区维护者 Pingze-github 的 Web 端插件，把费用和拆解挂进 harness 已有的统计形态，并在建议被采纳后重新测量相关指标，让「照做了」对应一组读数，而不是主观感受。
这是什么¶
DSH Cost Audit（dsh-cost-audit，当前 package 版本 0.1.0，MIT 许可证）面向 DeepSeek Harness Web GUI。它只聚焦一个问题：钱花到哪去了，照它说的做到底有没有用？
插件不改动官方「消耗」「耗时」胶囊的几何与样式，只在旁边追加自己的胶囊，并使用同一套图标胶囊、dt/dd 面板与设计 token。金额按 DeepSeek 官方人民币列表价估算；账户余额则从账单接口实时读取，可用于校准估算。
核心功能¶
每轮与每会话的费用胶囊¶
每轮：助手动作行里，在复制按钮与分支按钮之间、紧挨官方「消耗」「耗时」胶囊，多一个显示本轮人民币（如 ¥0.01）的胶囊。点开可见模型路由、缓存命中比例（不四舍五入成假的 100%）、缓存读取 / 未命中输入 / 缓存写入 / 总输入 / 输出 token，以及本轮费用和耗时分布。
每会话：与会话统计同一行追加类似 ¥2.72 · today ¥0.41 · Account balance ¥113.45 的摘要——会话总额、当日在本会话上的花费（隔日再打开会话时「今日」从零计，不用生命周期数字代替）、实时账户余额。面板内还有整段持久日志的 token 桶拆解、耗时分布，以及从 DeepSeek 账单接口读取的余额与赠送 / 充值构成。
别处往往统计不到的项里，插件单独列出上下文压缩时摘要调用自己的账单，并区分手动触发的压缩与 harness 系统自动压缩。
耗时分布¶
每轮与会话面板的用量部分都以「时间去哪了」收尾。工具行按名称排序，包括总耗时、模型用时、首 token 平均（TTFT）、生成阶段（含 tok/s）、工具用时、其他开销，以及最忙 6 个工具的明细（其余合并一行）。事件锚点来自 harness 日志中的 turn/start、step/start、tool/call 等。
省 Token 建议引擎¶
只有在确有数据支撑时，才会出现第四个「建议」胶囊；健康会话不为它占空间。建议由持久日志折叠得出，不调用模型。每条带严重程度、一行修法，以及按会话保存在浏览器里的「忽略」。
| 代号 | 触发条件（摘要） | 可一键动作 |
|---|---|---|
context-reread |
缓存重读 ≥ 会话花费 35%，且模型调用 ≥ 30 次 | 提交 /compact 立即压缩本会话 |
fragmented-tools |
某工具 ≥ 30 次且 ≥ 60% 不足 2 秒 | 让 agent 合并成脚本 |
repeated-target |
同一工具对同一目标 ≥ 4 次 | 读一次记结论，之后用 grep |
idle-grinding |
连续 ≥ 30 步无 write / edit / 交付 | 要进度汇报 |
tool-failures |
同一工具连续失败 3 次 | 停下来读完错误 |
cache-hit-drop |
50 次以上调用命中率 < 85% | 查每轮改请求头的原因 |
compaction-churn |
系统自动压缩 ≥ 3 次或摘要 ≥ 会话 10% | 需改宿主配置（说明在面板） |
model-retries |
模型重试 ≥ 5 次 | 手动处理说明 |
balance-low |
按当前速度余额撑不过约五个会话 | 充值等 |
手动 /compact 不计入「频繁压缩」的系统自动计数；compaction-churn 只看 harness 自己决定的压缩。金额统一两位小数；真有钱但低于显示粒度时显示 <¥0.01。
采纳建议与再测量¶
可执行建议通过输入框的 setDraft + submit 提交进本会话，与发送按钮同路径，agent 下一步会读到。输入框非空时执行按钮禁用；每条建议发出后自身禁用，避免重复点击。
采纳后建议仍留在列表，并随会话更新判定：已采纳 · 有改善 / 基本持平 / 反而变差 / 还在观察。判定块会写明实际执行了什么（如 已执行 /compact），样本不足时给出基线与还差多少证据；对压缩还会在摘要落地后补上该次命令花费。读数自采纳时刻的快照起算，与建议相关的指标（上下文 token、短调用占比、重复调用、失败占比、缓存命中率等）用基线比例门槛比较。界面语言跟随 harness：zh 简体中文，en 英文。
全账号与细粒度视图¶
全账号 · 最近 7 天：合并所有会话的按日桶，回答「是不是比以前花得少了」这类跨会话问题。产出侧分母保留两项：每产出编辑（每次 write / edit / present 的费用）与每 1K 回答 token；曲线绘制重读 / 冷输入 / 输出及其中压缩摘要（子集，非第四项）、高峰占比等。数据来自持久日志折叠，历史可回填（上限约 90 天）。面板注明：金额为列表价估算；部分调用日志无用量，报表是下界；趋势不能自动归因到你采纳的建议。
细粒度：同一批事件按分钟 / 小时折开，一行一个量度（均除以调用次数）。窗口决定桶宽：2 小时→1 分钟、24 小时→5 分钟、7 天→1 小时。改思考档位、换模型、子 agent、/compact、压缩摘要、切 preset 等会标为竖虚线。提供上下文档位与并发开关，便于在同档位内比较策略。
计价规则（摘要）¶
计价引用 DeepSeek 官方文档中的元 / 100 万 token；高峰为北京时间周一至周五 09:00–12:00、14:00–18:00，其余及周末为半价。deepseek-flash 族与 deepseek-pro / deepseek-v4-pro 族分别有一套 peak / off 的 cacheHit、cacheMiss、output 单价；不带 v4 或 deepseek 标记的模型名会计 token 但不计价，费用显示 —。
安装与启用¶
插件以 DSH 进程权限运行，安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。
Web profile 安装：
dsh plugin --profile web add github:Pingze-github/dsh-cost-audit
安装后刷新浏览器以加载客户端 bundle。本地 checkout 开发可用实时链接：
dsh plugin --profile web add link:/path/to/dsh-cost-audit
若已装 dsh-hotswap，新 bundle 可热挂载，一般不必重启 dsh web（重启会结束当前承载的会话）。重命名 link: 安装的插件可能导致 profile 里卸不掉的开机条目与重复 bundle 注册；补救是从 profile 清单摘掉条目再加回，而非仅靠重启。
可选配置写入同 id 的 profile 补丁层，例如账单 baseUrl、credentialRef（默认 DEEPSEEK_API_KEY）、balanceCacheMs、requestTimeoutMs 及 pricing 下 flash / pro 的 peak / off 单价覆盖。
典型用法¶
1、按上文命令为 web profile 安装插件并刷新页面。
2、打开任意会话，在助手每轮动作行查看新增的人民币胶囊，点开核对模型、缓存桶与耗时分布。
3、在会话顶栏统计行查看会话总额、今日花费与账户余额；需要跨会话趋势时打开成本面板底部的「全账号 · 最近 7 天」。
4、当出现「建议」胶囊时，阅读触发原因；若输入框为空，可对可执行项点一键采纳，随后在列表里查看「已采纳」判定与基线对比。
5、若要校准余额或改 API 端点，在 profile 中为 dsh-cost-audit 设置 credentialRef 与可选 baseUrl、pricing。
适用场景与注意¶
适合：长期在 DSH Web 里跑 agent、需要人民币维度拆解 token、关心压缩摘要是否悄悄烧钱、希望用可复现指标验证改用法是否有效的前端 / 全栈 / 智能体开发者。
注意：
- 费用为基于供应商回报用量的估算；余额为实时读取，可用于对照。
- 建议引擎保守触发，且不调用模型；「基本持平」应视为常见 honest 结果。
- 报表不能证明花费变化由某条建议导致，需自行对齐采纳时间与趋势。
- 社区插件目录 SkillHub 条目 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，以仓库 README 与源码为准。
结尾¶
DSH Cost Audit 把 harness 里已有的统计位置扩展成可操作的 cost audit：从每轮、每会话到全账号与细粒度曲线，并把「采纳建议 → 再测量」做成面板上的数字。进一步了解与 issue 见 GitHub：Pingze-github/dsh-cost-audit；目录页：SkillHub — dsh-cost-audit。
