OpenAI Plugins：包示例、便携格式与连接边界
OpenAI Plugins 分发：本地目录、安装副本与托管服务
区分插件包分发和 MCP 服务部署，理解为何修改源码目录不一定更新已安装插件。
你将学会
- 包分发不是服务托管
- 市场来源与安装副本是两个位置
- 私有共享与公开发布也要分开
开始前需要
- 了解基本 JSON 和目录路径
- 理解技能及外部服务权限
区分仓库示例与当前格式指导，检查插件包时不把元数据当作运行证明。
先看结论
- 组装插件包不会自动托管服务。
- 源码目录与安装缓存副本可能不同。
- 本地、工作区和公开分发是不同路径。
包分发不是服务托管
纯技能包可能不需要单独托管服务，带服务的插件则有两个部署问题：可安装的包，以及它连接的服务。上传清单不会部署本地 MCP 进程、创建远程端点，也不会让用户自动获得既有连接的访问权限。
Figma 示例文档将其描述为通过 .app.json 连接应用。仓库还放置了包含远程端点的 .mcp.json，但文件存在不能证明特定宿主怎样加载它，或怎样与应用映射组合。应遵循具体包的架构，不假设每个可选文件都已生效。
市场来源与安装副本是两个位置
官方打包页面说明，本地市场的来源路径相对市场根目录解析，同时描述了安装缓存副本，而非直接从创作目录执行。因此，修改源文件后可能需要走文档中的刷新或重启流程，已安装副本才会反映新内容。
看不到更新时，先记录市场身份、来源路径、包版本和实际安装内容，确认宿主究竟在使用哪一份，再继续改文件。不要把删除整个缓存目录当作第一步诊断，附近可能还有其他插件和用户拥有的状态。
私有共享与公开发布也要分开
官方页面区分本地测试、工作区发布和统一公开目录。发布到工作区需要相应管理员身份，内容仍留在该工作区边界内。公开提交有独立审核流程；仓库提交或本地市场条目本身，不会自动生成公开插件商店记录。
若要公开提交带服务插件，应在包组装之外独立核对当时端点与审核要求，不要把密钥写入清单，并为包和服务版本分别准备回滚方案。本系列没有执行安装、工作区发布、公开提交或服务器部署。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
确认插件是否需要独立服务。
- 2
记录市场来源和安装包身份。
- 3
诊断更新缺失前先验证刷新行为。
- 4
按目标读者准备发布及回滚。
可复制示例
{
"部署检查示例": true,
"包版本": "明确记录",
"已核对安装副本": false,
"需要服务": "取决于具体插件",
"已公开提交": false,
"已准备回滚": false
}常见问题
为什么改了源文件，插件没有变化？
文档中的本地流程使用安装副本，需要核对来源、版本和刷新步骤。
Git 提交等于公开发布插件吗？
不等于。公开目录提交是另一套流程。
资料来源
- OpenAI Plugins / plugins/figma/README.md来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/.app.json来源核查 2026-09-14
- OpenAI Plugins / plugins/figma/.mcp.json来源核查 2026-09-14
- OpenAI — Package your plugin (checked 2026-09-14)来源核查 2026-09-14