Herbertmt978/HA_Codex_Bridge

## 它是什么 Codex Bridge 将 Home Assistant 保留为面向用户的控制平面。管理员在 Home Assistant 面板中进行操作；私有的 Bridge 负责协调 Codex 以及特意授权的工作区。 ``` Browser -> Home Assistant -> Codex Bridge Integration -> private App or external Bridge -> Codex / OpenAI ``` 浏览器不会直接连接到 Bridge、App 或 Codex。请通过 Home Assistant 常规的 LAN 或 HTTPS 远程访问路由进行发布。 ## 两个组件，两条安装路径 - **HACS 集成：** `codex_bridge` 自定义集成提供了管理员面板，并通过 HACS 安装。上面的 HACS 链接会打开一个自定义仓库流程；这并不代表本项目已被 HACS 或 Home Assistant 列出、审查、认可或支持。 - **Supervisor App：** 专用的私有 runtime，旨在与 Home Assistant 一起运行 Bridge 和 Codex。将此仓库添加到 Home Assistant App 商店以安装其发布的不可变镜像。 App 处于实验阶段，仅支持 `amd64`，版本为 `0.6.0`；集成为 `0.5.4`，可选的外部 Bridge 为 `0.5.3`，内置的 Codex runtime 为 `0.144.4`。发布工作流会发布带有 SPDX SBOM 和构建来源的已签名 GHCR 镜像。2026 年 7 月 14 日，受保护的 runtime 镜像也在 amd64 Home Assistant OS 开发虚拟机上通过了沙盒自检和经过身份验证的就绪检查。远程访问验收、首次自动更新以及先前镜像的恢复仍需在目标 Home Assistant 安装环境中进行验证。 对于已经在运行外部 Bridge 的用户，外部 Bridge 仍然是一个可选的私有兼容路径。全新的 Home Assistant OS 安装应使用 App。在目标安装环境通过 App 更新和冷恢复演练之前，请仅将现有的外部 Bridge 作为恢复路径保留。 ## 安装与首次运行 1. 在 **Settings -> Apps -> App store -> Repositories** 中，添加 。安装并启动 **Codex Bridge**。 2. 通过 HACS 安装 **Codex Bridge** 集成，重启 Home Assistant，然后在 **Settings -> Devices & services** 中添加它。App 发现机制会自动提供私有连接；无需复制 host、port 或 bearer token。 3. 以 Home Assistant 管理员身份打开面板。选择 **Sign in with ChatGPT**，然后使用浏览器完成已批准的 ChatGPT 设备认证页面。**Cancel** 仅取消正在进行的登录；**Sign out** 会移除已建立的 Codex 会话。 4. 创建一个 Project，并在 App 模式下的 `/config/workspaces` 下授予一个小型工作区。在扩大该边界之前，请先审查更改。 Home Assistant 会话和 ChatGPT 会话是独立的。建立 ChatGPT 会话后，正常的面板使用可以保留在 Home Assistant 源上。初始登录和重新身份验证仍需要浏览器访问已批准的 ChatGPT 设备认证页面。此账户流程不使用 OpenAI API key。 ## 更新与恢复 App 镜像是不可变的：正在运行的 container 不会更新 Codex 或其自身。Home Assistant 可以提供已发布的 App 更新，并可以在管理员启用 App 的自动更新开关后自动应用。上游的 Codex 更新首先作为经过验证、可审查的仓库 PR 到达；在通过真实的更新/恢复金丝雀测试之前，无人值守合并仍处于禁用状态。Supervisor App 目前**不**提供经过验证的任意先前镜像选择方式，因此在更改 App 之前，请进行一次 Home Assistant 的冷备份。在演练过冷恢复之前，请将已存在的私有外部 Bridge 保留在原处；请参阅 [备份和恢复](docs/backup-restore.md)。 ## 安全边界 | 边界 | 责任 | | --- | --- | | 远程访问 | 发布 Home Assistant，而不是 App 或 Bridge。 | | Home Assistant | 面板仅供管理员使用；管理员可以要求 Codex 在授予的工作区中执行操作。 | | App / Bridge | 私有 runtime 状态和 Codex 会话保留在非浏览器面向的路径上。 | | 工作区 | Codex 只能检查和更改您授予的文件；从小的范围开始并审查更改。 | | 凭据 | 不要分享 device codes、Bridge token、会话材料或工作区机密。 | 当 App 的沙盒证明无法验证时，它会安全失效（关闭）。不要为了继续运行而削弱沙盒；请检查 App 日志并使用受支持的构建版本。请参阅 [App 文档](codex_bridge_app/DOCS.md) 和 [SECURITY.md](SECURITY.md)。 ## 卸载 停止 App 或外部 Bridge，移除集成，并在删除项目数据之前审查 `/config/workspaces`。在重新利用设备之前，请使用 **Sign out** 移除 Codex 访问权限，并通过常规账户控制撤销 ChatGPT 会话。[外部 Bridge 迁移指南](docs/migration-from-windows.md) 提供了安全的切换和恢复指导。 ## 开发与贡献

标签：请求拦截, 逆向工具