读懂 Codex（4.8）：Environment Context 的 cwd、Shell、Git 与运行环境

Environment Context 不是启动时读取一次的本机信息，而是从当前 TurnEnvironmentSnapshot 渲染出的模型可见快照。一次 Turn 可以选中本地或远端多个环境；每个环境都必须把 cwd、Shell 和可用的仓库状态与实际执行后端绑定，不能拿宿主机信息冒充远端事实。

两层环境说明

Codex 把环境相关上下文拆为两类 World State section：EnvironmentsInstructionsState 说明怎样使用多环境能力，EnvironmentsState 描述本次选中的具体环境。前者更像操作协议，后者是动态数据。

TurnEnvironmentSnapshot 编译 cwd、Shell、Git 和环境描述 — 图 4.8-1：环境选择先冻结成 Turn 快照，再由各环境自己的文件系统和执行器补全模型上下文；工具路由也消费同一选择。

每个环境记录稳定 environment ID、路径 URI、cwd 和环境类型。环境渲染器还可加入 Shell 描述、Git 信息及调用方提供的环境说明。XML 文本通过专用转义函数写入边界，避免路径或说明中的 <、& 破坏标记结构。

async def build_environment_state(selection):
    entries = []
    for env in selection.turn_environments:
        entries.append(EnvironmentEntry(
            id=env.id,
            cwd=env.cwd,
            shell=await env.executor.describe_shell(),
            git=await inspect_git(env.filesystem, env.cwd),
            kind=env.kind,
        ))
    return EnvironmentsState(entries)

cwd 是环境内路径，不只是本地 Path

远端环境的 cwd 使用可跨文件系统表达的 Path URI；发现 AGENTS、读取文件和执行命令都从同一环境对象取 filesystem/executor。若先把 URI 转成本机路径再读取，就可能得到不存在的目录，或更糟地访问到同名本地目录。

多个运行环境各自绑定 cwd、文件系统和命令执行器 — 图 4.8-2：environment ID 是关联键。Prompt 中的 cwd、AGENTS 发现和后续工具执行必须落到同一列，禁止跨列混用。

async def execute_in_environment(snapshot, environment_id, command):
    env = snapshot.require(environment_id)
    return await env.executor.run(command, cwd=env.cwd)

差异和失败边界

环境 Snapshot 保存足以比较的结构化条目。cwd、环境集合或描述变化时，section 渲染更新；完全相同则不重复。环境消失时必须明确告诉模型当前已不再选择该环境。

Git 探测失败不应阻止整个 Prompt 构造，可以省略不可靠字段并保留 cwd/环境身份；但执行器和文件系统不可用属于 Step 捕获失败，不能继续构造一个“看得到却用不了”的环境。

源码与测试锚点

codex-rs/core/src/environment_selection.rs：Turn 环境选择快照。
codex-rs/core/src/context/world_state/environment.rs：环境 Snapshot 与渲染。
codex-rs/core/src/context/world_state/environments_instructions.rs：多环境使用说明。
codex-rs/core/src/context/world_state/environment_tests.rs：新增、变化和删除。

两层环境说明

cwd 是环境内路径，不只是本地 Path

差异和失败边界

源码与测试锚点

评论