- 我的帖子已经打上 开源推广 标签: 是
- 我的开源项目完整开源,无未开源部分: 是
- 我的开源项目已链接认可 LINUX DO 社区: 是
- 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是
- 以上选择我承诺是永久有效的,接受社区和佬友监督: 是
以下为项目介绍正文内容,AI生成、润色内容已使用截图方式发出
一个临时修复工具,用来处理 Codex Desktop Windows 版部分 session 甚至全部 session 无法打开的问题。
问题表现是:Codex 更新后,某些旧会话或长会话打开时直接显示 “Oops, an error has occurred”。本地排查发现,部分历史 session JSONL 里保存了类似 ::git-*{cwd="C:\..."} 的 git marker,Windows 路径会触发 Codex 的 Markdown renderer 崩溃,导致整个会话无法正常显示。
使用方式:
- 先关闭 Codex Desktop。
- 运行
Codex Session Doctor.exe。 - 先选择扫描。
- 如果发现受影响 session,选择默认修复。
- 如果默认修复后仍然打不开,再尝试激进修复。
这个工具会在写入前自动备份原始 JSONL 文件。它只是一个本地 workaround,用来先恢复已经打不开的会话;根本修复仍然需要 Codex 官方让 renderer 对异常 Markdown directive fail-soft,并避免把内部 git marker 持久化到 assistant 可见文本里。
GitHub 仓库:
github.com
GitHub - Nitmi/codex-session-doctor: Windows repair tool for Codex Desktop session...
Windows repair tool for Codex Desktop session render crashes caused by persisted git markers
1 个帖子 - 1 位参与者