bb-browser 0.4.4 → 0.5.0

package/dist/cli.js

@@ -3,9 +3,30 @@ import {
   COMMAND_TIMEOUT,
   DAEMON_BASE_URL,
   generateId
-} from "./chunk-H7M4J4CW.js";
+} from "./chunk-DBJBHYC7.js";
+import {
+  applyJq
+} from "./chunk-AHGAQEFO.js";
+import "./chunk-D4HDZEJT.js";
 
 // packages/cli/src/client.ts
+var jqExpression;
+function setJqExpression(expression) {
+  jqExpression = expression;
+}
+function printJqResults(response) {
+  const target = response.data ?? response;
+  const results = applyJq(target, jqExpression || ".");
+  for (const result of results) {
+    console.log(typeof result === "string" ? result : JSON.stringify(result));
+  }
+  process.exit(0);
+}
+function handleJqResponse(response) {
+  if (jqExpression) {
+    printJqResults(response);
+  }
+}
 async function sendCommand(request) {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), COMMAND_TIMEOUT);
@@ -47,7 +68,8 @@ async function sendCommand(request) {
         error: `HTTP \u9519\u8BEF: ${res.status} ${res.statusText}`
       };
     }
-    return await res.json();
+    const response = await res.json();
+    return response;
   } catch (error) {
     clearTimeout(timeoutId);
     if (error instanceof Error) {
@@ -150,377 +172,595 @@ async function stopDaemon() {
   }
 }
 
-// packages/cli/src/commands/open.ts
-async function openCommand(url, options = {}) {
-  if (!url) {
-    throw new Error("\u7F3A\u5C11 URL \u53C2\u6570");
+// packages/cli/src/commands/site.ts
+import { readFileSync, readdirSync, existsSync as existsSync2, mkdirSync } from "fs";
+import { join, relative } from "path";
+import { homedir } from "os";
+import { execSync } from "child_process";
+var BB_DIR = join(homedir(), ".bb-browser");
+var LOCAL_SITES_DIR = join(BB_DIR, "sites");
+var COMMUNITY_SITES_DIR = join(BB_DIR, "bb-sites");
+var COMMUNITY_REPO = "https://github.com/epiral/bb-sites.git";
+function parseSiteMeta(filePath, source) {
+  let content;
+  try {
+    content = readFileSync(filePath, "utf-8");
+  } catch {
+    return null;
   }
-  await ensureDaemonRunning();
-  let normalizedUrl = url;
-  if (!url.startsWith("http://") && !url.startsWith("https://")) {
-    normalizedUrl = "https://" + url;
+  const sitesDir = source === "local" ? LOCAL_SITES_DIR : COMMUNITY_SITES_DIR;
+  const relPath = relative(sitesDir, filePath);
+  const defaultName = relPath.replace(/\.js$/, "").replace(/\\/g, "/");
+  const metaMatch = content.match(/\/\*\s*@meta\s*\n([\s\S]*?)\*\//);
+  if (metaMatch) {
+    try {
+      const metaJson = JSON.parse(metaMatch[1]);
+      return {
+        name: metaJson.name || defaultName,
+        description: metaJson.description || "",
+        domain: metaJson.domain || "",
+        args: metaJson.args || {},
+        capabilities: metaJson.capabilities,
+        readOnly: metaJson.readOnly,
+        example: metaJson.example,
+        filePath,
+        source
+      };
+    } catch {
+    }
   }
-  const request = {
-    id: generateId(),
-    action: "open",
-    url: normalizedUrl
+  const meta = {
+    name: defaultName,
+    description: "",
+    domain: "",
+    args: {},
+    filePath,
+    source
   };
-  if (options.tab !== void 0) {
-    if (options.tab === "current") {
-      request.tabId = "current";
-    } else {
-      const tabId = parseInt(options.tab, 10);
-      if (isNaN(tabId)) {
-        throw new Error(`\u65E0\u6548\u7684 tabId: ${options.tab}`);
-      }
-      request.tabId = tabId;
+  const tagPattern = /\/\/\s*@(\w+)[ \t]+(.*)/g;
+  let match;
+  while ((match = tagPattern.exec(content)) !== null) {
+    const [, key, value] = match;
+    switch (key) {
+      case "name":
+        meta.name = value.trim();
+        break;
+      case "description":
+        meta.description = value.trim();
+        break;
+      case "domain":
+        meta.domain = value.trim();
+        break;
+      case "args":
+        for (const arg of value.trim().split(/[,\s]+/).filter(Boolean)) {
+          meta.args[arg] = { required: true };
+        }
+        break;
+      case "example":
+        meta.example = value.trim();
+        break;
     }
   }
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      console.log(`\u5DF2\u6253\u5F00: ${response.data?.url ?? normalizedUrl}`);
-      if (response.data?.title) {
-        console.log(`\u6807\u9898: ${response.data.title}`);
-      }
-      if (response.data?.tabId) {
-        console.log(`Tab ID: ${response.data.tabId}`);
+  return meta;
+}
+function scanSites(dir, source) {
+  if (!existsSync2(dir)) return [];
+  const sites = [];
+  function walk(currentDir) {
+    let entries;
+    try {
+      entries = readdirSync(currentDir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const fullPath = join(currentDir, entry.name);
+      if (entry.isDirectory() && !entry.name.startsWith(".")) {
+        walk(fullPath);
+      } else if (entry.isFile() && entry.name.endsWith(".js")) {
+        const meta = parseSiteMeta(fullPath, source);
+        if (meta) sites.push(meta);
       }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
     }
   }
+  walk(dir);
+  return sites;
 }
-
-// packages/cli/src/commands/snapshot.ts
-async function snapshotCommand(options = {}) {
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "snapshot",
-    interactive: options.interactive,
-    compact: options.compact,
-    maxDepth: options.maxDepth,
-    selector: options.selector,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      console.log(`\u6807\u9898: ${response.data?.title ?? "(\u65E0\u6807\u9898)"}`);
-      console.log(`URL: ${response.data?.url ?? "(\u672A\u77E5)"}`);
-      if (response.data?.snapshotData?.snapshot) {
-        console.log("");
-        console.log(response.data.snapshotData.snapshot);
-      }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
-    }
+function getSiteHintForDomain(url) {
+  try {
+    const hostname = new URL(url).hostname;
+    const sites = getAllSites();
+    const matched = sites.filter((s) => s.domain && (hostname === s.domain || hostname.endsWith("." + s.domain)));
+    if (matched.length === 0) return null;
+    const names = matched.map((s) => s.name);
+    const example = matched[0].example || `bb-browser site ${names[0]}`;
+    return `\u8BE5\u7F51\u7AD9\u6709 ${names.length} \u4E2A site adapter \u53EF\u76F4\u63A5\u83B7\u53D6\u6570\u636E\uFF0C\u65E0\u9700\u624B\u52A8\u64CD\u4F5C\u6D4F\u89C8\u5668\u3002\u8BD5\u8BD5: ${example}`;
+  } catch {
+    return null;
   }
 }
-
-// packages/cli/src/commands/click.ts
-function parseRef(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
+function getAllSites() {
+  const community = scanSites(COMMUNITY_SITES_DIR, "community");
+  const local = scanSites(LOCAL_SITES_DIR, "local");
+  const byName = /* @__PURE__ */ new Map();
+  for (const s of community) byName.set(s.name, s);
+  for (const s of local) byName.set(s.name, s);
+  return Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
 }
-async function clickCommand(ref, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+function matchTabOrigin(tabUrl, domain) {
+  try {
+    const tabOrigin = new URL(tabUrl).hostname;
+    return tabOrigin === domain || tabOrigin.endsWith("." + domain);
+  } catch {
+    return false;
+  }
+}
+function siteList(options) {
+  const sites = getAllSites();
+  if (sites.length === 0) {
+    console.log("\u672A\u627E\u5230\u4EFB\u4F55 site adapter\u3002");
+    console.log("  \u5B89\u88C5\u793E\u533A adapter: bb-browser site update");
+    console.log(`  \u79C1\u6709 adapter \u76EE\u5F55: ${LOCAL_SITES_DIR}`);
+    return;
   }
-  await ensureDaemonRunning();
-  const parsedRef = parseRef(ref);
-  const request = {
-    id: generateId(),
-    action: "click",
-    ref: parsedRef,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      const role = response.data?.role ?? "element";
-      const name = response.data?.name;
-      if (name) {
-        console.log(`\u5DF2\u70B9\u51FB: ${role} "${name}"`);
-      } else {
-        console.log(`\u5DF2\u70B9\u51FB: ${role}`);
-      }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+    console.log(JSON.stringify(sites.map((s) => ({
+      name: s.name,
+      description: s.description,
+      domain: s.domain,
+      args: s.args,
+      source: s.source
+    })), null, 2));
+    return;
+  }
+  const groups = /* @__PURE__ */ new Map();
+  for (const s of sites) {
+    const platform = s.name.split("/")[0];
+    if (!groups.has(platform)) groups.set(platform, []);
+    groups.get(platform).push(s);
+  }
+  for (const [platform, items] of groups) {
+    console.log(`
+${platform}/`);
+    for (const s of items) {
+      const cmd = s.name.split("/").slice(1).join("/");
+      const src = s.source === "local" ? " (local)" : "";
+      const desc = s.description ? ` - ${s.description}` : "";
+      console.log(`  ${cmd.padEnd(20)}${desc}${src}`);
     }
   }
+  console.log();
 }
-
-// packages/cli/src/commands/hover.ts
-function parseRef2(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
-}
-async function hoverCommand(ref, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+function siteSearch(query, options) {
+  const sites = getAllSites();
+  const q = query.toLowerCase();
+  const matches = sites.filter(
+    (s) => s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q) || s.domain.toLowerCase().includes(q)
+  );
+  if (matches.length === 0) {
+    console.log(`\u672A\u627E\u5230\u5339\u914D "${query}" \u7684 adapter\u3002`);
+    console.log("  \u67E5\u770B\u6240\u6709: bb-browser site list");
+    return;
   }
-  await ensureDaemonRunning();
-  const parsedRef = parseRef2(ref);
-  const request = {
-    id: generateId(),
-    action: "hover",
-    ref: parsedRef,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
+    console.log(JSON.stringify(matches.map((s) => ({
+      name: s.name,
+      description: s.description,
+      domain: s.domain,
+      source: s.source
+    })), null, 2));
+    return;
+  }
+  for (const s of matches) {
+    const src = s.source === "local" ? " (local)" : "";
+    console.log(`${s.name.padEnd(24)} ${s.description}${src}`);
+  }
+}
+function siteUpdate() {
+  mkdirSync(BB_DIR, { recursive: true });
+  if (existsSync2(join(COMMUNITY_SITES_DIR, ".git"))) {
+    console.log("\u66F4\u65B0\u793E\u533A site adapter \u5E93...");
+    try {
+      execSync("git pull --ff-only", { cwd: COMMUNITY_SITES_DIR, stdio: "pipe" });
+      console.log("\u66F4\u65B0\u5B8C\u6210\u3002");
+      console.log("");
+      console.log("\u{1F4A1} \u8FD0\u884C bb-browser site recommend \u770B\u770B\u54EA\u4E9B\u548C\u4F60\u7684\u6D4F\u89C8\u4E60\u60EF\u5339\u914D");
+    } catch (e) {
+      console.error(`\u66F4\u65B0\u5931\u8D25: ${e instanceof Error ? e.message : e}`);
+      console.error("  \u624B\u52A8\u4FEE\u590D: cd ~/.bb-browser/bb-sites && git pull");
+      process.exit(1);
+    }
   } else {
-    if (response.success) {
-      const role = response.data?.role ?? "element";
-      const name = response.data?.name;
-      if (name) {
-        console.log(`\u5DF2\u60AC\u505C: ${role} "${name}"`);
-      } else {
-        console.log(`\u5DF2\u60AC\u505C: ${role}`);
-      }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
+    console.log(`\u514B\u9686\u793E\u533A adapter \u5E93: ${COMMUNITY_REPO}`);
+    try {
+      execSync(`git clone ${COMMUNITY_REPO} ${COMMUNITY_SITES_DIR}`, { stdio: "pipe" });
+      console.log("\u514B\u9686\u5B8C\u6210\u3002");
+      console.log("");
+      console.log("\u{1F4A1} \u8FD0\u884C bb-browser site recommend \u770B\u770B\u54EA\u4E9B\u548C\u4F60\u7684\u6D4F\u89C8\u4E60\u60EF\u5339\u914D");
+    } catch (e) {
+      console.error(`\u514B\u9686\u5931\u8D25: ${e instanceof Error ? e.message : e}`);
+      console.error(`  \u624B\u52A8\u4FEE\u590D: git clone ${COMMUNITY_REPO} ~/.bb-browser/bb-sites`);
       process.exit(1);
     }
   }
+  const sites = scanSites(COMMUNITY_SITES_DIR, "community");
+  console.log(`\u5DF2\u5B89\u88C5 ${sites.length} \u4E2A\u793E\u533A adapter\u3002`);
 }
-
-// packages/cli/src/commands/fill.ts
-function parseRef3(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
+function findSiteByName(name) {
+  return getAllSites().find((site) => site.name === name);
 }
-async function fillCommand(ref, text, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
-  }
-  if (text === void 0 || text === null) {
-    throw new Error("\u7F3A\u5C11 text \u53C2\u6570");
+function siteInfo(name, options) {
+  const site = findSiteByName(name);
+  if (!site) {
+    console.error(`[error] site info: adapter "${name}" not found.`);
+    console.error("  Try: bb-browser site list");
+    process.exit(1);
   }
-  await ensureDaemonRunning();
-  const parsedRef = parseRef3(ref);
-  const request = {
-    id: generateId(),
-    action: "fill",
-    ref: parsedRef,
-    text,
-    tabId: options.tabId
+  const meta = {
+    name: site.name,
+    description: site.description,
+    domain: site.domain,
+    args: site.args,
+    example: site.example,
+    readOnly: site.readOnly
   };
-  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
+    console.log(JSON.stringify(meta, null, 2));
+    return;
+  }
+  console.log(`${site.name} \u2014 ${site.description}`);
+  console.log();
+  console.log("\u53C2\u6570\uFF1A");
+  const argEntries = Object.entries(site.args);
+  if (argEntries.length === 0) {
+    console.log("  \uFF08\u65E0\uFF09");
   } else {
-    if (response.success) {
-      const role = response.data?.role ?? "element";
-      const name = response.data?.name;
-      if (name) {
-        console.log(`\u5DF2\u586B\u5145: ${role} "${name}"`);
-      } else {
-        console.log(`\u5DF2\u586B\u5145: ${role}`);
-      }
-      console.log(`\u5185\u5BB9: "${text}"`);
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+    for (const [argName, argDef] of argEntries) {
+      const requiredText = argDef.required ? "\u5FC5\u586B" : "\u53EF\u9009";
+      const description = argDef.description || "";
+      console.log(`  ${argName} (${requiredText})    ${description}`.trimEnd());
     }
   }
+  console.log();
+  console.log("\u793A\u4F8B\uFF1A");
+  console.log(`  ${site.example || `bb-browser site ${site.name}`}`);
+  console.log();
+  console.log(`\u57DF\u540D\uFF1A${site.domain || "\uFF08\u672A\u58F0\u660E\uFF09"}`);
+  console.log(`\u53EA\u8BFB\uFF1A${site.readOnly ? "\u662F" : "\u5426"}`);
 }
-
-// packages/cli/src/commands/type.ts
-function parseRef4(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
-}
-async function typeCommand(ref, text, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+async function siteRecommend(options) {
+  const days = options.days ?? 30;
+  const response = await sendCommand({
+    id: generateId(),
+    action: "history",
+    historyCommand: "domains",
+    ms: days
+  });
+  if (!response.success) {
+    throw new Error(response.error || "History command failed");
   }
-  if (text === void 0 || text === null) {
-    throw new Error("\u7F3A\u5C11 text \u53C2\u6570");
+  const historyDomains = response.data?.historyDomains || [];
+  const sites = getAllSites();
+  const sitesByDomain = /* @__PURE__ */ new Map();
+  for (const site of sites) {
+    if (!site.domain) continue;
+    const domain = site.domain.toLowerCase();
+    const existing = sitesByDomain.get(domain) || [];
+    existing.push(site);
+    sitesByDomain.set(domain, existing);
+  }
+  const available = [];
+  const notAvailable = [];
+  for (const item of historyDomains) {
+    const adapters = sitesByDomain.get(item.domain.toLowerCase());
+    if (adapters && adapters.length > 0) {
+      const sortedAdapters = [...adapters].sort((a, b) => a.name.localeCompare(b.name));
+      available.push({
+        domain: item.domain,
+        visits: item.visits,
+        adapterCount: sortedAdapters.length,
+        adapters: sortedAdapters.map((site) => ({
+          name: site.name,
+          description: site.description,
+          example: site.example || `bb-browser site ${site.name}`
+        }))
+      });
+    } else if (item.visits >= 5 && item.domain && !item.domain.includes("localhost") && item.domain.includes(".")) {
+      notAvailable.push(item);
+    }
   }
-  await ensureDaemonRunning();
-  const parsedRef = parseRef4(ref);
-  const request = {
-    id: generateId(),
-    action: "type",
-    ref: parsedRef,
-    text,
-    tabId: options.tabId
+  const jsonData = {
+    days,
+    available,
+    not_available: notAvailable
   };
-  const response = await sendCommand(request);
+  if (options.jq) {
+    handleJqResponse({ id: generateId(), success: true, data: jsonData });
+  }
   if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
+    console.log(JSON.stringify(jsonData, null, 2));
+    return;
+  }
+  console.log(`\u57FA\u4E8E\u4F60\u6700\u8FD1 ${days} \u5929\u7684\u6D4F\u89C8\u8BB0\u5F55\uFF1A`);
+  console.log();
+  console.log("\u{1F3AF} \u4F60\u5E38\u7528\u8FD9\u4E9B\u7F51\u7AD9\uFF0C\u53EF\u4EE5\u76F4\u63A5\u7528\uFF1A");
+  console.log();
+  if (available.length === 0) {
+    console.log("  \uFF08\u6682\u65E0\u5339\u914D\u7684 adapter\uFF09");
   } else {
-    if (response.success) {
-      const role = response.data?.role ?? "element";
-      const name = response.data?.name;
-      if (name) {
-        console.log(`\u5DF2\u8F93\u5165: ${role} "${name}"`);
-      } else {
-        console.log(`\u5DF2\u8F93\u5165: ${role}`);
+    for (const item of available) {
+      console.log(`  ${item.domain.padEnd(20)} ${item.visits} \u6B21\u8BBF\u95EE    ${item.adapterCount} \u4E2A\u547D\u4EE4`);
+      console.log(`    \u8BD5\u8BD5: ${item.adapters[0]?.example || `bb-browser site ${item.adapters[0]?.name || ""}`}`);
+      console.log();
+    }
+  }
+  console.log("\u{1F4CB} \u4F60\u5E38\u7528\u4F46\u8FD8\u6CA1\u6709 adapter\uFF1A");
+  console.log();
+  if (notAvailable.length === 0) {
+    console.log("  \uFF08\u6682\u65E0\uFF09");
+  } else {
+    for (const item of notAvailable) {
+      console.log(`  ${item.domain.padEnd(20)} ${item.visits} \u6B21\u8BBF\u95EE`);
+    }
+  }
+  console.log();
+  console.log('\u{1F4A1} \u8DDF\u4F60\u7684 AI Agent \u8BF4 "\u628A notion.so CLI \u5316"\uFF0C\u5B83\u5C31\u80FD\u81EA\u52A8\u5B8C\u6210\u3002');
+  console.log();
+  console.log(`\u6240\u6709\u5206\u6790\u7EAF\u672C\u5730\u5B8C\u6210\u3002\u7528 --days 7 \u53EA\u770B\u6700\u8FD1\u4E00\u5468\u3002`);
+}
+async function siteRun(name, args, options) {
+  const sites = getAllSites();
+  const site = sites.find((s) => s.name === name);
+  if (!site) {
+    const fuzzy = sites.filter((s) => s.name.includes(name));
+    console.error(`[error] site: "${name}" not found.`);
+    if (fuzzy.length > 0) {
+      console.error("  Did you mean:");
+      for (const s of fuzzy.slice(0, 5)) {
+        console.error(`    bb-browser site ${s.name}`);
       }
-      console.log(`\u5185\u5BB9: "${text}"`);
     } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+      console.error("  Try: bb-browser site list");
+      console.error("  Or:  bb-browser site update");
     }
+    process.exit(1);
   }
-}
-
-// packages/cli/src/commands/close.ts
-async function closeCommand(options = {}) {
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "close",
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      const title = response.data?.title ?? "";
-      if (title) {
-        console.log(`\u5DF2\u5173\u95ED: "${title}"`);
-      } else {
-        console.log("\u5DF2\u5173\u95ED\u5F53\u524D\u6807\u7B7E\u9875");
+  const argNames = Object.keys(site.args);
+  const argMap = {};
+  const positionalArgs = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      const flagName = args[i].slice(2);
+      if (flagName in site.args && args[i + 1]) {
+        argMap[flagName] = args[i + 1];
+        i++;
       }
     } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+      positionalArgs.push(args[i]);
     }
   }
-}
-
-// packages/cli/src/commands/get.ts
-function parseRef5(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
-}
-async function getCommand(attribute, ref, options = {}) {
-  if (attribute === "text" && !ref) {
-    throw new Error("get text \u9700\u8981 ref \u53C2\u6570\uFF0C\u5982: get text @5");
+  let posIdx = 0;
+  for (const argName of argNames) {
+    if (!argMap[argName] && posIdx < positionalArgs.length) {
+      argMap[argName] = positionalArgs[posIdx++];
+    }
   }
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "get",
-    attribute,
-    ref: ref ? parseRef5(ref) : void 0,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      const value = response.data?.value ?? "";
-      console.log(value);
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
+  for (const [argName, argDef] of Object.entries(site.args)) {
+    if (argDef.required && !argMap[argName]) {
+      console.error(`[error] site ${name}: missing required argument "${argName}".`);
+      const usage = argNames.map((a) => {
+        const def = site.args[a];
+        return def.required ? `<${a}>` : `[${a}]`;
+      }).join(" ");
+      console.error(`  Usage: bb-browser site ${name} ${usage}`);
+      if (site.example) console.error(`  Example: ${site.example}`);
       process.exit(1);
     }
   }
-}
-
-// packages/cli/src/commands/screenshot.ts
-import fs from "fs";
-import path from "path";
-import os from "os";
-function getDefaultPath() {
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  const filename = `bb-screenshot-${timestamp}.png`;
-  return path.join(os.tmpdir(), filename);
-}
-function saveBase64Image(dataUrl, filePath) {
-  const base64Data = dataUrl.replace(/^data:image\/png;base64,/, "");
-  const buffer = Buffer.from(base64Data, "base64");
-  const dir = path.dirname(filePath);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(filePath, buffer);
-}
-async function screenshotCommand(outputPath, options = {}) {
+  const jsContent = readFileSync(site.filePath, "utf-8");
+  const jsBody = jsContent.replace(/\/\*\s*@meta[\s\S]*?\*\//, "").trim();
+  const argsJson = JSON.stringify(argMap);
+  const script = `(${jsBody})(${argsJson})`;
   await ensureDaemonRunning();
-  const filePath = outputPath ? path.resolve(outputPath) : getDefaultPath();
-  const request = {
-    id: generateId(),
-    action: "screenshot",
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (response.success && response.data?.dataUrl) {
-    const dataUrl = response.data.dataUrl;
-    saveBase64Image(dataUrl, filePath);
+  let targetTabId = options.tabId;
+  if (!targetTabId && site.domain) {
+    const listReq = { id: generateId(), action: "tab_list" };
+    const listResp = await sendCommand(listReq);
+    if (listResp.success && listResp.data?.tabs) {
+      const matchingTab = listResp.data.tabs.find(
+        (tab) => matchTabOrigin(tab.url, site.domain)
+      );
+      if (matchingTab) {
+        targetTabId = matchingTab.tabId;
+      }
+    }
+    if (!targetTabId) {
+      const newResp = await sendCommand({
+        id: generateId(),
+        action: "tab_new",
+        url: `https://${site.domain}`
+      });
+      targetTabId = newResp.data?.tabId;
+      await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+    }
+  }
+  const evalReq = { id: generateId(), action: "eval", script, tabId: targetTabId };
+  const evalResp = await sendCommand(evalReq);
+  if (!evalResp.success) {
+    const hint = site.domain ? `Open https://${site.domain} in your browser, make sure you are logged in, then retry.` : void 0;
     if (options.json) {
-      console.log(JSON.stringify({
-        success: true,
-        path: filePath,
-        base64: dataUrl
-      }, null, 2));
+      console.log(JSON.stringify({ id: evalReq.id, success: false, error: evalResp.error || "eval failed", hint }));
     } else {
-      console.log(`\u622A\u56FE\u5DF2\u4FDD\u5B58: ${filePath}`);
+      console.error(`[error] site ${name}: ${evalResp.error || "eval failed"}`);
+      if (hint) console.error(`  Hint: ${hint}`);
     }
-  } else {
+    process.exit(1);
+  }
+  const result = evalResp.data?.result;
+  if (result === void 0 || result === null) {
     if (options.json) {
-      console.log(JSON.stringify(response, null, 2));
+      console.log(JSON.stringify({ id: evalReq.id, success: true, data: null }));
     } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
+      console.log("(no output)");
+    }
+    return;
+  }
+  let parsed;
+  try {
+    parsed = typeof result === "string" ? JSON.parse(result) : result;
+  } catch {
+    parsed = result;
+  }
+  if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
+    const errObj = parsed;
+    const checkText = `${errObj.error} ${errObj.hint || ""}`;
+    const isAuthError = /401|403|unauthorized|forbidden|not.?logged|login.?required|sign.?in|auth/i.test(checkText);
+    const loginHint = isAuthError && site.domain ? `Please log in to https://${site.domain} in your browser first, then retry.` : void 0;
+    const hint = loginHint || errObj.hint;
+    const reportHint = `If this is an adapter bug, report via: gh issue create --repo epiral/bb-sites --title "[${name}] <description>" OR: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] <description>"`;
+    if (options.json) {
+      console.log(JSON.stringify({ id: evalReq.id, success: false, error: errObj.error, hint, reportHint }));
+    } else {
+      console.error(`[error] site ${name}: ${errObj.error}`);
+      if (hint) console.error(`  Hint: ${hint}`);
+      console.error(`  Report: gh issue create --repo epiral/bb-sites --title "[${name}] ..."`);
+      console.error(`     or: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] ..."`);
     }
     process.exit(1);
   }
+  if (options.jq) {
+    const { applyJq: applyJq2 } = await import("./jq-HHMLHEPA.js");
+    const expr = options.jq.replace(/^\.data\./, ".");
+    const results = applyJq2(parsed, expr);
+    for (const r of results) {
+      console.log(typeof r === "string" ? r : JSON.stringify(r));
+    }
+  } else if (options.json) {
+    console.log(JSON.stringify({ id: evalReq.id, success: true, data: parsed }));
+  } else {
+    console.log(JSON.stringify(parsed, null, 2));
+  }
 }
+async function siteCommand(args, options = {}) {
+  const subCommand = args[0];
+  if (!subCommand || subCommand === "--help" || subCommand === "-h") {
+    console.log(`bb-browser site - \u7F51\u7AD9 CLI \u5316\uFF08\u7BA1\u7406\u548C\u8FD0\u884C site adapter\uFF09
 
-// packages/cli/src/commands/wait.ts
-function isTimeWait(target) {
-  return /^\d+$/.test(target);
-}
-function parseRef6(ref) {
-  return ref.startsWith("@") ? ref.slice(1) : ref;
+\u7528\u6CD5:
+  bb-browser site list                      \u5217\u51FA\u6240\u6709\u53EF\u7528 adapter
+  bb-browser site info <name>               \u67E5\u770B adapter \u5143\u4FE1\u606F
+  bb-browser site recommend                 \u57FA\u4E8E\u5386\u53F2\u8BB0\u5F55\u63A8\u8350 adapter
+  bb-browser site search <query>            \u641C\u7D22 adapter
+  bb-browser site <name> [args...]          \u8FD0\u884C adapter\uFF08\u7B80\u5199\uFF09
+  bb-browser site run <name> [args...]      \u8FD0\u884C adapter
+  bb-browser site update                    \u66F4\u65B0\u793E\u533A adapter \u5E93 (git clone/pull)
+
+\u76EE\u5F55:
+  ${LOCAL_SITES_DIR}      \u79C1\u6709 adapter\uFF08\u4F18\u5148\uFF09
+  ${COMMUNITY_SITES_DIR}   \u793E\u533A adapter
+
+\u793A\u4F8B:
+  bb-browser site update
+  bb-browser site list
+  bb-browser site reddit/thread https://www.reddit.com/r/LocalLLaMA/comments/...
+  bb-browser site twitter/user yan5xu
+  bb-browser site search reddit
+
+\u521B\u5EFA\u65B0 adapter: bb-browser guide
+\u62A5\u544A\u95EE\u9898: gh issue create --repo epiral/bb-sites --title "[adapter-name] \u63CF\u8FF0"
+\u8D21\u732E\u793E\u533A: https://github.com/epiral/bb-sites`);
+    return;
+  }
+  switch (subCommand) {
+    case "list":
+      siteList(options);
+      break;
+    case "search":
+      if (!args[1]) {
+        console.error("[error] site search: <query> is required.");
+        console.error("  Usage: bb-browser site search <query>");
+        process.exit(1);
+      }
+      siteSearch(args[1], options);
+      break;
+    case "info":
+      if (!args[1]) {
+        console.error("[error] site info: <name> is required.");
+        console.error("  Usage: bb-browser site info <name>");
+        process.exit(1);
+      }
+      siteInfo(args[1], options);
+      break;
+    case "recommend":
+      await siteRecommend(options);
+      break;
+    case "update":
+      siteUpdate();
+      break;
+    case "run":
+      if (!args[1]) {
+        console.error("[error] site run: <name> is required.");
+        console.error("  Usage: bb-browser site run <name> [args...]");
+        console.error("  Try: bb-browser site list");
+        process.exit(1);
+      }
+      await siteRun(args[1], args.slice(2), options);
+      break;
+    default:
+      if (subCommand.includes("/")) {
+        await siteRun(subCommand, args.slice(1), options);
+      } else {
+        console.error(`[error] site: unknown subcommand "${subCommand}".`);
+        console.error("  Available: list, info, recommend, search, run, update");
+        console.error("  Try: bb-browser site --help");
+        process.exit(1);
+      }
+      break;
+  }
 }
-async function waitCommand(target, options = {}) {
-  if (!target) {
-    throw new Error("\u7F3A\u5C11\u7B49\u5F85\u76EE\u6807\u53C2\u6570");
+
+// packages/cli/src/commands/open.ts
+async function openCommand(url, options = {}) {
+  if (!url) {
+    throw new Error("\u7F3A\u5C11 URL \u53C2\u6570");
   }
   await ensureDaemonRunning();
-  let request;
-  if (isTimeWait(target)) {
-    const ms = parseInt(target, 10);
-    request = {
-      id: generateId(),
-      action: "wait",
-      waitType: "time",
-      ms,
-      tabId: options.tabId
-    };
-  } else {
-    const ref = parseRef6(target);
-    request = {
-      id: generateId(),
-      action: "wait",
-      waitType: "element",
-      ref,
-      tabId: options.tabId
-    };
+  let normalizedUrl = url;
+  if (!url.startsWith("http://") && !url.startsWith("https://")) {
+    normalizedUrl = "https://" + url;
+  }
+  const request = {
+    id: generateId(),
+    action: "open",
+    url: normalizedUrl
+  };
+  if (options.tab !== void 0) {
+    if (options.tab === "current") {
+      request.tabId = "current";
+    } else {
+      const tabId = parseInt(options.tab, 10);
+      if (isNaN(tabId)) {
+        throw new Error(`\u65E0\u6548\u7684 tabId: ${options.tab}`);
+      }
+      request.tabId = tabId;
+    }
   }
   const response = await sendCommand(request);
   if (options.json) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      if (isTimeWait(target)) {
-        console.log(`\u5DF2\u7B49\u5F85 ${target}ms`);
-      } else {
-        console.log(`\u5143\u7D20 @${parseRef6(target)} \u5DF2\u51FA\u73B0`);
+      console.log(`\u5DF2\u6253\u5F00: ${response.data?.url ?? normalizedUrl}`);
+      if (response.data?.title) {
+        console.log(`\u6807\u9898: ${response.data.title}`);
+      }
+      if (response.data?.tabId) {
+        console.log(`Tab ID: ${response.data.tabId}`);
+      }
+      const siteHint = getSiteHintForDomain(normalizedUrl);
+      if (siteHint) {
+        console.log(`
+\u{1F4A1} ${siteHint}`);
       }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
@@ -529,35 +769,16 @@ async function waitCommand(target, options = {}) {
   }
 }
 
-// packages/cli/src/commands/press.ts
-function parseKey(keyString) {
-  const parts = keyString.split("+");
-  const modifierNames = ["Control", "Alt", "Shift", "Meta"];
-  const modifiers = [];
-  let key = "";
-  for (const part of parts) {
-    if (modifierNames.includes(part)) {
-      modifiers.push(part);
-    } else {
-      key = part;
-    }
-  }
-  return { key, modifiers };
-}
-async function pressCommand(keyString, options = {}) {
-  if (!keyString) {
-    throw new Error("\u7F3A\u5C11 key \u53C2\u6570");
-  }
+// packages/cli/src/commands/snapshot.ts
+async function snapshotCommand(options = {}) {
   await ensureDaemonRunning();
-  const { key, modifiers } = parseKey(keyString);
-  if (!key) {
-    throw new Error("\u65E0\u6548\u7684\u6309\u952E\u683C\u5F0F");
-  }
   const request = {
     id: generateId(),
-    action: "press",
-    key,
-    modifiers,
+    action: "snapshot",
+    interactive: options.interactive,
+    compact: options.compact,
+    maxDepth: options.maxDepth,
+    selector: options.selector,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -565,8 +786,12 @@ async function pressCommand(keyString, options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const displayKey = modifiers.length > 0 ? `${modifiers.join("+")}+${key}` : key;
-      console.log(`\u5DF2\u6309\u4E0B: ${displayKey}`);
+      console.log(`\u6807\u9898: ${response.data?.title ?? "(\u65E0\u6807\u9898)"}`);
+      console.log(`URL: ${response.data?.url ?? "(\u672A\u77E5)"}`);
+      if (response.data?.snapshotData?.snapshot) {
+        console.log("");
+        console.log(response.data.snapshotData.snapshot);
+      }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -574,31 +799,20 @@ async function pressCommand(keyString, options = {}) {
   }
 }
 
-// packages/cli/src/commands/scroll.ts
-var VALID_DIRECTIONS = ["up", "down", "left", "right"];
-var DEFAULT_PIXELS = 300;
-async function scrollCommand(direction, pixels, options = {}) {
-  if (!direction) {
-    throw new Error("\u7F3A\u5C11 direction \u53C2\u6570");
-  }
-  if (!VALID_DIRECTIONS.includes(direction)) {
-    throw new Error(
-      `\u65E0\u6548\u7684\u6EDA\u52A8\u65B9\u5411: ${direction}\uFF0C\u652F\u6301: ${VALID_DIRECTIONS.join(", ")}`
-    );
-  }
-  let pixelValue = DEFAULT_PIXELS;
-  if (pixels !== void 0) {
-    pixelValue = parseInt(pixels, 10);
-    if (isNaN(pixelValue) || pixelValue <= 0) {
-      throw new Error(`\u65E0\u6548\u7684\u50CF\u7D20\u503C: ${pixels}`);
-    }
+// packages/cli/src/commands/click.ts
+function parseRef(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
+}
+async function clickCommand(ref, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
   }
   await ensureDaemonRunning();
+  const parsedRef = parseRef(ref);
   const request = {
     id: generateId(),
-    action: "scroll",
-    direction,
-    pixels: pixelValue,
+    action: "click",
+    ref: parsedRef,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -606,7 +820,13 @@ async function scrollCommand(direction, pixels, options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      console.log(`\u5DF2\u6EDA\u52A8: ${direction} ${pixelValue}px`);
+      const role = response.data?.role ?? "element";
+      const name = response.data?.name;
+      if (name) {
+        console.log(`\u5DF2\u70B9\u51FB: ${role} "${name}"`);
+      } else {
+        console.log(`\u5DF2\u70B9\u51FB: ${role}`);
+      }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -614,188 +834,20 @@ async function scrollCommand(direction, pixels, options = {}) {
   }
 }
 
-// packages/cli/src/commands/daemon.ts
-import { spawn as spawn2 } from "child_process";
-async function daemonCommand(options = {}) {
-  if (await isDaemonRunning()) {
-    if (options.json) {
-      console.log(JSON.stringify({ success: false, error: "Daemon \u5DF2\u5728\u8FD0\u884C" }));
-    } else {
-      console.log("Daemon \u5DF2\u5728\u8FD0\u884C");
-    }
-    return;
-  }
-  const daemonPath = getDaemonPath();
-  const args = [daemonPath];
-  if (options.host) {
-    args.push("--host", options.host);
-  }
-  if (options.json) {
-    console.log(JSON.stringify({ success: true, message: "Daemon \u542F\u52A8\u4E2D..." }));
-  } else {
-    console.log("Daemon \u542F\u52A8\u4E2D...");
-  }
-  await new Promise((resolve2, reject) => {
-    const child = spawn2(process.execPath, args, {
-      stdio: "inherit"
-    });
-    child.on("exit", (code) => {
-      if (code && code !== 0) {
-        reject(new Error(`Daemon exited with code ${code}`));
-      } else {
-        resolve2();
-      }
-    });
-    child.on("error", reject);
-  });
-}
-async function stopCommand(options = {}) {
-  if (!await isDaemonRunning()) {
-    if (options.json) {
-      console.log(JSON.stringify({ success: false, error: "Daemon \u672A\u8FD0\u884C" }));
-    } else {
-      console.log("Daemon \u672A\u8FD0\u884C");
-    }
-    return;
-  }
-  const stopped = await stopDaemon();
-  if (stopped) {
-    if (options.json) {
-      console.log(JSON.stringify({ success: true, message: "Daemon \u5DF2\u505C\u6B62" }));
-    } else {
-      console.log("Daemon \u5DF2\u505C\u6B62");
-    }
-  } else {
-    if (options.json) {
-      console.log(JSON.stringify({ success: false, error: "\u65E0\u6CD5\u505C\u6B62 Daemon" }));
-    } else {
-      console.error("\u65E0\u6CD5\u505C\u6B62 Daemon");
-    }
-    process.exit(1);
-  }
-}
-async function statusCommand(options = {}) {
-  const running = await isDaemonRunning();
-  if (options.json) {
-    console.log(JSON.stringify({ running }));
-  } else {
-    console.log(running ? "Daemon \u8FD0\u884C\u4E2D" : "Daemon \u672A\u8FD0\u884C");
-  }
+// packages/cli/src/commands/hover.ts
+function parseRef2(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
 }
-
-// packages/cli/src/commands/reload.ts
-import WebSocket from "ws";
-var EXTENSION_NAME = "bb-browser";
-async function reloadCommand(options = {}) {
-  const port = options.port || 9222;
-  try {
-    const listRes = await fetch(`http://127.0.0.1:${port}/json/list`);
-    if (!listRes.ok) {
-      throw new Error(`CDP \u672A\u542F\u7528\u3002\u8BF7\u7528 --remote-debugging-port=${port} \u542F\u52A8 Chrome`);
-    }
-    const list = await listRes.json();
-    const extPage = list.find(
-      (t) => t.type === "page" && t.url.includes("chrome://extensions")
-    );
-    if (!extPage) {
-      throw new Error("\u8BF7\u5148\u6253\u5F00 chrome://extensions \u9875\u9762");
-    }
-    const result = await new Promise((resolve2, reject) => {
-      const ws = new WebSocket(extPage.webSocketDebuggerUrl);
-      let resolved = false;
-      const timeout = setTimeout(() => {
-        if (!resolved) {
-          resolved = true;
-          ws.close();
-          reject(new Error("CDP \u8FDE\u63A5\u8D85\u65F6"));
-        }
-      }, 1e4);
-      ws.on("open", () => {
-        const script = `
-          (async function() {
-            if (!chrome || !chrome.developerPrivate) {
-              return { error: 'developerPrivate API not available' };
-            }
-            
-            try {
-              const exts = await chrome.developerPrivate.getExtensionsInfo();
-              const bbExt = exts.find(e => e.name === '${EXTENSION_NAME}');
-              
-              if (!bbExt) {
-                return { error: '${EXTENSION_NAME} \u6269\u5C55\u672A\u5B89\u88C5' };
-              }
-              
-              if (bbExt.state !== 'ENABLED') {
-                return { error: '${EXTENSION_NAME} \u6269\u5C55\u5DF2\u7981\u7528' };
-              }
-              
-              await chrome.developerPrivate.reload(bbExt.id, {failQuietly: true});
-              return { success: true, extensionId: bbExt.id };
-            } catch (e) {
-              return { error: e.message };
-            }
-          })()
-        `;
-        ws.send(JSON.stringify({
-          id: 1,
-          method: "Runtime.evaluate",
-          params: {
-            expression: script,
-            awaitPromise: true,
-            returnByValue: true
-          }
-        }));
-      });
-      ws.on("message", (data) => {
-        const msg = JSON.parse(data.toString());
-        if (msg.id === 1) {
-          clearTimeout(timeout);
-          resolved = true;
-          ws.close();
-          const value = msg.result?.result?.value;
-          if (value?.success) {
-            resolve2({
-              success: true,
-              message: "\u6269\u5C55\u5DF2\u91CD\u8F7D",
-              extensionId: value.extensionId
-            });
-          } else if (value?.error) {
-            reject(new Error(value.error));
-          } else {
-            reject(new Error(`\u91CD\u8F7D\u5931\u8D25: ${JSON.stringify(value)}`));
-          }
-        }
-      });
-      ws.on("error", (err) => {
-        clearTimeout(timeout);
-        if (!resolved) {
-          resolved = true;
-          reject(new Error(`CDP \u8FDE\u63A5\u5931\u8D25: ${err.message}`));
-        }
-      });
-    });
-    if (options.json) {
-      console.log(JSON.stringify(result));
-    } else {
-      console.log(`${result.message} (${result.extensionId})`);
-    }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (options.json) {
-      console.log(JSON.stringify({ success: false, error: message }));
-    } else {
-      console.error(`\u9519\u8BEF: ${message}`);
-    }
-    process.exit(1);
+async function hoverCommand(ref, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
   }
-}
-
-// packages/cli/src/commands/nav.ts
-async function backCommand(options = {}) {
   await ensureDaemonRunning();
+  const parsedRef = parseRef2(ref);
   const request = {
     id: generateId(),
-    action: "back",
+    action: "hover",
+    ref: parsedRef,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -803,11 +855,12 @@ async function backCommand(options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const url = response.data?.url ?? "";
-      if (url) {
-        console.log(`\u540E\u9000\u81F3: ${url}`);
+      const role = response.data?.role ?? "element";
+      const name = response.data?.name;
+      if (name) {
+        console.log(`\u5DF2\u60AC\u505C: ${role} "${name}"`);
       } else {
-        console.log("\u5DF2\u540E\u9000");
+        console.log(`\u5DF2\u60AC\u505C: ${role}`);
       }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
@@ -815,11 +868,25 @@ async function backCommand(options = {}) {
     }
   }
 }
-async function forwardCommand(options = {}) {
+
+// packages/cli/src/commands/fill.ts
+function parseRef3(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
+}
+async function fillCommand(ref, text, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+  }
+  if (text === void 0 || text === null) {
+    throw new Error("\u7F3A\u5C11 text \u53C2\u6570");
+  }
   await ensureDaemonRunning();
+  const parsedRef = parseRef3(ref);
   const request = {
     id: generateId(),
-    action: "forward",
+    action: "fill",
+    ref: parsedRef,
+    text,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -827,36 +894,14 @@ async function forwardCommand(options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const url = response.data?.url ?? "";
-      if (url) {
-        console.log(`\u524D\u8FDB\u81F3: ${url}`);
+      const role = response.data?.role ?? "element";
+      const name = response.data?.name;
+      if (name) {
+        console.log(`\u5DF2\u586B\u5145: ${role} "${name}"`);
       } else {
-        console.log("\u5DF2\u524D\u8FDB");
-      }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
-    }
-  }
-}
-async function refreshCommand(options = {}) {
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "refresh",
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      const title = response.data?.title ?? "";
-      if (title) {
-        console.log(`\u5DF2\u5237\u65B0: "${title}"`);
-      } else {
-        console.log("\u5DF2\u5237\u65B0\u9875\u9762");
+        console.log(`\u5DF2\u586B\u5145: ${role}`);
       }
+      console.log(`\u5185\u5BB9: "${text}"`);
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -864,20 +909,24 @@ async function refreshCommand(options = {}) {
   }
 }
 
-// packages/cli/src/commands/check.ts
-function parseRef7(ref) {
+// packages/cli/src/commands/type.ts
+function parseRef4(ref) {
   return ref.startsWith("@") ? ref.slice(1) : ref;
 }
-async function checkCommand(ref, options = {}) {
+async function typeCommand(ref, text, options = {}) {
   if (!ref) {
     throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
   }
+  if (text === void 0 || text === null) {
+    throw new Error("\u7F3A\u5C11 text \u53C2\u6570");
+  }
   await ensureDaemonRunning();
-  const parsedRef = parseRef7(ref);
+  const parsedRef = parseRef4(ref);
   const request = {
     id: generateId(),
-    action: "check",
+    action: "type",
     ref: parsedRef,
+    text,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -885,38 +934,27 @@ async function checkCommand(ref, options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const role = response.data?.role ?? "checkbox";
+      const role = response.data?.role ?? "element";
       const name = response.data?.name;
-      const wasAlreadyChecked = response.data?.wasAlreadyChecked;
-      if (wasAlreadyChecked) {
-        if (name) {
-          console.log(`\u5DF2\u52FE\u9009\uFF08\u4E4B\u524D\u5DF2\u52FE\u9009\uFF09: ${role} "${name}"`);
-        } else {
-          console.log(`\u5DF2\u52FE\u9009\uFF08\u4E4B\u524D\u5DF2\u52FE\u9009\uFF09: ${role}`);
-        }
+      if (name) {
+        console.log(`\u5DF2\u8F93\u5165: ${role} "${name}"`);
       } else {
-        if (name) {
-          console.log(`\u5DF2\u52FE\u9009: ${role} "${name}"`);
-        } else {
-          console.log(`\u5DF2\u52FE\u9009: ${role}`);
-        }
+        console.log(`\u5DF2\u8F93\u5165: ${role}`);
       }
+      console.log(`\u5185\u5BB9: "${text}"`);
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
     }
   }
 }
-async function uncheckCommand(ref, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
-  }
+
+// packages/cli/src/commands/close.ts
+async function closeCommand(options = {}) {
   await ensureDaemonRunning();
-  const parsedRef = parseRef7(ref);
   const request = {
     id: generateId(),
-    action: "uncheck",
-    ref: parsedRef,
+    action: "close",
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -924,21 +962,11 @@ async function uncheckCommand(ref, options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const role = response.data?.role ?? "checkbox";
-      const name = response.data?.name;
-      const wasAlreadyUnchecked = response.data?.wasAlreadyUnchecked;
-      if (wasAlreadyUnchecked) {
-        if (name) {
-          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009\uFF08\u4E4B\u524D\u672A\u52FE\u9009\uFF09: ${role} "${name}"`);
-        } else {
-          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009\uFF08\u4E4B\u524D\u672A\u52FE\u9009\uFF09: ${role}`);
-        }
+      const title = response.data?.title ?? "";
+      if (title) {
+        console.log(`\u5DF2\u5173\u95ED: "${title}"`);
       } else {
-        if (name) {
-          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009: ${role} "${name}"`);
-        } else {
-          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009: ${role}`);
-        }
+        console.log("\u5DF2\u5173\u95ED\u5F53\u524D\u6807\u7B7E\u9875");
       }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
@@ -947,24 +975,20 @@ async function uncheckCommand(ref, options = {}) {
   }
 }
 
-// packages/cli/src/commands/select.ts
-function parseRef8(ref) {
+// packages/cli/src/commands/get.ts
+function parseRef5(ref) {
   return ref.startsWith("@") ? ref.slice(1) : ref;
 }
-async function selectCommand(ref, value, options = {}) {
-  if (!ref) {
-    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
-  }
-  if (value === void 0 || value === null) {
-    throw new Error("\u7F3A\u5C11 value \u53C2\u6570");
+async function getCommand(attribute, ref, options = {}) {
+  if (attribute === "text" && !ref) {
+    throw new Error("get text \u9700\u8981 ref \u53C2\u6570\uFF0C\u5982: get text @5");
   }
   await ensureDaemonRunning();
-  const parsedRef = parseRef8(ref);
   const request = {
     id: generateId(),
-    action: "select",
-    ref: parsedRef,
-    value,
+    action: "get",
+    attribute,
+    ref: ref ? parseRef5(ref) : void 0,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -972,20 +996,8 @@ async function selectCommand(ref, value, options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const role = response.data?.role ?? "combobox";
-      const name = response.data?.name;
-      const selectedValue = response.data?.selectedValue;
-      const selectedLabel = response.data?.selectedLabel;
-      if (name) {
-        console.log(`\u5DF2\u9009\u62E9: ${role} "${name}"`);
-      } else {
-        console.log(`\u5DF2\u9009\u62E9: ${role}`);
-      }
-      if (selectedLabel && selectedLabel !== selectedValue) {
-        console.log(`\u9009\u9879: "${selectedLabel}" (value="${selectedValue}")`);
-      } else {
-        console.log(`\u9009\u9879: "${selectedValue}"`);
-      }
+      const value = response.data?.value ?? "";
+      console.log(value);
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -993,32 +1005,96 @@ async function selectCommand(ref, value, options = {}) {
   }
 }
 
-// packages/cli/src/commands/eval.ts
-async function evalCommand(script, options = {}) {
-  if (!script) {
-    throw new Error("\u7F3A\u5C11 script \u53C2\u6570");
+// packages/cli/src/commands/screenshot.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+function getDefaultPath() {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  const filename = `bb-screenshot-${timestamp}.png`;
+  return path.join(os.tmpdir(), filename);
+}
+function saveBase64Image(dataUrl, filePath) {
+  const base64Data = dataUrl.replace(/^data:image\/png;base64,/, "");
+  const buffer = Buffer.from(base64Data, "base64");
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
   }
+  fs.writeFileSync(filePath, buffer);
+}
+async function screenshotCommand(outputPath, options = {}) {
   await ensureDaemonRunning();
+  const filePath = outputPath ? path.resolve(outputPath) : getDefaultPath();
   const request = {
     id: generateId(),
-    action: "eval",
-    script,
+    action: "screenshot",
     tabId: options.tabId
   };
   const response = await sendCommand(request);
+  if (response.success && response.data?.dataUrl) {
+    const dataUrl = response.data.dataUrl;
+    saveBase64Image(dataUrl, filePath);
+    if (options.json) {
+      console.log(JSON.stringify({
+        success: true,
+        path: filePath,
+        base64: dataUrl
+      }, null, 2));
+    } else {
+      console.log(`\u622A\u56FE\u5DF2\u4FDD\u5B58: ${filePath}`);
+    }
+  } else {
+    if (options.json) {
+      console.log(JSON.stringify(response, null, 2));
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+    }
+    process.exit(1);
+  }
+}
+
+// packages/cli/src/commands/wait.ts
+function isTimeWait(target) {
+  return /^\d+$/.test(target);
+}
+function parseRef6(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
+}
+async function waitCommand(target, options = {}) {
+  if (!target) {
+    throw new Error("\u7F3A\u5C11\u7B49\u5F85\u76EE\u6807\u53C2\u6570");
+  }
+  await ensureDaemonRunning();
+  let request;
+  if (isTimeWait(target)) {
+    const ms = parseInt(target, 10);
+    request = {
+      id: generateId(),
+      action: "wait",
+      waitType: "time",
+      ms,
+      tabId: options.tabId
+    };
+  } else {
+    const ref = parseRef6(target);
+    request = {
+      id: generateId(),
+      action: "wait",
+      waitType: "element",
+      ref,
+      tabId: options.tabId
+    };
+  }
+  const response = await sendCommand(request);
   if (options.json) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      const result = response.data?.result;
-      if (result !== void 0) {
-        if (typeof result === "object" && result !== null) {
-          console.log(JSON.stringify(result, null, 2));
-        } else {
-          console.log(result);
-        }
+      if (isTimeWait(target)) {
+        console.log(`\u5DF2\u7B49\u5F85 ${target}ms`);
       } else {
-        console.log("undefined");
+        console.log(`\u5143\u7D20 @${parseRef6(target)} \u5DF2\u51FA\u73B0`);
       }
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
@@ -1027,101 +1103,44 @@ async function evalCommand(script, options = {}) {
   }
 }
 
-// packages/cli/src/commands/tab.ts
-function parseTabSubcommand(args, rawArgv) {
-  let tabId;
-  if (rawArgv) {
-    const idIdx = rawArgv.indexOf("--id");
-    if (idIdx >= 0 && rawArgv[idIdx + 1]) {
-      tabId = parseInt(rawArgv[idIdx + 1], 10);
-      if (isNaN(tabId)) {
-        throw new Error(`\u65E0\u6548\u7684 tabId: ${rawArgv[idIdx + 1]}`);
-      }
+// packages/cli/src/commands/press.ts
+function parseKey(keyString) {
+  const parts = keyString.split("+");
+  const modifierNames = ["Control", "Alt", "Shift", "Meta"];
+  const modifiers = [];
+  let key = "";
+  for (const part of parts) {
+    if (modifierNames.includes(part)) {
+      modifiers.push(part);
+    } else {
+      key = part;
     }
   }
-  if (args.length === 0) {
-    return { action: "tab_list" };
-  }
-  const first = args[0];
-  if (first === "new") {
-    return { action: "tab_new", url: args[1] };
+  return { key, modifiers };
+}
+async function pressCommand(keyString, options = {}) {
+  if (!keyString) {
+    throw new Error("\u7F3A\u5C11 key \u53C2\u6570");
   }
-  if (first === "select") {
-    if (tabId !== void 0) {
-      return { action: "tab_select", tabId };
-    }
-    throw new Error("tab select \u9700\u8981 --id \u53C2\u6570\uFF0C\u7528\u6CD5\uFF1Abb-browser tab select --id <tabId>");
+  await ensureDaemonRunning();
+  const { key, modifiers } = parseKey(keyString);
+  if (!key) {
+    throw new Error("\u65E0\u6548\u7684\u6309\u952E\u683C\u5F0F");
   }
-  if (first === "close") {
-    if (tabId !== void 0) {
-      return { action: "tab_close", tabId };
-    }
-    const indexArg = args[1];
-    if (indexArg !== void 0) {
-      const index2 = parseInt(indexArg, 10);
-      if (isNaN(index2) || index2 < 0) {
-        throw new Error(`\u65E0\u6548\u7684\u6807\u7B7E\u9875\u7D22\u5F15: ${indexArg}`);
-      }
-      return { action: "tab_close", index: index2 };
-    }
-    return { action: "tab_close" };
-  }
-  const index = parseInt(first, 10);
-  if (!isNaN(index) && index >= 0) {
-    return { action: "tab_select", index };
-  }
-  throw new Error(`\u672A\u77E5\u7684 tab \u5B50\u547D\u4EE4: ${first}`);
-}
-function formatTabList(tabs, activeIndex) {
-  const lines = [];
-  lines.push(`\u6807\u7B7E\u9875\u5217\u8868\uFF08\u5171 ${tabs.length} \u4E2A\uFF0C\u5F53\u524D #${activeIndex}\uFF09\uFF1A`);
-  for (const tab of tabs) {
-    const prefix = tab.active ? "*" : " ";
-    const title = tab.title || "(\u65E0\u6807\u9898)";
-    lines.push(`${prefix} [${tab.index}] ${tab.url} - ${title}`);
-  }
-  return lines.join("\n");
-}
-async function tabCommand(args, options = {}) {
-  await ensureDaemonRunning();
-  const parsed = parseTabSubcommand(args, process.argv);
   const request = {
     id: generateId(),
-    action: parsed.action,
-    url: parsed.url,
-    index: parsed.index,
-    tabId: parsed.tabId
+    action: "press",
+    key,
+    modifiers,
+    tabId: options.tabId
   };
   const response = await sendCommand(request);
   if (options.json) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      switch (parsed.action) {
-        case "tab_list": {
-          const tabs = response.data?.tabs ?? [];
-          const activeIndex = response.data?.activeIndex ?? 0;
-          console.log(formatTabList(tabs, activeIndex));
-          break;
-        }
-        case "tab_new": {
-          const url = response.data?.url ?? "about:blank";
-          console.log(`\u5DF2\u521B\u5EFA\u65B0\u6807\u7B7E\u9875: ${url}`);
-          break;
-        }
-        case "tab_select": {
-          const title = response.data?.title ?? "(\u65E0\u6807\u9898)";
-          const url = response.data?.url ?? "";
-          console.log(`\u5DF2\u5207\u6362\u5230\u6807\u7B7E\u9875 #${parsed.index}: ${title}`);
-          console.log(`  URL: ${url}`);
-          break;
-        }
-        case "tab_close": {
-          const closedTitle = response.data?.title ?? "(\u65E0\u6807\u9898)";
-          console.log(`\u5DF2\u5173\u95ED\u6807\u7B7E\u9875: ${closedTitle}`);
-          break;
-        }
-      }
+      const displayKey = modifiers.length > 0 ? `${modifiers.join("+")}+${key}` : key;
+      console.log(`\u5DF2\u6309\u4E0B: ${displayKey}`);
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -1129,40 +1148,31 @@ async function tabCommand(args, options = {}) {
   }
 }
 
-// packages/cli/src/commands/frame.ts
-async function frameCommand(selector, options = {}) {
-  if (!selector) {
-    throw new Error("\u7F3A\u5C11 selector \u53C2\u6570");
+// packages/cli/src/commands/scroll.ts
+var VALID_DIRECTIONS = ["up", "down", "left", "right"];
+var DEFAULT_PIXELS = 300;
+async function scrollCommand(direction, pixels, options = {}) {
+  if (!direction) {
+    throw new Error("\u7F3A\u5C11 direction \u53C2\u6570");
   }
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "frame",
-    selector,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
-  if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
-  } else {
-    if (response.success) {
-      const frameInfo = response.data?.frameInfo;
-      if (frameInfo?.url) {
-        console.log(`\u5DF2\u5207\u6362\u5230 frame: ${selector} (${frameInfo.url})`);
-      } else {
-        console.log(`\u5DF2\u5207\u6362\u5230 frame: ${selector}`);
-      }
-    } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+  if (!VALID_DIRECTIONS.includes(direction)) {
+    throw new Error(
+      `\u65E0\u6548\u7684\u6EDA\u52A8\u65B9\u5411: ${direction}\uFF0C\u652F\u6301: ${VALID_DIRECTIONS.join(", ")}`
+    );
+  }
+  let pixelValue = DEFAULT_PIXELS;
+  if (pixels !== void 0) {
+    pixelValue = parseInt(pixels, 10);
+    if (isNaN(pixelValue) || pixelValue <= 0) {
+      throw new Error(`\u65E0\u6548\u7684\u50CF\u7D20\u503C: ${pixels}`);
     }
   }
-}
-async function frameMainCommand(options = {}) {
   await ensureDaemonRunning();
   const request = {
     id: generateId(),
-    action: "frame_main",
+    action: "scroll",
+    direction,
+    pixels: pixelValue,
     tabId: options.tabId
   };
   const response = await sendCommand(request);
@@ -1170,7 +1180,7 @@ async function frameMainCommand(options = {}) {
     console.log(JSON.stringify(response, null, 2));
   } else {
     if (response.success) {
-      console.log("\u5DF2\u8FD4\u56DE\u4E3B frame");
+      console.log(`\u5DF2\u6EDA\u52A8: ${direction} ${pixelValue}px`);
     } else {
       console.error(`\u9519\u8BEF: ${response.error}`);
       process.exit(1);
@@ -1178,797 +1188,1027 @@ async function frameMainCommand(options = {}) {
   }
 }
 
-// packages/cli/src/commands/dialog.ts
-async function dialogCommand(subCommand, promptText, options = {}) {
-  if (!subCommand || !["accept", "dismiss"].includes(subCommand)) {
-    throw new Error("\u8BF7\u4F7F\u7528 'dialog accept [text]' \u6216 'dialog dismiss'");
+// packages/cli/src/commands/daemon.ts
+import { spawn as spawn2 } from "child_process";
+async function daemonCommand(options = {}) {
+  if (await isDaemonRunning()) {
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: "Daemon \u5DF2\u5728\u8FD0\u884C" }));
+    } else {
+      console.log("Daemon \u5DF2\u5728\u8FD0\u884C");
+    }
+    return;
+  }
+  const daemonPath = getDaemonPath();
+  const args = [daemonPath];
+  if (options.host) {
+    args.push("--host", options.host);
   }
-  await ensureDaemonRunning();
-  const request = {
-    id: generateId(),
-    action: "dialog",
-    dialogResponse: subCommand,
-    promptText: subCommand === "accept" ? promptText : void 0,
-    tabId: options.tabId
-  };
-  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response, null, 2));
+    console.log(JSON.stringify({ success: true, message: "Daemon \u542F\u52A8\u4E2D..." }));
   } else {
-    if (response.success) {
-      const dialogInfo = response.data?.dialogInfo;
-      if (dialogInfo) {
-        const action = subCommand === "accept" ? "\u5DF2\u63A5\u53D7" : "\u5DF2\u62D2\u7EDD";
-        console.log(`${action}\u5BF9\u8BDD\u6846\uFF08${dialogInfo.type}\uFF09: "${dialogInfo.message}"`);
+    console.log("Daemon \u542F\u52A8\u4E2D...");
+  }
+  await new Promise((resolve2, reject) => {
+    const child = spawn2(process.execPath, args, {
+      stdio: "inherit"
+    });
+    child.on("exit", (code) => {
+      if (code && code !== 0) {
+        reject(new Error(`Daemon exited with code ${code}`));
       } else {
-        console.log("\u5BF9\u8BDD\u6846\u5DF2\u5904\u7406");
+        resolve2();
       }
+    });
+    child.on("error", reject);
+  });
+}
+async function stopCommand(options = {}) {
+  if (!await isDaemonRunning()) {
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: "Daemon \u672A\u8FD0\u884C" }));
     } else {
-      console.error(`\u9519\u8BEF: ${response.error}`);
-      process.exit(1);
+      console.log("Daemon \u672A\u8FD0\u884C");
+    }
+    return;
+  }
+  const stopped = await stopDaemon();
+  if (stopped) {
+    if (options.json) {
+      console.log(JSON.stringify({ success: true, message: "Daemon \u5DF2\u505C\u6B62" }));
+    } else {
+      console.log("Daemon \u5DF2\u505C\u6B62");
+    }
+  } else {
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: "\u65E0\u6CD5\u505C\u6B62 Daemon" }));
+    } else {
+      console.error("\u65E0\u6CD5\u505C\u6B62 Daemon");
     }
+    process.exit(1);
   }
 }
-
-// packages/cli/src/commands/network.ts
-async function networkCommand(subCommand, urlOrFilter, options = {}) {
-  const response = await sendCommand({
-    id: crypto.randomUUID(),
-    action: "network",
-    networkCommand: subCommand,
-    url: subCommand === "route" || subCommand === "unroute" ? urlOrFilter : void 0,
-    filter: subCommand === "requests" ? urlOrFilter : void 0,
-    routeOptions: subCommand === "route" ? {
-      abort: options.abort,
-      body: options.body
-    } : void 0,
-    withBody: subCommand === "requests" ? options.withBody : void 0,
-    tabId: options.tabId
-  });
+async function statusCommand(options = {}) {
+  const running = await isDaemonRunning();
   if (options.json) {
-    console.log(JSON.stringify(response));
-    return;
-  }
-  if (!response.success) {
-    throw new Error(response.error || "Network command failed");
+    console.log(JSON.stringify({ running }));
+  } else {
+    console.log(running ? "Daemon \u8FD0\u884C\u4E2D" : "Daemon \u672A\u8FD0\u884C");
   }
-  const data = response.data;
-  switch (subCommand) {
-    case "requests": {
-      const requests = data?.networkRequests || [];
-      if (requests.length === 0) {
-        console.log("\u6CA1\u6709\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55");
-        console.log("\u63D0\u793A: \u4F7F\u7528 network requests \u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
-      } else {
-        console.log(`\u7F51\u7EDC\u8BF7\u6C42 (${requests.length} \u6761):
-`);
-        for (const req of requests) {
-          const status = req.failed ? `FAILED (${req.failureReason})` : req.status ? `${req.status} ${req.statusText || ""}` : "pending";
-          console.log(`${req.method} ${req.url}`);
-          console.log(`  \u7C7B\u578B: ${req.type}, \u72B6\u6001: ${status}`);
-          if (options.withBody) {
-            const requestHeaderCount = req.requestHeaders ? Object.keys(req.requestHeaders).length : 0;
-            const responseHeaderCount = req.responseHeaders ? Object.keys(req.responseHeaders).length : 0;
-            console.log(`  \u8BF7\u6C42\u5934: ${requestHeaderCount}, \u54CD\u5E94\u5934: ${responseHeaderCount}`);
-            if (req.requestBody !== void 0) {
-              const preview = req.requestBody.length > 200 ? `${req.requestBody.slice(0, 200)}...` : req.requestBody;
-              console.log(`  \u8BF7\u6C42\u4F53: ${preview}`);
-            }
-            if (req.responseBody !== void 0) {
-              const preview = req.responseBody.length > 200 ? `${req.responseBody.slice(0, 200)}...` : req.responseBody;
-              console.log(`  \u54CD\u5E94\u4F53: ${preview}`);
-            }
-            if (req.bodyError) {
-              console.log(`  Body\u9519\u8BEF: ${req.bodyError}`);
-            }
-          }
-          console.log("");
-        }
-      }
-      break;
+}
+
+// packages/cli/src/commands/reload.ts
+import WebSocket from "ws";
+var EXTENSION_NAME = "bb-browser";
+async function reloadCommand(options = {}) {
+  const port = options.port || 9222;
+  try {
+    const listRes = await fetch(`http://127.0.0.1:${port}/json/list`);
+    if (!listRes.ok) {
+      throw new Error(`CDP \u672A\u542F\u7528\u3002\u8BF7\u7528 --remote-debugging-port=${port} \u542F\u52A8 Chrome`);
     }
-    case "route": {
-      console.log(`\u5DF2\u6DFB\u52A0\u62E6\u622A\u89C4\u5219: ${urlOrFilter}`);
-      if (options.abort) {
-        console.log("  \u884C\u4E3A: \u963B\u6B62\u8BF7\u6C42");
-      } else if (options.body) {
-        console.log("  \u884C\u4E3A: \u8FD4\u56DE mock \u6570\u636E");
-      } else {
-        console.log("  \u884C\u4E3A: \u7EE7\u7EED\u8BF7\u6C42");
-      }
-      console.log(`\u5F53\u524D\u89C4\u5219\u6570: ${data?.routeCount || 0}`);
-      break;
+    const list = await listRes.json();
+    const extPage = list.find(
+      (t) => t.type === "page" && t.url.includes("chrome://extensions")
+    );
+    if (!extPage) {
+      throw new Error("\u8BF7\u5148\u6253\u5F00 chrome://extensions \u9875\u9762");
     }
-    case "unroute": {
-      if (urlOrFilter) {
-        console.log(`\u5DF2\u79FB\u9664\u62E6\u622A\u89C4\u5219: ${urlOrFilter}`);
-      } else {
-        console.log("\u5DF2\u79FB\u9664\u6240\u6709\u62E6\u622A\u89C4\u5219");
-      }
-      console.log(`\u5269\u4F59\u89C4\u5219\u6570: ${data?.routeCount || 0}`);
-      break;
+    const result = await new Promise((resolve2, reject) => {
+      const ws = new WebSocket(extPage.webSocketDebuggerUrl);
+      let resolved = false;
+      const timeout = setTimeout(() => {
+        if (!resolved) {
+          resolved = true;
+          ws.close();
+          reject(new Error("CDP \u8FDE\u63A5\u8D85\u65F6"));
+        }
+      }, 1e4);
+      ws.on("open", () => {
+        const script = `
+          (async function() {
+            if (!chrome || !chrome.developerPrivate) {
+              return { error: 'developerPrivate API not available' };
+            }
+            
+            try {
+              const exts = await chrome.developerPrivate.getExtensionsInfo();
+              const bbExt = exts.find(e => e.name === '${EXTENSION_NAME}');
+              
+              if (!bbExt) {
+                return { error: '${EXTENSION_NAME} \u6269\u5C55\u672A\u5B89\u88C5' };
+              }
+              
+              if (bbExt.state !== 'ENABLED') {
+                return { error: '${EXTENSION_NAME} \u6269\u5C55\u5DF2\u7981\u7528' };
+              }
+              
+              await chrome.developerPrivate.reload(bbExt.id, {failQuietly: true});
+              return { success: true, extensionId: bbExt.id };
+            } catch (e) {
+              return { error: e.message };
+            }
+          })()
+        `;
+        ws.send(JSON.stringify({
+          id: 1,
+          method: "Runtime.evaluate",
+          params: {
+            expression: script,
+            awaitPromise: true,
+            returnByValue: true
+          }
+        }));
+      });
+      ws.on("message", (data) => {
+        const msg = JSON.parse(data.toString());
+        if (msg.id === 1) {
+          clearTimeout(timeout);
+          resolved = true;
+          ws.close();
+          const value = msg.result?.result?.value;
+          if (value?.success) {
+            resolve2({
+              success: true,
+              message: "\u6269\u5C55\u5DF2\u91CD\u8F7D",
+              extensionId: value.extensionId
+            });
+          } else if (value?.error) {
+            reject(new Error(value.error));
+          } else {
+            reject(new Error(`\u91CD\u8F7D\u5931\u8D25: ${JSON.stringify(value)}`));
+          }
+        }
+      });
+      ws.on("error", (err) => {
+        clearTimeout(timeout);
+        if (!resolved) {
+          resolved = true;
+          reject(new Error(`CDP \u8FDE\u63A5\u5931\u8D25: ${err.message}`));
+        }
+      });
+    });
+    if (options.json) {
+      console.log(JSON.stringify(result));
+    } else {
+      console.log(`${result.message} (${result.extensionId})`);
     }
-    case "clear": {
-      console.log("\u5DF2\u6E05\u7A7A\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55");
-      break;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.error(`\u9519\u8BEF: ${message}`);
     }
-    default:
-      throw new Error(`\u672A\u77E5\u7684 network \u5B50\u547D\u4EE4: ${subCommand}`);
+    process.exit(1);
   }
 }
 
-// packages/cli/src/commands/console.ts
-async function consoleCommand(options = {}) {
-  const response = await sendCommand({
-    id: crypto.randomUUID(),
-    action: "console",
-    consoleCommand: options.clear ? "clear" : "get",
+// packages/cli/src/commands/nav.ts
+async function backCommand(options = {}) {
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "back",
     tabId: options.tabId
-  });
-  if (options.json) {
-    console.log(JSON.stringify(response));
-    return;
-  }
-  if (!response.success) {
-    throw new Error(response.error || "Console command failed");
-  }
-  if (options.clear) {
-    console.log("\u5DF2\u6E05\u7A7A\u63A7\u5236\u53F0\u6D88\u606F");
-    return;
-  }
-  const messages = response.data?.consoleMessages || [];
-  if (messages.length === 0) {
-    console.log("\u6CA1\u6709\u63A7\u5236\u53F0\u6D88\u606F");
-    console.log("\u63D0\u793A: console \u547D\u4EE4\u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
-    return;
-  }
-  console.log(`\u63A7\u5236\u53F0\u6D88\u606F (${messages.length} \u6761):
-`);
-  const typeColors = {
-    log: "",
-    info: "[INFO]",
-    warn: "[WARN]",
-    error: "[ERROR]",
-    debug: "[DEBUG]"
   };
-  for (const msg of messages) {
-    const prefix = typeColors[msg.type] || `[${msg.type.toUpperCase()}]`;
-    const location = msg.url ? ` (${msg.url}${msg.lineNumber ? `:${msg.lineNumber}` : ""})` : "";
-    if (prefix) {
-      console.log(`${prefix} ${msg.text}${location}`);
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const url = response.data?.url ?? "";
+      if (url) {
+        console.log(`\u540E\u9000\u81F3: ${url}`);
+      } else {
+        console.log("\u5DF2\u540E\u9000");
+      }
     } else {
-      console.log(`${msg.text}${location}`);
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
   }
 }
-
-// packages/cli/src/commands/errors.ts
-async function errorsCommand(options = {}) {
-  const response = await sendCommand({
-    id: crypto.randomUUID(),
-    action: "errors",
-    errorsCommand: options.clear ? "clear" : "get",
+async function forwardCommand(options = {}) {
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "forward",
     tabId: options.tabId
-  });
+  };
+  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response));
-    return;
-  }
-  if (!response.success) {
-    throw new Error(response.error || "Errors command failed");
-  }
-  if (options.clear) {
-    console.log("\u5DF2\u6E05\u7A7A JS \u9519\u8BEF\u8BB0\u5F55");
-    return;
-  }
-  const errors = response.data?.jsErrors || [];
-  if (errors.length === 0) {
-    console.log("\u6CA1\u6709 JS \u9519\u8BEF");
-    console.log("\u63D0\u793A: errors \u547D\u4EE4\u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
-    return;
-  }
-  console.log(`JS \u9519\u8BEF (${errors.length} \u6761):
-`);
-  for (const err of errors) {
-    console.log(`[ERROR] ${err.message}`);
-    if (err.url) {
-      console.log(`  \u4F4D\u7F6E: ${err.url}:${err.lineNumber || 0}:${err.columnNumber || 0}`);
-    }
-    if (err.stackTrace) {
-      console.log(`  \u5806\u6808:`);
-      console.log(err.stackTrace.split("\n").map((line) => `    ${line}`).join("\n"));
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const url = response.data?.url ?? "";
+      if (url) {
+        console.log(`\u524D\u8FDB\u81F3: ${url}`);
+      } else {
+        console.log("\u5DF2\u524D\u8FDB");
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
-    console.log("");
   }
 }
-
-// packages/cli/src/commands/trace.ts
-async function traceCommand(subCommand, options = {}) {
-  const response = await sendCommand({
-    id: crypto.randomUUID(),
-    action: "trace",
-    traceCommand: subCommand,
+async function refreshCommand(options = {}) {
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "refresh",
     tabId: options.tabId
-  });
+  };
+  const response = await sendCommand(request);
   if (options.json) {
-    console.log(JSON.stringify(response));
-    return;
-  }
-  if (!response.success) {
-    throw new Error(response.error || "Trace command failed");
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const title = response.data?.title ?? "";
+      if (title) {
+        console.log(`\u5DF2\u5237\u65B0: "${title}"`);
+      } else {
+        console.log("\u5DF2\u5237\u65B0\u9875\u9762");
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
+    }
   }
-  const data = response.data;
-  switch (subCommand) {
-    case "start": {
-      const status = data?.traceStatus;
-      console.log("\u5F00\u59CB\u5F55\u5236\u7528\u6237\u64CD\u4F5C");
-      console.log(`\u6807\u7B7E\u9875 ID: ${status?.tabId || "N/A"}`);
-      console.log("\n\u5728\u6D4F\u89C8\u5668\u4E2D\u8FDB\u884C\u64CD\u4F5C\uFF0C\u5B8C\u6210\u540E\u8FD0\u884C 'bb-browser trace stop' \u505C\u6B62\u5F55\u5236");
-      break;
-    }
-    case "stop": {
-      const events = data?.traceEvents || [];
-      const status = data?.traceStatus;
-      console.log(`\u5F55\u5236\u5B8C\u6210\uFF0C\u5171 ${events.length} \u4E2A\u4E8B\u4EF6
-`);
-      if (events.length === 0) {
-        console.log("\u6CA1\u6709\u5F55\u5236\u5230\u4EFB\u4F55\u64CD\u4F5C");
-        break;
-      }
-      for (let i = 0; i < events.length; i++) {
-        const event = events[i];
-        const refStr = event.ref !== void 0 ? `@${event.ref}` : "";
-        switch (event.type) {
-          case "navigation":
-            console.log(`${i + 1}. \u5BFC\u822A\u5230: ${event.url}`);
-            break;
-          case "click":
-            console.log(`${i + 1}. \u70B9\u51FB ${refStr} [${event.elementRole}] "${event.elementName || ""}"`);
-            break;
-          case "fill":
-            console.log(`${i + 1}. \u586B\u5145 ${refStr} [${event.elementRole}] "${event.elementName || ""}" <- "${event.value}"`);
-            break;
-          case "select":
-            console.log(`${i + 1}. \u9009\u62E9 ${refStr} [${event.elementRole}] "${event.elementName || ""}" <- "${event.value}"`);
-            break;
-          case "check":
-            console.log(`${i + 1}. ${event.checked ? "\u52FE\u9009" : "\u53D6\u6D88\u52FE\u9009"} ${refStr} [${event.elementRole}] "${event.elementName || ""}"`);
-            break;
-          case "press":
-            console.log(`${i + 1}. \u6309\u952E ${event.key}`);
-            break;
-          case "scroll":
-            console.log(`${i + 1}. \u6EDA\u52A8 ${event.direction} ${event.pixels}px`);
-            break;
-          default:
-            console.log(`${i + 1}. ${event.type}`);
+}
+
+// packages/cli/src/commands/check.ts
+function parseRef7(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
+}
+async function checkCommand(ref, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+  }
+  await ensureDaemonRunning();
+  const parsedRef = parseRef7(ref);
+  const request = {
+    id: generateId(),
+    action: "check",
+    ref: parsedRef,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const role = response.data?.role ?? "checkbox";
+      const name = response.data?.name;
+      const wasAlreadyChecked = response.data?.wasAlreadyChecked;
+      if (wasAlreadyChecked) {
+        if (name) {
+          console.log(`\u5DF2\u52FE\u9009\uFF08\u4E4B\u524D\u5DF2\u52FE\u9009\uFF09: ${role} "${name}"`);
+        } else {
+          console.log(`\u5DF2\u52FE\u9009\uFF08\u4E4B\u524D\u5DF2\u52FE\u9009\uFF09: ${role}`);
+        }
+      } else {
+        if (name) {
+          console.log(`\u5DF2\u52FE\u9009: ${role} "${name}"`);
+        } else {
+          console.log(`\u5DF2\u52FE\u9009: ${role}`);
         }
       }
-      console.log(`
-\u72B6\u6001: ${status?.recording ? "\u5F55\u5236\u4E2D" : "\u5DF2\u505C\u6B62"}`);
-      break;
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
-    case "status": {
-      const status = data?.traceStatus;
-      if (status?.recording) {
-        console.log(`\u5F55\u5236\u4E2D (\u6807\u7B7E\u9875 ${status.tabId})`);
-        console.log(`\u5DF2\u5F55\u5236 ${status.eventCount} \u4E2A\u4E8B\u4EF6`);
+  }
+}
+async function uncheckCommand(ref, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
+  }
+  await ensureDaemonRunning();
+  const parsedRef = parseRef7(ref);
+  const request = {
+    id: generateId(),
+    action: "uncheck",
+    ref: parsedRef,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const role = response.data?.role ?? "checkbox";
+      const name = response.data?.name;
+      const wasAlreadyUnchecked = response.data?.wasAlreadyUnchecked;
+      if (wasAlreadyUnchecked) {
+        if (name) {
+          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009\uFF08\u4E4B\u524D\u672A\u52FE\u9009\uFF09: ${role} "${name}"`);
+        } else {
+          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009\uFF08\u4E4B\u524D\u672A\u52FE\u9009\uFF09: ${role}`);
+        }
       } else {
-        console.log("\u672A\u5728\u5F55\u5236");
+        if (name) {
+          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009: ${role} "${name}"`);
+        } else {
+          console.log(`\u5DF2\u53D6\u6D88\u52FE\u9009: ${role}`);
+        }
       }
-      break;
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
-    default:
-      throw new Error(`\u672A\u77E5\u7684 trace \u5B50\u547D\u4EE4: ${subCommand}`);
   }
 }
 
-// packages/cli/src/commands/fetch.ts
-function matchTabOrigin(tabUrl, targetHostname) {
-  try {
-    const tabHostname = new URL(tabUrl).hostname;
-    return tabHostname === targetHostname || tabHostname.endsWith("." + targetHostname);
-  } catch {
-    return false;
-  }
+// packages/cli/src/commands/select.ts
+function parseRef8(ref) {
+  return ref.startsWith("@") ? ref.slice(1) : ref;
 }
-async function ensureTabForOrigin(origin, hostname) {
-  const listReq = { id: generateId(), action: "tab_list" };
-  const listResp = await sendCommand(listReq);
-  if (listResp.success && listResp.data?.tabs) {
-    const matchingTab = listResp.data.tabs.find(
-      (tab) => matchTabOrigin(tab.url, hostname)
-    );
-    if (matchingTab) {
-      return matchingTab.tabId;
-    }
-  }
-  const newResp = await sendCommand({ id: generateId(), action: "tab_new", url: origin });
-  if (!newResp.success) {
-    throw new Error(`\u65E0\u6CD5\u6253\u5F00 ${origin}: ${newResp.error}`);
+async function selectCommand(ref, value, options = {}) {
+  if (!ref) {
+    throw new Error("\u7F3A\u5C11 ref \u53C2\u6570");
   }
-  await new Promise((resolve2) => setTimeout(resolve2, 3e3));
-  return newResp.data?.tabId;
-}
-function buildFetchScript(url, options) {
-  const method = (options.method || "GET").toUpperCase();
-  const hasBody = options.body && method !== "GET" && method !== "HEAD";
-  let headersExpr = "{}";
-  if (options.headers) {
-    try {
-      JSON.parse(options.headers);
-      headersExpr = options.headers;
-    } catch {
-      throw new Error(`--headers must be valid JSON. Got: ${options.headers}`);
-    }
+  if (value === void 0 || value === null) {
+    throw new Error("\u7F3A\u5C11 value \u53C2\u6570");
   }
-  return `(async () => {
-    try {
-      const resp = await fetch(${JSON.stringify(url)}, {
-        method: ${JSON.stringify(method)},
-        credentials: 'include',
-        headers: ${headersExpr}${hasBody ? `,
-        body: ${JSON.stringify(options.body)}` : ""}
-      });
-      const contentType = resp.headers.get('content-type') || '';
-      let body;
-      if (contentType.includes('application/json') && resp.status !== 204) {
-        try { body = await resp.json(); } catch { body = await resp.text(); }
+  await ensureDaemonRunning();
+  const parsedRef = parseRef8(ref);
+  const request = {
+    id: generateId(),
+    action: "select",
+    ref: parsedRef,
+    value,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const role = response.data?.role ?? "combobox";
+      const name = response.data?.name;
+      const selectedValue = response.data?.selectedValue;
+      const selectedLabel = response.data?.selectedLabel;
+      if (name) {
+        console.log(`\u5DF2\u9009\u62E9: ${role} "${name}"`);
       } else {
-        body = await resp.text();
+        console.log(`\u5DF2\u9009\u62E9: ${role}`);
       }
-      return JSON.stringify({
-        status: resp.status,
-        contentType,
-        body
-      });
-    } catch (e) {
-      return JSON.stringify({ error: e.message });
+      if (selectedLabel && selectedLabel !== selectedValue) {
+        console.log(`\u9009\u9879: "${selectedLabel}" (value="${selectedValue}")`);
+      } else {
+        console.log(`\u9009\u9879: "${selectedValue}"`);
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
-  })()`;
+  }
 }
-async function fetchCommand(url, options = {}) {
-  if (!url) {
-    throw new Error(
-      "\u7F3A\u5C11 URL \u53C2\u6570\n  \u7528\u6CD5: bb-browser fetch <url> [--json] [--method POST] [--body '{...}']\n  \u793A\u4F8B: bb-browser fetch https://www.reddit.com/api/me.json --json"
-    );
+
+// packages/cli/src/commands/eval.ts
+async function evalCommand(script, options = {}) {
+  if (!script) {
+    throw new Error("\u7F3A\u5C11 script \u53C2\u6570");
   }
   await ensureDaemonRunning();
-  const isAbsolute = url.startsWith("http://") || url.startsWith("https://");
-  let targetTabId = options.tabId;
-  if (isAbsolute) {
-    let origin;
-    let hostname;
-    try {
-      const parsed = new URL(url);
-      origin = parsed.origin;
-      hostname = parsed.hostname;
-    } catch {
-      throw new Error(`\u65E0\u6548\u7684 URL: ${url}`);
-    }
-    if (!targetTabId) {
-      targetTabId = await ensureTabForOrigin(origin, hostname);
-    }
-  }
-  const script = buildFetchScript(url, options);
-  const evalReq = { id: generateId(), action: "eval", script, tabId: targetTabId };
-  const evalResp = await sendCommand(evalReq);
-  if (!evalResp.success) {
-    throw new Error(`Fetch \u5931\u8D25: ${evalResp.error}`);
+  const request = {
+    id: generateId(),
+    action: "eval",
+    script,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const result = response.data?.result;
+      if (result !== void 0) {
+        if (typeof result === "object" && result !== null) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log(result);
+        }
+      } else {
+        console.log("undefined");
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
+    }
   }
-  const rawResult = evalResp.data?.result;
-  if (rawResult === void 0 || rawResult === null) {
-    throw new Error("Fetch \u672A\u8FD4\u56DE\u7ED3\u679C");
+}
+
+// packages/cli/src/commands/tab.ts
+function parseTabSubcommand(args, rawArgv) {
+  let tabId;
+  if (rawArgv) {
+    const idIdx = rawArgv.indexOf("--id");
+    if (idIdx >= 0 && rawArgv[idIdx + 1]) {
+      tabId = parseInt(rawArgv[idIdx + 1], 10);
+      if (isNaN(tabId)) {
+        throw new Error(`\u65E0\u6548\u7684 tabId: ${rawArgv[idIdx + 1]}`);
+      }
+    }
   }
-  let result;
-  try {
-    result = typeof rawResult === "string" ? JSON.parse(rawResult) : rawResult;
-  } catch {
-    console.log(rawResult);
-    return;
+  if (args.length === 0) {
+    return { action: "tab_list" };
   }
-  if (result.error) {
-    throw new Error(`Fetch error: ${result.error}`);
+  const first = args[0];
+  if (first === "new") {
+    return { action: "tab_new", url: args[1] };
   }
-  if (options.output) {
-    const { writeFileSync } = await import("fs");
-    const content = typeof result.body === "object" ? JSON.stringify(result.body, null, 2) : String(result.body);
-    writeFileSync(options.output, content, "utf-8");
-    console.log(`\u5DF2\u5199\u5165 ${options.output} (${result.status}, ${content.length} bytes)`);
-    return;
+  if (first === "select") {
+    if (tabId !== void 0) {
+      return { action: "tab_select", tabId };
+    }
+    throw new Error("tab select \u9700\u8981 --id \u53C2\u6570\uFF0C\u7528\u6CD5\uFF1Abb-browser tab select --id <tabId>");
   }
-  if (typeof result.body === "object") {
-    console.log(JSON.stringify(result.body, null, 2));
+  if (first === "close") {
+    if (tabId !== void 0) {
+      return { action: "tab_close", tabId };
+    }
+    const indexArg = args[1];
+    if (indexArg !== void 0) {
+      const index2 = parseInt(indexArg, 10);
+      if (isNaN(index2) || index2 < 0) {
+        throw new Error(`\u65E0\u6548\u7684\u6807\u7B7E\u9875\u7D22\u5F15: ${indexArg}`);
+      }
+      return { action: "tab_close", index: index2 };
+    }
+    return { action: "tab_close" };
+  }
+  const index = parseInt(first, 10);
+  if (!isNaN(index) && index >= 0) {
+    return { action: "tab_select", index };
+  }
+  throw new Error(`\u672A\u77E5\u7684 tab \u5B50\u547D\u4EE4: ${first}`);
+}
+function formatTabList(tabs, activeIndex) {
+  const lines = [];
+  lines.push(`\u6807\u7B7E\u9875\u5217\u8868\uFF08\u5171 ${tabs.length} \u4E2A\uFF0C\u5F53\u524D #${activeIndex}\uFF09\uFF1A`);
+  for (const tab of tabs) {
+    const prefix = tab.active ? "*" : " ";
+    const title = tab.title || "(\u65E0\u6807\u9898)";
+    lines.push(`${prefix} [${tab.index}] ${tab.url} - ${title}`);
+  }
+  return lines.join("\n");
+}
+async function tabCommand(args, options = {}) {
+  await ensureDaemonRunning();
+  const parsed = parseTabSubcommand(args, process.argv);
+  const request = {
+    id: generateId(),
+    action: parsed.action,
+    url: parsed.url,
+    index: parsed.index,
+    tabId: parsed.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
   } else {
-    console.log(result.body);
+    if (response.success) {
+      switch (parsed.action) {
+        case "tab_list": {
+          const tabs = response.data?.tabs ?? [];
+          const activeIndex = response.data?.activeIndex ?? 0;
+          console.log(formatTabList(tabs, activeIndex));
+          break;
+        }
+        case "tab_new": {
+          const url = response.data?.url ?? "about:blank";
+          console.log(`\u5DF2\u521B\u5EFA\u65B0\u6807\u7B7E\u9875: ${url}`);
+          break;
+        }
+        case "tab_select": {
+          const title = response.data?.title ?? "(\u65E0\u6807\u9898)";
+          const url = response.data?.url ?? "";
+          console.log(`\u5DF2\u5207\u6362\u5230\u6807\u7B7E\u9875 #${parsed.index}: ${title}`);
+          console.log(`  URL: ${url}`);
+          break;
+        }
+        case "tab_close": {
+          const closedTitle = response.data?.title ?? "(\u65E0\u6807\u9898)";
+          console.log(`\u5DF2\u5173\u95ED\u6807\u7B7E\u9875: ${closedTitle}`);
+          break;
+        }
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
+    }
   }
 }
 
-// packages/cli/src/commands/site.ts
-import { readFileSync, readdirSync, existsSync as existsSync2, mkdirSync } from "fs";
-import { join, relative } from "path";
-import { homedir } from "os";
-import { execSync } from "child_process";
-var BB_DIR = join(homedir(), ".bb-browser");
-var LOCAL_SITES_DIR = join(BB_DIR, "sites");
-var COMMUNITY_SITES_DIR = join(BB_DIR, "bb-sites");
-var COMMUNITY_REPO = "https://github.com/epiral/bb-sites.git";
-function parseSiteMeta(filePath, source) {
-  let content;
-  try {
-    content = readFileSync(filePath, "utf-8");
-  } catch {
-    return null;
+// packages/cli/src/commands/frame.ts
+async function frameCommand(selector, options = {}) {
+  if (!selector) {
+    throw new Error("\u7F3A\u5C11 selector \u53C2\u6570");
   }
-  const sitesDir = source === "local" ? LOCAL_SITES_DIR : COMMUNITY_SITES_DIR;
-  const relPath = relative(sitesDir, filePath);
-  const defaultName = relPath.replace(/\.js$/, "").replace(/\\/g, "/");
-  const metaMatch = content.match(/\/\*\s*@meta\s*\n([\s\S]*?)\*\//);
-  if (metaMatch) {
-    try {
-      const metaJson = JSON.parse(metaMatch[1]);
-      return {
-        name: metaJson.name || defaultName,
-        description: metaJson.description || "",
-        domain: metaJson.domain || "",
-        args: metaJson.args || {},
-        capabilities: metaJson.capabilities,
-        readOnly: metaJson.readOnly,
-        example: metaJson.example,
-        filePath,
-        source
-      };
-    } catch {
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "frame",
+    selector,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const frameInfo = response.data?.frameInfo;
+      if (frameInfo?.url) {
+        console.log(`\u5DF2\u5207\u6362\u5230 frame: ${selector} (${frameInfo.url})`);
+      } else {
+        console.log(`\u5DF2\u5207\u6362\u5230 frame: ${selector}`);
+      }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
   }
-  const meta = {
-    name: defaultName,
-    description: "",
-    domain: "",
-    args: {},
-    filePath,
-    source
+}
+async function frameMainCommand(options = {}) {
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "frame_main",
+    tabId: options.tabId
   };
-  const tagPattern = /\/\/\s*@(\w+)[ \t]+(.*)/g;
-  let match;
-  while ((match = tagPattern.exec(content)) !== null) {
-    const [, key, value] = match;
-    switch (key) {
-      case "name":
-        meta.name = value.trim();
-        break;
-      case "description":
-        meta.description = value.trim();
-        break;
-      case "domain":
-        meta.domain = value.trim();
-        break;
-      case "args":
-        for (const arg of value.trim().split(/[,\s]+/).filter(Boolean)) {
-          meta.args[arg] = { required: true };
-        }
-        break;
-      case "example":
-        meta.example = value.trim();
-        break;
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      console.log("\u5DF2\u8FD4\u56DE\u4E3B frame");
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
   }
-  return meta;
 }
-function scanSites(dir, source) {
-  if (!existsSync2(dir)) return [];
-  const sites = [];
-  function walk(currentDir) {
-    let entries;
-    try {
-      entries = readdirSync(currentDir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      const fullPath = join(currentDir, entry.name);
-      if (entry.isDirectory() && !entry.name.startsWith(".")) {
-        walk(fullPath);
-      } else if (entry.isFile() && entry.name.endsWith(".js")) {
-        const meta = parseSiteMeta(fullPath, source);
-        if (meta) sites.push(meta);
+
+// packages/cli/src/commands/dialog.ts
+async function dialogCommand(subCommand, promptText, options = {}) {
+  if (!subCommand || !["accept", "dismiss"].includes(subCommand)) {
+    throw new Error("\u8BF7\u4F7F\u7528 'dialog accept [text]' \u6216 'dialog dismiss'");
+  }
+  await ensureDaemonRunning();
+  const request = {
+    id: generateId(),
+    action: "dialog",
+    dialogResponse: subCommand,
+    promptText: subCommand === "accept" ? promptText : void 0,
+    tabId: options.tabId
+  };
+  const response = await sendCommand(request);
+  if (options.json) {
+    console.log(JSON.stringify(response, null, 2));
+  } else {
+    if (response.success) {
+      const dialogInfo = response.data?.dialogInfo;
+      if (dialogInfo) {
+        const action = subCommand === "accept" ? "\u5DF2\u63A5\u53D7" : "\u5DF2\u62D2\u7EDD";
+        console.log(`${action}\u5BF9\u8BDD\u6846\uFF08${dialogInfo.type}\uFF09: "${dialogInfo.message}"`);
+      } else {
+        console.log("\u5BF9\u8BDD\u6846\u5DF2\u5904\u7406");
       }
+    } else {
+      console.error(`\u9519\u8BEF: ${response.error}`);
+      process.exit(1);
     }
   }
-  walk(dir);
-  return sites;
-}
-function getAllSites() {
-  const community = scanSites(COMMUNITY_SITES_DIR, "community");
-  const local = scanSites(LOCAL_SITES_DIR, "local");
-  const byName = /* @__PURE__ */ new Map();
-  for (const s of community) byName.set(s.name, s);
-  for (const s of local) byName.set(s.name, s);
-  return Array.from(byName.values()).sort((a, b) => a.name.localeCompare(b.name));
 }
-function matchTabOrigin2(tabUrl, domain) {
-  try {
-    const tabOrigin = new URL(tabUrl).hostname;
-    return tabOrigin === domain || tabOrigin.endsWith("." + domain);
-  } catch {
-    return false;
+
+// packages/cli/src/commands/network.ts
+async function networkCommand(subCommand, urlOrFilter, options = {}) {
+  const response = await sendCommand({
+    id: crypto.randomUUID(),
+    action: "network",
+    networkCommand: subCommand,
+    url: subCommand === "route" || subCommand === "unroute" ? urlOrFilter : void 0,
+    filter: subCommand === "requests" ? urlOrFilter : void 0,
+    routeOptions: subCommand === "route" ? {
+      abort: options.abort,
+      body: options.body
+    } : void 0,
+    withBody: subCommand === "requests" ? options.withBody : void 0,
+    tabId: options.tabId
+  });
+  if (options.json) {
+    console.log(JSON.stringify(response));
+    return;
+  }
+  if (!response.success) {
+    throw new Error(response.error || "Network command failed");
+  }
+  const data = response.data;
+  switch (subCommand) {
+    case "requests": {
+      const requests = data?.networkRequests || [];
+      if (requests.length === 0) {
+        console.log("\u6CA1\u6709\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55");
+        console.log("\u63D0\u793A: \u4F7F\u7528 network requests \u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
+      } else {
+        console.log(`\u7F51\u7EDC\u8BF7\u6C42 (${requests.length} \u6761):
+`);
+        for (const req of requests) {
+          const status = req.failed ? `FAILED (${req.failureReason})` : req.status ? `${req.status} ${req.statusText || ""}` : "pending";
+          console.log(`${req.method} ${req.url}`);
+          console.log(`  \u7C7B\u578B: ${req.type}, \u72B6\u6001: ${status}`);
+          if (options.withBody) {
+            const requestHeaderCount = req.requestHeaders ? Object.keys(req.requestHeaders).length : 0;
+            const responseHeaderCount = req.responseHeaders ? Object.keys(req.responseHeaders).length : 0;
+            console.log(`  \u8BF7\u6C42\u5934: ${requestHeaderCount}, \u54CD\u5E94\u5934: ${responseHeaderCount}`);
+            if (req.requestBody !== void 0) {
+              const preview = req.requestBody.length > 200 ? `${req.requestBody.slice(0, 200)}...` : req.requestBody;
+              console.log(`  \u8BF7\u6C42\u4F53: ${preview}`);
+            }
+            if (req.responseBody !== void 0) {
+              const preview = req.responseBody.length > 200 ? `${req.responseBody.slice(0, 200)}...` : req.responseBody;
+              console.log(`  \u54CD\u5E94\u4F53: ${preview}`);
+            }
+            if (req.bodyError) {
+              console.log(`  Body\u9519\u8BEF: ${req.bodyError}`);
+            }
+          }
+          console.log("");
+        }
+      }
+      break;
+    }
+    case "route": {
+      console.log(`\u5DF2\u6DFB\u52A0\u62E6\u622A\u89C4\u5219: ${urlOrFilter}`);
+      if (options.abort) {
+        console.log("  \u884C\u4E3A: \u963B\u6B62\u8BF7\u6C42");
+      } else if (options.body) {
+        console.log("  \u884C\u4E3A: \u8FD4\u56DE mock \u6570\u636E");
+      } else {
+        console.log("  \u884C\u4E3A: \u7EE7\u7EED\u8BF7\u6C42");
+      }
+      console.log(`\u5F53\u524D\u89C4\u5219\u6570: ${data?.routeCount || 0}`);
+      break;
+    }
+    case "unroute": {
+      if (urlOrFilter) {
+        console.log(`\u5DF2\u79FB\u9664\u62E6\u622A\u89C4\u5219: ${urlOrFilter}`);
+      } else {
+        console.log("\u5DF2\u79FB\u9664\u6240\u6709\u62E6\u622A\u89C4\u5219");
+      }
+      console.log(`\u5269\u4F59\u89C4\u5219\u6570: ${data?.routeCount || 0}`);
+      break;
+    }
+    case "clear": {
+      console.log("\u5DF2\u6E05\u7A7A\u7F51\u7EDC\u8BF7\u6C42\u8BB0\u5F55");
+      break;
+    }
+    default:
+      throw new Error(`\u672A\u77E5\u7684 network \u5B50\u547D\u4EE4: ${subCommand}`);
   }
 }
-function siteList(options) {
-  const sites = getAllSites();
-  if (sites.length === 0) {
-    console.log("\u672A\u627E\u5230\u4EFB\u4F55 site adapter\u3002");
-    console.log("  \u5B89\u88C5\u793E\u533A adapter: bb-browser site update");
-    console.log(`  \u79C1\u6709 adapter \u76EE\u5F55: ${LOCAL_SITES_DIR}`);
+
+// packages/cli/src/commands/console.ts
+async function consoleCommand(options = {}) {
+  const response = await sendCommand({
+    id: crypto.randomUUID(),
+    action: "console",
+    consoleCommand: options.clear ? "clear" : "get",
+    tabId: options.tabId
+  });
+  if (options.json) {
+    console.log(JSON.stringify(response));
     return;
   }
-  if (options.json) {
-    console.log(JSON.stringify(sites.map((s) => ({
-      name: s.name,
-      description: s.description,
-      domain: s.domain,
-      args: s.args,
-      source: s.source
-    })), null, 2));
+  if (!response.success) {
+    throw new Error(response.error || "Console command failed");
+  }
+  if (options.clear) {
+    console.log("\u5DF2\u6E05\u7A7A\u63A7\u5236\u53F0\u6D88\u606F");
     return;
   }
-  const groups = /* @__PURE__ */ new Map();
-  for (const s of sites) {
-    const platform = s.name.split("/")[0];
-    if (!groups.has(platform)) groups.set(platform, []);
-    groups.get(platform).push(s);
+  const messages = response.data?.consoleMessages || [];
+  if (messages.length === 0) {
+    console.log("\u6CA1\u6709\u63A7\u5236\u53F0\u6D88\u606F");
+    console.log("\u63D0\u793A: console \u547D\u4EE4\u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
+    return;
   }
-  for (const [platform, items] of groups) {
-    console.log(`
-${platform}/`);
-    for (const s of items) {
-      const cmd = s.name.split("/").slice(1).join("/");
-      const src = s.source === "local" ? " (local)" : "";
-      const desc = s.description ? ` - ${s.description}` : "";
-      console.log(`  ${cmd.padEnd(20)}${desc}${src}`);
+  console.log(`\u63A7\u5236\u53F0\u6D88\u606F (${messages.length} \u6761):
+`);
+  const typeColors = {
+    log: "",
+    info: "[INFO]",
+    warn: "[WARN]",
+    error: "[ERROR]",
+    debug: "[DEBUG]"
+  };
+  for (const msg of messages) {
+    const prefix = typeColors[msg.type] || `[${msg.type.toUpperCase()}]`;
+    const location = msg.url ? ` (${msg.url}${msg.lineNumber ? `:${msg.lineNumber}` : ""})` : "";
+    if (prefix) {
+      console.log(`${prefix} ${msg.text}${location}`);
+    } else {
+      console.log(`${msg.text}${location}`);
     }
   }
-  console.log();
 }
-function siteSearch(query, options) {
-  const sites = getAllSites();
-  const q = query.toLowerCase();
-  const matches = sites.filter(
-    (s) => s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q) || s.domain.toLowerCase().includes(q)
-  );
-  if (matches.length === 0) {
-    console.log(`\u672A\u627E\u5230\u5339\u914D "${query}" \u7684 adapter\u3002`);
-    console.log("  \u67E5\u770B\u6240\u6709: bb-browser site list");
+
+// packages/cli/src/commands/errors.ts
+async function errorsCommand(options = {}) {
+  const response = await sendCommand({
+    id: crypto.randomUUID(),
+    action: "errors",
+    errorsCommand: options.clear ? "clear" : "get",
+    tabId: options.tabId
+  });
+  if (options.json) {
+    console.log(JSON.stringify(response));
     return;
   }
-  if (options.json) {
-    console.log(JSON.stringify(matches.map((s) => ({
-      name: s.name,
-      description: s.description,
-      domain: s.domain,
-      source: s.source
-    })), null, 2));
+  if (!response.success) {
+    throw new Error(response.error || "Errors command failed");
+  }
+  if (options.clear) {
+    console.log("\u5DF2\u6E05\u7A7A JS \u9519\u8BEF\u8BB0\u5F55");
     return;
   }
-  for (const s of matches) {
-    const src = s.source === "local" ? " (local)" : "";
-    console.log(`${s.name.padEnd(24)} ${s.description}${src}`);
+  const errors = response.data?.jsErrors || [];
+  if (errors.length === 0) {
+    console.log("\u6CA1\u6709 JS \u9519\u8BEF");
+    console.log("\u63D0\u793A: errors \u547D\u4EE4\u4F1A\u81EA\u52A8\u5F00\u59CB\u76D1\u63A7");
+    return;
   }
-}
-function siteUpdate() {
-  mkdirSync(BB_DIR, { recursive: true });
-  if (existsSync2(join(COMMUNITY_SITES_DIR, ".git"))) {
-    console.log("\u66F4\u65B0\u793E\u533A site adapter \u5E93...");
-    try {
-      execSync("git pull --ff-only", { cwd: COMMUNITY_SITES_DIR, stdio: "pipe" });
-      console.log("\u66F4\u65B0\u5B8C\u6210\u3002");
-    } catch (e) {
-      console.error(`\u66F4\u65B0\u5931\u8D25: ${e instanceof Error ? e.message : e}`);
-      console.error("  \u624B\u52A8\u4FEE\u590D: cd ~/.bb-browser/bb-sites && git pull");
-      process.exit(1);
+  console.log(`JS \u9519\u8BEF (${errors.length} \u6761):
+`);
+  for (const err of errors) {
+    console.log(`[ERROR] ${err.message}`);
+    if (err.url) {
+      console.log(`  \u4F4D\u7F6E: ${err.url}:${err.lineNumber || 0}:${err.columnNumber || 0}`);
     }
-  } else {
-    console.log(`\u514B\u9686\u793E\u533A adapter \u5E93: ${COMMUNITY_REPO}`);
-    try {
-      execSync(`git clone ${COMMUNITY_REPO} ${COMMUNITY_SITES_DIR}`, { stdio: "pipe" });
-      console.log("\u514B\u9686\u5B8C\u6210\u3002");
-    } catch (e) {
-      console.error(`\u514B\u9686\u5931\u8D25: ${e instanceof Error ? e.message : e}`);
-      console.error(`  \u624B\u52A8\u4FEE\u590D: git clone ${COMMUNITY_REPO} ~/.bb-browser/bb-sites`);
-      process.exit(1);
+    if (err.stackTrace) {
+      console.log(`  \u5806\u6808:`);
+      console.log(err.stackTrace.split("\n").map((line) => `    ${line}`).join("\n"));
     }
+    console.log("");
   }
-  const sites = scanSites(COMMUNITY_SITES_DIR, "community");
-  console.log(`\u5DF2\u5B89\u88C5 ${sites.length} \u4E2A\u793E\u533A adapter\u3002`);
 }
-async function siteRun(name, args, options) {
-  const sites = getAllSites();
-  const site = sites.find((s) => s.name === name);
-  if (!site) {
-    const fuzzy = sites.filter((s) => s.name.includes(name));
-    console.error(`[error] site: "${name}" not found.`);
-    if (fuzzy.length > 0) {
-      console.error("  Did you mean:");
-      for (const s of fuzzy.slice(0, 5)) {
-        console.error(`    bb-browser site ${s.name}`);
+
+// packages/cli/src/commands/trace.ts
+async function traceCommand(subCommand, options = {}) {
+  const response = await sendCommand({
+    id: crypto.randomUUID(),
+    action: "trace",
+    traceCommand: subCommand,
+    tabId: options.tabId
+  });
+  if (options.json) {
+    console.log(JSON.stringify(response));
+    return;
+  }
+  if (!response.success) {
+    throw new Error(response.error || "Trace command failed");
+  }
+  const data = response.data;
+  switch (subCommand) {
+    case "start": {
+      const status = data?.traceStatus;
+      console.log("\u5F00\u59CB\u5F55\u5236\u7528\u6237\u64CD\u4F5C");
+      console.log(`\u6807\u7B7E\u9875 ID: ${status?.tabId || "N/A"}`);
+      console.log("\n\u5728\u6D4F\u89C8\u5668\u4E2D\u8FDB\u884C\u64CD\u4F5C\uFF0C\u5B8C\u6210\u540E\u8FD0\u884C 'bb-browser trace stop' \u505C\u6B62\u5F55\u5236");
+      break;
+    }
+    case "stop": {
+      const events = data?.traceEvents || [];
+      const status = data?.traceStatus;
+      console.log(`\u5F55\u5236\u5B8C\u6210\uFF0C\u5171 ${events.length} \u4E2A\u4E8B\u4EF6
+`);
+      if (events.length === 0) {
+        console.log("\u6CA1\u6709\u5F55\u5236\u5230\u4EFB\u4F55\u64CD\u4F5C");
+        break;
       }
-    } else {
-      console.error("  Try: bb-browser site list");
-      console.error("  Or:  bb-browser site update");
+      for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        const refStr = event.ref !== void 0 ? `@${event.ref}` : "";
+        switch (event.type) {
+          case "navigation":
+            console.log(`${i + 1}. \u5BFC\u822A\u5230: ${event.url}`);
+            break;
+          case "click":
+            console.log(`${i + 1}. \u70B9\u51FB ${refStr} [${event.elementRole}] "${event.elementName || ""}"`);
+            break;
+          case "fill":
+            console.log(`${i + 1}. \u586B\u5145 ${refStr} [${event.elementRole}] "${event.elementName || ""}" <- "${event.value}"`);
+            break;
+          case "select":
+            console.log(`${i + 1}. \u9009\u62E9 ${refStr} [${event.elementRole}] "${event.elementName || ""}" <- "${event.value}"`);
+            break;
+          case "check":
+            console.log(`${i + 1}. ${event.checked ? "\u52FE\u9009" : "\u53D6\u6D88\u52FE\u9009"} ${refStr} [${event.elementRole}] "${event.elementName || ""}"`);
+            break;
+          case "press":
+            console.log(`${i + 1}. \u6309\u952E ${event.key}`);
+            break;
+          case "scroll":
+            console.log(`${i + 1}. \u6EDA\u52A8 ${event.direction} ${event.pixels}px`);
+            break;
+          default:
+            console.log(`${i + 1}. ${event.type}`);
+        }
+      }
+      console.log(`
+\u72B6\u6001: ${status?.recording ? "\u5F55\u5236\u4E2D" : "\u5DF2\u505C\u6B62"}`);
+      break;
     }
-    process.exit(1);
-  }
-  const argNames = Object.keys(site.args);
-  const argMap = {};
-  const positionalArgs = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i].startsWith("--")) {
-      const flagName = args[i].slice(2);
-      if (flagName in site.args && args[i + 1]) {
-        argMap[flagName] = args[i + 1];
-        i++;
+    case "status": {
+      const status = data?.traceStatus;
+      if (status?.recording) {
+        console.log(`\u5F55\u5236\u4E2D (\u6807\u7B7E\u9875 ${status.tabId})`);
+        console.log(`\u5DF2\u5F55\u5236 ${status.eventCount} \u4E2A\u4E8B\u4EF6`);
+      } else {
+        console.log("\u672A\u5728\u5F55\u5236");
       }
-    } else {
-      positionalArgs.push(args[i]);
+      break;
+    }
+    default:
+      throw new Error(`\u672A\u77E5\u7684 trace \u5B50\u547D\u4EE4: ${subCommand}`);
+  }
+}
+
+// packages/cli/src/commands/fetch.ts
+function matchTabOrigin2(tabUrl, targetHostname) {
+  try {
+    const tabHostname = new URL(tabUrl).hostname;
+    return tabHostname === targetHostname || tabHostname.endsWith("." + targetHostname);
+  } catch {
+    return false;
+  }
+}
+async function ensureTabForOrigin(origin, hostname) {
+  const listReq = { id: generateId(), action: "tab_list" };
+  const listResp = await sendCommand(listReq);
+  if (listResp.success && listResp.data?.tabs) {
+    const matchingTab = listResp.data.tabs.find(
+      (tab) => matchTabOrigin2(tab.url, hostname)
+    );
+    if (matchingTab) {
+      return matchingTab.tabId;
     }
   }
-  let posIdx = 0;
-  for (const argName of argNames) {
-    if (!argMap[argName] && posIdx < positionalArgs.length) {
-      argMap[argName] = positionalArgs[posIdx++];
+  const newResp = await sendCommand({ id: generateId(), action: "tab_new", url: origin });
+  if (!newResp.success) {
+    throw new Error(`\u65E0\u6CD5\u6253\u5F00 ${origin}: ${newResp.error}`);
+  }
+  await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+  return newResp.data?.tabId;
+}
+function buildFetchScript(url, options) {
+  const method = (options.method || "GET").toUpperCase();
+  const hasBody = options.body && method !== "GET" && method !== "HEAD";
+  let headersExpr = "{}";
+  if (options.headers) {
+    try {
+      JSON.parse(options.headers);
+      headersExpr = options.headers;
+    } catch {
+      throw new Error(`--headers must be valid JSON. Got: ${options.headers}`);
     }
   }
-  for (const [argName, argDef] of Object.entries(site.args)) {
-    if (argDef.required && !argMap[argName]) {
-      console.error(`[error] site ${name}: missing required argument "${argName}".`);
-      const usage = argNames.map((a) => {
-        const def = site.args[a];
-        return def.required ? `<${a}>` : `[${a}]`;
-      }).join(" ");
-      console.error(`  Usage: bb-browser site ${name} ${usage}`);
-      if (site.example) console.error(`  Example: ${site.example}`);
-      process.exit(1);
+  return `(async () => {
+    try {
+      const resp = await fetch(${JSON.stringify(url)}, {
+        method: ${JSON.stringify(method)},
+        credentials: 'include',
+        headers: ${headersExpr}${hasBody ? `,
+        body: ${JSON.stringify(options.body)}` : ""}
+      });
+      const contentType = resp.headers.get('content-type') || '';
+      let body;
+      if (contentType.includes('application/json') && resp.status !== 204) {
+        try { body = await resp.json(); } catch { body = await resp.text(); }
+      } else {
+        body = await resp.text();
+      }
+      return JSON.stringify({
+        status: resp.status,
+        contentType,
+        body
+      });
+    } catch (e) {
+      return JSON.stringify({ error: e.message });
     }
+  })()`;
+}
+async function fetchCommand(url, options = {}) {
+  if (!url) {
+    throw new Error(
+      "\u7F3A\u5C11 URL \u53C2\u6570\n  \u7528\u6CD5: bb-browser fetch <url> [--json] [--method POST] [--body '{...}']\n  \u793A\u4F8B: bb-browser fetch https://www.reddit.com/api/me.json --json"
+    );
   }
-  const jsContent = readFileSync(site.filePath, "utf-8");
-  const jsBody = jsContent.replace(/\/\*\s*@meta[\s\S]*?\*\//, "").trim();
-  const argsJson = JSON.stringify(argMap);
-  const script = `(${jsBody})(${argsJson})`;
   await ensureDaemonRunning();
+  const isAbsolute = url.startsWith("http://") || url.startsWith("https://");
   let targetTabId = options.tabId;
-  if (!targetTabId && site.domain) {
-    const listReq = { id: generateId(), action: "tab_list" };
-    const listResp = await sendCommand(listReq);
-    if (listResp.success && listResp.data?.tabs) {
-      const matchingTab = listResp.data.tabs.find(
-        (tab) => matchTabOrigin2(tab.url, site.domain)
-      );
-      if (matchingTab) {
-        targetTabId = matchingTab.tabId;
-      }
+  if (isAbsolute) {
+    let origin;
+    let hostname;
+    try {
+      const parsed = new URL(url);
+      origin = parsed.origin;
+      hostname = parsed.hostname;
+    } catch {
+      throw new Error(`\u65E0\u6548\u7684 URL: ${url}`);
     }
     if (!targetTabId) {
-      const newResp = await sendCommand({
-        id: generateId(),
-        action: "tab_new",
-        url: `https://${site.domain}`
-      });
-      targetTabId = newResp.data?.tabId;
-      await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+      targetTabId = await ensureTabForOrigin(origin, hostname);
     }
   }
+  const script = buildFetchScript(url, options);
   const evalReq = { id: generateId(), action: "eval", script, tabId: targetTabId };
   const evalResp = await sendCommand(evalReq);
   if (!evalResp.success) {
-    const hint = site.domain ? `Open https://${site.domain} in your browser, make sure you are logged in, then retry.` : void 0;
-    if (options.json) {
-      console.log(JSON.stringify({ id: evalReq.id, success: false, error: evalResp.error || "eval failed", hint }));
-    } else {
-      console.error(`[error] site ${name}: ${evalResp.error || "eval failed"}`);
-      if (hint) console.error(`  Hint: ${hint}`);
-    }
-    process.exit(1);
+    throw new Error(`Fetch \u5931\u8D25: ${evalResp.error}`);
   }
-  const result = evalResp.data?.result;
-  if (result === void 0 || result === null) {
-    if (options.json) {
-      console.log(JSON.stringify({ id: evalReq.id, success: true, data: null }));
-    } else {
-      console.log("(no output)");
-    }
-    return;
+  const rawResult = evalResp.data?.result;
+  if (rawResult === void 0 || rawResult === null) {
+    throw new Error("Fetch \u672A\u8FD4\u56DE\u7ED3\u679C");
   }
-  let parsed;
+  let result;
   try {
-    parsed = typeof result === "string" ? JSON.parse(result) : result;
+    result = typeof rawResult === "string" ? JSON.parse(rawResult) : rawResult;
   } catch {
-    parsed = result;
+    console.log(rawResult);
+    return;
   }
-  if (typeof parsed === "object" && parsed !== null && "error" in parsed) {
-    const errObj = parsed;
-    const checkText = `${errObj.error} ${errObj.hint || ""}`;
-    const isAuthError = /401|403|unauthorized|forbidden|not.?logged|login.?required|sign.?in|auth/i.test(checkText);
-    const loginHint = isAuthError && site.domain ? `Please log in to https://${site.domain} in your browser first, then retry.` : void 0;
-    const hint = loginHint || errObj.hint;
-    const reportHint = `If this is an adapter bug, report via: gh issue create --repo epiral/bb-sites --title "[${name}] <description>" OR: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] <description>"`;
-    if (options.json) {
-      console.log(JSON.stringify({ id: evalReq.id, success: false, error: errObj.error, hint, reportHint }));
-    } else {
-      console.error(`[error] site ${name}: ${errObj.error}`);
-      if (hint) console.error(`  Hint: ${hint}`);
-      console.error(`  Report: gh issue create --repo epiral/bb-sites --title "[${name}] ..."`);
-      console.error(`     or: bb-browser site github/issue-create epiral/bb-sites --title "[${name}] ..."`);
-    }
-    process.exit(1);
+  if (result.error) {
+    throw new Error(`Fetch error: ${result.error}`);
   }
-  if (options.json) {
-    console.log(JSON.stringify({ id: evalReq.id, success: true, data: parsed }));
+  if (options.output) {
+    const { writeFileSync } = await import("fs");
+    const content = typeof result.body === "object" ? JSON.stringify(result.body, null, 2) : String(result.body);
+    writeFileSync(options.output, content, "utf-8");
+    console.log(`\u5DF2\u5199\u5165 ${options.output} (${result.status}, ${content.length} bytes)`);
+    return;
+  }
+  if (typeof result.body === "object") {
+    console.log(JSON.stringify(result.body, null, 2));
   } else {
-    console.log(JSON.stringify(parsed, null, 2));
+    console.log(result.body);
   }
 }
-async function siteCommand(args, options = {}) {
-  const subCommand = args[0];
-  if (!subCommand || subCommand === "--help" || subCommand === "-h") {
-    console.log(`bb-browser site - \u7F51\u7AD9 CLI \u5316\uFF08\u7BA1\u7406\u548C\u8FD0\u884C site adapter\uFF09
-
-\u7528\u6CD5:
-  bb-browser site list                      \u5217\u51FA\u6240\u6709\u53EF\u7528 adapter
-  bb-browser site search <query>            \u641C\u7D22 adapter
-  bb-browser site <name> [args...]          \u8FD0\u884C adapter\uFF08\u7B80\u5199\uFF09
-  bb-browser site run <name> [args...]      \u8FD0\u884C adapter
-  bb-browser site update                    \u66F4\u65B0\u793E\u533A adapter \u5E93 (git clone/pull)
-
-\u76EE\u5F55:
-  ${LOCAL_SITES_DIR}      \u79C1\u6709 adapter\uFF08\u4F18\u5148\uFF09
-  ${COMMUNITY_SITES_DIR}   \u793E\u533A adapter
-
-\u793A\u4F8B:
-  bb-browser site update
-  bb-browser site list
-  bb-browser site reddit/thread https://www.reddit.com/r/LocalLLaMA/comments/...
-  bb-browser site twitter/user yan5xu
-  bb-browser site search reddit
 
-\u521B\u5EFA\u65B0 adapter: bb-browser guide
-\u62A5\u544A\u95EE\u9898: gh issue create --repo epiral/bb-sites --title "[adapter-name] \u63CF\u8FF0"
-\u8D21\u732E\u793E\u533A: https://github.com/epiral/bb-sites`);
+// packages/cli/src/commands/history.ts
+async function historyCommand(subCommand, options = {}) {
+  const response = await sendCommand({
+    id: crypto.randomUUID(),
+    action: "history",
+    historyCommand: subCommand,
+    text: options.query,
+    ms: options.days
+  });
+  if (options.json) {
+    console.log(JSON.stringify(response));
     return;
   }
+  if (!response.success) {
+    throw new Error(response.error || "History command failed");
+  }
+  const data = response.data;
   switch (subCommand) {
-    case "list":
-      siteList(options);
-      break;
-    case "search":
-      if (!args[1]) {
-        console.error("[error] site search: <query> is required.");
-        console.error("  Usage: bb-browser site search <query>");
-        process.exit(1);
+    case "search": {
+      const items = data?.historyItems || [];
+      console.log(`\u627E\u5230 ${items.length} \u6761\u5386\u53F2\u8BB0\u5F55
+`);
+      if (items.length === 0) {
+        console.log("\u6CA1\u6709\u627E\u5230\u5339\u914D\u7684\u5386\u53F2\u8BB0\u5F55");
+        break;
       }
-      siteSearch(args[1], options);
-      break;
-    case "update":
-      siteUpdate();
-      break;
-    case "run":
-      if (!args[1]) {
-        console.error("[error] site run: <name> is required.");
-        console.error("  Usage: bb-browser site run <name> [args...]");
-        console.error("  Try: bb-browser site list");
-        process.exit(1);
+      for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        console.log(`${i + 1}. ${item.title || "(\u65E0\u6807\u9898)"}`);
+        console.log(`   ${item.url}`);
+        console.log(`   \u8BBF\u95EE\u6B21\u6570: ${item.visitCount}`);
       }
-      await siteRun(args[1], args.slice(2), options);
       break;
-    default:
-      if (subCommand.includes("/")) {
-        await siteRun(subCommand, args.slice(1), options);
-      } else {
-        console.error(`[error] site: unknown subcommand "${subCommand}".`);
-        console.error("  Available: list, search, run, update");
-        console.error("  Try: bb-browser site --help");
-        process.exit(1);
+    }
+    case "domains": {
+      const domains = data?.historyDomains || [];
+      console.log(`\u627E\u5230 ${domains.length} \u4E2A\u57DF\u540D
+`);
+      if (domains.length === 0) {
+        console.log("\u6CA1\u6709\u627E\u5230\u5386\u53F2\u8BB0\u5F55");
+        break;
+      }
+      for (let i = 0; i < domains.length; i++) {
+        const domain = domains[i];
+        console.log(`${i + 1}. ${domain.domain}`);
+        console.log(`   \u8BBF\u95EE\u6B21\u6570: ${domain.visits}`);
       }
       break;
+    }
+    default:
+      throw new Error(`\u672A\u77E5\u7684 history \u5B50\u547D\u4EE4: ${subCommand}`);
   }
 }
 
@@ -1977,88 +2217,64 @@ var VERSION = "0.3.0";
 var HELP_TEXT = `
 bb-browser - AI Agent \u6D4F\u89C8\u5668\u81EA\u52A8\u5316\u5DE5\u5177
 
+\u63D0\u793A\uFF1A\u5927\u591A\u6570\u6570\u636E\u83B7\u53D6\u4EFB\u52A1\u8BF7\u76F4\u63A5\u4F7F\u7528 site \u547D\u4EE4\uFF0C\u65E0\u9700\u624B\u52A8\u64CD\u4F5C\u6D4F\u89C8\u5668\uFF1A
+  bb-browser site list                    \u67E5\u770B\u6240\u6709\u53EF\u7528\u547D\u4EE4
+  bb-browser site twitter/search "AI"     \u793A\u4F8B\uFF1A\u641C\u7D22\u63A8\u6587
+  bb-browser site xueqiu/hot-stock 5      \u793A\u4F8B\uFF1A\u83B7\u53D6\u4EBA\u6C14\u80A1\u7968
+
 \u7528\u6CD5\uFF1A
   bb-browser <command> [options]
 
-\u547D\u4EE4\uFF1A
-  open <url> [--tab] \u6253\u5F00\u6307\u5B9A URL\uFF08\u9ED8\u8BA4\u65B0 tab\uFF0C--tab current \u5F53\u524D tab\uFF09
-  snapshot          \u83B7\u53D6\u5F53\u524D\u9875\u9762\u5FEB\u7167\uFF08\u9ED8\u8BA4\u5B8C\u6574\u6811\uFF09
-  click <ref>       \u70B9\u51FB\u5143\u7D20\uFF08ref \u5982 @5 \u6216 5\uFF09
-  hover <ref>       \u60AC\u505C\u5728\u5143\u7D20\u4E0A
-  fill <ref> <text> \u586B\u5145\u8F93\u5165\u6846\uFF08\u6E05\u7A7A\u540E\u586B\u5165\uFF09
-  type <ref> <text> \u9010\u5B57\u7B26\u8F93\u5165\uFF08\u4E0D\u6E05\u7A7A\uFF09
-  check <ref>       \u52FE\u9009\u590D\u9009\u6846
-  uncheck <ref>     \u53D6\u6D88\u52FE\u9009\u590D\u9009\u6846
-  select <ref> <val> \u4E0B\u62C9\u6846\u9009\u62E9
-  eval "<js>"       \u6267\u884C JavaScript
-  close             \u5173\u95ED\u5F53\u524D\u6807\u7B7E\u9875
-  get text <ref>    \u83B7\u53D6\u5143\u7D20\u6587\u672C
-  get url           \u83B7\u53D6\u5F53\u524D\u9875\u9762 URL
-  get title         \u83B7\u53D6\u9875\u9762\u6807\u9898
-  screenshot [path] \u622A\u53D6\u5F53\u524D\u9875\u9762
-  wait <ms|@ref>    \u7B49\u5F85\u65F6\u95F4\u6216\u5143\u7D20
-  press <key>       \u53D1\u9001\u952E\u76D8\u6309\u952E\uFF08\u5982 Enter, Tab, Control+a\uFF09
-  scroll <dir> [px] \u6EDA\u52A8\u9875\u9762\uFF08up/down/left/right\uFF0C\u9ED8\u8BA4 300px\uFF09
-  daemon            \u524D\u53F0\u542F\u52A8 Daemon
-  start             \u524D\u53F0\u542F\u52A8 Daemon\uFF08daemon \u7684\u522B\u540D\uFF09
-  stop              \u505C\u6B62 Daemon
-  status            \u67E5\u770B Daemon \u72B6\u6001
-  reload            \u91CD\u8F7D\u6269\u5C55\uFF08\u9700\u8981 CDP \u6A21\u5F0F\uFF09
-  back              \u540E\u9000
-  forward           \u524D\u8FDB
-  refresh           \u5237\u65B0\u9875\u9762
-  tab               \u5217\u51FA\u6240\u6709\u6807\u7B7E\u9875
-  tab new [url]     \u65B0\u5EFA\u6807\u7B7E\u9875
-  tab <n>           \u5207\u6362\u5230\u7B2C n \u4E2A\u6807\u7B7E\u9875\uFF08\u6309 index\uFF09
-  tab select --id <id>  \u5207\u6362\u5230\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
-  tab close [n]     \u5173\u95ED\u6807\u7B7E\u9875\uFF08\u6309 index\uFF0C\u9ED8\u8BA4\u5F53\u524D\uFF09
-  tab close --id <id>   \u5173\u95ED\u6307\u5B9A tabId \u7684\u6807\u7B7E\u9875
-  frame <selector>  \u5207\u6362\u5230\u6307\u5B9A iframe
-  frame main        \u8FD4\u56DE\u4E3B frame
-  dialog accept [text]  \u63A5\u53D7\u5BF9\u8BDD\u6846\uFF08alert/confirm/prompt\uFF09
-  dialog dismiss    \u62D2\u7EDD/\u5173\u95ED\u5BF9\u8BDD\u6846
-  network requests [filter]  \u67E5\u770B\u7F51\u7EDC\u8BF7\u6C42
-  network route <url> [--abort|--body <json>]  \u62E6\u622A\u8BF7\u6C42
-  network unroute [url]  \u79FB\u9664\u62E6\u622A\u89C4\u5219
-  network clear     \u6E05\u7A7A\u8BF7\u6C42\u8BB0\u5F55
-  console           \u67E5\u770B\u63A7\u5236\u53F0\u6D88\u606F
-  console --clear   \u6E05\u7A7A\u63A7\u5236\u53F0
-  errors            \u67E5\u770B JS \u9519\u8BEF
-  errors --clear    \u6E05\u7A7A\u9519\u8BEF\u8BB0\u5F55
-  trace start       \u5F00\u59CB\u5F55\u5236\u7528\u6237\u64CD\u4F5C
-  trace stop        \u505C\u6B62\u5F55\u5236\uFF0C\u8F93\u51FA\u4E8B\u4EF6\u5217\u8868
-  trace status      \u67E5\u770B\u5F55\u5236\u72B6\u6001
-  fetch <url>       \u5728\u6D4F\u89C8\u5668\u4E0A\u4E0B\u6587\u4E2D fetch\uFF08\u81EA\u52A8\u540C\u6E90\u8DEF\u7531\uFF0C\u5E26\u767B\u5F55\u6001\uFF09
-  site              \u7F51\u7AD9 CLI \u5316 \u2014 \u7BA1\u7406\u548C\u8FD0\u884C site adapter
-  site list         \u5217\u51FA\u6240\u6709\u53EF\u7528 adapter
-  site search <q>   \u641C\u7D22 adapter
-  site <name>       \u8FD0\u884C adapter\uFF08\u5982 site reddit/thread <url>\uFF09
-  site update       \u66F4\u65B0\u793E\u533A adapter \u5E93
-  guide             \u5982\u4F55\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210 site adapter\uFF08\u5F00\u53D1\u6307\u5357\uFF09
+\u5F00\u59CB\u4F7F\u7528\uFF1A
+  site recommend               \u63A8\u8350\u4F60\u53EF\u80FD\u9700\u8981\u7684 adapter\uFF08\u57FA\u4E8E\u6D4F\u89C8\u5386\u53F2\uFF09
+  site list                    \u5217\u51FA\u6240\u6709 adapter
+  site info <name>             \u67E5\u770B adapter \u7528\u6CD5\uFF08\u53C2\u6570\u3001\u8FD4\u56DE\u503C\u3001\u793A\u4F8B\uFF09
+  site <name> [args]           \u8FD0\u884C adapter
+  site update                  \u66F4\u65B0\u793E\u533A adapter \u5E93
+  guide                        \u5982\u4F55\u628A\u4EFB\u4F55\u7F51\u7AD9\u53D8\u6210 adapter
+
+\u6D4F\u89C8\u5668\u64CD\u4F5C\uFF1A
+  open <url> [--tab]           \u6253\u5F00 URL
+  snapshot [-i] [-c] [-d <n>]  \u83B7\u53D6\u9875\u9762\u5FEB\u7167
+  click <ref>                  \u70B9\u51FB\u5143\u7D20
+  hover <ref>                  \u60AC\u505C\u5143\u7D20
+  fill <ref> <text>            \u586B\u5145\u8F93\u5165\u6846\uFF08\u6E05\u7A7A\u540E\u586B\u5165\uFF09
+  type <ref> <text>            \u9010\u5B57\u7B26\u8F93\u5165\uFF08\u4E0D\u6E05\u7A7A\uFF09
+  check/uncheck <ref>          \u52FE\u9009/\u53D6\u6D88\u590D\u9009\u6846
+  select <ref> <val>           \u4E0B\u62C9\u6846\u9009\u62E9
+  press <key>                  \u53D1\u9001\u6309\u952E
+  scroll <dir> [px]            \u6EDA\u52A8\u9875\u9762
+
+\u9875\u9762\u4FE1\u606F\uFF1A
+  get text|url|title <ref>     \u83B7\u53D6\u9875\u9762\u5185\u5BB9
+  screenshot [path]            \u622A\u56FE
+  eval "<js>"                  \u6267\u884C JavaScript
+  fetch <url>                  \u5E26\u767B\u5F55\u6001\u7684 HTTP \u8BF7\u6C42
+
+\u6807\u7B7E\u9875\uFF1A
+  tab [list|new|close|<n>]     \u7BA1\u7406\u6807\u7B7E\u9875
+
+\u5BFC\u822A\uFF1A
+  back / forward / refresh     \u540E\u9000 / \u524D\u8FDB / \u5237\u65B0
+
+\u8C03\u8BD5\uFF1A
+  network requests [filter]    \u67E5\u770B\u7F51\u7EDC\u8BF7\u6C42
+  console [--clear]            \u67E5\u770B/\u6E05\u7A7A\u63A7\u5236\u53F0
+  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
 
 \u9009\u9879\uFF1A
-  --json          \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
-  -i, --interactive \u53EA\u8F93\u51FA\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08snapshot \u547D\u4EE4\uFF09
-  -c, --compact   \u79FB\u9664\u7A7A\u7ED3\u6784\u8282\u70B9\uFF08snapshot \u547D\u4EE4\uFF09
-  -d, --depth <n> \u9650\u5236\u6811\u6DF1\u5EA6\uFF08snapshot \u547D\u4EE4\uFF09
+  --json               \u4EE5 JSON \u683C\u5F0F\u8F93\u51FA
+  --jq <expr>          \u5BF9 JSON \u8F93\u51FA\u5E94\u7528 jq \u8FC7\u6EE4\uFF08\u76F4\u63A5\u4F5C\u7528\u4E8E\u6570\u636E\uFF0C\u8DF3\u8FC7 id/success \u4FE1\u5C01\uFF09
+  -i, --interactive    \u53EA\u8F93\u51FA\u53EF\u4EA4\u4E92\u5143\u7D20\uFF08snapshot \u547D\u4EE4\uFF09
+  -c, --compact        \u79FB\u9664\u7A7A\u7ED3\u6784\u8282\u70B9\uFF08snapshot \u547D\u4EE4\uFF09
+  -d, --depth <n>      \u9650\u5236\u6811\u6DF1\u5EA6\uFF08snapshot \u547D\u4EE4\uFF09
   -s, --selector <sel> \u9650\u5B9A CSS \u9009\u62E9\u5668\u8303\u56F4\uFF08snapshot \u547D\u4EE4\uFF09
-  --tab <tabId>   \u6307\u5B9A\u64CD\u4F5C\u7684\u6807\u7B7E\u9875 ID
-  --mcp           \u542F\u52A8 MCP server\uFF08\u7528\u4E8E Claude Code / Cursor \u7B49 AI \u5DE5\u5177\uFF09
-  --help, -h      \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
-  --version, -v   \u663E\u793A\u7248\u672C\u53F7
-
-\u793A\u4F8B\uFF1A
-  bb-browser open https://example.com
-  bb-browser snapshot --json
-  bb-browser click @5
-  bb-browser fill @3 "hello world"
-  bb-browser type @3 "append text"
-  bb-browser get text @5
-  bb-browser get url
-  bb-browser press Enter
-  bb-browser press Control+a
-  bb-browser daemon
-  bb-browser stop
+  --tab <tabId>        \u6307\u5B9A\u64CD\u4F5C\u7684\u6807\u7B7E\u9875 ID
+  --mcp                \u542F\u52A8 MCP server\uFF08\u7528\u4E8E Claude Code / Cursor \u7B49 AI \u5DE5\u5177\uFF09
+  --help, -h           \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
+  --version, -v        \u663E\u793A\u7248\u672C\u53F7
 `.trim();
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -2081,6 +2297,13 @@ function parseArgs(argv) {
     }
     if (arg === "--json") {
       result.flags.json = true;
+    } else if (arg === "--jq") {
+      skipNext = true;
+      const nextIdx = args.indexOf(arg) + 1;
+      if (nextIdx < args.length) {
+        result.flags.jq = args[nextIdx];
+        result.flags.json = true;
+      }
     } else if (arg === "--help" || arg === "-h") {
       result.flags.help = true;
     } else if (arg === "--version" || arg === "-v") {
@@ -2101,6 +2324,12 @@ function parseArgs(argv) {
       if (nextIdx < args.length) {
         result.flags.selector = args[nextIdx];
       }
+    } else if (arg === "--days") {
+      skipNext = true;
+      const nextIdx = args.indexOf(arg) + 1;
+      if (nextIdx < args.length) {
+        result.flags.days = parseInt(args[nextIdx], 10);
+      }
     } else if (arg === "--id") {
       skipNext = true;
     } else if (arg === "--tab") {
@@ -2116,6 +2345,7 @@ function parseArgs(argv) {
 }
 async function main() {
   const parsed = parseArgs(process.argv);
+  setJqExpression(parsed.flags.jq);
   const tabArgIdx = process.argv.indexOf("--tab");
   const globalTabId = tabArgIdx >= 0 && process.argv[tabArgIdx + 1] ? parseInt(process.argv[tabArgIdx + 1], 10) : void 0;
   if (parsed.flags.version) {
@@ -2429,6 +2659,23 @@ async function main() {
         await traceCommand(subCmd, { json: parsed.flags.json, tabId: globalTabId });
         break;
       }
+      case "history": {
+        const subCmd = parsed.args[0];
+        if (!subCmd || !["search", "domains"].includes(subCmd)) {
+          console.error("\u9519\u8BEF\uFF1A\u7F3A\u5C11\u6216\u65E0\u6548\u7684\u5B50\u547D\u4EE4");
+          console.error("\u7528\u6CD5\uFF1Abb-browser history <search|domains> [query] [--days <n>]");
+          console.error("\u793A\u4F8B\uFF1Abb-browser history search github");
+          console.error("      bb-browser history domains --days 7");
+          process.exit(1);
+        }
+        const query = parsed.args.slice(1).join(" ");
+        await historyCommand(subCmd, {
+          json: parsed.flags.json,
+          days: parsed.flags.days || 30,
+          query
+        });
+        break;
+      }
       case "fetch": {
         const fetchUrl = parsed.args[0];
         if (!fetchUrl) {
@@ -2456,7 +2703,12 @@ async function main() {
         break;
       }
       case "site": {
-        await siteCommand(parsed.args, { json: parsed.flags.json, tabId: globalTabId });
+        await siteCommand(parsed.args, {
+          json: parsed.flags.json,
+          jq: parsed.flags.jq,
+          days: parsed.flags.days,
+          tabId: globalTabId
+        });
         break;
       }
       case "guide": {