feat: 支持连接用户已有的 Chrome 浏览器进行爬取

新增 CDP_CONNECT_EXISTING 配置项，默认开启，通过 Chrome 远程调试功能
(chrome://inspect/#remote-debugging) 直接连接用户正在使用的浏览器，
复用真实的 Cookie、扩展和浏览历史，大幅降低平台风控检测风险。

主要变更:
- 新增 _connect_existing_browser 方法，通过 ws:// 直接连接已有浏览器
- 支持等待用户在浏览器端确认连接对话框（60秒超时）
- cleanup 时不关闭用户的浏览器进程
- 修复小红书在真实浏览器下 cookie 过多导致签名失败的问题
- 更新 README、CDP使用指南和常见问题文档

docs/CDP模式使用指南.md

@@ -12,34 +12,63 @@ CDP（Chrome DevTools Protocol）模式是一种高级的反检测爬虫技术
 4. **扩展支持**: 可以利用用户安装的广告拦截器、代理扩展等工具
 5. **更自然的行为**: 浏览器行为模式更接近真实用户
 
+### 📌 两种 CDP 模式
+
+CDP模式支持两种使用方式：
+
+| 模式 | 说明 | 适用场景 |
+|------|------|----------|
+| **连接已有浏览器**（默认推荐） | 连接用户正在使用的 Chrome 浏览器，复用真实的 Cookie、扩展和浏览历史 | 反检测要求高，需要最大程度降低风控风险 |
+| **启动新浏览器** | 自动检测并启动一个新的 Chrome/Edge 浏览器实例 | 不需要复用浏览器状态的场景 |
+
 ## 快速开始
 
-### 1. 启用CDP模式
+### 方式一：连接已有浏览器（默认推荐）
 
-在 `config/base_config.py` 中设置：
+这是**默认且推荐**的方式，直接连接你正在使用的 Chrome 浏览器，反检测效果最好。
+
+#### 第一步：确保 Chrome 版本
+
+需要 Chrome **144 或更高版本**（2026年1月起的稳定版均支持）。在地址栏输入 `chrome://version` 查看当前版本。
+
+如果版本过低，请前往 [Chrome 官网](https://www.google.com/chrome/) 下载最新版。
+
+#### 第二步：开启远程调试
+
+1. 在 Chrome 地址栏输入：`chrome://inspect/#remote-debugging`
+2. 勾选 **"Allow remote debugging for this browser instance"**
+3. 页面会显示 `Server running at: 127.0.0.1:9222`，表示已就绪
+
+#### 第三步：运行爬虫
+
+```bash
+uv run main.py --platform xhs --lt qrcode --type search
+```
+
+运行后，Chrome 浏览器会**弹出确认对话框**，点击"接受"即可。程序会等待用户确认（默认60秒超时）。
+
+#### 配置说明
+
+`config/base_config.py` 中的默认配置：
 
 ```python
 # 启用CDP模式
 ENABLE_CDP_MODE = True
 
-# CDP调试端口（可选，默认9222）
+# 连接已有浏览器（默认开启）
+CDP_CONNECT_EXISTING = True
+
+# CDP调试端口（与 chrome://inspect 页面显示的端口一致）
 CDP_DEBUG_PORT = 9222
-
-# 是否在无头模式下运行（建议设为False以获得最佳反检测效果）
-CDP_HEADLESS = False
-
-# 程序结束时是否自动关闭浏览器
-AUTO_CLOSE_BROWSER = True
 ```
 
-### 2. 运行测试
+### 方式二：启动新浏览器
 
-```bash
-# 运行CDP功能测试
-python examples/cdp_example.py
+如果不想连接已有浏览器，可以让程序自动启动一个新的浏览器实例：
 
-# 运行小红书爬虫（CDP模式）
-python main.py
+```python
+ENABLE_CDP_MODE = True
+CDP_CONNECT_EXISTING = False  # 关闭连接已有浏览器，改为启动新浏览器
 ```
 
 ## 配置选项详解
@@ -48,7 +77,8 @@ python main.py
 
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `ENABLE_CDP_MODE` | bool | False | 是否启用CDP模式 |
+| `ENABLE_CDP_MODE` | bool | True | 是否启用CDP模式 |
+| `CDP_CONNECT_EXISTING` | bool | True | 是否连接已有浏览器（推荐开启） |
 | `CDP_DEBUG_PORT` | int | 9222 | CDP调试端口 |
 | `CDP_HEADLESS` | bool | False | CDP模式下的无头模式 |
 | `AUTO_CLOSE_BROWSER` | bool | True | 程序结束时是否关闭浏览器 |
@@ -57,8 +87,8 @@ python main.py
 
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `CUSTOM_BROWSER_PATH` | str | "" | 自定义浏览器路径 |
-| `BROWSER_LAUNCH_TIMEOUT` | int | 30 | 浏览器启动超时时间（秒） |
+| `CUSTOM_BROWSER_PATH` | str | "" | 自定义浏览器路径（仅启动新浏览器模式下有效） |
+| `BROWSER_LAUNCH_TIMEOUT` | int | 60 | 浏览器连接超时时间（秒） |
 
 ### 自定义浏览器路径
 
@@ -219,15 +249,25 @@ ps aux | grep chrome
 
 ## 技术原理
 
-CDP模式的工作原理：
+### 连接已有浏览器模式（推荐）
+
+1. **用户开启远程调试**: 在 `chrome://inspect/#remote-debugging` 中勾选启用
+2. **WebSocket连接**: 程序通过 `ws://localhost:9222/devtools/browser` 直接连接浏览器
+3. **用户确认**: Chrome 弹出确认对话框，用户点击接受后连接建立
+4. **Playwright集成**: 使用 `connectOverCDP` 方法接管浏览器控制
+5. **上下文复用**: 直接使用浏览器已有的上下文（包含用户的Cookie、登录状态等）
+
+> 💡 与传统CDP模式的区别：传统方式通过 `--remote-debugging-port` 启动新浏览器，使用 HTTP 接口 `/json/version` 获取 WebSocket URL。而连接已有浏览器方式直接通过 WebSocket 连接，Chrome 新版（136+）的远程调试不提供 HTTP 接口，需要用户在浏览器端确认授权。
+
+### 启动新浏览器模式
 
 1. **浏览器检测**: 自动扫描系统中的Chrome/Edge安装路径
 2. **进程启动**: 使用`--remote-debugging-port`参数启动浏览器
-3. **CDP连接**: 通过WebSocket连接到浏览器的调试接口
+3. **CDP连接**: 通过 HTTP 获取 WebSocket URL，再连接到浏览器的调试接口
 4. **Playwright集成**: 使用`connectOverCDP`方法接管浏览器控制
 5. **上下文管理**: 创建或复用浏览器上下文进行操作
 
-这种方式绕过了传统WebDriver的检测机制，提供了更加隐蔽的自动化能力。
+两种方式都绕过了传统WebDriver的检测机制，提供了更加隐蔽的自动化能力。连接已有浏览器模式的反检测效果更好，因为使用的是用户真实的浏览器环境。
 
 ## 更新日志