123 lines
2.5 KiB
Markdown
123 lines
2.5 KiB
Markdown
# AI直连真实浏览器
|
||
|
||
`浏览器自动化` `Chrome扩展` `CDP` `AI工具` `MCP`
|
||
|
||
# vibe-browser
|
||
|
||
## **Chrome 从 146 版本开始支持直接开启 MCP 连接，所以这个项目已经完成了它的历史使命**
|
||
|
||
[English](./README-en.md)
|
||
|
||
---
|
||
|
||
## 项目简介
|
||
|
||
`vibe-browser` 让 AI **直接连接你正在使用的真实浏览器实例**。
|
||
|
||
它不会启动新的自动化浏览器，而是附加到当前浏览器进程，共享同一套运行时和会话状态。
|
||
|
||
因此 AI 可以直接：
|
||
|
||
- 复用登录状态
|
||
- 访问 Cookie
|
||
- 读取 Local Storage
|
||
- 操作真实标签页
|
||
|
||
无需重新登录，也无需同步环境。
|
||
|
||
**这是 `vibe-browser` 与市面同类浏览器自动化工具最大的区别。**
|
||
|
||
项目不使用 Playwright，而是直接基于 Chrome DevTools Protocol（CDP）实现，提供更底层、更轻量的控制能力。
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 1. 构建扩展
|
||
|
||
```bash
|
||
cd extension
|
||
bun install
|
||
bun run build
|
||
```
|
||
|
||
浏览器加载：
|
||
|
||
```
|
||
extension/.output/chrome-mv3
|
||
```
|
||
|
||
开启扩展并切换为 **Active**。
|
||
|
||
---
|
||
|
||
### 2. 为你的项目添加 skill
|
||
|
||
```bash
|
||
bunx skills add https://github.com/0xUniko/vibe-browser
|
||
```
|
||
|
||
---
|
||
|
||
### 3. 启动 relay
|
||
|
||
```bash
|
||
bun skill/scripts/relay.ts
|
||
```
|
||
|
||
默认地址：
|
||
|
||
```
|
||
http://127.0.0.1:9111
|
||
```
|
||
|
||
连接成功后扩展里会显示：
|
||
|
||
```
|
||
Connected to relay
|
||
```
|
||
|
||
---
|
||
|
||
## 技术架构
|
||
|
||
- `extension/`
|
||
Chromium 扩展（WXT + TypeScript + effect）
|
||
负责 CDP 控制、Tab 路由和事件转发
|
||
|
||
- `skill/`
|
||
本地 Relay 服务（对外 HTTP + SSE）
|
||
连接你的工具 / 脚本 / AI 与扩展
|
||
|
||
---
|
||
|
||
## Relay 接口（默认）
|
||
|
||
- 健康检查：`GET /health`
|
||
- 发送命令：`POST /command`
|
||
- 事件流（SSE）：`GET /events`
|
||
|
||
环境变量：
|
||
|
||
```
|
||
SKILL_HOST
|
||
SKILL_PORT
|
||
SKILL_REQUEST_TIMEOUT_MS
|
||
SKILL_HEALTH_PROBE_TIMEOUT_MS
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题（阻塞/超时）
|
||
|
||
- 不要一次做非常"重"的操作：尽量拆成多次小操作，并且每次都等上一条命令返回后再发下一条。
|
||
- `GET /health` 只能说明"可连通/可快速探测"，并不能保证当前没有长任务在跑或扩展没有被卡住。
|
||
- 如果 `POST /command` 经常超时（默认 15s），大概率是扩展端被长任务卡住或调试链路拥塞；此时停止继续发命令，去浏览器手动刷新扩展（`chrome://extensions` 或 `edge://extensions` 里找到 `vibe-browser` 点刷新/重载），再重新切到 **Active**。
|
||
|
||
## 待办事项
|
||
|
||
- 优化架构和实现细节，以节省 token 并降低对模型智力的要求
|
||
|
||
## 许可证
|
||
|
||
MIT |