用途:把 Design 项目从内联 Alpine/HTML 原型升级为真实运行的应用,支持真实路由、后端行为和可部署 URL,并走通到发布。仅当用户明确要真实应用而非原型时使用;UI 探索与视觉迭代仍走普通内联设计流程或 /visual-edit。
主要能力:create-fusion-app 通过 Builder 云代理创建应用分支,返回 building、projectId、branchName、editorUrl;sync-fusion-app 轮询容器启动状态(building|ready|error),就绪后更新 previewUrl 并写入 URL 化屏幕;add-fusion-screens 把额外路由作为屏幕放到画布;push-fusion-app 推送分支代码到 git 远端;deploy-fusion-app 预留 <slug>.builder.cloud 并触发部署;get-fusion-deploy-status 轮询部署状态。
编辑方式:Fusion 屏幕不是内联 HTML,禁止直接改其标记,也不能用 generate-design、edit-design、apply-visual-edit。应使用 queue-fusion-edit 记录编辑意图(可用 target 指定元素/屏幕),list-fusion-edits 查看队列,apply-fusion-edits 批量派发给容器内编码代理,或用 send-fusion-message 发送较大自由请求。派发是异步的,不会同步生效,需再次 sync-fusion-app 或让用户刷新屏幕。
限制:该功能由 templates/design/shared/full-app.ts 中的 FULL_APP_BUILDING_ENABLED 布尔开关控制,当前为 false;开关关闭时应告知用户尚未启用。即使开启,fusion 操作也需要 Builder 凭据和已配置的分支项目 ID,否则返回 not-configured 状态与 cta,应引导用户通过 connect-builder-app 或 connectUrl 连接 Builder 后重试,不要静默回退到内联设计。创建分支和启动容器可能需数分钟,部署也需真实时间,应持续轮询并给出状态更新。