mirror of https://github.com/claude-code-best/claude-code.git synced 2026-06-15 12:55:51 +00:00

Files

claude-code-best 37dac682b9 docs: 文档大重组，对齐 README 入口

以 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>

2026-06-15 16:51:29 +08:00

2.5 KiB

Raw Blame History

title, description, keywords

title

description

keywords

浏览器操作工具

让 AI 控制 Chrome 完成网页操作：导航、点击、输入、抓取。

浏览器工具

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）

四、关键设计决策

Bun WebView API：使用 Bun 内置的 WebView 而非外部浏览器驱动（Puppeteer/Playwright）
REPL 侧边面板：浏览器状态在 REPL 布局中独立渲染
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`	工具注册

2.5 KiB Raw Blame History Unescape Escape