Skip to main content

​
WEB_BROWSER_TOOL — 浏览器工具

Feature Flag: FEATURE_WEB_BROWSER_TOOL=1 实现状态：核心实现缺失，面板为 Stub，布线完整 引用数：4

​
一、功能概述

WEB_BROWSER_TOOL 让模型可以启动浏览器实例、导航网页、与页面元素交互。使用 Bun 的内置 WebView API 提供无头/有头浏览器能力。

​
二、实现架构

​
2.1 模块状态

模块文件状态
浏览器面板src/tools/WebBrowserTool/WebBrowserPanel.tsStub — 返回 null
浏览器工具src/tools/WebBrowserTool/WebBrowserTool.ts缺失
REPL 集成src/screens/REPL.tsx布线 — 渲染 WebBrowserPanel
工具注册src/tools.ts布线 — 动态加载
WebView 检测src/main.tsx布线 — 'WebView' in Bun 检测

​
2.2 预期数据流

模型调用 WebBrowserTool
         │
         ▼
Bun WebView 创建浏览器实例
         │
         ├── navigate(url) — 导航到 URL
         ├── click(selector) — 点击元素
         ├── screenshot() — 截取页面截图
         └── extract(selector) — 提取页面内容
         │
         ▼
结果返回给模型
         │
         ▼
WebBrowserPanel 在 REPL 侧边显示浏览器状态

​
三、需要补全的内容

模块工作量说明
WebBrowserTool.ts大工具 schema + Bun WebView API 执行
WebBrowserPanel.tsx中REPL 侧边栏浏览器状态面板

​
四、关键设计决策

  1. Bun WebView API：使用 Bun 内置的 WebView 而非外部浏览器驱动（Puppeteer/Playwright）
  2. REPL 侧边面板：浏览器状态在 REPL 布局中独立渲染
  3. Bun 特性检测：'WebView' in Bun 检查运行时是否支持

​
五、使用方式

FEATURE_WEB_BROWSER_TOOL=1 bun run dev

​
六、文件索引

文件职责
src/tools/WebBrowserTool/WebBrowserPanel.ts面板组件（stub）
src/tools/WebBrowserTool/WebBrowserTool.ts工具实现（缺失）
src/screens/REPL.tsx:273,4582面板渲染
src/tools.ts:115-116工具注册