GitHub 趋势 · 第 32 期

你在 Codex 里装的插件,都出自这个 6,378 star 的仓库

#Agent工具#插件生态#官方仓库

我的判断:这个仓库一行「功能」都没有,但它决定了你在 Codex 里能看到、能装到哪些插件。它不是工具,是一份目录。README 第一句就把定位说得很直白——"a curated collection of Codex plugin examples",Codex 插件示例的精选集合。你在客户端里看到的那个可安装清单,源头就是它里面的 .agents/plugins/marketplace.json。所以这一期不聊「怎么用」,聊的是一个更少被讨论的问题:当你的编码 Agent 开始有「应用商店」,这个商店的货架是谁摆的、货是从哪进的。

痛点场景:过去一年,我们这一系列写过不少 Agent 技能与插件——从 archify 到 superpowers,从 vercel-labs/skills 到 NVIDIA 的 SkillSpector。共同点是:装之前你总得自己判断「这东西靠不靠谱」。

但官方插件市场的出现,把判断方式变了。清单里躺着一百多个名字,看起来都是「官方的」——可它到底是官方自己写的代码,还是把第三方的包搬进了自己的仓库?装上去之后,代码是谁在维护、什么时候同步、同步的是哪个版本?这些问题在 UI 上通常只呈现为一行名字和一个「安装」按钮。而答案,恰好都写在这个仓库的提交记录里。

项目是什么

openai/plugins,仓库简介只有三个词:OpenAI Plugins。它 2026 年 3 月建仓时只有一句 placeholder README,6 月补上正式内容,最近一次提交在 2026-09-08。总 star 6,378、fork 837,本周新增 +753。

按 README 的约定,每个插件住在 plugins/<name>/ 下,必须带一个 .codex-plugin/plugin.json 清单,可选附带 skills/.app.json.mcp.json,以及插件级的 agents/commands/hooks.jsonassets/。市场清单分两份:默认那份给普通用户,另一份 api_marketplace.json 面向 API key 登录的用户。

清单文件自己的描述是 name: openai-curated,displayName: Codex official。也就是说,你在 Codex 里看到的那个「官方」标签,指的就是这份 curated 清单——它是一份人工维护的收录名单,不是自动同步的镜像。

核心能力:把清单拆开看

我把默认市场清单拉下来数了一遍,一共 65 个插件条目,落在 10 个分类里。分布很不平均:

分类条目数代表条目
Developer Tools27github、vercel、cloudflare、sentry、supabase、datadog、expo、coderabbit、temporal
Productivity12linear、notion、google-calendar、airtable、dropbox、clickup
Creativity9figma、canva、adobe、remotion、hyperframes、higgsfield
Communication5gmail、slack、teams、outlook-email、zoom
Education & Research4zotero、consensus、life-science-research、ngs-analysis
Data & Analytics3posthog、mixpanel-headless、data-analytics
Finance2stripe、public-equity-investing
Security / Business & Operations / Scientific Research各 1codex-security、shopify、boltz-api-cli

除了数量,有三个细节值得单独拎出来:

README 另外点名了几个「内容更丰富」的示例:plugins/figma(use_figma、Code to Canvas、Code Connect、设计系统规则)、plugins/notion(规划、研究、会议、知识沉淀)、plugins/build-ios-apps / build-macos-apps / build-web-apps(写 App 的全流程)、plugins/expo,以及 netlify、remotion、google-slides。

上手:这个仓库没有「安装命令」

这句话得说在前头,免得你 clone 下来发现不知道干什么。它不是给你 pip install 的东西,它是给客户端读的目录。README 里没有任何安装章节,唯一算得上「用法」的是两段约定——一是插件目录长什么样,二是市场清单放在哪:

# 一个插件包的结构(取自 README 原文)
plugins/<name>/
  .codex-plugin/plugin.json   # 必需:插件清单
  skills/                     # 可选
  .app.json                   # 可选
  .mcp.json                   # 可选
  agents/  commands/  hooks.json  assets/   # 可选,插件级

# 两份市场清单(取自 README 原文)
.agents/plugins/marketplace.json       # 默认市场,指向 ./plugins
.agents/plugins/api_marketplace.json   # API key 登录用户

如果你是想「自己写一个插件」的开发者,那这套结构就是你要对齐的规范:写一个 .codex-plugin/plugin.json,把能力拆进 skills/commands/hooks.json,需要外部服务就加 .mcp.json。真想让插件出现在官方清单里,从前面的提交记录看,走的是 PR 审核制——仓库里那些「新增某插件到 curated marketplace」的提交,就是这条路。

