previous-draft/collect.py

第 1 条注释，第 1 行

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

第 2 条注释，第 2 行

previous-draft/collect.py:2

"""LLM 用量采集与统计入口。

两种运行方式：
1. Blueprint Automation 托管执行，调用 run(ctx)。
   ctx.input: {"refresh": bool, "tools": [名称...]}
2. 独立运行：python collect.py [--refresh] [--tool NAME ...] [--out PATH]
   增量采集后把统计快照写入 dashboard/data.json（供静态看板读取），
   并打印各数据源状态。数据库默认使用 data/usage.db。
"""

第 3 条注释，第 21 行

previous-draft/collect.py:21

# 保留 noqa: E402 指令，允许此处的导入顺序。

第 4 条注释，第 22 行

previous-draft/collect.py:22

# 保留 noqa: E402 指令，允许此处的导入顺序。

第 5 条注释，第 23 行

previous-draft/collect.py:23

# 保留 noqa: E402 指令，允许此处的导入顺序。

第 6 条注释，第 29 行

previous-draft/collect.py:29

"""自动发现 collectors/ 包下的所有采集器模块——新增工具只需丢一个文件进来。"""

第 7 条注释，第 90 行

previous-draft/collect.py:90

# 只重算有新事件的日期——历史数据直接沿用缓存