bb-browser 0.11.0 → 0.11.2

package/dist/cli.js

@@ -1,41 +1,274 @@
 #!/usr/bin/env node
 import {
   COMMAND_TIMEOUT,
-  DAEMON_PORT,
   generateId
-} from "./chunk-5WGFUZLM.js";
+} from "./chunk-H2VEQBAU.js";
 import {
   applyJq
 } from "./chunk-AHGAQEFO.js";
+import {
+  parseOpenClawJson
+} from "./chunk-FSL4RNI6.js";
 import "./chunk-D4HDZEJT.js";
 
 // packages/cli/src/index.ts
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // packages/cli/src/daemon-manager.ts
-import { spawn } from "child_process";
-import { readFile } from "fs/promises";
+import { spawn as spawn2 } from "child_process";
+import { readFile as readFile2, unlink } from "fs/promises";
 import { request as httpRequest } from "http";
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
+import { existsSync as existsSync2 } from "fs";
+import os2 from "os";
+import path2 from "path";
+
+// packages/cli/src/cdp-discovery.ts
+import { execFile, execSync, spawn } from "child_process";
 import { existsSync } from "fs";
+import { mkdir, readFile, writeFile } from "fs/promises";
 import os from "os";
 import path from "path";
-var DAEMON_DIR = path.join(os.homedir(), ".bb-browser");
-var TOKEN_FILE = path.join(DAEMON_DIR, "daemon.token");
-var cachedToken = null;
+var DEFAULT_CDP_PORT = 19825;
+var MANAGED_BROWSER_DIR = path.join(os.homedir(), ".bb-browser", "browser");
+var MANAGED_USER_DATA_DIR = path.join(MANAGED_BROWSER_DIR, "user-data");
+var MANAGED_PORT_FILE = path.join(MANAGED_BROWSER_DIR, "cdp-port");
+var CDP_CACHE_FILE = path.join(os.tmpdir(), "bb-browser-cdp-cache.json");
+var CACHE_TTL_MS = 3e4;
+function execFileAsync(command, args, timeout) {
+  return new Promise((resolve2, reject) => {
+    execFile(command, args, { encoding: "utf8", timeout }, (error, stdout) => {
+      if (error) {
+        reject(error);
+        return;
+      }
+      resolve2(stdout.trim());
+    });
+  });
+}
+function getArgValue(flag) {
+  const index = process.argv.indexOf(flag);
+  if (index < 0) return void 0;
+  return process.argv[index + 1];
+}
+async function tryOpenClaw() {
+  try {
+    const raw = await execFileAsync("npx", ["openclaw", "browser", "status", "--json"], 3e4);
+    const parsed = parseOpenClawJson(raw);
+    let result = null;
+    if (parsed?.cdpUrl) {
+      try {
+        const url = new URL(parsed.cdpUrl);
+        const port = Number(url.port);
+        if (Number.isInteger(port) && port > 0) {
+          result = { host: url.hostname, port };
+        }
+      } catch {
+      }
+    }
+    if (!result) {
+      const port = Number(parsed?.cdpPort);
+      if (Number.isInteger(port) && port > 0) {
+        const host = parsed?.cdpHost || "127.0.0.1";
+        result = { host, port };
+      }
+    }
+    if (result) {
+      try {
+        await writeFile(CDP_CACHE_FILE, JSON.stringify({ ...result, timestamp: Date.now() }), "utf8");
+      } catch {
+      }
+    }
+    return result;
+  } catch {
+  }
+  return null;
+}
+async function canConnect(host, port) {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 1200);
+    const response = await fetch(`http://${host}:${port}/json/version`, { signal: controller.signal });
+    clearTimeout(timeout);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+function findBrowserExecutable() {
+  if (process.platform === "darwin") {
+    const candidates = [
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      "/Applications/Google Chrome Dev.app/Contents/MacOS/Google Chrome Dev",
+      "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
+      "/Applications/Google Chrome Beta.app/Contents/MacOS/Google Chrome Beta",
+      "/Applications/Arc.app/Contents/MacOS/Arc",
+      "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+      "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
+    ];
+    return candidates.find((candidate) => existsSync(candidate)) ?? null;
+  }
+  if (process.platform === "linux") {
+    const candidates = ["google-chrome", "google-chrome-stable", "chromium-browser", "chromium"];
+    for (const candidate of candidates) {
+      try {
+        const resolved = execSync(`which ${candidate}`, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        if (resolved) {
+          return resolved;
+        }
+      } catch {
+      }
+    }
+    return null;
+  }
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA ?? "";
+    const candidates = [
+      "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
+      "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe",
+      ...localAppData ? [
+        `${localAppData}\\Google\\Chrome Dev\\Application\\chrome.exe`,
+        `${localAppData}\\Google\\Chrome SxS\\Application\\chrome.exe`,
+        `${localAppData}\\Google\\Chrome Beta\\Application\\chrome.exe`
+      ] : [],
+      "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
+      "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe",
+      "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+    ];
+    return candidates.find((candidate) => existsSync(candidate)) ?? null;
+  }
+  return null;
+}
+async function launchManagedBrowser(port = DEFAULT_CDP_PORT) {
+  const executable = findBrowserExecutable();
+  if (!executable) {
+    return null;
+  }
+  await mkdir(MANAGED_USER_DATA_DIR, { recursive: true });
+  const defaultProfileDir = path.join(MANAGED_USER_DATA_DIR, "Default");
+  const prefsPath = path.join(defaultProfileDir, "Preferences");
+  await mkdir(defaultProfileDir, { recursive: true });
+  try {
+    let prefs = {};
+    try {
+      prefs = JSON.parse(await readFile(prefsPath, "utf8"));
+    } catch {
+    }
+    if (!prefs.profile?.name || prefs.profile.name !== "bb-browser") {
+      prefs.profile = { ...prefs.profile || {}, name: "bb-browser" };
+      await writeFile(prefsPath, JSON.stringify(prefs), "utf8");
+    }
+  } catch {
+  }
+  const args = [
+    `--remote-debugging-port=${port}`,
+    `--user-data-dir=${MANAGED_USER_DATA_DIR}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    "--disable-sync",
+    "--disable-background-networking",
+    "--disable-component-update",
+    "--disable-features=Translate,MediaRouter",
+    "--disable-session-crashed-bubble",
+    "--hide-crash-restore-bubble",
+    "about:blank"
+  ];
+  try {
+    const child = spawn(executable, args, {
+      detached: true,
+      stdio: "ignore"
+    });
+    child.unref();
+  } catch {
+    return null;
+  }
+  await mkdir(MANAGED_BROWSER_DIR, { recursive: true });
+  await writeFile(MANAGED_PORT_FILE, String(port), "utf8");
+  const deadline = Date.now() + 8e3;
+  while (Date.now() < deadline) {
+    if (await canConnect("127.0.0.1", port)) {
+      return { host: "127.0.0.1", port };
+    }
+    await new Promise((resolve2) => setTimeout(resolve2, 250));
+  }
+  return null;
+}
+async function discoverCdpPort() {
+  const envUrl = process.env.BB_BROWSER_CDP_URL;
+  if (envUrl) {
+    try {
+      const url = new URL(envUrl);
+      const port = Number(url.port);
+      if (Number.isInteger(port) && port > 0 && await canConnect(url.hostname, port)) {
+        return { host: url.hostname, port };
+      }
+    } catch {
+    }
+  }
+  const explicitPort = Number.parseInt(getArgValue("--port") ?? "", 10);
+  if (Number.isInteger(explicitPort) && explicitPort > 0 && await canConnect("127.0.0.1", explicitPort)) {
+    return { host: "127.0.0.1", port: explicitPort };
+  }
+  try {
+    const rawPort = await readFile(MANAGED_PORT_FILE, "utf8");
+    const managedPort = Number.parseInt(rawPort.trim(), 10);
+    if (Number.isInteger(managedPort) && managedPort > 0 && await canConnect("127.0.0.1", managedPort)) {
+      return { host: "127.0.0.1", port: managedPort };
+    }
+  } catch {
+  }
+  try {
+    const cacheRaw = await readFile(CDP_CACHE_FILE, "utf8");
+    const cache = JSON.parse(cacheRaw);
+    if (Date.now() - cache.timestamp < CACHE_TTL_MS && await canConnect(cache.host, cache.port)) {
+      return { host: cache.host, port: cache.port };
+    }
+  } catch {
+  }
+  if (process.argv.includes("--openclaw")) {
+    const viaOpenClaw = await tryOpenClaw();
+    if (viaOpenClaw && await canConnect(viaOpenClaw.host, viaOpenClaw.port)) {
+      return viaOpenClaw;
+    }
+  }
+  const launched = await launchManagedBrowser();
+  if (launched) {
+    return launched;
+  }
+  if (!process.argv.includes("--openclaw")) {
+    const detectedOpenClaw = await tryOpenClaw();
+    if (detectedOpenClaw && await canConnect(detectedOpenClaw.host, detectedOpenClaw.port)) {
+      return detectedOpenClaw;
+    }
+  }
+  return null;
+}
+
+// packages/cli/src/daemon-manager.ts
+var DAEMON_DIR = process.env.BB_BROWSER_HOME || path2.join(os2.homedir(), ".bb-browser");
+var DAEMON_JSON = path2.join(DAEMON_DIR, "daemon.json");
+var cachedInfo = null;
 var daemonReady = false;
-function httpJson(method, urlPath, token, body, timeout = 5e3) {
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function httpJson(method, urlPath, info, body, timeout = 5e3) {
   return new Promise((resolve2, reject) => {
     const payload = body !== void 0 ? JSON.stringify(body) : void 0;
     const req = httpRequest(
       {
-        hostname: "127.0.0.1",
-        port: DAEMON_PORT,
+        hostname: info.host,
+        port: info.port,
         path: urlPath,
         method,
         headers: {
-          Authorization: `Bearer ${token}`,
+          Authorization: `Bearer ${info.token}`,
           ...payload ? {
             "Content-Type": "application/json",
             "Content-Length": Buffer.byteLength(payload)
@@ -69,59 +302,81 @@ function httpJson(method, urlPath, token, body, timeout = 5e3) {
     req.end();
   });
 }
-async function readToken() {
+async function readDaemonJson() {
   try {
-    return (await readFile(TOKEN_FILE, "utf8")).trim();
+    const raw = await readFile2(DAEMON_JSON, "utf8");
+    const info = JSON.parse(raw);
+    if (typeof info.pid === "number" && typeof info.host === "string" && typeof info.port === "number" && typeof info.token === "string") {
+      return info;
+    }
+    return null;
   } catch {
     return null;
   }
 }
+async function deleteDaemonJson() {
+  try {
+    await unlink(DAEMON_JSON);
+  } catch {
+  }
+}
 function getDaemonPath() {
   const currentFile = fileURLToPath(import.meta.url);
   const currentDir = dirname(currentFile);
   const sameDirPath = resolve(currentDir, "daemon.js");
-  if (existsSync(sameDirPath)) {
+  if (existsSync2(sameDirPath)) {
     return sameDirPath;
   }
   return resolve(currentDir, "../../daemon/dist/index.js");
 }
 async function ensureDaemon() {
-  if (daemonReady && cachedToken) {
+  if (daemonReady && cachedInfo) {
     try {
-      await httpJson("GET", "/status", cachedToken, void 0, 2e3);
+      await httpJson("GET", "/status", cachedInfo, void 0, 2e3);
       return;
     } catch {
       daemonReady = false;
-      cachedToken = null;
+      cachedInfo = null;
     }
   }
-  let token = await readToken();
-  if (token) {
-    try {
-      const status = await httpJson("GET", "/status", token, void 0, 2e3);
-      if (status.running) {
-        cachedToken = token;
-        daemonReady = true;
-        return;
+  let info = await readDaemonJson();
+  if (info) {
+    if (!isProcessAlive(info.pid)) {
+      await deleteDaemonJson();
+      info = null;
+    } else {
+      try {
+        const status = await httpJson("GET", "/status", info, void 0, 2e3);
+        if (status.running) {
+          cachedInfo = info;
+          daemonReady = true;
+          return;
+        }
+      } catch {
       }
-    } catch {
     }
   }
+  const 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"
+    );
+  }
   const daemonPath = getDaemonPath();
-  const child = spawn(process.execPath, [daemonPath], {
+  const child = spawn2(process.execPath, [daemonPath, "--cdp-host", cdpInfo.host, "--cdp-port", String(cdpInfo.port)], {
     detached: true,
     stdio: "ignore"
   });
   child.unref();
-  const deadline = Date.now() + 5e3;
+  const deadline = Date.now() + 1e4;
   while (Date.now() < deadline) {
     await new Promise((r) => setTimeout(r, 200));
-    token = await readToken();
-    if (!token) continue;
+    info = await readDaemonJson();
+    if (!info) continue;
     try {
-      const status = await httpJson("GET", "/status", token, void 0, 2e3);
+      const status = await httpJson("GET", "/status", info, void 0, 2e3);
       if (status.running) {
-        cachedToken = token;
+        cachedInfo = info;
         daemonReady = true;
         return;
       }
@@ -129,23 +384,35 @@ async function ensureDaemon() {
     }
   }
   throw new Error(
-    "bb-browser: Daemon did not start in time.\n\nMake sure Chrome is installed, then try again."
+    "bb-browser: Daemon did not start in time.\n\nChrome CDP is reachable, but the daemon process failed to initialize.\nTry: bb-browser daemon status"
   );
 }
 async function daemonCommand(request) {
-  if (!cachedToken) {
-    cachedToken = await readToken();
+  if (!cachedInfo) {
+    cachedInfo = await readDaemonJson();
+  }
+  if (!cachedInfo) {
+    throw new Error("No daemon.json found. Is the daemon running?");
   }
-  if (!cachedToken) {
-    throw new Error("No daemon token found. Is the daemon running?");
+  return httpJson("POST", "/command", cachedInfo, request, COMMAND_TIMEOUT);
+}
+async function stopDaemon() {
+  const info = cachedInfo ?? await readDaemonJson();
+  if (!info) return false;
+  try {
+    await httpJson("POST", "/shutdown", info);
+    daemonReady = false;
+    cachedInfo = null;
+    return true;
+  } catch {
+    return false;
   }
-  return httpJson("POST", "/command", cachedToken, request, COMMAND_TIMEOUT);
 }
 async function getDaemonStatus() {
-  const token = cachedToken ?? await readToken();
-  if (!token) return null;
+  const info = cachedInfo ?? await readDaemonJson();
+  if (!info) return null;
   try {
-    return await httpJson("GET", "/status", token, void 0, 2e3);
+    return await httpJson("GET", "/status", info, void 0, 2e3);
   } catch {
     return null;
   }
@@ -176,8 +443,8 @@ async function sendCommand(request) {
 }
 
 // packages/cli/src/history-sqlite.ts
-import { copyFileSync, existsSync as existsSync2, unlinkSync } from "fs";
-import { execSync } from "child_process";
+import { copyFileSync, existsSync as existsSync3, unlinkSync } from "fs";
+import { execSync as execSync2 } from "child_process";
 import { homedir, tmpdir } from "os";
 import { join } from "path";
 function getHistoryPathCandidates() {
@@ -200,7 +467,7 @@ function getHistoryPathCandidates() {
 }
 function findHistoryPath() {
   for (const historyPath of getHistoryPathCandidates()) {
-    if (existsSync2(historyPath)) {
+    if (existsSync3(historyPath)) {
       return historyPath;
     }
   }
@@ -225,7 +492,7 @@ function runHistoryQuery(sql, mapRow) {
     copyFileSync(historyPath, tmpPath);
     const escapedTmpPath = tmpPath.replace(/"/g, '\\"');
     const escapedSql = sql.replace(/"/g, '\\"');
-    const output = execSync(`sqlite3 -separator $'\\t' "${escapedTmpPath}" "${escapedSql}"`, {
+    const output = execSync2(`sqlite3 -separator $'\\t' "${escapedTmpPath}" "${escapedSql}"`, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -320,18 +587,18 @@ function getHistoryDomains(days) {
 }
 
 // packages/cli/src/commands/site.ts
-import { readFileSync, readdirSync, existsSync as existsSync3, mkdirSync } from "fs";
+import { readFileSync, readdirSync, existsSync as existsSync4, mkdirSync } from "fs";
 import { join as join2, relative } from "path";
 import { homedir as homedir2 } from "os";
-import { execSync as execSync2 } from "child_process";
+import { execSync as execSync3 } from "child_process";
 var BB_DIR = join2(homedir2(), ".bb-browser");
 var LOCAL_SITES_DIR = join2(BB_DIR, "sites");
 var COMMUNITY_SITES_DIR = join2(BB_DIR, "bb-sites");
 var COMMUNITY_REPO = "https://github.com/epiral/bb-sites.git";
 function checkCliUpdate() {
   try {
-    const current = execSync2("bb-browser --version", { timeout: 3e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
-    const latest = execSync2("npm view bb-browser version", { timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
+    const current = execSync3("bb-browser --version", { timeout: 3e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
+    const latest = execSync3("npm view bb-browser version", { timeout: 5e3, stdio: ["pipe", "pipe", "pipe"] }).toString().trim();
     if (latest && current && latest !== current && latest.localeCompare(current, void 0, { numeric: true }) > 0) {
       console.log(`
 \u{1F4E6} bb-browser ${latest} available (current: ${current}). Run: npm install -g bb-browser`);
@@ -406,7 +673,7 @@ function parseSiteMeta(filePath, source) {
   return meta;
 }
 function scanSites(dir, source) {
-  if (!existsSync3(dir)) return [];
+  if (!existsSync4(dir)) return [];
   const sites = [];
   function walk(currentDir) {
     let entries;
@@ -528,13 +795,13 @@ function siteSearch(query, options) {
 }
 function siteUpdate(options = {}) {
   mkdirSync(BB_DIR, { recursive: true });
-  const updateMode = existsSync3(join2(COMMUNITY_SITES_DIR, ".git")) ? "pull" : "clone";
+  const updateMode = existsSync4(join2(COMMUNITY_SITES_DIR, ".git")) ? "pull" : "clone";
   if (updateMode === "pull") {
     if (!options.json) {
       console.log("\u66F4\u65B0\u793E\u533A site adapter \u5E93...");
     }
     try {
-      execSync2("git pull --ff-only", { cwd: COMMUNITY_SITES_DIR, stdio: "pipe" });
+      execSync3("git pull --ff-only", { cwd: COMMUNITY_SITES_DIR, stdio: "pipe" });
       if (!options.json) {
         console.log("\u66F4\u65B0\u5B8C\u6210\u3002");
         console.log("");
@@ -555,7 +822,7 @@ function siteUpdate(options = {}) {
       console.log(`\u514B\u9686\u793E\u533A adapter \u5E93: ${COMMUNITY_REPO}`);
     }
     try {
-      execSync2(`git clone ${COMMUNITY_REPO} ${COMMUNITY_SITES_DIR}`, { stdio: "pipe" });
+      execSync3(`git clone ${COMMUNITY_REPO} ${COMMUNITY_SITES_DIR}`, { stdio: "pipe" });
       if (!options.json) {
         console.log("\u514B\u9686\u5B8C\u6210\u3002");
         console.log("");
@@ -769,7 +1036,7 @@ async function siteRun(name, args, options) {
   const argsJson = JSON.stringify(argMap);
   const script = `(${jsBody})(${argsJson})`;
   if (options.openclaw) {
-    const { ocGetTabs, ocFindTabByDomain, ocOpenTab, ocEvaluate } = await import("./openclaw-bridge-Q6EFUQCH.js");
+    const { ocGetTabs, ocFindTabByDomain, ocOpenTab, ocEvaluate } = await import("./openclaw-bridge-4XJKWEQ3.js");
     let targetId;
     if (site.domain) {
       const tabs = ocGetTabs();
@@ -980,9 +1247,9 @@ async function siteCommand(args, options = {}) {
 }
 function silentUpdate() {
   const gitDir = join2(COMMUNITY_SITES_DIR, ".git");
-  if (!existsSync3(gitDir)) return;
-  import("child_process").then(({ spawn: spawn2 }) => {
-    const child = spawn2("git", ["pull", "--ff-only"], {
+  if (!existsSync4(gitDir)) return;
+  import("child_process").then(({ spawn: spawn3 }) => {
+    const child = spawn3("git", ["pull", "--ff-only"], {
       cwd: COMMUNITY_SITES_DIR,
       stdio: "ignore",
       detached: true
@@ -1280,17 +1547,17 @@ async function getCommand(attribute, ref, options = {}) {
 
 // packages/cli/src/commands/screenshot.ts
 import fs from "fs";
-import path2 from "path";
-import os2 from "os";
+import path3 from "path";
+import os3 from "os";
 function getDefaultPath() {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const filename = `bb-screenshot-${timestamp}.png`;
-  return path2.join(os2.tmpdir(), filename);
+  return path3.join(os3.tmpdir(), filename);
 }
 function saveBase64Image(dataUrl, filePath) {
   const base64Data = dataUrl.replace(/^data:image\/png;base64,/, "");
   const buffer = Buffer.from(base64Data, "base64");
-  const dir = path2.dirname(filePath);
+  const dir = path3.dirname(filePath);
   if (!fs.existsSync(dir)) {
     fs.mkdirSync(dir, { recursive: true });
   }
@@ -1298,7 +1565,7 @@ function saveBase64Image(dataUrl, filePath) {
 }
 async function screenshotCommand(outputPath, options = {}) {
   await ensureDaemonRunning();
-  const filePath = outputPath ? path2.resolve(outputPath) : getDefaultPath();
+  const filePath = outputPath ? path3.resolve(outputPath) : getDefaultPath();
   const request = {
     id: generateId(),
     action: "screenshot",
@@ -2369,6 +2636,14 @@ Tabs (${tabs.length}):`);
     console.log("\nNo tabs");
   }
 }
