必须先运行 codex-history doctor 验证本地数据结构兼容性，否则 purge 命令将被拒绝；再用 list 筛选目标会话，通过 purge 单条、多条或按条件删除，并以 verify 确认五处存储位置无残留引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在 CodeGeeX 中真正清空对话记录，不是点“删除”或“归档”就完事——界面上消失的对话，可能还藏在 SQLite 数据库、JSONL 会话文件、索引文件和日志里，随时可能被搜索命中或作为上下文重新载入。
先确认本地数据结构是否受支持
运行 codex-history doctor。这一步必须做，【若返回 “unsupported structure” 或明确提示版本不匹配，后续所有 purge 命令将被拒绝执行】。Codex 的本地存储格式会随版本更新变化，强行清理未知结构可能破坏会话状态或导致服务启动失败。
不安装也能检查：直接执行 npx @liuyoumi/codex-history doctor。
列出并筛选要清理的对话
默认只列出未归档的活跃会话：
执行 codex-history list。
按关键词快速定位：
执行 codex-history list --grep "Node.js deadlock"。注意：【--grep 只匹配标题、首条用户消息和预览文本，不扫描完整对话内容，也不匹配 thread id 或工作目录路径】，避免误删。
按项目路径筛选：
执行 codex-history list --cwd /Users/me/Projects/backend。路径支持片段匹配，输入项目名或子目录名即可，不用写全路径。
安全删除目标对话
第一步：删除单条对话 → 执行 codex-history purge 019e6885 → 工具会展示该会话的标题、创建时间、工作目录和首条消息 → 确认无误后，终端会要求你再次输入短 ID（如 019e6885）完成最终确认。
第二步：批量删除多条 → 执行 codex-history purge 019e6885 019e6874 019e686a → 每条都会单独展示摘要 → 每一条都需手动键入对应短 ID 完成二次确认。
第三步：按条件批量清理 → 执行 codex-history purge --archived 清理所有已归档会话；或 codex-history purge --cwd /tmp/test --grep "demo" 同时满足路径与关键词条件才触发删除。
验证清理是否彻底
执行 codex-history verify。它会扫描 ~/.codex/sessions/、archived_sessions/、state_5.sqlite、session_index.jsonl 和 logs_2.sqlite 五个位置，检查是否存在残留引用。
若输出显示 “✅ No known references found”，说明该工具支持范围内的本地数据已全部移除。
