Merge pull request #23 from autoclaw-cc/perf/qrcode-login-optimization

性能优化

- 优化二维码获取流程：当页面已经在 explore 页面时跳过重复导航，二维码获取速度提升约 5–15 秒。
- 合并登录界面等待逻辑：将 `_wait_for_auth_ui` 与 `wait_for_element` 合并为一次等待，减少不必要的等待时间。
- `wait_for_login` 登录检测轮询间隔从 0.5 秒缩短到 0.3 秒，登录状态识别更快。

二维码登录体验改进

- `check-login` 在未登录时会自动返回二维码信息（`qrcode_data_url` 与 `qrcode_path`），无需额外请求。
- `get-qrcode` 新增 `qrcode_data_url` 字段，AI 或前端可以直接以内嵌 Markdown 的方式展示二维码。
- 新增 `_open_file_if_display`：在有桌面环境时自动打开二维码图片，方便直接扫码。
- QR 码生成优化：使用 goqr.me API 替代 base64 方案，并消除重复导航。

登录流程简化

- `SKILL.md` 中的方式 A 登录流程从 3 步简化为 2 步：
  - `check-login`
  - `wait-login`

自动降级机制

当手机验证码登录触发频率限制时：

- `send-code` 会自动切换到二维码登录（`_qrcode_fallback`）。
- `check-login` 也会在未登录时直接返回二维码，避免额外操作。

标题长度检测强化

- 修复标题长度超过小红书限制时，发布失败但仍显示发布成功的问题。

问题修复

- 修复 `cmd_phone_login` 在验证码发送频率限制时未正确捕获异常的问题。
- 新增 `_qrcode_fallback`，在此类情况下自动降级为二维码登录。

Author: Angiin

scripts/cli.py

@@ -81,6 +81,28 @@ def _output(data: dict, exit_code: int = 0) -> None:
     sys.exit(exit_code)
 
 
+def _open_file_if_display(path: str) -> None:
+    """有桌面环境时用系统默认程序打开文件，无界面环境静默跳过。"""
+    from chrome_launcher import has_display
+
+    if not has_display():
+        return
+
+    import platform
+    import subprocess
+
+    try:
+        system = platform.system()
+        if system == "Windows":
+            os.startfile(path)
+        elif system == "Darwin":
+            subprocess.Popen(["open", path])
+        else:
+            subprocess.Popen(["xdg-open", path])
+    except Exception:
+        logger.debug("无法自动打开文件: %s", path)
+
+
 def _update_account_nickname(args: argparse.Namespace, page) -> None:
     """登录成功后，将平台昵称写入账号描述（best-effort，失败不影响登录结果）。"""
     if not getattr(args, "account", ""):
@@ -229,43 +251,105 @@ def _headless_fallback(port: int) -> None:
             exit_code=1,
         )
 
+def _qrcode_fallback(browser, page, args: argparse.Namespace) -> None:
+    """频率限制时刷新页面返回二维码，让 AI 直接展示给用户扫码。"""
+    from xhs.login import (
+        fetch_qrcode,
+        make_qrcode_url,
+        save_qrcode_to_file,
+    )
+    from xhs.urls import EXPLORE_URL
+
+    # 刷新页面使登录弹窗回到默认的二维码 tab
+    page.navigate(EXPLORE_URL)
+    page.wait_for_load()
+
+    png_bytes, _b64_orig, already = fetch_qrcode(page)
+    if already:
+        browser.close()
+        _output({"logged_in": True, "message": "已登录"})
+        return
+
+    qrcode_path = save_qrcode_to_file(png_bytes)
+    image_url, login_url = make_qrcode_url(png_bytes)
+
+    _open_file_if_display(qrcode_path)
+
+    _save_login_tab(page.target_id, args.port)
+    _clear_session_tab(args.port)
+    browser.close()
+    result: dict = {
+        "logged_in": False,
+        "login_method": "qrcode",
+        "qrcode_path": qrcode_path,
+        "qrcode_image_url": image_url,
+        "message": (
+            "验证码发送受限，已切换为二维码登录，请扫码。"
+            "扫码后运行 wait-login 等待登录结果。"
+        ),
+    }
+    if login_url:
+        result["qr_login_url"] = login_url
+    _output(result, exit_code=1)
+
 
 # ========== 子命令实现 ==========
 
 
 def cmd_check_login(args: argparse.Namespace) -> None:
-    """检查登录状态。"""
-    from xhs.login import check_login_status
+    """检查登录状态。未登录时自动获取二维码，省去单独调 get-qrcode 的一轮通信。
+
+    直接调 fetch_qrcode 一步完成：导航 + 登录检查 + 二维码获取，
+    不再经过 check_login_status 避免重复导航和等待。
+    """
+    from xhs.login import (
+        fetch_qrcode,
+        make_qrcode_url,
+        save_qrcode_to_file,
+    )
 
     browser, page = _connect(args)
     try:
-        logged_in = check_login_status(page)
-        if logged_in:
+        png_bytes, _b64_orig, already = fetch_qrcode(page)
+        if already:
             _output({"logged_in": True}, exit_code=0)