+async function shutdownCommand(options = {}) {
+  const ok = await stopDaemon();
+  if (options.json) {
+    console.log(JSON.stringify({ stopped: ok }));
+  } else {
+    console.log(ok ? "Daemon stopped" : "Daemon was not running");
+  }
+}
 function formatUptime(ms) {
   if (!ms || ms <= 0) return "0s";
   const s = Math.floor(ms / 1e3);
@@ -2380,7 +2655,7 @@ function formatUptime(ms) {
 }
 
 // packages/cli/src/index.ts
-var VERSION = "0.11.0";
+var VERSION = "0.11.2";
 var HELP_TEXT = `
 bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 
@@ -2435,6 +2710,7 @@ bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
   errors [--clear]             \u67E5\u770B/\u6E05\u7A7A JS \u9519\u8BEF
   trace start|stop|status      \u5F55\u5236\u7528\u6237\u64CD\u4F5C
   history search|domains       \u67E5\u770B\u6D4F\u89C8\u5386\u53F2
+  daemon [status|stop] [opts]  \u524D\u53F0\u8FD0\u884C\u6216\u7BA1\u7406 daemon
 
 \u9009\u9879\uFF1A
   --json               \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
@@ -2544,12 +2820,16 @@ async function main() {
   }
   if (process.argv.includes("--mcp")) {
     const mcpPath = fileURLToPath2(new URL("./mcp.js", import.meta.url));
-    const { spawn: spawn2 } = await import("child_process");
-    const child = spawn2(process.execPath, [mcpPath], { stdio: "inherit" });
+    const { spawn: spawn3 } = await import("child_process");
+    const child = spawn3(process.execPath, [mcpPath], { stdio: "inherit" });
     child.on("exit", (code) => process.exit(code ?? 0));
     return;
   }
-  if (parsed.flags.help || !parsed.command) {
+  if (!parsed.command) {
+    console.log(HELP_TEXT);
+    return;
+  }
+  if (parsed.flags.help && parsed.command !== "daemon") {
     console.log(HELP_TEXT);
     return;
   }
@@ -2705,7 +2985,31 @@ async function main() {
         await getCommand(attribute, ref, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
-      case "daemon":
+      case "daemon": {
+        const daemonSubcommand = parsed.args[0];
+        if (daemonSubcommand === "status") {
+          await statusCommand({ json: parsed.flags.json });
+          break;
+        }
+        if (daemonSubcommand === "stop" || daemonSubcommand === "shutdown") {
+          await shutdownCommand({ json: parsed.flags.json });
+          break;
+        }
+        const daemonPath = getDaemonPath();
+        const daemonArgs = process.argv.slice(3);
+        const { spawn: spawn3 } = await import("child_process");
+        const child = spawn3(process.execPath, [daemonPath, ...daemonArgs], {
+          stdio: "inherit"
+        });
+        child.on("exit", (code, signal) => {
+          if (signal) {
+            process.kill(process.pid, signal);
+            return;
+          }
+          process.exit(code ?? 0);
+        });
+        return;
+      }
       case "close": {
         await closeCommand({ json: parsed.flags.json, tabId: globalTabId });
         break;
@@ -2893,9 +3197,9 @@ async function main() {
         break;
       }
       case "star": {
-        const { execSync: execSync3 } = await import("child_process");
+        const { execSync: execSync4 } = await import("child_process");
         try {
-          execSync3("gh auth status", { stdio: "pipe" });
+          execSync4("gh auth status", { stdio: "pipe" });
         } catch {
           console.error("\u9700\u8981\u5148\u5B89\u88C5\u5E76\u767B\u5F55 GitHub CLI: https://cli.github.com");
           console.error("  brew install gh && gh auth login");
@@ -2904,7 +3208,7 @@ async function main() {
         const repos = ["epiral/bb-browser", "epiral/bb-sites"];
         for (const repo of repos) {
           try {
-            execSync3(`gh api user/starred/${repo} -X PUT`, { stdio: "pipe" });
+            execSync4(`gh api user/starred/${repo} -X PUT`, { stdio: "pipe" });
             console.log(`\u2B50 Starred ${repo}`);
           } catch {
             console.log(`Already starred or failed: ${repo}`);