previous-draft/store.py

第 1 条注释，第 1 行

# 文件编码为 UTF-8；保留原生编码声明。

"""LLM 用量存储层：原始事件表 + 按日聚合缓存（历史数据缓存优先，保留一年）。"""

"""本地时区（运行机器时区）的日期串。"""

# ---- 采集状态（增量游标/文件偏移） ----

# ---- 事件写入（不重复新增） ----

"""插入事件，返回实际新插入事件的 day 列表（去重后）。"""

# ---- 按日聚合缓存 ----

"""重算指定日期的聚合缓存（历史数据直接读缓存，不回溯源）。"""

# ---- 查询 ----

"""指定日期按 本地小时 × 工具 × 模型 聚合（今日实时图表用）。"""