清理废弃接口代码前须确认其已完全移除且无技能包或会话引用，否则会导致会话加载失败；需通过Codex CLI历史查询、全项目文本搜索、技能包签名追踪、AI生成标记扫描及会话快照比对定位并删除相关代码；最后重启应用、刷新上下文、验证API列表并执行purge-orphans清理孤立引用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
清理 Codex 中废弃接口对应的代码，必须先确认该接口是否已被项目完全移除、是否仍有技能包或会话上下文在引用它——直接删除源文件可能导致后续会话加载失败或技能注入异常。
确认接口是否真正废弃
打开 Codex CLI，执行 codex-history list --grep "GET /api/v1/users\|DELETE /legacy/endpoint"（将 URL 替换为你想查的接口路径）。如果返回空结果，且 grep -r "/api/v1/users" . --include="*.js" --include="*.ts" --include="*.py" 2>/dev/null 也无输出，说明该接口在当前项目中已无任何文本痕迹。
【切勿跳过这一步就删代码】。Codex 可能仍在后台缓存旧会话快照，若该接口曾被用于生成控制器模板或路由配置，残留引用会导致下次同类请求触发错误补全。
定位并清理接口相关代码片段
方法一：通过技能包签名反向追踪
运行 grep -r "CODX_AUTOGEN.*users" ~/.codex/skills/ 2>/dev/null。若命中 skills/rest-api/templates/controller.ts 类文件，说明该接口曾被技能包自动注入过逻辑，需进入对应技能目录手动检查 templates/ 和 snippets/ 子目录，删除含该接口路径的 .ts/.js 文件。
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI，等待编码任务完成，并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时，使用此功能。
方法二：扫描项目内 AI 修改标记
执行 grep -n "/// @codex-ignore\|// @codex-generated" src/api/ --include="*.ts" -r 2>/dev/null。这类注释是 Codex 插件写入的锚点，一旦发现某行紧邻 export const fetchUsers =，说明该函数由 AI 生成且未被人工重写，属于高优先级清理目标。
方法三：比对会话快照中的实际改动
用 codex-history show abc123（abc123 替换为曾讨论该接口的会话 short-id）查看 diff_summary 字段。若显示 + export function deleteUser() 但当前代码库中该函数不存在，说明该会话曾建议添加但被弃用，此时应进入 ~/.codex/sessions/abc123.jsonl 手动删掉该条 diff 记录——否则 Codex 在后续“重构”提示中仍可能复现此废弃逻辑。
验证清理结果
第一步：重启 Codex 桌面应用 → 左侧边栏点击「项目」→ 右键目标项目选择「刷新上下文」。
第二步：在任意新会话中输入 “列出本项目所有暴露的 API 端点”，观察返回结果是否还包含该废弃接口。
第三步：执行 codex-history purge-orphans 清理因本次删除而产生的孤立会话引用。
这一步操作起来很简单，直接把文件拖进去就行。
