Skip to content

About

Codex skill for project-local research discussion, execution plans, and reproducible handoff records.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Research Flow · 科研讨论与执行

在官方普通 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; 详见 连接说明。

日常使用

  1. 在已连接工具的普通 Chat 讨论,讨论本身不自动启动 Codex。
  2. 说“在 my-project 开始执行……”;项目明确后派发已确定工作。
  3. 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 的端到端验收。

MIT License · 中文说明

About

Codex skill for project-local research discussion, execution plans, and reproducible handoff records.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages