Codex更新致插件失效？让AI自动排查修复

背景

近期，Codex 的 Windows 桌面版进行了更新，部分用户反馈在更新后遇到了 Chrome 插件和 Computer Use 插件突然消失或无法使用的情况。在 LINUX DO 社区的 AI 板块中，有用户分享了这一问题的排查与修复经验。

值得注意的是，许多用户最初倾向于将此类问题归咎于社区中常见的 node_repl 权限问题或 Windows Sandbox 配置错误。然而，通过实际排查发现，该特定案例的根因并非权限或沙箱配置，而是插件市场源（Marketplace）异常以及插件缓存路径指向错误。作者通过让 Codex 自身读取本地配置、检查插件缓存并自动修复，成功恢复了插件功能，避免了重装软件或手动复杂修改配置的需要。

核心内容

问题现象与初步排查

用户在更新 Codex Windows 版后，发现原本可用的 Chrome 插件和 Computer Use 插件在界面中消失。起初，用户怀疑是社区讨论中常见的 node_repl 或 Windows Sandbox 权限问题，但通过让 Codex 自主排查，确认了并非此类根因。

实际根因分析

经过深入检查，发现导致插件不可用的具体技术原因如下：

1. 插件市场源异常：openai-bundled 插件市场源出现配置错误。
2. 缓存路径指向错误：chrome/latest 指向了一个不完整的临时目录（如 ~/.codex/.tmp），而非稳定的插件资源目录。
3. 配置与状态不一致：虽然 Codex 的配置文件中仍启用了 Chrome 和 Computer Use，但由于底层资源缺失，导致界面无法加载插件。

自动化修复流程

作者并未选择手动重装或复杂调试，而是利用 Codex 自身的系统管理能力进行修复。Codex 执行了以下操作：

• 检查本机配置、插件缓存及 Marketplace 状态。
• 备份关键配置文件。
• 自动修正错误的插件指向和缓存链接。
• 重启 Codex 后，Chrome 和 Computer Use 插件恢复正常。

标准化排查提示词

为了帮助其他用户解决类似问题，作者提供了两套详细的提示词（Prompt），指导 Codex 进行“桌面版 Codex 插件分层健康检查”。

提示词 1 侧重于基础排查：

• 备份：~/.codex/config.toml、~/.codex/.codex-global-state.json、chrome-native-hosts.json 等。
• 验证：运行 codex plugin marketplace list 和 codex plugin list，确认 openai-bundled 存在，且 chrome@openai-bundled 和 computer-use@openai-bundled 处于 installed 和 enabled 状态。
• 完整性检查：确认 ~/.codex/plugins/cache/openai-bundled/chrome/latest 指向完整目录，且存在 scripts/browser-client.mjs 等关键文件。
• 组件检查：验证 Chrome native host、Codex Chrome Extension 及 Computer Use runtime 状态。
• 权限判断：仅在出现 os error 740（请求的操作需要提升）时，才考虑修改 [windows] sandbox = "unelevated"，避免盲目修改。

提示词 2 侧重于深度诊断与路径修正：

• 执行路径：避免使用 PATH 中的 codex，而是从 config.toml 的 CODEX_CLI_PATH 或桌面版安装目录调用 codex.exe。
• 路径修正：重点检查 openai-bundled 是否错误指向临时目录，若是，需改回桌面版 resources/plugins/openai-bundled。
• 文件完整性：检查 chrome/latest 目录是否存在，是否包含 scripts/browser-client.mjs 和 extension-host.exe。
• 运行时检查：检查 Chrome native host manifest、扩展安装状态、Computer Use 文件完整性、系统管道（pipe）状态及 Node runtime 的 nativePipe 暴露情况。
• 错误代码区分：
  • os error 740：考虑 Sandbox 权限修改。
  • os error 2/5：优先排查管道缺失、路径失效、文件占用或 Marketplace 异常。
• 输出格式：最后生成包含现象、证据、根因、修改文件、验证命令和结果的表格。

额外案例：Codex 的自我修复能力

作者还分享了一个极端案例：当 Windows Store 损坏导致无法通过常规渠道更新 Codex 时，用户让 Codex 自身强行更新版本并修复了 Windows Store。这体现了 Codex 在系统级任务中的强大自主修复能力。

关键要点

• 根因多样性：插件消失不一定都是 Sandbox 或权限问题，需警惕插件市场源（Marketplace）和缓存路径（Cache Path）的配置错误。
• 自动化排查优势：利用 Codex 自身的 CLI 能力（如 plugin list、marketplace list）比手动查找文件更高效、准确。
• 关键配置文件：
  • ~/.codex/config.toml：主配置文件。
  • ~/.codex/.codex-global-state.json：全局状态文件。
  • ~/.codex/chrome-native-hosts.json：Chrome 原生主机配置。
• 关键目录与文件：
  • ~/.codex/plugins/cache/openai-bundled/chrome/latest：需确保指向完整目录。
  • scripts/browser-client.mjs：Chrome 插件核心脚本。
  • extension-host.exe：扩展宿主进程。
  • resources/plugins/openai-bundled：桌面版正确的插件资源路径。
• 错误代码指引：
  • os error 740：关联 Windows 权限提升问题，可能与 Sandbox 配置有关。
  • os error 2/5：关联文件未找到、权限拒绝或路径失效，需优先检查文件完整性和路径指向。
• 操作顺序：始终遵循“备份 -> 检查 -> 诊断 -> 修复 -> 验证”的流程，避免数据丢失。

意义与影响

1. 降低用户维护门槛：通过提供结构化的提示词，普通用户无需深入理解 Codex 的内部架构，即可借助 AI 代理完成复杂的系统级故障排查和修复。
2. 揭示潜在的配置陷阱：此次事件暴露了桌面版应用在更新后可能出现的插件路径解析错误，为后续版本优化提供了参考，提示开发者需更严格地处理插件缓存和 Marketplace 的兼容性。
3. 强化 AI 代理的系统管理能力：案例证明，Codex 不仅能处理代码生成，还能有效管理系统配置、文件结构和运行时环境，展示了 AI 助手在 DevOps 和桌面运维领域的巨大潜力。
4. 社区知识沉淀：LINUX DO 社区用户分享的详细排查步骤和提示词，为其他遇到类似问题的用户提供了宝贵的参考，促进了社区内的技术互助和问题解决效率。