Skip to content

Ephemeral 模式提供临时的执行环境,执行完毕即清理,适用于一次性任务和自动化场景。

为什么需要 Ephemeral

自动化场景(如 CI/CD 管道、批量处理)需要无状态的执行模式——每次任务独立运行,不留残留状态。Ephemeral 模式确保每次执行在干净的环境中启动,完成后自动清理临时资源,适合脚本化调用和无人值守操作。

核心原理

  1. 临时环境ThreadConfigSnapshot.ephemeral = true 标识线程为临时模式,Session 据此调整资源管理策略
  2. 无状态执行:不保留之前的对话状态,每次执行从零开始(除非显式 --resume
  3. 自动清理:任务完成后自动释放所有资源(连接、文件句柄、沙箱环境)
  4. Exec 模式集成codex exec 默认使用 Ephemeral 模式,输出结果后立即退出

在源码中的实现

  • codex-rs/core/src/session/mod.rsThreadConfigSnapshot.ephemeral 字段
  • codex-rs/exec/src/lib.rs — Exec 模式默认使用 Ephemeral 执行
  • codex-rs/core/src/codex_thread.rsCodexThread 管理 Ephemeral 线程的生命周期

相关概念