概述
工作空间管理员可以将 GitHub 上的插件市场导入工作空间目录。插件市场是一个 JSON 目录，其中列出了要导入的插件。导入后，每日同步会根据代码仓库中的更改更新插件。
插件市场同步仅导入插件内容，不会连接工作空间成员的账号，也不会授予对插件所含应用的访问权限。
有关插件及其所含应用的介绍，请参阅：ChatGPT 和 Codex 中的插件。
开始之前
请使用有权读取插件市场代码仓库及其引用的所有其他代码仓库的 GitHub 账号。支持 github.com 上的公开和私有代码仓库。
完成必要的 GitHub 组织审批，确保用于导入的账号可以访问这些代码仓库。
审查代码仓库内容。导入时会处理所有有效插件，无需逐一审批，后续同步也可能添加新插件。
新插件的初始安装策略为可用，并要求在安装时进行身份验证。新添加的插件市场默认启用每日自动同步。导入后，请检查每个插件的工作空间设置和所需应用。
导入插件市场
前往管理控制台，选择目标 ChatGPT 工作空间，然后打开插件。然后选择添加，再选择导入插件市场。
在来源中输入代码仓库 URL，例如
https://github.com/example/team-plugins。仅使用代码仓库 URL，不要使用分支或文件夹 URL。如果插件市场位于子目录中，请在路径中输入该目录。例如，对于
team-tools/.agents/plugins/marketplace.json，应输入team-tools。如果位于代码仓库根目录，请将路径留空。不要输入清单文件名。你也可以输入分支、标签或提交。留空则使用代码仓库的默认分支。使用分支可接收后续提交的更新。指定固定提交则会停留在该版本。
选择导入插件市场，并在系统提示时授权访问 GitHub。
查看导入结果，然后逐一打开已导入的插件，配置其安装策略和所需应用。
对于规模非常大的插件市场，首次导入可能需要长达 1 小时。后续的每日同步通常只需几分钟。
如果某个插件无法导入，报告会说明错误原因。其他有效插件仍可正常导入。
支持的格式
所选目录必须包含受支持的清单文件：
Codex 插件市场使用
.agents/plugins/marketplace.json。兼容 Claude 的插件市场使用
.claude-plugin/marketplace.json。没有插件市场清单时，独立的 Claude 插件使用
.claude-plugin/plugin.json。
插件市场条目可以引用同一代码仓库中的插件文件夹，或受支持的 GitHub 代码仓库来源。工作空间导入功能不支持其他 Git 托管平台及 npm 等包注册表来源。
有关支持的格式、JSON 示例和来源字段，请参阅：插件管理。
配置工作空间访问权限
GitHub 提供插件内容，工作空间设置则控制安装和身份验证。导入和同步不会应用代码仓库中的策略值，例如 AVAILABLE 或 ON_USE。请为工作空间中的每个插件配置这些设置。
在安装策略中，为每个符合条件的角色选择可用或已安装。还必须启用所需应用，成员必须有权访问所连接的服务，并完成必要的身份验证。
同步插件更新或将现有插件改为通过 GitHub 管理时，其工作空间策略会保留。导入插件不会授予应用访问权限，也不会连接成员的账号。
有关工作空间导航、应用访问权限和工作空间控制措施，请参阅：插件和应用的管理员控制、安全性与合规性。
保持插件更新
新添加的插件市场每天都会检查更新。如果不想等待自动同步，可以按以下步骤请求更新：
前往管理控制台，选择目标 ChatGPT 工作空间，然后打开插件。
打开插件市场并选择相应的插件市场。
选择立即同步。
同步可以添加插件市场中的新条目，并更新现有插件。请在合并前审查代码仓库中的更改，因为自动同步可能会直接导入新插件，无需再次执行导入操作。
查看同步结果
同步后，请查看同步状态及保存的报告。已完成 — N 个错误表示同步已结束，但部分插件未能处理。
如果现有插件的更新无效，系统会保留其上一个可用版本。其他有效更新仍可正常完成。在 GitHub 中修复报告的问题，然后选择立即同步以重试。
如果管理员界面为单独导入的插件显示了刷新选项，可使用该选项刷新此插件。刷新插件列表只会重新加载显示的列表，不会从 GitHub 同步内容。
了解移除与删除操作
从代码仓库中移除条目，不会删除已导入工作空间的副本。该插件会被标记为来源中已不存在。
在 ChatGPT 中删除插件市场，会删除从该市场导入的所有插件。不要为了重新连接 GitHub 或更改所有权而删除插件市场。
重新连接或更改 GitHub 访问权限
插件市场同步使用导入该市场的管理员的 GitHub 连接。该账号需要持续拥有对插件市场代码仓库及其引用的所有代码仓库的访问权限。
重新连接原账号
确认用于导入的 GitHub 账号仍有权访问所有必需的代码仓库。
请最初导入该插件市场的管理员在 ChatGPT 中打开 GitHub 插件，并重新连接其账号。
转交给新管理员
新的工作空间管理员可以使用自己的 GitHub 连接导入同一个插件市场：
前往管理控制台，选择目标 ChatGPT 工作空间，然后打开插件。然后选择添加 > 导入插件市场。
输入与现有插件市场相同的来源、路径和分支、标签或提交值。
选择导入插件市场，并在系统提示时授权访问 GitHub。
后续同步将使用新管理员的 GitHub 连接。新管理员的账号必须有权读取插件市场代码仓库及其引用的所有代码仓库。
将现有插件改为通过 GitHub 管理
对于以压缩包形式上传或尚未由 GitHub 来源管理的现有工作空间插件，你可以使用插件市场进行管理。现有插件必须位于同一工作空间内，且插件名称必须相同。已由其他 GitHub 来源管理的插件无法通过这种方式接管。
要在插件市场中标识现有插件，请按以下步骤操作：
前往管理控制台，选择目标 ChatGPT 工作空间，然后打开插件。打开该插件。
复制其 URL 中
/admin/plugins/后面的插件 ID。在插件市场的
plugins数组中找到对应条目，将该 ID 添加为pluginId，与name和source并列。不要将其添加到插件的plugin.json文件中。
插件会保留其 ID、共享设置和工作空间策略。GitHub 将成为后续更新的来源，因此之后上传的压缩包无法替换该插件。
有关迁移示例和要求，请参阅：插件管理。
引用现有应用
插件可以在其根目录下的 .app.json 文件中引用现有应用。文件名开头的点号不可省略，并且应使用应用 ID，而非插件 ID。对于原生插件，请将 .codex-plugin/plugin.json 中的 apps 字段设为 ./.app.json。
引用不会创建应用，也不会授予额外权限。该应用现有的工作空间访问权限、身份验证要求、操作控制和所连接服务的权限仍然适用。
有关 JSON 格式，请参阅：插件管理。
了解“仅限桌面端”标签
标记为仅限桌面端的插件无法在 ChatGPT 网页版中运行。如果导入的插件声明了 MCP 服务器，例如在 mcp.json 或 .mcp.json 中进行声明，即使服务器使用的是远程 HTTPS URL，该插件也可能被加上此标签。
仅添加 .app.json 引用并不会移除仅限桌面端标签。任何被引用的应用仍须对该成员的角色开放，且其常规访问权限和身份验证要求仍然适用。