使用文档 | Agent Plugins Hub

快速开始

在插件市场选择综合、24 小时趋势或热门榜，使用同一榜单上方的搜索框与功能分类收窄结果。
打开目录条目，在详情页先选择目标 Agent。
核对兼容性、来源、前置条件和权限，再复制 Installation Plan。

CLI 与安装方案

Agent Plugins Hub 不是安装器。详情页会根据目标 Agent 展示经过来源标注的命令或人工步骤，你可以复制后在自己的受控环境中执行。

Hub 只展示和复制 Installation Plan，不会执行命令。

Codex marketplace 来源管理

codex plugin marketplace add owner/repo添加 GitHub marketplace 来源
codex plugin marketplace list查看 Codex 正在使用的来源
codex plugin marketplace upgrade刷新已配置的来源
codex plugin marketplace remove marketplace-name移除指定来源

Codex 命令与结构以 OpenAI 官方插件打包文档为准；具体条目的安装方式以详情页证据为准。

插件目录

Codex 插件以 manifest 提供稳定身份，并可组合 Skill、MCP Server、应用连接、Hooks 与静态资源。多生态插件可能采用不同结构，Hub 会在条目详情中分别说明。

my-plugin/
├── .codex-plugin/
│   └── plugin.json
├── skills/
│   └── my-skill/
│       └── SKILL.md
├── .app.json
├── .mcp.json
├── hooks.json
└── assets/

.codex-plugin/plugin.json: 必需的插件 manifest。
skills/: 可选的可复用工作流，每个 Skill 包含 SKILL.md。
.app.json / .mcp.json: 可选的 MCP 连接或随插件分发的 MCP Server 配置。
hooks.json / assets/: 可选的生命周期 Hooks 与图标等资源。

理解目录信息

Catalog Item

统一表示 Plugin、Skill 或 MCP Server，避免同一产物在多个渠道重复出现。

目标 Agent

详情页会列出全部已核验兼容目标；选中后显示对应兼容性和 Installation Plan。

分发渠道

记录版本、发布来源和渠道级 Usage，保留证据而不混加不同来源指标。

榜单

综合榜、趋势榜和热门榜分别显示计算规则、观察时间与数据完整性。

收录准则

来源、发布者和版本可追溯，索引展示授权明确，并有目录审核记录。
普通收录不要求 Hub 实装或完整安全审核，也不代表安全或功能保证。
来源或授权不清、已撤回或有已确认风险的条目暂停公开。
有原生依据时提供安装指引和提示词；其余条目只索引用途与来源。精选另需完整安全与真实使用证据。

安全边界

Hub 不安装、不注册，也不运行第三方插件代码。
复制前检查命令来源、适用版本、作用域、前置条件和权限摘要。
安全基线通过不等于零风险；未解决风险的条目暂停公开。安装未实测与正常账号要求分别说明。
发现来源、许可证或权限信息有误时，通过条目来源或 GitHub Issue 提交纠错。

Agent Plugins Hub 使用手册