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