Codex 系统手册

前端会话启动和面向用户的初始化

stage-941 个文件

这一阶段把已经启动好的后端,接到用户真正能用的前台上。走聊天界面时,TUI 会读取配置和命令,处理登录、恢复旧会话、新手引导、目录信任、模型选择,再搭好聊天窗口、快捷键、通知和终端接管,像把柜台布置好再开门营业。走 exec 模式时,它不打开聊天窗口,而是为脚本准备一次性会话,接好输入和机器可读的输出,跑完后用退出码告诉外部成功还是失败。

子阶段

本阶段涉及的状态19
  • reg-effective-config系统最终采用的那份配置,把文件、云端规则、项目设置、命令行参数和临时覆盖合在一起,后面各模块都按它办事。
  • reg-feature-flags当前打开或关闭的实验功能和能力开关,决定界面、模型、工具、插件等功能能不能用。
  • reg-auth-account用户当前是谁、有没有登录、用的是哪种账号或套餐、令牌是否还能用的身份状态。
  • reg-account-quota-limits账号的额度、限流、消费控制和剩余可用量信息,用来决定请求能不能继续发。
  • reg-thread-session-store当前有哪些线程和会话、哪个正在用、哪些能恢复或关闭的共享会话账本。
  • reg-model-catalog系统当前知道有哪些模型、各模型有什么能力、来自哪个提供方以及能不能选用的模型清单。
  • reg-backend-remote-config-cache从云端拉下来的配置、目录和规则的本地缓存,启动和后台刷新都会读写它。
  • reg-plugin-registry已安装、可用、来自市场或本地的插件清单,以及每个插件的能力和加载结果。
  • reg-permissions-approvals用户已经允许、拒绝或需要确认的命令、文件、联网、MCP 调用等权限和审批状态。
  • reg-sandbox-execution-policy命令和工具运行时要遵守的沙箱、读写、联网、身份和执行策略。
  • reg-ui-interaction-stateTUI 或前端当前显示哪个线程、输入框内容、弹窗、快捷键、通知和终端接管等界面状态。
  • reg-cloud-task-state云端任务、任务列表、默认环境、尝试次数、状态和结果在本地界面与后端之间同步的那份状态。
  • reg-realtime-session-state线程级实时对话的会话参数、音频/文本输入缓冲、实时 WebSocket 状态和流式通知进度。
  • reg-workspace-trust-state当前工作区和目录的信任状态、授权根目录及同步到前端和沙箱的工作区权限信息。
  • reg-instructions-context-store用户规则、项目 AGENTS.md、扩展贡献指令和其他需持续注入模型的说明片段集合。
  • reg-invocation-dispatch-state本次进程启动选择的入口模式、子命令和早期解析参数,决定后续走 TUI、exec、登录、服务器或维护流程。
  • reg-active-model-selection当前线程或会话实际选中的模型、提供方和推理参数状态,区别于仅列出可用模型的模型目录。
  • reg-active-workspace-context当前会话选中的工作目录、项目根和能力根等工作区上下文,用于提示词、工具执行、权限判断和结果展示。
  • reg-onboarding-preferences-state新手引导、提示是否已看过、界面偏好和类似本地用户体验标记的持久状态。