跳到主要内容

本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/plugins

Plugins

在 Codex 中使用插件,以添加可复用的工作流、skills 和应用集成

概述

插件将 skills、应用集成和 MCP servers 打包为可在 Codex 中复用的工作流。

扩展 Codex 的能力,例如:

  • 安装 Gmail 插件,让 Codex 读取和管理 Gmail。
  • 安装 Google Drive 插件,以便在 Drive、Docs、Sheets 和 Slides 之间协同工作。
  • 安装 Slack 插件来总结频道内容或起草回复。

一个插件可以包含:

  • Skills: 针对特定类型工作的可复用指令。Codex 可以在需要时加载它们,以便在任务中遵循正确步骤,并使用正确的参考资料或辅助脚本。
  • Apps: 与 GitHub、Slack 或 Google Drive 等工具的连接,使 Codex 能够从这些工具中读取信息并在其中执行操作。
  • MCP servers: 为 Codex 提供对额外工具或共享信息的访问,通常来自本地项目之外的系统。

更多插件能力即将推出。

使用和安装插件

Codex 应用中的插件目录

在 Codex 应用中打开 Plugins,浏览并安装精选插件。

Codex Plugins page

CLI 中的插件目录

在 Codex CLI 中,运行以下命令以打开插件列表:

codex
/plugins

Codex CLI 中的插件列表

CLI 插件浏览器会按 marketplace 对插件进行分组。使用 marketplace 标签页切换来源,打开某个插件以查看详细信息,安装或卸载 marketplace 条目,并在已安装插件上按 Space 切换其启用状态。

安装并使用插件

打开插件目录后:

  1. 搜索或浏览一个插件,然后打开其详情。
  2. 选择安装按钮。在应用中,选择加号按钮或 Add to Codex。在 CLI 中,选择 Install plugin
  3. 如果插件需要外部应用,请在提示时进行连接。有些插件会在安装期间要求你进行身份验证。另一些则会等到你第一次使用它们时再提示。
  4. 安装完成后,开启一个新线程并请求 Codex 使用该插件。

安装插件后,你可以直接在提示窗口中使用它:

Codex Plugins page

直接描述任务

说明你想要的结果,例如“总结今天未读的 Gmail 线程”或“从 Google Drive 拉取最新的发布说明”。

当你希望 Codex 为任务选择合适的已安装工具时,请使用这种方式。

选择特定插件

输入 @ 以显式调用该插件或其打包的某个 skill。

当你想明确指定 Codex 应使用哪个插件或 skill 时,请使用这种方式。参见 Codex 应用命令和 Skills。

权限和数据共享的工作方式

安装插件会使其工作流在 Codex 中可用,但你现有的审批设置仍然适用。任何已连接的外部服务仍受其自身的身份验证、隐私和数据共享政策约束。

  • 打包的 skills 会在你安装插件后立即可用。
  • 如果插件包含 apps,Codex 可能会在设置期间或你首次使用它们时提示你在 ChatGPT 中安装这些 apps 或登录。
  • 如果插件包含 MCP servers,在你使用它们之前,可能需要额外设置或身份验证。
  • 当 Codex 通过打包的 app 发送数据时,该 app 的条款和隐私政策适用。

移除或关闭插件

要移除插件,请从插件浏览器中重新打开它并选择 Uninstall plugin

卸载插件会从 Codex 中移除该插件包,但打包的 apps 会继续保持已安装状态,直到你在 ChatGPT 中管理它们。

如果你想保留插件已安装但将其关闭,请在 ~/.codex/config.toml 中将其条目设置为 enabled = false,然后重启 Codex:

[plugins."gmail@openai-curated"]
enabled = false

构建你自己的插件

如果你想创建、测试或分发自己的插件,请参见构建插件。该页面涵盖本地脚手架、手动 marketplace 设置、插件清单以及打包指南。