Codex插件老是“丢”？CCSwitch路由模式下插件失踪的排查与解决

最近在折腾开发环境的时候，遇到一个非常让人头秃的问题：

插件安装后莫名消失，令人头秃

明明在 Codex 桌面端里老老实实安装好了 Superpowers 插件，结果过段时间一看，它居然“离家出走”了！我这一天里反反复复装了四次，心态都要崩了。

如果你的环境里也用了 CCSwitch + 路由模式，并且碰到了类似的插件安装后失效、重启后消失的怪象，那不妨跟着我一起排查一下，看看问题到底出在哪儿，以及怎么彻底根治。

一、 为什么插件会“自动消失”？

这种“幽灵般”的失踪案，通常不是因为插件本身坏了，而是因为它“住”的地方出了问题。在 CCSwitch 开启路由模式的场景下，大多数情况都逃不开以下三个原因：

1. 目录映射是“临时工”

路由模式的核心在于路径重定向。很多时候，我们配置的映射目录是在内存或者临时文件系统中的。这就好比你把东西存在了酒店的“临时寄存柜”里，一旦服务重启、容器重建，或者仅仅是清理了一次缓存，这个“寄存柜”就被清空了。

确保 CCSwitch 路由模式下的映射路径配置正确且持久化

表现： 插件安装当时能用，一旦退出客户端或重启电脑，插件就没了。

2. 权限不足被“无情驱逐”

Codex 桌面端在安装插件时，需要向特定的目录写入文件。如果因为 CCSwitch 的设置问题，导致 Codex 进程对该目录没有“写入权限”或“持久化保留权限”，系统可能会在写入成功后的某个时刻（比如同步检查时）判定这些文件为“非法入侵”并直接删除。

表现： 安装过程看似没有报错，但刷新或重启后文件凭空蒸发。

3. 缓存清理机制的“误伤”

很多优化工具或 Switch 类软件为了保持轻量，内置了自动清理临时文件的机制。如果你的插件安装路径正好被判定为“缓存路径”，那么在触发清理机制（比如达到一定时间阈值或存储空间预警）时，插件就会作为“垃圾文件”被无辜清理掉。

二、 实操排查与解决方案

既然知道了病因，咱们就得对症下药。不用慌，按下面的步骤一步步来，大概率能救回来。

第一步：锁定安装目录

别再盲目地点击“安装”了。首先，你需要搞清楚 Codex 到底把插件扔到了哪个文件夹里。

• 打开 Codex 的设置面板，查看插件目录的默认路径。
• 在电脑上实际访问这个路径，看看安装后的文件是否真实存在。

注意： 如果你发现文件根本没有写进去，或者写在了一个非常深的临时路径下，那就是目录映射配置错了。

第二步：修改映射路径为“永久驻地”

这是解决问题的关键一步。

1. 关闭 CCSwitch 的路由功能（临时）： 先断开干扰，直接在本地环境测试插件是否能稳定留存。
2. 自定义插件目录： 不要让它使用默认路径。在你的本地磁盘（非系统盘为佳）创建一个专门的文件夹，比如 D:\DevTools\CodexPlugins。
3. 重新配置 CCSwitch： 进入路由模式设置，将 Codex 的插件请求路径，强制映射到你刚刚创建的物理路径上。确保这个映射规则是“持久化”的，而不是仅对当前会话有效。

第三步：检查文件权限

光有路径还不够，得给它“房产证”。

• 右键点击那个存放插件的文件夹 -> 属性 -> 安全。
• 确保 Codex 的运行用户身份（通常是当前登录用户）拥有“完全控制”的权限。
• 如果是在 Linux 或 macOS 环境下，可能需要通过 chmod 或 chown 命令确保该目录对于运行 Codex 的用户是可写的。

第四步：排除清理干扰

如果你使用了系统清理软件（如 CCleaner 等）或者是 CCSwitch 自带了加速清理功能，请务必检查“白名单”设置。

• 将你的插件自定义目录加入“忽略列表”或“排除列表”。
• 防止那些“为了你好”的清理工具把你辛辛苦苦装好的工具给扫走了。

总结

出现 Codex 插件安装后反复消失的情况，多半是 CCSwitch 路由模式下的映射路径不稳定 或者 权限/缓存机制冲突 导致的。

不要无止境地反复安装，那只是在治标不治本。把路径拿出来，挂载到本地物理盘上，给它写满权限，并告诉清理工具“别动它”，你的 Superpowers 就能稳定地待在家里听候差遣了。

希望这篇排查笔记能帮到同样踩坑的朋友，如果大家有更具体的配置参数或者其他奇葩原因，欢迎在评论区补充！