docs(browser): 更新默认调试端口为40821

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）

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),

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 自动检测并启动浏览器

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）