github/claude-code-best
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
03a41d19e3
claude-code-best/docs/features/web-browser-tool.md
deviosyan 5a53d83ad5 fix: sync outdated stub docs + integrate LSP closeAllFiles with compact 
- Remove redundant fork:true and run_in_background params in /fork command
- Integrate LSP closeAllFiles() into postCompactCleanup (memory leak #14)
- Update 10 docs files: mark implemented features no longer as stubs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-28 02:17:42 +08:00

2.4 KiB
Raw Blame History

WEB_BROWSER_TOOL — 浏览器工具

Feature Flag: FEATURE_WEB_BROWSER_TOOL=1 实现状态：核心工具已实现，面板故意为 null（结果在对话中内联显示） 引用数：4

一、功能概述

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

二、实现架构

2.1 模块状态

模块 文件 状态
浏览器面板 packages/builtin-tools/src/tools/WebBrowserTool/WebBrowserPanel.ts Null by design — 结果内联显示，不需面板
浏览器工具 packages/builtin-tools/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 侧边栏浏览器状态面板（仍为 Stub）

四、关键设计决策

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

五、使用方式

FEATURE_WEB_BROWSER_TOOL=1 bun run dev

六、文件索引

文件 职责
packages/builtin-tools/src/tools/WebBrowserTool/WebBrowserPanel.ts 面板组件（stub）
packages/builtin-tools/src/tools/WebBrowserTool/WebBrowserTool.ts 工具实现（已实现）
src/screens/REPL.tsx:471,5676 面板渲染
src/tools.ts:115-116 工具注册