合并

etl_billiards/fetch-test/README.md

@@ -0,0 +1,25 @@
+# fetch-test
+
+用于放置“接口联调/规则验证”的一次性脚本（不影响主流程）。
+
+## 近期记录 vs 历史记录(Former) 对比
+
+脚本：`fetch-test/compare_recent_former_endpoints.py`
+
+默认对比窗口（end 为次日 00:00:00，与 ETL 窗口一致）：
+- 近期：2025-12-01 ~ 2025-12-15
+- 历史：2025-08-01 ~ 2025-08-15
+
+运行：
+```bash
+cd etl_billiards
+python fetch-test/compare_recent_former_endpoints.py
+```
+
+输出：
+- `etl_billiards/fetch-test/recent_vs_former_report.md`
+- `etl_billiards/fetch-test/recent_vs_former_report.json`
+
+依赖：
+- `.env` 需配置 `API_TOKEN`（或 `FICOO_TOKEN`）与 `STORE_ID`，并保证 `API_BASE` 正确。
+