插件 UI 兼容性 API 和 ChatGPT 扩展程序的最新更新。
August 2026
-
稳定的 OAuth 回调地址和 CIMD 客户端 ID
修复与改进
ChatGPT 应用可以使用稳定的 OAuth 回调地址 https://chatgpt.com/connector_platform_oauth_redirect,前提是应用的受保护资源和 OAuth 元数据均指向同一授权服务器,且该服务器支持 RFC 9207 定义的签发者标识机制。
使用客户端 ID 元数据文档(CIMD)的应用还可以将 https://chatgpt.com/oauth/client.json 用作稳定的客户端 ID。不支持签发者标识机制的服务器继续沿用原有的回调方式。了解详情。
July 2026
-
修复与改进
已弃用 _meta["openai/visibility"]。将其设为 private 会对模型隐藏工具,但未指明工具对应用是否可见,因此可能难以判断工具原本供谁使用。请使用 _meta.ui.visibility 指定工具仅供模型使用、仅供应用使用,还是供两者使用。
June 2026
-
ChatGPT 中的应用权限设置
修复与改进
ChatGPT 用户现在可以选择已连接的应用何时请求授权:每次都询问、在进行更改前询问,或仅在进行重要更改前询问。个人账户用户可以设置全局偏好,也可以为单个应用单独设置偏好。Business 和 Enterprise 管理员可以管理整个工作空间及各个应用的默认设置。
May 2026
-
MCP Apps 主机样式变量
修复与改进
ChatGPT 现在会在初始化时通过 hostContext.styles.variables 提供标准化的 MCP Apps 主机 CSS 变量,并在主机主题变化时通过 ui/notifications/host-context-changed 更新这些变量。应用可以使用这些变量匹配 ChatGPT 的浅色和深色外观,无需硬编码主机专用的颜色值。
-
MCP Apps 工具生命周期更新
修复与改进
当 ChatGPT 启动小组件时,window.openai.toolResponseMetadata 现在会保留 MCP 工具结果的标准封装结构,包括隐藏的 _meta 字段。
对于需要用户审批的工具,ChatGPT 现在会在审批通过后,通过 MCP Apps 的 ui/notifications/tool-input 生命周期通知将工具输入传给小组件,不再将输入预加载到小组件的初始全局变量中。
-
修复与改进
ChatGPT 现在会读取 MCP 服务器在初始化时返回的指令,并结合这些指令和工具元数据来理解跨工具工作流、约束条件以及适用于整个服务器的指导原则。
-
修复与改进
插件界面和 MCP 服务器文档现已在工具示例中展示 outputSchema,并建议为返回结构化内容的工具声明输出模式。
March 2026
-
修复与改进
已获批准的 Apps SDK 集成可作为 Codex 插件分发。插件刚推出时,仅可在 Codex 中使用。
-
window.openai 中的文件库辅助方法
修复与改进
当用户的 ChatGPT 文件库可用时,小组件可以调用 window.openai.selectFiles() 从库中选择已有文件。
当用户的 ChatGPT 文件库可用时,小组件可以调用 window.openai.uploadFile(file, { library: true }) 将上传的文件保存到库中。
-
修复与改进
window.openai.uploadFile 现已支持上传非图像文件。
February 2026
-
修复与改进
ChatGPT 现已完全兼容 MCP Apps 规范。
-
插件界面更新:重定向、小组件描述和发送后续消息时的滚动行为
修复与改进
window.openai.openExternal({ href, redirectUrl }) 支持 redirectUrl: false。设置该值后,主机就不会在外部链接末尾追加 ?redirectUrl=...。
window.openai.setOpenInAppUrl({ href }) 是更改全屏模式下“在 中打开”目标地址的受支持方法。如果您未调用此方法,ChatGPT 仍会打开小组件当前的 iframe 路径。
如果设置了 openai/widgetDescription,系统在构建资源时会优先使用该值,而非 resource.description。
window.openai.sendFollowUpMessage 支持 scrollToBottom 参数,默认值为 true。您可以传入 false 以关闭自动滚动到底部的行为。
January 2026
-
修复与改进
新增了 ChatGPT 企业知识功能的兼容性指南,说明如何让 search 和 fetch 工具与该功能兼容。点击此处了解详情。
-
工具调用的会话元数据与 requestModal 模板切换
修复与改进
工具调用现在包含 _meta["openai/session"] 字段。您可以使用其中的匿名化对话 ID 关联同一 ChatGPT 会话中的请求。
调用 window.openai.requestModal({ template }) 时,您现在可以传入来自 registerResource 的模板 URI,打开另一个已注册的 UI 模板。