kita / notes
← 回到全部笔记

事件日期 阅读约 3 分钟

Codex 会话级 Provider 绑定与 Paginated 历史截断报错的修复铁律

发布于

本文目录(3 节)
  1. 1. Provider 是会话级(Thread-level)持久化的,改全局配置只管新会话
  2. 2. 模型槽位前缀残留引发的 503 GROUP_MODEL_UNAVAILABLE
  3. 3. paginated 历史模式下绝不能截断源 Rollout 文件

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,ordinal 5446–9418),这才是当前的活动主文件。
  • 我刚才动手裁剪的 10/21 那个文件(ordinal 0–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 指向的活动主文件上,源文件连一个字节的长度都不能截断。

← 返回全部手记