用途
该技能将类似 IDE 的功能请求转化为有边界的架构,围绕 WebContainers 构建自定义的浏览器内开发体验。它把宿主 UI、虚拟文件系统、编辑器模型、终端流、运行时进程、预览帧和持久化策略分开,防止原型意外变成不安全的单体结构。
主要能力
- 将功能请求拆解为最小用户旅程,并确定真正需要的面板与运行时能力。
- 划分宿主状态、生命周期适配器、文件系统、编辑器模型、进程/终端句柄、预览和持久化的所有权。
- 在面板之间建立类型化消息/事件契约,而不是共享原始运行时全局变量。
- 实现一个垂直切片:打开合成文件、编辑、写入、运行受限命令、显示发出的预览 URL。
- 添加路径策略、进程取消、预览隔离、保存/导出和永久处置行为。
- 在扩展功能前验证键盘/无障碍行为、HMR 所有权、内存清理和启动失败恢复。
使用方式
使用 Read、Glob 和 Grep 映射宿主框架、编辑器与终端库、应用状态、持久化和运行时边界。仅使用 WebFetch 获取当前官方 StackBlitz 或 WebContainers 文档。仅对用户批准的有界切片使用 Write 或 Edit。
当前契约要求:宿主应用拥有单一生命周期适配器,各面板不调用 boot() 或 teardown();文件浏览器路径在虚拟文件系统操作前经过验证和规范化,编辑器模型使用稳定的规范路径;终端输入/输出显式绑定到一个进程并在处置时释放;预览 URL 来自运行时事件,并被视为不可信的应用内容,而非可信宿主 UI;WebContainer 文件系统不保证持久化,在声称持久工作前需定义明确的保存/导出/版本化路径;注册错误、端口和服务器就绪观察者时使用有界日志并明确退订所有权。
适用场景
适用于需要自定义 WebContainer 体验而非 StackBlitz SDK 嵌入的浏览器应用,例如教育沙盒。示例:为教育游乐场实现一个合成项目,包含文件面板、编辑器、受限终端命令、预览和显式下载/导出操作,同时将协作和私有包排除在范围之外。
限制
前提条件包括:命名的用户旅程和目标浏览器应用;决定自定义 WebContainer 体验优于 StackBlitz SDK 嵌入;生产使用需要产品、许可、安全和持久化负责人。
认证方面:不要将宿主机密、认证令牌、客户 .env 文件或环境浏览器凭据挂载到用户控制的项目中。如果需要私有包,使用文档化的组织认证边界,并披露哪些项目代码可以访问已安装材料。
批准边界:在执行任意用户代码、持久化或导出用户文件、连接私有注册表、注入预览脚本或启用协作/遥测之前,需要明确批准。先呈现数据流、滥用案例、保留和回滚。
错误处理:如果 UI 面板共享原始运行时状态,在添加功能前引入作用域适配器和类型化事件;如果编辑器和文件系统分歧,通过规范路径和显式写入确认进行协调;如果预览被视为可信,隔离它并定义允许的宿主-预览通信;如果持久化未指定,将体验标记为临时并停止持久性声明。
输出应返回:用户旅程、组件和信任边界图、生命周期和数据契约、已实现的切片、验证证据、持久化语义、推出阶段、回滚以及开放的产品/安全决策。
资源包括官方 StackBlitz 和 WebContainers 参考、WebContainers 介绍、使用文件系统。