For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航

插件用户界面更新日志

插件用户界面兼容性 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月

  • MCP 应用主机样式变量

    修复与改进

    • 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 生命周期向小组件传递工具输入,而不再将其预加载到小组件的初始全局变量中。

  • MCP 服务器指令

    修复与改进

    • 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月

  • MCP 应用兼容性

  • 插件 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月

  • 公司知识兼容性指南

  • 工具调用的会话元数据与 requestModal 模板切换

    修复与改进

    • 工具调用现在包含 _meta["openai/session"],这是一个匿名化的对话 ID,您可以用它来关联同一 ChatGPT 会话中的请求。

    • window.openai.requestModal({ template }) 现在支持通过传入来自 registerResource 的模板 URI,打开另一个已注册的 UI 模板。

2025年11月