| 1 | # 用量 Catalog |
| 2 | |
| 3 | Reasonix 将可丢弃的用量聚合保存到 `<cache root>/usage-catalog/v1.sqlite`。每日统计 |
| 4 | JSONL 继续作为权威数据，并与旧版保持字节兼容。Catalog 记录文件 offset 和行 hash， |
| 5 | 用于跨进程幂等，再派生按日、source、model/provider 的 rollup。 |
| 6 | |
| 7 | 只有 JSONL append 成功后才会非阻塞提交 receipt；重复 receipt 不会重复累计。同一 |
| 8 | offset hash 改变、文件缩短/替换、队列溢出或外部追加会触发 offset 对账或按日安全重建。 |
| 9 | torn tail、空行、坏 JSON、旧 requests 默认值、时区、日期边界及 ActiveDays 语义都与 |
| 10 | 现有 JSONL decoder 一致。 |
| 11 | |
| 12 | 只有所选日期全部完成索引时才使用 SQL；否则用户主动打开统计页时执行现有 JSONL 精确 |
| 13 | 查询，同时后台继续补齐。Catalog 故障不会阻塞 provider event、TurnDone、controller |
| 14 | 启动或退出。 |
| 15 | |
| 16 | ```sh |
| 17 | reasonix doctor catalogs [--json] |
| 18 | reasonix catalogs reindex usage [--json] |
| 19 | ``` |
| 20 | |
| 21 | 诊断只暴露 schema、完整性、lag、数量和错误，不包含模型请求内容；reindex 不修改每日 |
| 22 | JSONL。 |
| 23 |