Codex 会话级 Provider 绑定与 Paginated 历史截断报错的修复铁律
本文目录(3 节)
10 月下旬在本地代理 magpie(127.0.0.1:3425)和远端通道 kakou 之间来回切换 Codex 模型源时,我连着撞上三次「全局配置明明改了,旧会话一打开就崩」的故障。把这三次排障串起来,刚好能看清 Codex 桌面端管理长会话状态的底层结构。
1. Provider 是会话级(Thread-level)持久化的,改全局配置只管新会话
10 月 22 日我把全局 config.toml 的 model_provider 切到本地代理 magpie,删掉了旧的 auth.json。结果新建会话完全正常,点开前一天那个 19.4 MB 的旧会话却立刻报:
unexpected status 401 Unauthorized: 当前 Key 不正确
url: https://api.kakouai.com/responses
日志里写着 model=zyrus/gpt-6.1-sol,但请求的 URL 却还是旧站 api.kakouai.com。
查 state_5.sqlite 和会话 JSONL 才发现:model_provider 在会话创建时就被写死进了每个 thread 自己的状态里:
state_5.sqlite的threads.model_provider列存着"kakou"。- 会话 JSONL 首行的
session_meta.model_provider(1 处)和历史里每一条thread_settings_applied.thread_settings.model_provider_id(88 处)也全写着"kakou"。
把旧会话切到新站,必须停掉 ChatGPT.exe,同时更新 state_5.threads.model_provider 和 JSONL 里的这 89 处字段,并重算 thread_history_1.sqlite 里 46 个 turn 的字节偏移。
2. 模型槽位前缀残留引发的 503 GROUP_MODEL_UNAVAILABLE
第二天(10 月 23 日)从 magpie 切回 kakou 时,轮到模型名出问题了:发消息报 503 当前 kakou/gpt-6.1-sol 模型暂不可用。
用 curl 直连上游做对照:传 "model": "gpt-6.1-sol" 7 秒返回 200 OK;传 "model": "kakou/gpt-6.1-sol" 则必回 503 GROUP_MODEL_UNAVAILABLE。因为本地代理 magpie 的 catalog 用 <provider>/<model> 命名路由槽位,而远端站只认裸模型名。切回远端站时,不仅要改 model_provider,还得把 JSONL 的 turn_context、world_state 和 collaboration_mode.settings.model 里残留的 kakou/ 前缀一并剥干净。
3. paginated 历史模式下绝不能截断源 Rollout 文件
最凶险的一次在 10 月 29 日。当时会话已经涨到了约 38 万 token,为了塞进 12.8 万窗口的 deepseek-v4.1-flash,我照着 10 月 23 日做过的「按压缩摘要行折叠历史」的思路,把 sessions/2026/10/21/rollout-...jsonl 从 14.1 MB 裁到了 3.09 MB。
结果一启动 Codex,会话直接报致命错误:
invalid paginated history lineage for 01a15d45-...:
cutoff byte offset is past the source rollout
去查 state_5.sqlite 的 threads 表才发现,这个长会话在 10 月 24 日已经被 Codex 自动升级成了分页历史模式(history_mode = 'paginated'):
threads.rollout_path指向的是sessions/2026/10/24/rollout-..._01a16e53-....jsonl(16.7 MB,ordinal5446–9418),这才是当前的活动主文件。- 我刚才动手裁剪的
10/21那个文件(ordinal0–5630)已经变成了只读的源 rollout(source rollout)。 - 活动主文件首行的
session_meta.payload.history_base写着:
{
"end_ordinal_exclusive": 5446,
"end_byte_offset": 13153912
}
也就是说,在 paginated 模式下,Codex 把完整历史定义为「源文件前 13,153,912 字节 + 当前主文件的全部内容」。我把源文件裁成 3,098,816 字节后,长度小于 end_byte_offset(13.15 MB),启动校验当场判定 lineage 越界损坏。
好在动手前做了完整备份。立刻把 10/21 的源文件整份恢复回 14,144,705 字节,改为只更新 10/24 活动主文件上的 78 行结构化 model 字段并保持 history_base 不变,重启后 lineage 报错消失。
这也成了我之后动 Codex 会话文件的一条死规矩:动手前先查 SELECT history_mode, rollout_path FROM threads——只要是 paginated 模式,修改必须落在 rollout_path 指向的活动主文件上,源文件连一个字节的长度都不能截断。