ADR-0020 Codex 会话配置变化时分叉

状态：Accepted · 日期：2026-10-23 · 补充 ADR-0003

背景

AgentServer 每轮对话都会把最新配置（Profile 的文件访问策略、权限模式、技能、全局禁止项、功能开关、系统提示词）通过 thread/resume 传给 Codex。但会话一旦加载进 app-server 进程，Codex 就沿用首次加载时的配置。

验证结果（codex 0.164）：resume 时放开某个目录，命令仍然读不到
thread/unsubscribe 不会卸载会话
turn/start 没有权限覆盖项

这样后台收紧安全设置（例如新增全局禁止项）后，进行中的 Codex 会话要到服务重启才会受约束。

决策

适配器为当前 app-server 进程中每个已加载的会话记录配置指纹：线程参数的 SHA-256，模型除外，模型每轮单独传入。
下一轮的配置与指纹相同时直接继续，指纹不同时调用 thread/fork，传入新配置：
- 新会话保留全部历史，采用新配置
- 会话映射更新为新的 thread id，旧会话取消订阅
- 已验证：放宽后可以读取，再收紧后又被拒绝，历史轮数不变
分叉失败时新建会话，宁可丢失上下文，也不在旧配置下继续。
app-server 重启后，已加载记录清空，下一轮按正常流程 resume。

后果

配置修改在下一轮立即生效，不需要重启服务
分叉后，Codex 在本会话中"本会话内允许"的审批记录不再保留，需要重新审批
旧会话的记录留在 Codex 自己的历史中，不影响 AgentServer