构建插件

身份非官方简体中文镜像

翻译状态 AI 翻译

来源版本官方未提供

同步日期 2026-07-31

如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加 .md 来获取 URL。

要构建或提交插件，请使用完整的构建者文档，位于 developers.openai.com。

构建并提交插件

本页面提供简要介绍。插件是一个可安装的软件包可以包含技能、一个 MCP 服务器，或两者兼有。一个 MCP 服务器还可以返回可选 UI。

ChatGPT 和 Codex 共享一个通用插件目录。发布一次公共插件即可让同一个条目在两个产品的受支持界面中被发现。开发期间，请使用本地市场来测试该软件包然后再将其提交到通用目录。

当你仍在迭代某个个人工作流时，请从技能开始。当你想共享该工作流、打包相关技能、连接到外部服务，或向团队分发稳定能力时，请构建插件。

使用 `@plugin-creator` 创建插件

要最快完成设置，请使用内置 @plugin-creator 技能，在 ChatGPT Work 模式下，或 $plugin-creator 在 Codex中。

交互内容： CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。

描述预期结果、要包含的技能或 MCP 服务器，以及是否需要用于测试的本地市场条目。例如：

@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.

该技能会创建所需的 .codex-plugin/plugin.json 清单，整理插件文件夹，并可将插件添加到本地市场。

交互内容： CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。

完成后：

查看 .codex-plugin/plugin.json。
检查 skills/下的每个已打包技能。
刷新 ChatGPT 或 Codex 并从其本地市场来源安装插件。
在新对话中使用有代表性的请求测试插件。

如果插件包含 MCP 服务器，请先构建并测试该服务器，然后向 @plugin-creator 提供已注册的连接详情。请遵循完整的 MCP 服务器工作流来处理工具、身份验证、部署和测试。

手动创建仅包含技能的插件

最小插件包含一个清单和至少一项技能：

meeting-follow-up/
├── .codex-plugin/
│   └── plugin.json
└── skills/
    └── meeting-follow-up/
        └── SKILL.md

创建 .codex-plugin/plugin.json：

{
  "name": "meeting-follow-up",
  "version": "1.0.0",
  "description": "Turn meeting notes into decisions and next steps",
  "skills": "./skills/"
}

然后添加 skills/meeting-follow-up/SKILL.md：

---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---

Review the meeting notes. Return:

1. Decisions
2. Action items with owners
3. Open questions

使用 kebab case 的稳定插件名称。让技能描述足够具体以便 ChatGPT 和 Codex 识别该工作流何时适用。

使用 @plugin-creator 将该文件夹添加到本地市场，然后安装并测试后再共享。

继续阅读构建器文档

如需完整的构建者文档，请使用插件文档。它涵盖：

要浏览、安装、启用或移除插件，请参阅使用插件。

构建插件

使用 @plugin-creator 创建插件

手动创建仅包含技能的插件

继续阅读构建器文档

使用 `@plugin-creator` 创建插件