用 Playwright 连接本地 Chrome（CDP 模式）科普指南
很多自动化项目默认用 Playwright 自带的浏览器（Chromium/Firefox/WebKit）启动并运行。但在一些更贴近真实用户环境的场景里，我们会选择连接本地已经安装的 Chrome，甚至直接接管你手动打开的浏览器窗口。这时最常用的方式就是CDP（Chrome DevTools Protocol）连接。
一句话总结：
CDP 模式 = 先把本地 Chrome 用远程调试端口启动起来，再让 Playwright “连进去接管”。
1. 为什么要连接本地 Chrome？
相比 Playwright 自带 Chromium，连接本地 Chrome 的常见收益包括：
环境更“真”
本地 Chrome 的版本、字体、系统证书、GPU、扩展、企业策略等，往往更接近真实用户。更方便调试
你可以先手动打开 Chrome、登录、滑动、观察页面状态，然后让 Playwright 接管继续跑流程。复用已有用户数据（登录态/缓存）
通过--user-data-dir指定一个 profile 目录，可以长期保存登录态、cookie、localStorage（前提是业务允许且你自己做好隔离）。
2. CDP 是什么？Playwright 怎么用它？
**CDP（Chrome DevTools Protocol）**是 Chrome 暴露出来的一套调试协议。只要 Chrome 以「远程调试」方式启动，外部程序就能通过 WebSocket 接入控制页面。
在 Playwright 里对应的入口通常是：
- Node.js：
chromium.connectOverCDP(endpointURL) - Python：
chromium.connect_over_cdp(endpoint_url)
3. 第一步：用远程调试端口启动本地 Chrome
你需要先手动启动 Chrome，并给它一个远程调试端口，例如9222。
Windows 示例
找到chrome.exe路径（常见位置之一）并执行：
"C:\Program Files\Google\Chrome\Application\chrome.exe"^ --remote-debugging-port=9222^ --user-data-dir="C:\chrome_profiles\playwright_profile"macOS 示例
/Applications/Google\Chrome.app/Contents/MacOS/Google\Chrome\--remote-debugging-port=9222\--user-data-dir="/tmp/chrome_playwright_profile"Linux 示例
google-chrome\--remote-debugging-port=9222\--user-data-dir="/tmp/chrome_playwright_profile"建议：一定要单独指定
--user-data-dir，不要直接接管你日常使用的默认 Chrome 用户目录，避免污染/冲突。
启动后你可以打开下面地址验证 Chrome 是否在监听：
http://127.0.0.1:9222/json/version
能看到一段 JSON（包含webSocketDebuggerUrl）就说明成功。
4. 第二步：Playwright 通过 CDP 连接 Chrome
下面给两份最小示例（你可以按项目语言选一个）。
Python 示例
fromplaywright.sync_apiimportsync_playwright CDP_URL="http://127.0.0.1:9222"withsync_playwright()asp:browser=p.chromium.connect_over_cdp(CDP_URL)context=browser.contexts[0]ifbrowser.contextselsebrowser.new_context()page=context.new_page()page.goto("https://example.com")print(page.title())# 注意：CDP 接管的浏览器通常不建议随意 browser.close()，视你的运行方式而定Node.js 示例
const{chromium}=require('playwright');(async()=>{constbrowser=awaitchromium.connectOverCDP('http://127.0.0.1:9222');constcontexts=browser.contexts();constcontext=contexts.length?contexts[0]:awaitbrowser.newContext();constpage=awaitcontext.newPage();awaitpage.goto('https://example.com');console.log(awaitpage.title());})();5. 回到你的项目：在config/base_config.py调整 xhs / dy 配置
你原话里提到：
如需使用 CDP 方式，可在 config/base_config.py 中调整 xhs 和 dy 的相关配置。
这通常意味着：项目里对「小红书（xhs）」「抖音（dy）」分别做了浏览器启动策略的配置开关，比如：
- 是否使用 CDP 接管（
use_cdp: true/false） - CDP 地址（
cdp_url: http://127.0.0.1:9222） - 端口（
cdp_port: 9222） - 是否复用已有上下文（
reuse_context） - user-data-dir/profile 相关（有些项目会写在启动命令里，有些写在配置里）
你可以按下面思路改（字段名以你项目实际为准）：
- 打开
config/base_config.py - 找到
xhs和dy的配置块 - 将启动模式从“launch”切换到“cdp”
- 填入本机端口与地址：
127.0.0.1:9222 - 确保你的 Chrome 已按第 3 节方式启动，并且端口一致
如果你把config/base_config.py中xhs/dy 那两段配置贴出来（或截图也行），我可以在不猜字段名的情况下，帮你把“应该改哪里、改成什么、为什么”直接写成可复制粘贴的版本，并把你修改的部分按你偏好加粗标注。
6. 常见坑位（提前避雷）
端口占用
9222被占用就换一个，例如9333，并同步修改配置与连接地址。防火墙/安全软件拦截
如果连不上，先用http://127.0.0.1:9222/json/version测通路。CDP 接管到的是“已存在的浏览器上下文”
连接后可能拿到的是已有 contexts/pages。你要明确是复用还是新建。不要用默认用户目录
直接接管日常 Chrome profile 容易出现锁文件、数据污染、扩展干扰。
7. 你这句话更像“说明书摘要”，如何改成发布级文案？
你给的原句：
使用 Playwright 连接本地 Chrome。如需使用 CDP 方式，可在 config/base_config.py 中调整 xhs 和 dy 的相关配置。
可以改成更清晰的文档表达，例如：
本项目支持两种浏览器模式：默认使用 Playwright 自带 Chromium；如需接管本地 Chrome（推荐用于调试/复用登录态），请以
--remote-debugging-port启动 Chrome，并在config/base_config.py中将xhs与dy的浏览器模式切换为 CDP，同时配置对应的cdp_url（如http://127.0.0.1:9222）。