当用户明确希望连接到已运行的 Chrome 浏览器、扫描本地 CDP 端口、显式指定 `cdp_port`，或让多个 agent / 工具共享同一个浏览器时，使用本 skill。browser 默认不开放调试端口；仅当用户明确希望其他本地工具附加时才显式传入 `cdp_port`。
复制下面这句话，粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具，它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-browser-cdp-zh-b310f565e0d2 ，按照其中的说明把「browser_cdp」安装到你（当前 AI 工具）中。执行前先告诉我将运行的命令和写入的位置，等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件，由原作者维护。在 GitHub 查看
已弃用： 此参考服务于稳定的
browser实现。启用实验模式时，请优先使用统一的browser工具。
browser 默认不开放调试端口，浏览器由 Playwright 直接管理。本 skill 关注的是有意需要 CDP 端口的场景。
本 skill 关注的是更“显式”的 CDP 用法：
connect_cdp）cdp_port 启动浏览器也就是说：
start 不开放调试端口，通常不需要用户理解或感知 CDP 细节隐私建议
默认
start本身不暴露任何东西——不会开放调试端口。只有用户明确希望其他本地工具附加时才传cdp_port，并应先提示暴露风险。
⚠️ 单 workspace 单浏览器实例
同一 workspace 同时只能运行或连接一个浏览器。若当前已有浏览器实例，必须先执行
stop，再切换到新的浏览器或新的 CDP 连接。
仅在用户明确表达以下意图时使用本 skill：
以下情况通常不要进入本 skill：
这些情况通常直接使用普通 start，必要时加 headed=true，参考 browser_visible 即可。
默认扫描端口范围 9000–10000：
{"action": "list_cdp_targets"}
指定单个端口：
{"action": "list_cdp_targets", "port": 9222}
自定义扫描范围：
{"action": "list_cdp_targets", "port_min": 8000, "port_max": 12000}
适用场景：
连接已存在的 CDP 端点：
{"action": "connect_cdp", "cdp_url": "http://localhost:9222"}
特点：
open、snapshot、click、type 等常规操作stop 时只断开连接，不会关闭外部浏览器适用场景：
如果用户明确要求使用固定端口，或需要把端点提供给其他工具，可以在 start 时指定 cdp_port：
{"action": "start", "cdp_port": 9222}
如需同时打开可见窗口：
{"action": "start", "headed": true, "cdp_port": 9222}
当前行为说明：
cdp_port 已被占用，会直接报错，不会强行复用cdp_port，则完全不开放端口，也不会自动挑选端口因此：
cdp_portcdp_port当前多 workspace 下的端口策略是：
127.0.0.1:cdp_port 是否已占用；若已占用则直接失败，提示用户换端口或先停止旧进程这意味着：
cdp_port，后启动的那个会因为端口已占用而失败CDP 相关 stop 需要区分两类：
例如：
{"action": "start", "cdp_port": 9222}
这类浏览器由 QwenPaw 自行启动并持有进程，stop 时会：
例如：
{"action": "connect_cdp", "cdp_url": "http://localhost:9222"}
这类浏览器不是 QwenPaw 启动的，stop 时只会：
简单说：
start 不开放调试端口；只有用户明确询问时才向其暴露 CDP 概念private_mode 是每次 start 的显式参数，不作为 workspace 持久状态保存