SuperAPI AI 工具集

ui-porting-migration

智能体与模型

查看项目

更新于 10-16 06:16

技能介绍

用途:在 Agent UI 协议或 SDK 之间迁移时使用,涵盖 OpenAI Apps SDK 到可移植 MCP Apps、mcp-ui 旧版 actions 到 ui/* 桥接、MCP Apps 到 A2UI,以及为现有应用增加 AG-UI。若应用已构建适配层,迁移多为机械操作;否则需重写。

主要能力与用法:核心是适配层(adapter layer),所有 host 交互集中在一个模块,组件不直接触碰 window.openai、app.* 或 postMessage。给出 HostBridge 接口示意(onToolInput、onToolResult、callTool、sendMessage、updateModelContext、openLink、setSize、requestDisplayMode、getContext、capabilities)。需同时支持两种协议时,实现两套并在初始化时探测(app.getHostCapabilities(),再 window.openai,再 mcp-ui postMessage 存活探测)。

各迁移提供字段映射:服务端 _meta 字段(openai/outputTemplate 到 ui.resourceUri、openai/widgetCSP 到 ui.csp 等),View 层映射(toolInput 到 app.ontoolinput、callTool 到 app.callServerTool 等),并指出无标准等价物的 API 保持特性检测(requestCheckout、uploadFile、selectFiles、getFileDownloadUrl、requestModal、widgetState/setWidgetState)。mcp-ui 旧动作映射到 app.callServerTool、app.sendMessage、app.openLink 等,intent 无直接等价物。MCP Apps 到 A2UI 是重实现而非迁移。AG-UI 是增量添加,保留 MCP Apps 渲染最终产物。

限制与注意:externalUrl、remoteDom 无 MCP Apps 等价物;remoteDom 需真正重写。迁移顺序、兼容性验证、CSP 重新推导、别名移除时机等均有清单。运行 /ui:port --from <protocol> --to <protocol> 可自动化机械部分并生成需人工判断的报告。