# Codex Bridge

让 Codex 通过本机 MCP 程序操作你已打开的 Firefox 标签页。支持 Windows x64、Firefox 140+；本机程序使用 C++23，运行时无需 Node.js。

> **免责声明**：我是一个学生，这是我用 Codex 开发的一个尚不成熟的实验插件，可能存在各种错误、兼容性问题或意外行为。它并非 OpenAI、Codex 或 Mozilla 官方出品，与其无隶属、认可或担保关系。项目按现状提供，不作可用性或安全保证；请自行评估风险，避免用于敏感页面和重要操作。希望社区能够一起参与开发、测试和改进。

## 使用

1. 下载并解压发布包；或按 [构建说明](docs/usage.md) 从源码构建。
2. 在项目目录运行本机连接程序安装脚本：

   ```powershell
   powershell -NoProfile -ExecutionPolicy Bypass -File scripts/repair-native-outside-codex.ps1
   ```

3. 在 Firefox 安装签名 XPI，然后重新加载 Codex MCP 配置。未签名开发包仅可通过 `about:debugging` 临时加载；签名与商店状态以发布说明为准。
4. 在 Codex 使用 `firefox_status`、`firefox_tabs` 等工具。工具栏面板可暂停或恢复控制。

安装脚本写入当前用户的 Native Messaging 注册项和 Codex MCP 配置，并备份原配置。浏览器无需调试端口；Windows 本机配套程序是必需组件，单装扩展不能工作。

## 能力与限制

- 12 项工具：状态、标签页、新建、激活、导航、快照、点击、填写、按键、滚动、截图、等待。
- 操作限普通网页；不支持 Firefox 内置页面、受保护站点、密码管理器和浏览器界面。合成输入在部分网站可能无效。
- 网页内容和截图会交给本机 Codex，可能进一步发送至用户配置的 AI 服务。详见 [隐私说明](PRIVACY.md)。

欢迎 [提交问题](https://github.com/zybin7890/firefox-codex-bridge/issues) 和 Pull Request，一起把它做好。见 [参与开发](CONTRIBUTING.md)。

**Unofficial student experiment, built with Codex. Immature software; bugs and unexpected behavior are possible. Not affiliated with or endorsed by OpenAI or Mozilla. Community contributions are welcome.**

许可证：[AGPL-3.0-or-later](LICENSE)。本项目允许按 GNU Affero General Public License 第 3 版或任何后续版本使用、修改和分发；第三方组件保留各自许可证。