Appearance
Ephemeral 模式提供临时的执行环境,执行完毕即清理,适用于一次性任务和自动化场景。
为什么需要 Ephemeral
自动化场景(如 CI/CD 管道、批量处理)需要无状态的执行模式——每次任务独立运行,不留残留状态。Ephemeral 模式确保每次执行在干净的环境中启动,完成后自动清理临时资源,适合脚本化调用和无人值守操作。
核心原理
- 临时环境:
ThreadConfigSnapshot.ephemeral = true标识线程为临时模式,Session 据此调整资源管理策略 - 无状态执行:不保留之前的对话状态,每次执行从零开始(除非显式
--resume) - 自动清理:任务完成后自动释放所有资源(连接、文件句柄、沙箱环境)
- Exec 模式集成:
codex exec默认使用 Ephemeral 模式,输出结果后立即退出
在源码中的实现
codex-rs/core/src/session/mod.rs—ThreadConfigSnapshot.ephemeral字段codex-rs/exec/src/lib.rs— Exec 模式默认使用 Ephemeral 执行codex-rs/core/src/codex_thread.rs—CodexThread管理 Ephemeral 线程的生命周期