在官方普通 Chat 中讨论,通过本机 MCP 桥接调用 Codex,结果回到同一对话。 不需要新的聊天前端;不再默认要求上传交接文件。
基于 MIT 开源项目 Engineering Bridge, 固定上游提交 33904f37f5aea530fa02da948a6f54d3968d0bf8,适配范围见 上游说明。
已实现本地桥接安装/启动、项目发现、任务派发、结果等待和继续同一个任务。 模型与思考强度可指定,默认继承 Codex 配置。 本机服务就绪不等于普通 Chat 已接通:开发者连接、账号权限和一次真实调用需单独验收。 检查报告区分本机验证和官方普通 Chat 验证,不把模拟客户端当成官方 Chat。
需要 Python 3.11+、Node.js 22+、Git,以及已登录且可从 PATH 调用的官方 Codex CLI。
安装:python bridge/bridge.py install --project "my-project=C:\absolute\project"
连接检查:python bridge/check_bridge.py
默认私有状态目录是用户目录下的 .research-flow-bridge,可用 RESEARCH_FLOW_HOME 指定。 这里保存项目路径、固定版本依赖和任务状态,不进入源码仓库。 本地插件通过 .mcp.json 提供工具;已有插件时无需重复安装独立 Skill。
普通 Chat 无法直连本地服务时,使用 官方 Secure MCP Tunnel; 详见 连接说明。
- 在已连接工具的普通 Chat 讨论,讨论本身不自动启动 Codex。
- 说“在 my-project 开始执行……”;项目明确后派发已确定工作。
- Chat 等待、审阅并展示结果,可以继续同一个 Codex 任务。
执行模型通过 model 与 reasoning_effort 选择,由 Codex 校验;不替换 Chat 的模型选择器。 桥接不会使 Codex 执行免费,也不会自行切换官方 Chat / Work 模式。
- run_task 只读且执行环境网络关闭;代码修改保留完整 diff 和上游 APPLY / COMMIT 确认。
- 单次执行最多 15 分钟;Windows 不支持上游异步补丁校验。
- 任意写入、长时间训练和后台实验队列不是本版能力。
- 本机服务和隧道需要运行;Bridge 重启后临时任务映射不保证保留。
- 旧项目记录与导出脚本保留,文件交接仅作为用户明确选择的备用方式。
python -m unittest discover -s tests -v
python bridge/check_bridge.py
仅在明确需要一次有用量的真实验收时运行: python bridge/check_bridge.py --execute --project my-project
真实验收比较返回的 README 第一行和 Git HEAD,并检查未改动已跟踪文件。 本机检查仍不能替代官方普通 Chat 的端到端验收。