EVIDENCE / 源码证据
版本固定,结论有边界
路径来自实际检出代码。固定提交链接让课程可以被复查。
来源与适用范围
主要来源为 OpenAI 的公开 Codex 仓库。本课程于 2026-10-13 浅克隆仓库并核对工作区、模块、函数、测试名称和相关说明。没有更改上游代码,也没有构建或运行其 测试套件。
课程覆盖公开 核心运行机制及相关公开组件,图示区分实际代码分支与教学省略。闭源桌面界面、远程推理内部、账户后端、未启用功能的实际表现,不在本课程证明范围内。主分支和产品行为可能在此提交之后变化。
复查方式
git clone https://github.com/openai/codex.git
cd codex
git checkout f82e36592278a0a782fb0d0fc97e5fa10e832ac2
git show -s --format="%H %cI" HEAD只读原文与相邻分支,再对照下方证据。如果运行版本不同,请重新验证路径、配置和条件。
按课汇总的定位索引
01 / Harness 的边界
- 仓库明确的产品入口与范围
README.md:1–12 - 模型客户端的生命周期说明
codex-rs/core/src/client.rs:1–17 - 回合执行循环的入口
codex-rs/core/src/session/turn.rs:150–171
02 / 仓库边界与依赖
- CLI 导入了哪些入口
codex-rs/cli/src/main.rs:1–40 - 核心库的模块组织
codex-rs/core/src/lib.rs:1–40 - 核心 crate 的名称与依赖
codex-rs/core/Cargo.toml:1–35 - 真实的 MCP 与历史库路径
codex-rs/Cargo.toml:254–273
03 / 回合循环
- 提交的数据及关联元信息
codex-rs/core/src/session/submission.rs:1–20 - 入口与前置整理
codex-rs/core/src/session/turn.rs:150–210 - 历史准备与继续条件
codex-rs/core/src/session/turn.rs:515–575 - 历史整理及停止判断
codex-rs/core/src/session/turn.rs:609–675 - 流式输出项处理
codex-rs/core/src/session/turn.rs:2674–2814
04 / 工具计划与调度
- 路由结构持有哪些内容
codex-rs/core/src/tools/router.rs:91–100 - 并发能力与调用解析
codex-rs/core/src/tools/router.rs:245–275 - 核心工具执行契约
codex-rs/core/src/tools/registry.rs:57–100 - 等待、执行门与分派
codex-rs/core/src/tools/parallel.rs:190–245 - 工具计划构造模块
codex-rs/core/src/tools/spec_plan.rs:1–45
05 / 工具暴露策略
- 资格与预算
codex-rs/core/src/mcp_tool_exposure.rs:77–158 - 暴露矩阵
codex-rs/tools/src/tool_executor.rs:51–96 - 表面策略
codex-rs/core/src/tools/spec_plan.rs:197–285 - 冲突
codex-rs/core/src/tools/spec_plan.rs:475–518
06 / 上下文选择
- 入库、输出截断和请求材料
codex-rs/core/src/context_manager/history.rs:517–617 - 规范化
codex-rs/core/src/context_manager/history.rs:962–980 - 模型历史项白名单
codex-rs/core/src/context_manager/history.rs:1031–1054 - 状态基线与注入
codex-rs/core/src/session/mod.rs:4744–4785 - 最终 Prompt 装配
codex-rs/core/src/session/turn.rs:1563–1592
07 / 上下文压缩
- 压缩触发公式
codex-rs/core/src/session/context_window.rs:59–130 - 时点、模型切换与实现分支
codex-rs/core/src/session/turn.rs:1304–1513 - 本地用户原文预算
codex-rs/core/src/compact.rs:695–781 - 远程原文选择与预算
codex-rs/core/src/compact_remote_v2.rs:499–722 - 请求前救容量
codex-rs/core/src/compact_remote_history.rs:76–146 - 不生成摘要的新窗口
codex-rs/core/src/session/mod.rs:4658–4718
08 / 沙箱实现
- 授权、有效权限与第一次尝试
codex-rs/core/src/tools/orchestrator.rs:146–385 - 拒绝与第二次尝试
codex-rs/core/src/tools/orchestrator.rs:395–587 - 平台转换
codex-rs/sandboxing/src/manager.rs:355–542 - macOS 策略生成
codex-rs/sandboxing/src/seatbelt.rs:878–1105 - Linux 两阶段执行
codex-rs/linux-sandbox/src/linux_run_main.rs:196–345 - 挂载顺序
codex-rs/linux-sandbox/src/bwrap.rs:414–432 - 系统调用与权限约束
codex-rs/linux-sandbox/src/seccomp.rs:36–100
09 / 命令规则
- 命令拆段
codex-rs/core/src/exec_policy.rs:872–908 - 决定合并
codex-rs/execpolicy/src/policy.rs:401–411 - 授权要求
codex-rs/core/src/exec_policy.rs:394–460 - 建议覆盖
codex-rs/core/src/exec_policy.rs:958–1021
10 / 配置与扩展
- 配置层加载入口
codex-rs/config/src/loader/mod.rs:146–205 - 合并与要求层模块
codex-rs/config/src/lib.rs:1–48 - 项目约定发现范围
codex-rs/core/src/agents_md.rs:1–19 - 指南元数据解析与校验
codex-rs/skills/src/parser.rs:22–95 - 内嵌系统指南缓存
codex-rs/skills/src/lib.rs:60–100 - MCP 的真实库入口
codex-rs/codex-mcp/src/lib.rs:1–56 - 本步工具计划读取 MCP 工具
codex-rs/core/src/session/turn.rs:1790–1810
11 / 请求恢复
- 恢复策略
codex-rs/core/src/responses_retry.rs:57–186 - 增量校验
codex-rs/core/src/client.rs:1468–1502 - 传输回退
codex-rs/core/src/client.rs:2380–2391 - 截止时间测试
codex-rs/core/src/responses_retry_tests.rs:53–99
12 / 验证与扩展
- 现有测试与扩展执行器示例
codex-rs/core/src/tools/router_tests.rs:46–100 - 模拟事件与跨组件测试依赖
codex-rs/core/tests/suite/pending_input.rs:1–70 - 上游的构建和测试指导
docs/install.md:14–61 - 实际测试配方
justfile:76–92 - 当前上游贡献边界
docs/contributing.md:1–24
许可与署名
本课程原创文字、页面代码与 图示采用 Apache-2.0 许可;没有复用官方标志或宣传图片。源码短摘录保留其 Apache-2.0 属性,来源为 OpenAI Codex,Copyright 2025 OpenAI。不是 OpenAI 官方课程,也不暗示官方背书。
部署文档来源
部署由用户自行完成;本任务未创建任何托管项目。说明核验日期:2026-10-13。