我的判断

适合谁:正在给 Codex 写插件或 skill、想知道「官方认的结构长什么样」的开发者——这仓库就是那份事实规范,比任何二手教程都准;做企业采购或工具选型、需要说清「我们装的这个插件是谁在维护」的人;以及单纯想看看大厂怎么摆 Agent 应用商店货架的人。它信息密度不低,只是信息都在目录结构和 JSON 里,不在 README 的正文里。

不适合谁:想找一个开箱即用的工具来试的人——这里没有可运行的程序,装上也不会多出任何功能;以及指望它当「官方背书」来判断插件质量的人,原因见下面第一条坑。

几个坑(全部能从仓库的 README 与提交记录里读到原文):

  • 「收录」不等于「官方自研」,也不等于「代码干净」。README 自己的措辞是 examples(示例),清单名是 curated(精选)。提交 #390 的说明里写明:50 个精选插件中,Public Equity Investing 的测试套件有 30 个既有失败("The complete 204-test Public Equity suite has 30 existing failures"),官方核实后确认这些失败在上游未修改的发行版里同样存在。收录是分发动作,不是质量认证。
  • 大部分第三方插件的代码,是被「搬」进这个仓库的。同样来自 #390:这批插件是从各自的 release 下载后提交进来的("Eight bundles were downloaded from their current releases"),每个插件包含完整 bundle、.app.json 与插件清单。好消息是供应链收敛在一处、官方做过审计(提交里提到扫描了 869 个文本文件找凭据与私钥模式、编译了 166 个 Python 文件);代价是你拿到的版本取决于官方同步节奏,不是上游最新
  • 反而那三个不在仓库里的条目,是「活」的。Qodo 那条在收录说明里明确写了 follows the upstream default branch without a pinned ref——不钉版本、跟上游默认分支。CrowdStrike 两条直接指 GitHub 仓库地址,同理。这类条目的内容随时可能变,装的时候心里要有数:版本锁定在「仓库内条目」上是明确的,在「仓库外条目」上是没有的。
  • 给 API key 用户的那份市场清单,仓库自己注明还没生效。提交 #333 的原文是 "note this doesn't take effect yet, we still need to wire up the plugins sync"。也就是说,api_marketplace.json 文件已经进仓库了,但同步链路还没接上——如果你是走 API key 登录的,别拿这份清单的条目数去对你在客户端里实际看到的东西。
  • 仓库根目录没有 LICENSE 文件(文件树就 .agentsplugins.gitignoreREADME.md 四项)。这在意料之中——它是目录不是代码,各个插件的许可以各自上游为准。但如果你要把某个插件的代码copy进自己的项目,得回去看那个插件原始仓库的许可,别拿「它在官方仓库里」当授权依据。
  • 别把它和别家的市场搞混。这一期只看 Codex 的目录;Claude 生态有自己的插件市场(含官方与社区两条线),Cursor 也有自己的插件规范仓库,两边都是独立维护、收录标准不同。

仓库:github.com/openai/plugins

总 star:6,378(截至 2026-09-11,本周 +753);fork 837;主语言 JavaScript

许可证:仓库根目录未提供 LICENSE 文件;各插件许可以其上游仓库为准

清单规模:65 个插件条目 / 10 个分类(62 个仓库内条目 + 2 个 url 源 + 1 个 git-subdir 源)

活跃度:最近提交 2026-09-08;最近一次较大变更 #392(Add Qodo to curated marketplaces)

数据来源:GitHub Trending 官方页面 + 仓库 README / 文件树 / .agents/plugins/marketplace.json / 提交记录 #390、#392、#333

抓取时间:2026-09-11 05:40(GMT+8)

想问一句:你的团队在 Codex、Claude Code 这类工具里装插件,是有审核流程,还是看到名字顺眼就装?装完之后,有没有人真的去对过「仓库里这份代码」和「上游最新版」差了多远。评论区聊聊你们的做法。

下期预告:这一期聊了 OpenAI 的插件目录,下一期想把镜头转到另一家——cursor/plugins(7,365 star,本月 +4,683),Cursor 的插件规范与官方插件仓库,正好可以做一次跨平台对照:两家的市场是怎么组织的、收录标准差在哪、同一个 skill 迁过去要不要改。若核实后内容不够撑一期,就换月榜上的 volcengine/OpenViking(36,493 star,本月 +8,284)。

#Agent工具#插件生态#官方仓库