先判断卡在哪一层
- 文件层：插件目录是否完整，入口文件是否存在。
- 登记层：marketplace manifest（插件市场清单）是否有效并包含该插件。
- 启用层：插件总开关和单项 skill（技能）开关是否开启。
- 运行层：应用重启后，真实工具调用是否成功。
风险提示不要先删除整个插件缓存或用户配置。先备份相关目录，否则可能一起丢失其他插件状态。
推荐排查顺序
- 在 Codex 的插件或技能列表确认状态，记录是“完全不存在”还是“已安装但未加载”。
- 检查市场清单文件是否是合法 JSON（结构化数据），编码应为 UTF-8 且尽量无 BOM（字节顺序标记）。
- 确认插件和它包含的技能都已启用。只开总开关可能不够。
- 完全退出并重新打开 Codex，避免旧进程继续使用缓存清单。
- 不要只看列表。调用一个只读工具，确认插件真的返回结果。
成功标志
- 插件能在列表中出现且状态为启用。
- 插件暴露的技能或工具可见。
- 一次真实只读调用成功返回，而不只是身份接口成功。
仍然不显示怎么办
保存插件列表、市场清单报错和应用版本，不要发送 Token（令牌）或密码。可通过咨询表单提交这些脱敏信息。