bb-browser-api 0.11.5 → 0.12.0

package/README.zh-CN.md

@@ -205,7 +205,7 @@ curl -X POST http://localhost:18888/api/fetch \
 curl "http://localhost:18888/api/capture?url=https://example.com&pattern=api"
 
 # Storage API — 读取指定域名的 Cookie / localStorage / sessionStorage
-curl "http://localhost:18888/api/storage?domain=example.com"
+curl "http://localhost:18888/api/storage?domain=baidu.com"
 ```
 
 **核心优势：** 在你的真实浏览器上下文中执行，自动携带 Cookie 和登录态。

package/dist/cli.js

@@ -266,7 +266,7 @@ function getDaemonPath() {
   }
   return resolve(currentDir, "../../daemon/dist/index.js");
 }
-async function ensureDaemon() {
+async function ensureDaemon(customCdpUrl) {
   if (daemonReady && cachedInfo) {
     try {
       const status = await httpJson("GET", "/status", cachedInfo, void 0, 2e3);
@@ -300,10 +300,27 @@ async function ensureDaemon() {
       }
     }
   }
-  const cdpInfo = await discoverCdpPort();
+  let cdpInfo;
+  if (customCdpUrl) {
+    try {
+      const url = new URL(customCdpUrl);
+      cdpInfo = {
+        host: url.hostname,
+        port: parseInt(url.port) || 9222
+      };
+    } catch (error) {
+      throw new Error(
+        `bb-browser: Invalid CDP URL: ${customCdpUrl}
+
+Expected format: http://localhost:9222 or http://127.0.0.1:9222`
+      );
+    }
+  } else {
+    cdpInfo = await discoverCdpPort();
+  }
   if (!cdpInfo) {
     throw new Error(
-      "bb-browser: Cannot find a Chromium-based browser.\n\nPlease do one of the following:\n  1. Install Google Chrome, Edge, or Brave\n  2. Start Chrome with: google-chrome --remote-debugging-port=19825\n  3. Set BB_BROWSER_CDP_URL=http://host:port"
+      "bb-browser: Cannot find a Chromium-based browser.\n\nPlease do one of the following:\n  1. Install Google Chrome, Edge, or Brave\n  2. Start Chrome with: google-chrome --remote-debugging-port=19825\n  3. Set BB_BROWSER_CDP_URL=http://host:port\n  4. Use: bb-browser-api daemon start --cdp-url http://localhost:9222"
     );
   }
   const daemonPath = getDaemonPath();
@@ -2594,7 +2611,7 @@ Tabs (${tabs.length}):`);
   }
 }
 async function startCommand(options = {}) {
-  await ensureDaemon();
+  await ensureDaemon(options.cdpUrl);
   const status = await getDaemonStatus();
   if (options.json) {
     console.log(JSON.stringify(status, null, 2));
@@ -2626,7 +2643,7 @@ function formatUptime(ms) {
 }
 
 // packages/cli/src/index.ts
-var VERSION = "0.11.5";
+var VERSION = "0.12.0";
 var HELP_TEXT = `
 bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 
@@ -2682,6 +2699,7 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
   trace start|stop|status      \u5F55\u5236\u7528\u6237\u64CD\u4F5C
   history search|domains       \u67E5\u770B\u6D4F\u89C8\u5386\u53F2
   daemon [start|status|stop]   \u7BA1\u7406 daemon\uFF08start: \u540E\u53F0\u542F\u52A8\uFF09
+    --cdp-url <url>            \u6307\u5B9A CDP URL\uFF08\u4F8B\u5982\uFF1Ahttp://localhost:9222\uFF09
 
 \u9009\u9879\uFF1A
   --json               \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
@@ -2967,7 +2985,9 @@ async function main() {
           break;
         }
         if (daemonSubcommand === "start") {
-          await startCommand({ json: parsed.flags.json });
+          const cdpUrlIndex = process.argv.findIndex((a) => a === "--cdp-url");
+          const cdpUrl = cdpUrlIndex >= 0 ? process.argv[cdpUrlIndex + 1] : void 0;
+          await startCommand({ json: parsed.flags.json, cdpUrl });
           break;
         }
         const daemonPath = getDaemonPath();