要精准删除codex本地历史中某条特定会话，必须使用codex-history list输出的8位短id执行codex-history purge命令，该命令会安全清除会话的五类关联数据并支持交互确认或脚本跳过，最后通过list、verify和客户端搜索三步验证彻底清除。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想从 Codex 本地历史中精准删除某一条特定会话，而不是清空全部或误删归档状态，必须绕过 UI 的“归档即删除”错觉，直击底层多点存储结构。
确认目标会话短 ID
打开终端，运行：codex-history list。输出中每条记录开头的 8 位十六进制字符串（如 019e6885）就是该会话的短 ID——这是唯一能被 purge 命令识别的安全标识符。
若列表过长，可用关键词筛选：codex-history list --grep "React Router"。注意：grep 匹配标题、首条用户消息和预览文本，不搜归档目录里的文件名。
【短 ID 必须来自 list 输出，不可手输或从文件名猜测】。手动拼写错误或复制了完整 UUID（如 019e6885-3a2b-4c1d-8e9f-0a1b2c3d4e5f）会导致命令静默失败，无任何提示。
执行单条安全删除
方法一：交互式确认（推荐新手）
运行：codex-history purge 019e6885。工具会立即展示该会话的标题、路径、时间戳和关联文件清单，然后暂停并等待你输入短 ID 二次确认。这一步防止误操作波及其他会话。
方法二：跳过确认（脚本场景）
加 --yes 参数：codex-history purge 019e6885 --yes。仅当批量清理且已人工核对过 list 输出时使用。
删除过程自动处理五类关联项：session transcript（rollout-*.jsonl）、SQLite 中的 thread 记录、索引文件（session_index.jsonl）、shell 快照（shell_snapshots/ 对应条目）、生成图像缓存（generated_images/ 中关联哈希）。任一环节缺失都会在最后 verify 阶段报出。
验证是否真正清除
第一步：重新运行 codex-history list，确认目标短 ID 不再出现。
第二步：强制触发一次扫描验证：codex-history verify。它会遍历所有受支持的本地存储位置，检查是否存在残留引用。如果返回 No orphaned data found，说明该会话在硬盘上已无痕迹。
第三步：打开 Codex 桌面客户端，搜索该会话标题或关键词。若仍可搜到，说明你删的是归档目录里的副本，而主数据库中的 archived = 1 记录未同步清理——此时需改用 codex-history purge --archived 批量处理归档会话，或先用 codex-history list --archived 确认其短 ID 再单独 purge。
