chore: auto release commit (2026-09-14 23:55:58)

scripts/cli/app.py

@@ -198,8 +198,8 @@ def cmd_render_html(args: argparse.Namespace) -> int:
 def cmd_collect_platform(args: argparse.Namespace) -> int:
     """Playwright RPA 抓 SmartCampus HR 平台数据 → 落库。
 
-    首次需用户手工登录保存 cookie（默认 headless=False 便于交互）；
-    后续可用 headless=True 复用 profile。
+    默认显示浏览器，以便登录态失效时可立即手工登录；
+    传 --headless 可复用已保存的 profile 进行无头采集。
 
     退出码：
         0 = 成功（即使抓到 0 行也返回 0，错误信息在 output["error"]）
@@ -209,7 +209,7 @@ def cmd_collect_platform(args: argparse.Namespace) -> int:
     try:
         result = platform_collector.collect_all(
             limit=args.limit,
-            headless=not args.show_browser,
+            headless=args.headless,
             human_wait_timeout=args.human_wait_timeout or HUMAN_WAIT_TIMEOUT,
         )
     except platform_collector.RPAError as e:
@@ -344,8 +344,11 @@ def build_parser() -> argparse.ArgumentParser:
     )
     sp.add_argument("--limit", type=int, default=0,
                     help="限制抓取行数（0=全量）")
-    sp.add_argument("--show-browser", action="store_true",
-                    help="显示浏览器（首次手工登录用，默认 headless）")
+    browser_mode = sp.add_mutually_exclusive_group()
+    browser_mode.add_argument("--headless", action="store_true",
+                              help="无头运行（仅适合已保存有效登录态的自动化任务）")
+    browser_mode.add_argument("--show-browser", dest="headless", action="store_false",
+                              help=argparse.SUPPRESS)
     sp.add_argument("--human-wait-timeout", type=int, default=None,
                     help="手工登录 fallback 等待秒数（默认 180 = HUMAN_WAIT_TIMEOUT）")
     sp.set_defaults(handler=cmd_collect_platform)