migrate-oai-app

此技能为希望将旧版 OpenAI Apps SDK 应用程序迁移至 Model Context Protocol (MCP) Apps SDK (@modelcontextprotocol/ext-apps) 的开发人员提供自动化且具指导性的路径。它专为需要将专有的 window.openai 模式转移至 MCP 所提供之标准化、开放且交互式 UI 协议的工程师与平台开发人员而设计。此技能充当迁移架构师的角色，确保先前绑定于 OpenAI 运行环境的逻辑能正确重构以适应 MCP 生命周期。

• 提供将 OpenAI Apps 转换为符合 MCP 标准的服务器与 UI 的分步迁移指导。

• 提供全面的 API 映射表，协助将旧版 window.openai 调用替换为现代化的应用程序实例与处理程序。

• 提供使用 registerAppTool 与 registerAppResource 辅助工具来现代化服务器端逻辑的基础架构指导。

• 提供内容安全策略 (CSP) 审核的自动化工作流程，以便在部署前识别必要的资源、连接与框架域名。

• 支持包括 React、Vue、Svelte、Preact 与 Solid 在内的主要前端框架集成。

• 提供管理应用程序状态与主机环境内容的最佳实践，无需依赖全局 window 对象。

• 首先使用提供的 git 指令克隆当前的 SDK 存储库，确保拥有最新的参考文档与示例服务器模板。

• 请参阅位于 /tmp/mcp-ext-apps/docs/migrate_from_openai_apps.md 的迁移参考指南，以获取精确的代码库映射对照。

• 请务必优先使用包管理器来安装依赖项目，以确保版本兼容性，而非手动硬编码版本号。

• 通过追踪现有构建版本中的所有网络来源，将其归类为资源、连接与框架域名，借此执行详尽的 CSP 调查。

• 在连接之前实现事件处理程序 (ontoolinput, ontoolresult)，以确保与主机环境进行可靠的通信。

• 请注意，某些 OpenAI 特有功能（如 widgetState 或直接文件上传）在 MCP 中没有直接的对应项目，需要改用服务器端状态管理模式。

• 在完成迁移工作之前，请务必完成“完成前检查清单 (Before Finishing checklist)”，确保您的应用程序符合现代 MCP 主机所需的安全与性能标准。