+            return
+
+        qrcode_path = save_qrcode_to_file(png_bytes)
+        image_url, login_url = make_qrcode_url(png_bytes)
+
+        # 记录 login tab + 清除 session tab
+        _save_login_tab(page.target_id, args.port)
+        _clear_session_tab(args.port)
+
+        _open_file_if_display(qrcode_path)
+
+        from chrome_launcher import has_display
+
+        result: dict = {
+            "logged_in": False,
+            "qrcode_path": qrcode_path,
+            "qrcode_image_url": image_url,
+        }
+        if login_url:
+            result["qr_login_url"] = login_url
+        if has_display():
+            result["login_method"] = "qrcode"
+            result["hint"] = (
+                "未登录，二维码已自动生成。"
+                "扫码后运行 wait-login 等待登录结果"
+            )
         else:
-            import platform
-            from chrome_launcher import has_display
-            system = platform.system()
-
-            if has_display():
-                # 所有有界面环境（macOS/Windows/Linux 桌面）：二维码显示在对话窗口
-                _output({
-                    "logged_in": False,
-                    "login_method": "qrcode",
-                    "hint": "请运行 get-qrcode 获取二维码，扫码后运行 wait-login 等待登录结果",
-                }, exit_code=1)
-            else:
-                # 无界面服务器：二维码或手机验证码均可
-                _output({
-                    "logged_in": False,
-                    "login_method": "both",
-                    "hint": (
-                        "方式A: get-qrcode + wait-login（二维码显示在对话窗口）；"
-                        "方式B: send-code --phone <手机号> + verify-code（手机验证码）"
-                    ),
-                }, exit_code=1)
+            result["login_method"] = "both"
+            result["hint"] = (
+                "未登录，二维码已自动生成。"
+                "方式A: 直接扫码 + wait-login；"
+                "方式B: send-code --phone <手机号>"
+                " + verify-code（手机验证码）"
+            )
+        _output(result, exit_code=1)
     finally:
-        # 不关闭 tab，保留页面供下次命令复用（_SESSION_TAB_FILE）
+        # 只断开 CDP 连接，不关闭 tab——保留登录页面
         browser.close()
 
 
@@ -275,15 +359,16 @@ def cmd_login(args: argparse.Namespace) -> None:
 
     browser, page = _connect(args)
     try:
-        png_bytes, already = fetch_qrcode(page)
+        png_bytes, _b64, already = fetch_qrcode(page)
         if already:
             _output({"logged_in": True, "message": "已登录"})
             return
 
         qrcode_path = save_qrcode_to_file(png_bytes)
+        _open_file_if_display(qrcode_path)
         print(
             json.dumps(
-                {"qrcode_path": qrcode_path, "message": "请扫码登录，二维码已保存到文件"},
+                {"qrcode_path": qrcode_path, "message": "请扫码登录"},
                 ensure_ascii=False,
             )
         )
@@ -301,19 +386,33 @@ def cmd_login(args: argparse.Namespace) -> None:
 
 def cmd_phone_login(args: argparse.Namespace) -> None:
     """手机号+验证码登录（适用于无界面服务器）。"""
+    from xhs.errors import RateLimitError
     from xhs.login import send_phone_code, submit_phone_code
 
     browser, page = _connect(args)
     try:
         sent = send_phone_code(page, args.phone)
