用途:为 StackBlitz WebContainer 建立基于证据的容量预算,记录本地阈值与优雅降级方案,而非宣称固定的厂商配额。容量取决于浏览器、设备、项目、依赖图、并发嵌入与托管运行时。
主要能力:盘点挂载字节与文件数、依赖数量与锁文件、进程数、预览数与清理行为;在支持的浏览器/设备矩阵上测量冷启动与重复运行;用合成夹具逐项变更单一维度,记录首次降级或失败状态;应用最小优化(减少挂载输入、固定/裁剪依赖、复用生命周期所有权、延迟嵌入、终止未用进程);重新测量并设定应用自有预算与用户可见回退。
必要用法:使用 Read、Glob、Grep 检查挂载输入、锁文件、进程创建、嵌入、清理与既有性能预算;WebFetch 仅用于当前官方 StackBlitz 或 WebContainers 文档;Write 或 Edit 仅用于已批准的测量工具或有界优化。
限制与约束:一个页面只能并发启动一个 WebContainer,额外体验需共享所有权或延迟加载;多项目、进程、依赖与嵌入消耗浏览器内存,内存不足行为因设备与浏览器而异;原生插件不可运行,除非替换为 JavaScript 或 WebAssembly 实现;包含适用锁文件可避免重新解析依赖并提升可重复性;仅挂载必需文件,初始水合优先使用一次批量 mount();页面含多个交互示例时使用懒加载或点击加载嵌入并提供静态回退。容量测试默认使用合成公共包,禁止将私有源码、令牌、注册表凭据或客户依赖元数据复制到基准产物;授权企业行为仅可在其授权环境测试。未经明确范围,不得对客户项目运行负载实验、削弱浏览器安全、移除必需功能或更改生产加载行为;上线前需展示实测影响与回滚方案。输出应包含旅程与矩阵、输入维度、测量值、应用预算、瓶颈证据、优化、前后结果、优雅回退、回滚及未由证据确立的限制。错误处理:浏览器报告内存不足时减少并发项目/进程与挂载/依赖大小并保留回退;安装时间不稳定时固定输入、包含锁文件并区分网络波动与运行时工作;原生插件失败时选择 JavaScript/WebAssembly 替代或声明项目不兼容;无厂商配额文档时发布实测应用预算而非编造通用数字。