mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-17 22:05:50 +00:00
37dac682b9
以 README 为单一事实来源，重构整个 docs/ 目录。 最终结构（3 大组、15 篇文档）： - 开始: installation / quickstart / model-providers - 核心功能: pipes-and-lan、acp、channels、chrome-control、computer-use、 voice-mode、web-browser-tool、auto-dream、remote-control-self-hosting、 langfuse-monitoring - 内部机制: growthbook-adapter、sentry-setup 主要变更： - 删除 56 个 README 未提及的文档（architecture 全部 / guides 全部 / features 中未在 README 出现的 20 篇 / internals 中的 5 篇） - 合并 6 组重复文档（pipes-and-lan、chrome-control、acp、computer-use、 auto-dream、coordinator-mode 简化为入口） - features 子组从 5 → 4，ui/ 合并入 tools/ - 所有保留文档加上人性化 frontmatter（title/description/keywords） - docs.json navigation 简化为 3 大组，redirects 重新过滤为 7 条合并跳转 - 新增 docs.md 工作大纲与验证脚本（verify-docs / check-docs-orphans / dump-docs-outline） 总计 130 文件改动，从约 35000 行精简到约 2000 行。 Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
76 lines
2.5 KiB
Markdown
76 lines
2.5 KiB
Markdown
---
|
||
title: "浏览器操作工具"
|
||
description: "让 AI 控制 Chrome 完成网页操作：导航、点击、输入、抓取。"
|
||
keywords: ["浏览器工具", "Chrome 控制", "网页操作", "Bun WebView", "WEB_BROWSER_TOOL"]
|
||
---
|
||
|
||
# WEB_BROWSER_TOOL — 浏览器工具
|
||
|
||
> Feature Flag: `FEATURE_WEB_BROWSER_TOOL=1`
|
||
> 实现状态：核心工具已实现，面板为 Stub，布线完整
|
||
> 引用数：4
|
||
|
||
## 一、功能概述
|
||
|
||
WEB_BROWSER_TOOL 让模型可以启动浏览器实例、导航网页、与页面元素交互。使用 Bun 的内置 WebView API 提供无头/有头浏览器能力。
|
||
|
||
## 二、实现架构
|
||
|
||
### 2.1 模块状态
|
||
|
||
| 模块 | 文件 | 状态 |
|
||
|------|------|------|
|
||
| 浏览器面板 | `packages/builtin-tools/src/tools/WebBrowserTool/WebBrowserPanel.ts` | **Stub** — 返回 null |
|
||
| 浏览器工具 | `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` 检查运行时是否支持
|
||
|
||
## 五、使用方式
|
||
|
||
```bash
|
||
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` | 工具注册 |
|