dsh-ocg-billing

dsh 本身已经记录了每个会话的 Token 用量，但裸 token 数并不等于真金白银的花费。对于使用 OpenCode Go 订阅的团队或个人来说，每周花了多少钱、哪个模型最贵、缓存读写又省了多少，这些问题需要一个直观的答案。dsh-ocg-billing 正是为此而生：它只拉取一次官方定价页面，将价格表写入本地缓存，之后所有计费运算都基于缓存完成，绝不重复请求网站；后台每 24 小时自动 diff 一次，仅在官方表格变化时更新本地数据。

核心能力有三块。其一是账单计算，ocg_bill 支持全局范围（最近 N 天所有会话）或单会话粒度，按模型和会话两个维度拆分，正确处理 Cached Read、Cached Write 以及 GPT 5.6 Luna 272K、Qwen3.7/3.6 Plus 256K 等分级费率，未知模型以零成本列出并标记备查。其二是 Web 端常驻计费行，位于 composer 卡片下方，展示 7 天累计费用、月度额度进度、当前会话花费、Top 模型和价格源新鲜度，每 60 秒自动刷新，点击即可立即刷新。其三是透明的价格缓存管理，ocg_pricing_status 报告缓存健康与获取时间，ocg_pricing_check 主动拉取官方文档并与缓存 diff，仅在变化时写入，force 参数可强制刷新。

在数字之上，ocg_bill_analyze 将计算好的账单交给 dsh 默认模型，请求生成摘要、异常标记、主要费用驱动因素以及具体的省钱建议，把一张 token 清单变成可操作的洞察。适合希望在 dsh 工作流内获得周期性费用可视化的 OpenCode Go 用户，尤其是想控制订阅开销、理解成本结构的团队。