内容
# 浏览器接管桥
> 公共测试版 — 核心浏览器控制路径已测试并可用。商店分发和第三方浏览器兼容性认证仍在进行中。
[产品网站](https://fangsylar-pixel.github.io/browser-takeover-bridge/) ·
[下载 v0.6.0](https://github.com/fangsylar-pixel/browser-takeover-bridge/releases/tag/v0.6.0)
## 在 Codex 中安装
将此仓库添加为 Codex 市场源，然后安装插件：
```powershell
codex plugin marketplace add fangsylar-pixel/browser-takeover-bridge
codex plugin add browser-takeover@browser-takeover-marketplace
```
重启 Codex 并在安装后打开一个新线程。配套的 Chrome 或 Edge 扩展程序仍然需要从 `browser-takeover/extension` 或发布 ZIP 加载一次。
浏览器接管是一种本地优先的浏览器控制层，允许 AI 代理与已经打开并已验证身份的 Chrome 和 Edge 标签页合作。
与强制用户进入全新配置文件的浏览器自动化不同，浏览器接管与用户已经信任的会话合作。它添加了可见的安全控制、受信任的站点限制、诊断健康报告和用于 Codex 和其他 MCP 兼容代理的开放本地协议。
大多数浏览器自动化工具需要新的浏览器配置文件或使用远程调试端口启动的浏览器。该项目添加了一个配套扩展程序和本地桥，允许代理发现和控制用户正常的 Chrome 或 Edge 标签页，而无需要求用户再次登录。
## 功能
- 列出用户正常浏览器配置文件中已经打开的 Chrome 或 Edge 标签页。
- 读取可见的页面文本和 DOM 结构。
- 输入提示、点击按钮、导航标签页和捕获截图。
- 获取需要浏览器登录会话的图像资源。
- 降级到 Chrome DevTools 协议，用于使用 `--remote-debugging-port` 启动的浏览器。
- 使用可续签的只读或交互式租约声明标签页。
- 使用结构化操作协议进行可靠的点击、填充、读取、按下、选择和快照操作。
- 使用每个扩展程序令牌验证扩展程序流量到本地桥。
- 在扩展程序弹出窗口中显示实时连接健康状况和错误。
- 流式传输标签页生命周期事件，并在一个只读批次中捕获多个打开的标签页。
- 使用可观察的 URL、文本、元素或值证据验证写入操作。
- 从扩展程序弹出窗口暂停所有自动化。
- 将控制权限制在明确的受信任站点列表中。
- 复制用于支持和团队故障排除的隐私安全诊断。
验证本地：
- ChatGPT：发送提示并下载生成的图像。
- Feishu/Lark 文档：读取文档文本并下载嵌入的图像。
- 今日头条：读取已验证的页面并捕获截图。
## 项目布局
```text
browser-takeover/
.codex-plugin/plugin.json
.mcp.json
extension/
manifest.json
background.js
scripts/
browser_takeover_mcp.py
skills/
browser-takeover/SKILL.md
README.md
website/
src/
public/
package.json
```
## 下载和验证
GitHub 发布包含：
- `browser-takeover-extension-<version>.zip` 用于加载配套扩展程序。
- `browser-takeover-plugin-<version>.zip` 用于 Codex 或 MCP 兼容的本地安装。
- `SHA256SUMS.txt` 用于完整性验证。
维护者可以使用以下命令在本地复制这些文件：
```powershell
python browser-takeover/scripts/verify_release.py
```
## 产品网站
双语产品网站位于 `website/`。它根据浏览器语言环境自动选择中文或英文，并包含手动语言切换。
公开网站：<https://fangsylar-pixel.github.io/browser-takeover-bridge/>
```powershell
cd website
npm install
npm run dev
```
## 工作原理
1. MCP 服务器在 `127.0.0.1:17321` 上启动本地桥。
2. 浏览器扩展程序从用户的正常浏览器配置文件中轮询该桥。
3. 扩展程序报告打开的标签页并在这些标签页中执行请求的命令。
4. 结果返回到本地 MCP 服务器。
该桥仅限本地使用。它不公开网络服务。
## 安装扩展程序
1. 打开 `edge://extensions` 或 `chrome://extensions`。
2. 启用开发者模式。
3. 点击“加载解压”。
4. 选择：
```text
browser-takeover/extension
```
## MCP 服务器
插件 MCP 入口点是：
```text
browser-takeover/scripts/browser_takeover_mcp.py
```
有用的工具包括：
- `browser_takeover_extension_bridge_status`
- `browser_takeover_extension_list_tabs`
- `browser_takeover_extension_reload`
- `browser_takeover_extension_evaluate`
- `browser_takeover_extension_navigate`
- `browser_takeover_extension_screenshot`
- `browser_takeover_claim_tab`
- `browser_takeover_renew_claim`
- `browser_takeover_release_tab`
- `browser_takeover_extension_action`
## 安全模型
- 扩展程序必须由用户安装。
- 桥仅在 `127.0.0.1` 上监听。
- 用户可以随时暂停自动化。
- 用户可以从弹出窗口将命令限制在受信任的主机名上。
- 扩展程序流量在注册后通过 CORS 限制到扩展程序源。
- 代理只能访问安装扩展程序的浏览器配置文件中的标签页。
- 该项目不会绕过身份验证、权限、CAPTCHA、付费墙或浏览器安全边界。
- 将每个连接的页面视为敏感信息。避免记录私人文档内容、签名 URL 或帐户数据。
在团队环境中部署桥之前，请阅读完整的 [隐私政策](PRIVACY.md)、[安全政策](SECURITY.md) 和 [使用条款](TERMS.md)。有关故障排除，请参阅 [支持指南](SUPPORT.md)。
## CDP 边界
普通的 Chrome 或 Edge 窗口无法在启动后通过 CDP 附加，除非使用以下标志启动：
```powershell
msedge.exe --remote-debugging-port=9222
chrome.exe --remote-debugging-port=9222
```
扩展程序桥存在用于覆盖用户已经在正常登录浏览器中打开页面的实用情况。
## 团队选择浏览器接管的原因
- **本地优先：** 控制桥绑定到 localhost。
- **浏览器选择：** 支持 Chrome 和 Edge。
- **现有会话：** 与用户已经登录的标签页合作。
- **操作安全：** 暂停开关、受信任站点模式、声明、租约和证据检查。
- **适用于复杂页面：** Shadow DOM、iframe、上传、下载、原生输入和全页面捕获。
- **开放集成：** 文档化的 MCP 接口而非单一供应商工作流。
## 支持
浏览器接管桥是开源的，适用于尝试使用 Codex、浏览器代理和身份验证 Web 工作流的人员。
如果它对您有帮助，欢迎可选支持：
[在 Afdian 上支持](https://afdian.com/a/fangsylar)
欢迎提交错误报告和贡献。参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 许可证
MIT
