From 6fd7db1b95e6b982fc5802b668c0492c633bcb9a Mon Sep 17 00:00:00 2001
From: knowen <1369727119@qq.com>
Date: Wed, 18 Mar 2026 21:19:15 +0800
Subject: [PATCH] =?UTF-8?q?docs(browser):=20=E6=9B=B4=E6=96=B0=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4=E8=B0=83=E8=AF=95=E7=AB=AF=E5=8F=A3=E4=B8=BA40821?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/browser.js | 2 +-
 src/config.js  | 9 ++++-----
 src/demo.js    | 4 ++--
 src/index.js   | 2 +-
 4 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/src/browser.js b/src/browser.js
index 3729715..1a98664 100644
--- a/src/browser.js
+++ b/src/browser.js
@@ -405,7 +405,7 @@ async function findOrCreateGeminiPage(browser) {
  *
  * @param {object} [opts]
  * @param {string} [opts.executablePath] - 浏览器路径（不传则自动检测）
- * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9223）
+ * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 40821）
  * @param {string} [opts.userDataDir] - 用户数据目录（env: BROWSER_USER_DATA_DIR，不传则多级兜底）
  * @param {boolean} [opts.headless] - 无头模式（env: BROWSER_HEADLESS，默认 false）
  * @param {object} [opts.debugOpts] - 调试/信号控制选项（透传给 Puppeteer launch）
diff --git a/src/config.js b/src/config.js
index 1c6a511..9a46f22 100644
--- a/src/config.js
+++ b/src/config.js
@@ -107,14 +107,13 @@ const config = {
   /**
    * CDP 远程调试端口
    *
-   * Chromium 社区通用默认值是 9222，这里用 9223（= 9222 + 1）作为 WJZ_P 的项目专属端口。
+   * 默认 40821，作为 WJZ_P 所有 skill 的统一 CDP 端口。
    * 使用独立端口的原因：
    *   1. 不信任其他浏览器实例的反爬措施，自己启动并控制的浏览器反爬最保险。
-   *   2. 避免与用户手动启动的调试浏览器或其他工具（如 OpenClaw 默认 9222）的端口冲突。
-   *
-   * 注意：9223 是 WJZ_P 所有项目统一约定的 CDP 端口，不仅限于本项目。
+   *   2. 避免与用户手动启动的调试浏览器或其他工具的端口冲突。
+   *   3. 跨 skill 共享同一个浏览器实例，多个 skill 各用各的 tab。
    */
-  browserDebugPort: envInt('BROWSER_DEBUG_PORT', 9223),
+  browserDebugPort: envInt('BROWSER_DEBUG_PORT', 40821),
 
   /** 浏览器用户数据目录（不设则自动解析，见 browser.js resolveUserDataDir） */
   browserUserDataDir: envStr('BROWSER_USER_DATA_DIR', undefined),
diff --git a/src/demo.js b/src/demo.js
index a1f39a5..fb1b157 100644
--- a/src/demo.js
+++ b/src/demo.js
@@ -4,8 +4,8 @@
  * 两种启动方式：
  *
  * 方式 1（推荐）：先手动启动浏览器，再运行 demo
- *   chrome --remote-debugging-port=9223 --user-data-dir="~/.gemini-skill/browser-data"
- *   （也可以用 Edge：msedge --remote-debugging-port=9223 --user-data-dir=...）
+ *   chrome --remote-debugging-port=40821 --user-data-dir="~/.gemini-skill/browser-data"
+ *   （也可以用 Edge：msedge --remote-debugging-port=40821 --user-data-dir=...）
  *   node src/demo.js
  *
  * 方式 2：让 skill 自动检测并启动浏览器
diff --git a/src/index.js b/src/index.js
index 286e7fb..af99189 100644
--- a/src/index.js
+++ b/src/index.js
@@ -27,7 +27,7 @@ export { disconnect, close };
  *
  * @param {object} [opts]
  * @param {string} [opts.executablePath] - 浏览器路径（env: BROWSER_PATH，不设则自动检测）
- * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 9223）
+ * @param {number} [opts.port] - 调试端口（env: BROWSER_DEBUG_PORT，默认 40821）
  * @param {string} [opts.userDataDir] - 用户数据目录（env: BROWSER_USER_DATA_DIR）
  * @param {boolean} [opts.headless] - 无头模式（env: BROWSER_HEADLESS，默认 false）
  * @param {object} [opts.debugOpts] - 调试/信号控制选项（透传给 Puppeteer launch）