+    except RateLimitError:
+        # 频率限制——直接切换二维码登录
+        logger.info("验证码发送受限，切换为二维码登录")
+        _qrcode_fallback(browser, page, args)
+        return
+
+    try:
         if not sent:
             _output({"logged_in": True, "message": "已登录，无需重新登录"})
             return
 
         # 输出提示，等待用户在终端输入验证码
         print(
             json.dumps(
-                {"status": "code_sent", "message": f"验证码已发送至 {args.phone[:3]}****{args.phone[-4:]}"},
+                {
+                    "status": "code_sent",
+                    "message": (
+                        f"验证码已发送至 "
+                        f"{args.phone[:3]}****{args.phone[-4:]}"
+                    ),
+                },
                 ensure_ascii=False,
             ),
             flush=True,
@@ -326,16 +425,25 @@ def cmd_phone_login(args: argparse.Namespace) -> None:
             try:
                 code = input("请输入验证码: ").strip()
             except EOFError:
-                _output({"success": False, "error": "未收到验证码输入"}, exit_code=2)
+                _output(
+                    {"success": False, "error": "未收到验证码输入"},
+                    exit_code=2,
+                )
                 return
 
         if not code:
-            _output({"success": False, "error": "验证码不能为空"}, exit_code=2)
+            _output(
+                {"success": False, "error": "验证码不能为空"},
+                exit_code=2,
+            )
             return
 
         success = submit_phone_code(page, code)
         _output(
-            {"logged_in": success, "message": "登录成功" if success else "验证码错误或超时"},
+            {
+                "logged_in": success,
+                "message": "登录成功" if success else "验证码错误或超时",
+            },
             exit_code=0 if success else 2,
         )
     finally:
@@ -351,30 +459,42 @@ def cmd_get_qrcode(args: argparse.Namespace) -> None:
     调用方收到 qrcode_data_url 后直接内嵌到对话窗口显示；同时浏览器窗口（GUI 环境）
     也会显示二维码，用户可选择扫任意一个。
     """
-    from xhs.login import fetch_qrcode, save_qrcode_to_file
+    from xhs.login import (
+        fetch_qrcode,
+        make_qrcode_url,
+        save_qrcode_to_file,
+    )
 
     browser, page = _connect(args)
 
-    png_bytes, already = fetch_qrcode(page)
+    png_bytes, _b64_orig, already = fetch_qrcode(page)
     if already:
         browser.close_page(page)
         browser.close()
         _output({"logged_in": True, "message": "已登录"})
         return
 
     qrcode_path = save_qrcode_to_file(png_bytes)
+    image_url, login_url = make_qrcode_url(png_bytes)
+
+    _open_file_if_display(qrcode_path)
 
     # 记录 login tab，供 wait-login 精确 reconnect
     _save_login_tab(page.target_id, args.port)
-    # 清除 session tab 引用——隔离登录表单，防止其他命令复用并关闭/导航该 tab
+    # 清除 session tab 引用——隔离登录表单，防止其他命令复用
     _clear_session_tab(args.port)
 
-    # 只断开 CDP 连接，不关闭 tab——QR 会话保持，用户可继续扫码
+    # 只断开 CDP 连接，不关闭 tab——QR 会话保持
     browser.close()
-    _output({
+    result: dict = {
         "qrcode_path": qrcode_path,
-        "message": "二维码已生成，请扫码登录。扫码后运行 check-login 确认登录状态。",
-    })
+        "qrcode_image_url": image_url,
+        "message": "二维码已生成，请扫码登录。"
+        "扫码后运行 wait-login 等待登录结果。",
+    }
+    if login_url:
+        result["qr_login_url"] = login_url
+    _output(result)
 
 
 def cmd_wait_login(args: argparse.Namespace) -> None:
@@ -402,39 +522,39 @@ def cmd_wait_login(args: argparse.Namespace) -> None:
 
 
 def cmd_send_code(args: argparse.Namespace) -> None:
-    """分步登录第一步：填写手机号并发送验证码，保持页面不关闭。"""
-    from chrome_launcher import has_display, restart_chrome
+    """分步登录第一步：填写手机号并发送验证码，保持页面不关闭。
+
+    频率限制时返回错误信息和建议，由 AI 告知用户选择。
+    """
     from xhs.errors import RateLimitError
     from xhs.login import send_phone_code
 
-    for attempt in range(2):
-        browser, page = _connect(args)
-        try:
-            sent = send_phone_code(page, args.phone)
-            if not sent:
-                _output({"logged_in": True, "message": "已登录，无需重新登录"})
-                return
-
-            # 记录 login tab，供 verify-code 精确 reconnect
-            _save_login_tab(page.target_id, args.port)
-            # 清除 session tab 引用——隔离登录表单，防止其他命令复用并关闭/导航该 tab
-            _clear_session_tab(args.port)
-            _output({
-                "status": "code_sent",
-                "message": f"验证码已发送至 {args.phone[:3]}****{args.phone[-4:]}，请运行 verify-code --code <验证码>",
-            })
-        except RateLimitError:
-            browser.close()
-            if attempt == 0:
-                logger.info("请求频率限制，重启 Chrome 后重试...")
-                restart_chrome(port=args.port, headless=not has_display())
-                continue
-            _output({"success": False, "error": "请求太频繁，重启后仍失败，请稍后再试"}, exit_code=2)
-        else:
-            # 只断开控制连接，不关闭页面——tab 保持打开，verify-code 继续复用
-            browser.close()
+    browser, page = _connect(args)
+    try:
+        sent = send_phone_code(page, args.phone)
+        if not sent:
+            _output({"logged_in": True, "message": "已登录，无需重新登录"})
             return
 
+        # 记录 login tab，供 verify-code 精确 reconnect
+        _save_login_tab(page.target_id, args.port)
+        # 清除 session tab 引用——隔离登录表单，防止其他命令复用并关闭/导航该 tab
+        _clear_session_tab(args.port)
+        _output({
+            "status": "code_sent",
+            "message": (
+                f"验证码已发送至 {args.phone[:3]}****{args.phone[-4:]}，"
+                "请运行 verify-code --code <验证码>"
+            ),
+        })
+    except RateLimitError:
+        # 频率限制——直接切换二维码登录
+        logger.info("验证码发送受限，切换为二维码登录")
+        _qrcode_fallback(browser, page, args)
+    else:
+        # 只断开控制连接，不关闭页面——tab 保持打开，verify-code 继续复用
+        browser.close()
+
 
 def cmd_verify_code(args: argparse.Namespace) -> None:
     """分步登录第二步：在已有页面上填写验证码并提交。"""