Codex 系统手册

传输和服务器运行时初始化

stage-840 个文件

这一阶段是在程序要当“服务器”时,先把收发消息的路铺好,属于开机启动和幕后支撑。它一边启动 app-server 和 daemon,管进程开关、日志、配置、鉴权,并把 stdio、本机 socket、WebSocket 等通道接上;另一边启动 exec-server、MCP 等外挂机器,让外部工具、远程控制和客户端都能用 JSON-RPC 这种固定格式说话。各部件像总机、门卫和转接线,先登记连接,再转发请求和通知。

子阶段

本阶段涉及的状态17
  • reg-effective-config系统最终采用的那份配置,把文件、云端规则、项目设置、命令行参数和临时覆盖合在一起,后面各模块都按它办事。
  • reg-feature-flags当前打开或关闭的实验功能和能力开关,决定界面、模型、工具、插件等功能能不能用。
  • reg-installation-environment程序知道自己装在哪里、家目录在哪里、运行在哪台机器和什么终端里的那组环境信息。
  • reg-auth-account用户当前是谁、有没有登录、用的是哪种账号或套餐、令牌是否还能用的身份状态。
  • reg-backend-remote-config-cache从云端拉下来的配置、目录和规则的本地缓存,启动和后台刷新都会读写它。
  • reg-mcp-registryMCP 服务器、连接、工具和资源的登记表,模型和前端都靠它知道能调用哪些外部能力。
  • reg-sandbox-execution-policy命令和工具运行时要遵守的沙箱、读写、联网、身份和执行策略。
  • reg-exec-environment-processesexec-server 和统一执行层里正在运行或已经结束的进程、退出码、输入输出和失败原因。
  • reg-transport-rpc-connectionsstdio、本机 socket、WebSocket、JSON-RPC、relay 等通道上的连接、请求编号和收发队列。
  • reg-server-daemon-stateapp-server、daemon、exec-server 等常驻服务当前是否启动、有哪些客户端连着、处理器是否还接单的运行状态。
  • reg-observability-telemetry日志、指标、分析事件、请求耗时、工具结果和错误报告等观测数据的收集与发送状态。
  • reg-remote-control-state远程控制功能的开启状态、配对码、已授权设备、撤销记录和远端会话可用性状态。
  • reg-filesystem-watch-state文件系统监听订阅、被监控路径、最近快照、变更去抖和待通知事件的共享状态。
  • reg-realtime-session-state线程级实时对话的会话参数、音频/文本输入缓冲、实时 WebSocket 状态和流式通知进度。
  • reg-invocation-dispatch-state本次进程启动选择的入口模式、子命令和早期解析参数,决定后续走 TUI、exec、登录、服务器或维护流程。
  • reg-async-runtime-shutdown全局异步运行时、任务执行句柄、取消信号和关机协调状态,供服务器、后台任务、工具执行和清理流程共用。
  • reg-extension-lifecycle-state已加载扩展在账户、线程、回合和工具生命周期中注册的贡献、回调上下文和运行中结果状态。