必须主动清理Codex中已下线功能的残留代码，包括本地插件目录、历史快照及会话上下文，否则将导致进程崩溃或静默丢弃请求；确认下线需查官方Changelog与GitHub主分支，清理推荐用codex-cli plugin uninstall，历史快照需编辑并重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Codex 项目中发现某些功能代码仍保留在本地文件、插件目录或历史快照里，但对应的功能早已从官方版本下线（比如被标记为 deprecated、移入 archive 分支、或在 v6.0+ 中彻底删除），这些残留代码可能干扰新功能调用、触发废弃 API 报错，甚至被 codex-history 自动索引进会话上下文——必须主动清理。
确认功能是否真正下线
打开 Codex 官方 Changelog 页面（https://docs.codex.dev/changelog），定位到你怀疑已下线功能的名称（如 “auto-shell-exec”、“legacy-webview-proxy”），搜索其最后一次出现的版本号。若最新稳定版（v6.1.3）未提及该功能，且 GitHub 仓库主分支中已删除对应 /src/plugins/xxx 或 /skills/xxx 目录，则确认下线。
切勿仅凭 UI 界面消失就判定下线——Codex 的「隐藏」和「下线」是两回事。UI 隐藏可能只是配置开关关闭，而下线意味着核心逻辑已被移除，残留代码继续运行将导致 【进程崩溃或静默丢弃请求】。
清理本地插件目录中的废弃功能代码
方法一：按插件名精准删除
进入 ~/.codex/plugins/ 目录 → 找到与下线功能同名的子目录（如 legacy-ssh-tunnel）→ 直接删除整个文件夹。
方法二：用 codex-cli 扫描并卸载（推荐）
在终端执行：codex-cli plugin list --deprecated → 查看输出中带 DEPRECATED 标记的插件名 → 对每个插件执行：codex-cli plugin uninstall [插件名]。
这一步会同步清除插件注册表项、禁用其加载器钩子，并从 session_index.jsonl 中剥离所有关联会话引用。手动删目录只清文件，不清理元数据，【下次启动 Codex 时可能触发自动重装或报 MissingPluginError】。
从历史会话快照中剥离废弃功能调用痕迹
第一步：定位含废弃功能调用的会话
通过 codex-reset-radar.pages.dev 监控 Codex 使用重置窗口。轮询 current.json，检测窗口开启/关闭、预测等级变化以及概率跳变。
运行：codex-history list --grep "legacy-ssh-tunnel\|auto-shell-exec" → 获取匹配会话的短 ID 列表（如 018a3f2c、019e6885）。
第二步：检查快照内容是否真含执行逻辑
对每个短 ID，执行：codex-history show 018a3f2c | grep -A5 -B5 "shell_exec\|tunnel_start" → 若返回非空结果，说明该会话快照中实际调用了已下线功能。
第三步：选择性净化快照
使用 codex++ 启动 Web UI（http://127.0.0.1:8765）→ 进入「会话管理」→ 找到目标会话 → 点击「编辑快照」→ 删除所有含 legacy-* 调用的 message block 或 tool_call 记录 → 保存。此操作不会删除会话本身，仅清除其中不可执行的废弃指令段。
第四步：强制刷新索引缓存
关闭 Codex 主程序 → 在终端执行：codex-history rebuild-index → 等待完成提示后重启 Codex。
