bb-browser 0.10.0 → 0.11.0

package/README.md

@@ -71,13 +71,6 @@ bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePerc
 
 Skill on ClawHub: [bb-browser-openclaw](https://clawhub.ai/yan5xu/bb-browser)
 
-### Chrome Extension (standalone mode)
-
-For use without OpenClaw (Claude Code MCP, standalone CLI):
-
-1. Download from [Releases](https://github.com/epiral/bb-browser/releases/latest)
-2. Unzip → `chrome://extensions/` → Developer Mode → Load unpacked
-
 ### MCP (Claude Code / Cursor)
 
 ```json
@@ -185,10 +178,15 @@ bb-browser daemon --host 0.0.0.0      # listen on all interfaces (for Tailscale
 AI Agent (Claude Code, Codex, Cursor, etc.)
        │ CLI or MCP (stdio)
        ▼
-bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome Extension
-                                              │
-                                              ▼ chrome.debugger (CDP)
-                                         Your Real Browser
+bb-browser CLI ──HTTP──▶ Daemon ──CDP WebSocket──▶ Your Real Browser
+                           │
+                    ┌──────┴──────┐
+                    │ Per-tab     │
+                    │ event cache │
+                    │ (network,   │
+                    │  console,   │
+                    │  errors)    │
+                    └─────────────┘
 ```
 
 ## License

package/README.zh-CN.md

@@ -71,13 +71,6 @@ bb-browser site xueqiu/hot-stock 5 --openclaw --jq '.items[] | {name, changePerc
 
 ClawHub Skill: [bb-browser-openclaw](https://clawhub.ai/yan5xu/bb-browser)
 
-### Chrome 扩展（独立模式）
-
-不使用 OpenClaw 时（Claude Code MCP、独立 CLI）需要安装扩展：
-
-1. 从 [Releases](https://github.com/epiral/bb-browser/releases/latest) 下载 zip
-2. 解压 → `chrome://extensions/` → 开发者模式 → 加载已解压的扩展程序
-
 ### MCP 接入（Claude Code / Cursor）
 
 ```json
@@ -185,10 +178,15 @@ bb-browser daemon --host 0.0.0.0      # 监听所有网卡（用于 Tailscale /
 AI Agent (Claude Code, Codex, Cursor 等)
        │ CLI 或 MCP (stdio)
        ▼
-bb-browser CLI ──HTTP──▶ Daemon ──SSE──▶ Chrome 扩展
-                                              │
-                                              ▼ chrome.debugger (CDP)
-                                         你的真实浏览器
+bb-browser CLI ──HTTP──▶ Daemon ──CDP WebSocket──▶ 你的真实浏览器
+                           │
+                    ┌──────┴──────┐
+                    │ Per-tab     │
+                    │ 事件缓存    │
+                    │ (network,   │
+                    │  console,   │
+                    │  errors)    │
+                    └─────────────┘
 ```
 
 ## 许可证

package/dist/{chunk-DBJBHYC7.js → chunk-5WGFUZLM.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
 // packages/shared/dist/index.js
+import { randomUUID } from "crypto";
 function generateId() {
-  return crypto.randomUUID();
+  return randomUUID();
 }
 var DAEMON_PORT = 19824;
 var DAEMON_HOST = "localhost";
 var DAEMON_BASE_URL = `http://${DAEMON_HOST}:${DAEMON_PORT}`;
-var SSE_HEARTBEAT_INTERVAL = 15e3;
 var COMMAND_TIMEOUT = 3e4;
 
 export {
@@ -15,7 +15,6 @@ export {
   DAEMON_PORT,
   DAEMON_HOST,
   DAEMON_BASE_URL,
-  SSE_HEARTBEAT_INTERVAL,
   COMMAND_TIMEOUT
 };
-//# sourceMappingURL=chunk-DBJBHYC7.js.map
+//# sourceMappingURL=chunk-5WGFUZLM.js.map

package/dist/chunk-5WGFUZLM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../packages/shared/src/protocol.ts","../packages/shared/src/constants.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\n\n/**\n * bb-browser 通信协议 — CLI/MCP ↔ Daemon ↔ Chrome CDP\n */\n\n/** 支持的操作类型 */\nexport type ActionType =\n  | \"open\"\n  | \"snapshot\"\n  | \"click\"\n  | \"hover\"\n  | \"fill\"\n  | \"type\"\n  | \"check\"\n  | \"uncheck\"\n  | \"select\"\n  | \"get\"\n  | \"screenshot\"\n  | \"close\"\n  | \"wait\"\n  | \"press\"\n  | \"scroll\"\n  | \"back\"\n  | \"forward\"\n  | \"refresh\"\n  | \"eval\"\n  | \"tab_list\"\n  | \"tab_new\"\n  | \"tab_select\"\n  | \"tab_close\"\n  | \"frame\"\n  | \"frame_main\"\n  | \"dialog\"\n  | \"network\"\n  | \"console\"\n  | \"errors\"\n  | \"trace\"\n  | \"history\";\n\n/** 请求类型 */\nexport interface Request {\n  /** 请求唯一标识 */\n  id: string;\n  /** 操作类型 */\n  action: ActionType;\n  /** 目标 URL（open 操作时必填） */\n  url?: string;\n  /** 元素引用（click, fill, get 操作时使用） */\n  ref?: string;\n  /** 输入文本（fill 操作时使用） */\n  text?: string;\n  /** 获取属性类型（get 操作时使用） */\n  attribute?: string;\n  /** 截图保存路径（screenshot 操作时使用） */\n  path?: string;\n  /** 是否只输出可交互元素（snapshot 命令使用） */\n  interactive?: boolean;\n  /** 移除空结构节点（snapshot 命令使用） */\n  compact?: boolean;\n  /** 限制树深度（snapshot 命令使用） */\n  maxDepth?: number;\n  /** JavaScript 代码（eval 命令使用） */\n  script?: string;\n  /** 选项值（select 命令使用） */\n  value?: string;\n  /** 标签页索引（tab_select, tab_close 命令使用） */\n  index?: number;\n  /** 标签页 ID（tab_select, tab_close 命令使用，优先于 index） */\n  tabId?: number | string;\n  /** CSS 选择器（frame 命令使用，定位 iframe） */\n  selector?: string;\n  /** dialog 响应类型（dialog 命令使用） */\n  dialogResponse?: \"accept\" | \"dismiss\";\n  /** prompt 对话框的输入文本（dialog accept 时可选） */\n  promptText?: string;\n  /** network 子命令：requests, route, unroute, clear */\n  networkCommand?: \"requests\" | \"route\" | \"unroute\" | \"clear\";\n  /** network route 选项 */\n  routeOptions?: {\n    abort?: boolean;\n    body?: string;\n    status?: number;\n    headers?: Record<string, string>;\n  };\n  /** 过滤字符串（network requests, console 使用） */\n  filter?: string;\n  /** network requests 是否包含 body/headers */\n  withBody?: boolean;\n  /** console 子命令：get, clear */\n  consoleCommand?: \"get\" | \"clear\";\n  /** errors 子命令：get, clear */\n  errorsCommand?: \"get\" | \"clear\";\n  /** trace 子命令：start, stop, status */\n  traceCommand?: \"start\" | \"stop\" | \"status\";\n  /** history 子命令：search, domains */\n  historyCommand?: \"search\" | \"domains\";\n  /** 按键名（press 命令使用） */\n  key?: string;\n  /** 修饰键列表（press 命令使用） */\n  modifiers?: string[];\n  /** 滚动方向（scroll 命令使用） */\n  direction?: string;\n  /** 滚动距离（scroll 命令使用） */\n  pixels?: number;\n  /** 等待类型（wait 命令使用） */\n  waitType?: string;\n  /** 等待毫秒数（wait 命令使用） */\n  ms?: number;\n  /** 增量查询起点（observation 命令使用，支持 seq 数值或 \"last_action\"） */\n  since?: number | \"last_action\";\n  /** HTTP 方法过滤（network requests 使用） */\n  method?: string;\n  /** HTTP 状态码过滤（network requests 使用，支持 \"4xx\"/\"5xx\" 或具体数字） */\n  status?: string;\n  /** 返回条数限制（observation 命令使用） */\n  limit?: number;\n}\n\n/** 元素引用信息 */\nexport interface RefInfo {\n  /** CDP backendDOMNodeId（主定位方式） */\n  backendDOMNodeId?: number;\n  /** 元素的 XPath（向后兼容） */\n  xpath?: string;\n  /** 可访问性角色 */\n  role: string;\n  /** 可访问名称 */\n  name?: string;\n  /** 标签名 */\n  tagName?: string;\n}\n\n/** 标签页信息 */\nexport interface TabInfo {\n  /** 标签页在窗口中的索引（0-based） */\n  index: number;\n  /** 标签页 URL */\n  url: string;\n  /** 标签页标题 */\n  title: string;\n  /** 是否是当前活动标签页 */\n  active: boolean;\n  /** 标签页 ID（CDP targetId 或 extension tabId） */\n  tabId: number | string;\n  /** 短标签页 ID（daemon 模式） */\n  tab?: string;\n}\n\n/** Snapshot 命令返回的数据 */\nexport interface SnapshotData {\n  /** 文本格式的可访问性树 */\n  snapshot: string;\n  /** 元素引用映射，key 为 ref ID */\n  refs: Record<string, RefInfo>;\n}\n\n/** 网络请求信息 */\nexport interface NetworkRequestInfo {\n  requestId: string;\n  url: string;\n  method: string;\n  type: string;\n  timestamp: number;\n  status?: number;\n  statusText?: string;\n  failed?: boolean;\n  failureReason?: string;\n  requestHeaders?: Record<string, string>;\n  requestBody?: string;\n  requestBodyTruncated?: boolean;\n  responseHeaders?: Record<string, string>;\n  responseBody?: string;\n  responseBodyBase64?: boolean;\n  responseBodyTruncated?: boolean;\n  mimeType?: string;\n  bodyError?: string;\n}\n\n/** 控制台消息 */\nexport interface ConsoleMessageInfo {\n  type: 'log' | 'info' | 'warn' | 'error' | 'debug';\n  text: string;\n  timestamp: number;\n  url?: string;\n  lineNumber?: number;\n}\n\n/** JS 错误信息 */\nexport interface JSErrorInfo {\n  message: string;\n  url?: string;\n  lineNumber?: number;\n  columnNumber?: number;\n  stackTrace?: string;\n  timestamp: number;\n}\n\n/** Trace 事件类型 - 录制用户操作 */\nexport interface TraceEvent {\n  /** 事件类型 */\n  type: 'click' | 'fill' | 'select' | 'check' | 'press' | 'scroll' | 'navigation';\n  /** 时间戳 */\n  timestamp: number;\n  /** 事件发生时的页面 URL */\n  url: string;\n  \n  /** 元素引用 - highlightIndex，可直接用于 @ref */\n  ref?: number;\n  /** 备用定位 - XPath */\n  xpath?: string;\n  /** CSS 选择器 */\n  cssSelector?: string;\n  \n  /** 操作参数 - fill/select 的值 */\n  value?: string;\n  /** 操作参数 - press 的按键 */\n  key?: string;\n  /** 操作参数 - scroll 方向 */\n  direction?: 'up' | 'down' | 'left' | 'right';\n  /** 操作参数 - scroll 距离 */\n  pixels?: number;\n  /** 操作参数 - check/uncheck 状态 */\n  checked?: boolean;\n  \n  /** 语义信息 - 元素角色 */\n  elementRole?: string;\n  /** 语义信息 - 元素名称 */\n  elementName?: string;\n  /** 语义信息 - 元素标签 */\n  elementTag?: string;\n}\n\n/** Trace 录制状态 */\nexport interface TraceStatus {\n  /** 是否正在录制 */\n  recording: boolean;\n  /** 已录制事件数量 */\n  eventCount: number;\n  /** 录制的标签页 ID */\n  tabId?: number;\n}\n\n/** 响应数据 */\nexport interface ResponseData {\n  /** 页面标题 */\n  title?: string;\n  /** 当前 URL */\n  url?: string;\n  /** Tab ID */\n  tabId?: number | string;\n  /** 短标签页 ID（daemon 模式） */\n  tab?: string;\n  /** 全局操作序号 */\n  seq?: number;\n  /** 观测查询游标（用于 since 增量查询） */\n  cursor?: number;\n  /** Snapshot 数据（snapshot 操作返回） */\n  snapshotData?: SnapshotData;\n  /** 获取的文本或属性值（get 操作返回） */\n  value?: string;\n  /** 截图路径（screenshot 操作返回） */\n  screenshotPath?: string;\n  /** 截图 data URL（screenshot 操作返回） */\n  dataUrl?: string;\n  /** eval 执行结果 */\n  result?: unknown;\n  /** 标签页列表（tab_list 命令返回） */\n  tabs?: TabInfo[];\n  /** 当前活动标签页索引（tab_list 命令返回） */\n  activeIndex?: number;\n  /** Frame 信息（frame 命令返回） */\n  frameInfo?: {\n    /** iframe 的 CSS 选择器 */\n    selector?: string;\n    /** iframe 的 name 属性 */\n    name?: string;\n    /** iframe 的 URL */\n    url?: string;\n    /** frame ID */\n    frameId?: number;\n  };\n  /** dialog 信息（dialog 命令返回） */\n  dialogInfo?: {\n    /** 对话框类型：alert, confirm, prompt, beforeunload */\n    type: string;\n    /** 对话框消息 */\n    message: string;\n    /** 是否成功处理 */\n    handled: boolean;\n  };\n  /** 网络请求列表（network requests 命令返回） */\n  networkRequests?: NetworkRequestInfo[];\n  /** 网络路由规则数量（network route/unroute 命令返回） */\n  routeCount?: number;\n  /** 控制台消息列表（console 命令返回） */\n  consoleMessages?: ConsoleMessageInfo[];\n  /** JS 错误列表（errors 命令返回） */\n  jsErrors?: JSErrorInfo[];\n  /** Trace 事件列表（trace stop 命令返回） */\n  traceEvents?: TraceEvent[];\n  /** Trace 录制状态（trace status 命令返回） */\n  traceStatus?: TraceStatus;\n  /** History 搜索结果 */\n  historyItems?: Array<{\n    url: string;\n    title: string;\n    visitCount: number;\n    lastVisitTime: number;\n  }>;\n  /** History 域名聚合结果 */\n  historyDomains?: Array<{\n    domain: string;\n    visits: number;\n    titles: string[];\n  }>;\n}\n\n/** 响应类型 */\nexport interface Response {\n  /** 对应请求的 ID */\n  id: string;\n  /** 操作是否成功 */\n  success: boolean;\n  /** 成功时返回的数据 */\n  data?: ResponseData;\n  /** 失败时的错误信息 */\n  error?: string;\n}\n\n/** Daemon 状态 */\nexport interface DaemonStatus {\n  running: boolean;\n  cdpConnected: boolean;\n  uptime: number;\n  currentSeq?: number;\n  tabs?: Array<{\n    shortId: string;\n    targetId: string;\n    networkRequests: number;\n    consoleMessages: number;\n    jsErrors: number;\n    lastActionSeq: number;\n  }>;\n}\n\n/**\n * 生成唯一请求 ID\n * @returns UUID v4 格式的字符串\n */\nexport function generateId(): string {\n  return randomUUID();\n}\n","/**\n * bb-browser 共享常量\n */\n\n/** Daemon HTTP 服务端口 */\nexport const DAEMON_PORT = 19824;\n\n/** Daemon 主机地址 */\nexport const DAEMON_HOST = \"localhost\";\n\n/** Daemon 基础 URL */\nexport const DAEMON_BASE_URL = `http://${DAEMON_HOST}:${DAEMON_PORT}`;\n\n/** SSE 心跳间隔（毫秒） - 15秒确保 MV3 Service Worker 不休眠 */\nexport const SSE_HEARTBEAT_INTERVAL = 15000; // 15 秒\n\n/** 命令执行超时时间（毫秒） */\nexport const COMMAND_TIMEOUT = 30000; // 30 秒\n\n/** SSE 重连延迟（毫秒） */\nexport const SSE_RECONNECT_DELAY = 3000; // 3 秒\n\n/** SSE 最大重连尝试次数 */\nexport const SSE_MAX_RECONNECT_ATTEMPTS = 5;\n"],"mappings":";;;AAAA,SAAS,kBAAkB;AA8VpB,SAAS,aAAqB;AACnC,SAAO,WAAW;AACpB;AC3VO,IAAM,cAAc;AAGpB,IAAM,cAAc;AAGpB,IAAM,kBAAkB,UAAU,WAAW,IAAI,WAAW;AAM5D,IAAM,kBAAkB;","names":[]}