夜雨聆风最近不少朋友在用 OpenAI Codex 桌面端时都会遇到一个很迷惑的问题：
明明别人能装的 Product Design、Data Analytics、Sales 这些角色插件，自己在插件市场里却怎么都搜不到。
很多人第一反应是：是不是我装错了？账号权限不对？客户端出 bug 了？
其实大多数情况下，不是你不会用，而是你没有把对应的插件市场源加进去。
这篇文章我一次讲清楚：
• 为什么默认市场里搜不到很多插件
• 第三方插件市场要怎么加
• 如果加完还是搜不到，该怎么排查
• Codex 常用插件市场都有哪些
如果你正卡在这里，照着下面做，基本就能解决。
一、为什么默认市场搜不到很多插件？
先说结论：Codex 插件市场支持多个来源（Marketplace Source），而默认只展示其中一部分。
很多人打开插件市场后，只看到了 OpenAI Curated / Bundled 这一类官方精选源，于是就误以为“市场里就这些插件”。
但实际上，像下面这些角色型插件，通常并不在默认源里：
• 🎨 Product Design：产品设计、Figma、原型相关
• 📊 Data Analytics：数据分析、Tableau、Snowflake 相关
• 💼 Sales & Financial Markets：销售、投研、金融市场相关
也就是说：
不是这些插件不存在，而是它们属于独立的 Role-Specific Plugins 市场源。
如果这个源没加进来，你自然搜不到。
除了市场源没加全，下面几个因素也会导致插件列表看起来“不完整”：
• 使用的是 纯 API Key 登录，而不是带完整工作区能力的登录方式
• 客户端缓存没有刷新，旧列表还停留在本地
• Codex 版本过旧，市场同步机制不完整
• 公司/团队环境下，管理员禁用了某些插件能力
所以遇到“搜不到插件”时，第一件事先别折腾重装，先检查 Marketplace Source。
二、四步添加 Role-Specific Plugins 市场源
如果你现在的插件市场里只有少量官方精选插件，可以按下面步骤操作。
第 1 步：打开插件市场
进入 Codex 后，打开左侧工具栏里的：
Plugins / 技能
在插件市场面板里，找到当前的市场来源下拉框。很多人这里默认显示的是：
OpenAI Curated
第 2 步：添加新的市场源
点击下拉框，选择：
Add More / 添加插件市场
然后在弹出的配置框里填写：
• Source / 来源
• Git 引用
• 稀疏路径
填写完成后，点击：
添加市场
第 3 步：切换到新市场
添加完成后，回到市场来源下拉框，把当前来源从默认市场切换到：
Role-Specific Plugins
这一步非常关键。
很多人其实已经加成功了，但因为顶部来源没有切换过去，结果还是在默认市场里搜索，自然继续“搜不到”。
第 4 步：重新搜索目标插件
现在你再去搜索下面这些关键词：
• Product Design
• Data Analytics
• Sales
通常就能搜到了。
找到后直接安装即可。
小提醒：安装完插件后，建议新开一个对话线程再调用插件。这样成功率更高，也更容易正确加载角色能力。
例如你可以尝试输入：
• /Prod
• /Data
三、如果还是找不到，按这个顺序排查
如果你已经加了 Role-Specific Plugins，但搜索结果还是空的，建议按下面这个顺序一项项检查。
1）确认你真的切到了正确的市场源
最常见的问题不是“没加成功”，而是：
顶部市场来源还停留在 OpenAI Curated，而不是 Role-Specific Plugins。
请先确认当前显示的来源名称。
2）清空旧关键词，重新用英文搜
搜索框有时会保留旧关键词，或者中文关键词匹配不到结果。
建议直接清空，然后用插件的英文名称去搜：
• Product Design
• Data Analytics
• Sales
3）重启 Codex 客户端
有时候新市场虽然已经添加，但前端列表没有及时刷新。
这时最简单有效的办法就是：
• 退出 Codex
• 重新打开客户端
如果还是不显示，可以进一步清理本地缓存目录（适合稍微会折腾一点的朋友）：
~/.codex/.tmp/bundled-marketplaces/
清掉缓存后再重启，常常能恢复正常显示。
4）检查网络是否能访问 GitHub 相关资源
有些市场源数据需要从 GitHub 或相关静态资源地址拉取。
如果你的网络环境无法访问：
raw.githubusercontent.com
那么就可能出现：市场能添加，但插件列表加载不全。
5）企业/团队环境下，确认管理员没有禁用
如果你用的是企业工作区版本，还要多排查一步：
看看 Workspace Admin 是否限制了该类插件。
尤其是一些角色型插件、外部集成插件，在团队环境里不一定默认开放。
四、Codex 常用插件市场来源清单
为了方便你后面排查，我把几个常见市场源整理成一份清单。
1）OpenAI Curated / Bundled
这是默认内置的官方精选市场，通常不需要手动添加。
里面常见的是：
• GitHub
• Gmail
• Chrome
• Computer Use
• Docs
• 以及一些基础官方插件
2）Role-Specific Plugins
这是很多人最容易漏掉、但又非常实用的一个来源。
它主要提供：
• Product Design
• Data Analytics
• Sales
• Investment Banking
• 其他角色导向型插件
添加地址是：
https://github.com/openai/role-specific-plugins
3）团队仓库市场（Repo）
如果你所在团队做了项目级共享插件，通常会通过仓库内文件来定义市场。
常见位置：
$REPO_ROOT/.agents/plugins/marketplace.json
适合团队内部统一分发插件能力。
4）个人市场（Personal）
如果你自己写了本地插件，或者想长期维护一套个人插件集合，常见位置是：
~/.agents/plugins/marketplace.json
这类市场更适合进阶用户做定制化扩展。
5）官方插件示例库（参考）
还有一个常被拿来参考的仓库：
https://github.com/openai/plugins
这里常能看到一些官方或示例级插件实现，比如：
• Notion
• Figma
• Slack
它不一定等于“直接可安装市场”，但很适合你了解插件能力边界和接入方式。
五、哪些插件值得优先安装？
如果你不想一上来装太多，可以先按使用场景来选。
开发类
适合开发、调试、协作场景优先装：
• GitHub
• Sentry
• Vercel
办公协作类
适合知识管理、邮件处理、团队协作：
• Gmail
• Google Drive
• Notion
系统与浏览器类
适合网页操作、文档处理、表格演示：
• Computer Use
• Chrome
• Documents
• Spreadsheets
• Presentations
角色专属类
这个是很多人真正想找的重点，但前提是你已经加了 Role-Specific 源：
• Product Design
• Data Analytics
• Sales
如果你平时是产品、数据、增长、咨询、投研这些工作流，角色插件往往比通用插件更高效。
六、一句话记住这个问题的本质
你可以把这件事理解成两层：
• API Key / 登录方式 决定你“模型怎么跑”
• Marketplace Source / 市场源 决定你“插件从哪里显示”
所以当你遇到“插件搜不到”的时候，最优先检查的不是重装，也不是换电脑，而是这句：
先看你有没有加对市场源，尤其是 Role-Specific Plugins。
很多问题，到这里就已经解决了。
最后
如果你想看更多 AI 工具实操、效率工作流、Codex / Agent / 插件玩法，欢迎关注我的公众号。
也欢迎在留言区告诉我：你最想让我下一篇拆解哪个插件或哪个使用场景。
