Agent Skills
返回列表
🔒

Codex 项目对话恢复

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2a52e6b3/recover-codex-project-chats。

技能介绍

问题背景

Codex Desktop(或共用 Codex 运行时的 ChatGPT Desktop)里,项目列表里看不到对话、线程挂在错误项目下、或 cwd 与真实仓库路径不一致,往往来自 Provider 元数据不一致、.codex-global-state.json 里 thread-project-assignments 丢失、工作目录整体迁移,或 state_5.sqlite 与 WAL/SHM、rollout JSONL 等状态不同步。盲目整包替换 ~/.codex 很容易抹掉唯一一份仍可恢复的会话数据。

技能如何工作

本技能给出一套 只读诊断 → 分类证据 → 完整备份 → 停进程后定点修复 → 验证与复盘 的流程,核心脚本为 scripts/codex_project_recovery.sh(diagnose / repair-provider / verify),并对照 references/incident-patterns.md 里的已知故障模式再动数据。

典型修复路径包括:

  • Provider 不匹配:仅在两套名称指向同一兼容后端时,才执行 repair-provider。
  • 分配缺失:根据真实 thread ID 与 cwd 重建 thread-project-assignments,保留已有映射,并显式处理根目录重叠与临时目录。
  • 路径迁移:先建立旧 cwd 到当前项目的映射表,再改 assignment 或元数据。
  • 库表缺行:在 PRAGMA integrity_check 与副本试跑通过后,才从 schema 兼容 的备份合并。

操作前要求 Codex 完全退出(无 app-server、renderer、service 进程);禁止直接编辑在线 SQLite;将 state_5.sqlite、rollout、全局状态与项目元数据视为同一恢复集合。

适用边界与注意点

面向 macOS,依赖 Zsh、SQLite 3、jq、ripgrep、rsync、Perl;可选 CSV 快照或 ~/.codex 备份作对照。不确定 Provider 兼容性时,优先恢复原始 Provider 配置,而不是为了「显示出来」随意改元数据。修复前备份需保留到你能在 UI 中打开代表性对话并确认项目可见性为止。

使用场景

  • 升级或切换模型 Provider 后,侧边栏项目仍在但对话线程从列表中消失,需要先跑 diagnose 再决定是否 repair-provider
  • 仓库从旧路径整块迁到新目录后,Codex 仍用旧 cwd,需要建立路径映射再改 thread-project-assignments
  • .codex-global-state.json 中线程与项目对应关系缺失,需按真实 thread ID 与 cwd 重建且保留已有分配
  • 怀疑 state_5.sqlite 缺行或损坏,手上有 schema 兼容的 ~/.codex 备份,要在副本上做 integrity_check 后再合并

适合人员

  • 长期在 macOS 上用 Codex Desktop 写代码、项目级对话突然不可见、又不敢整包覆盖 ~/.codex 的工程师
  • 负责团队开发机或共享 Mac、需要按 incident-patterns 归类故障并留下备份路径与 CSV 证据的 IT 运维
  • 本地路径重构或 monorepo 迁盘后,要核对 SQLite 与全局 JSON 状态一致性的个人维护者
  • 曾手工改过 Codex 状态文件、现在要在停进程前提下做 verify 并输出未恢复 thread ID 清单的排障者