ETL 完成

etl_billiards/cli/main.py

@@ -40,6 +40,23 @@ def parse_args():
     parser.add_argument("--api-timeout", type=int, help="API超时(秒)")
     parser.add_argument("--api-page-size", type=int, help="分页大小")
     parser.add_argument("--api-retry-max", type=int, help="API重试最大次数")
+
+    # 回溯/手动窗口
+    parser.add_argument(
+        "--window-start",
+        dest="window_start",
+        help="固定时间窗口开始（优先级高于游标，例如：2025-07-01 00:00:00）",
+    )
+    parser.add_argument(
+        "--window-end",
+        dest="window_end",
+        help="固定时间窗口结束（优先级高于游标，推荐用月末+1，例如：2025-08-01 00:00:00）",
+    )
+    parser.add_argument(
+        "--force-window-override",
+        action="store_true",
+        help="强制使用 window_start/window_end，不走 MAX(fetched_at) 兜底",
+    )
     
     # 目录参数
     parser.add_argument("--export-root", help="导出根目录")
@@ -108,6 +125,16 @@ def build_cli_overrides(args) -> dict:
     if args.write_pretty_json:
         overrides.setdefault("io", {})["write_pretty_json"] = True
 
+    # 回溯/手动窗口
+    if args.window_start or args.window_end:
+        overrides.setdefault("run", {}).setdefault("window_override", {})
+        if args.window_start:
+            overrides["run"]["window_override"]["start"] = args.window_start
+        if args.window_end:
+            overrides["run"]["window_override"]["end"] = args.window_end
+    if args.force_window_override:
+        overrides.setdefault("run", {})["force_window_override"] = True
+
     # 运行窗口
     if args.idle_start:
         overrides.setdefault("run", {}).setdefault("idle_window", {})["start"] = args.idle_start