用途:为 WebContainer 问题生成有界、隐私安全的诊断包,记录状态与结果,而非任意源码、环境值、完整终端输出、浏览器历史、Cookie 或凭据。
主要能力:记录 schema 版本、采集时间、应用发布版本、包版本、粗略浏览器家族/版本、安全上下文状态与 crossOriginIsolated 布尔值;记录相关响应头的存在与归一化值(不含无关头或 Cookie);记录生命周期转换、事件名、进程命令标识、退出码、时长与有界/脱敏输出尾部;仅记录文件系统计数与测试用合成路径,不枚举或复制用户文件内容;记录内存不足等资源症状,但不虚构通用数值内存配额;在元数据中显式标注每项脱敏与省略的证据类别。
使用方式:先定义事件 ID、受众、保留期、schema、字节上限与脱敏规则;从仓库证据收集静态包与托管配置;从失败会话收集浏览器能力、响应头与生命周期状态;添加有界事件与进程证据,保留退出码与时间戳;自动脱敏后人工复核再分享;用合成夹具复现一次,附上包哈希与采集限制。工具上使用 Read、Glob、Grep 定位现有日志、头、启动、事件与进程插桩;WebFetch 仅用于当前官方 StackBlitz 或 WebContainers 文档;Write 用于新 schema 或产物,Edit 用于窄范围插桩修改。
适用场景:间歇性启动失败等 WebContainer 问题的诊断与共享。
限制:绝不包含 API 密钥值、OAuth 参数、注册表凭据、Cookie、带令牌 URL、.env 内容、超出最小身份的私有包元数据或完整用户代理/客户端指纹;认证状态仅以粗略枚举记录。添加运行时遥测、持久化诊断包、采集用户会话证据或向批准受众外发送前需明确授权,外部披露前须人工复核最终字节。输出返回 schema 与包路径、SHA-256 摘要、字节数、已采集与省略字段、脱敏结果、复现链接或命令、受众/保留期与未解决证据缺口。包超上限时保留结构化摘要并确定性裁剪重复输出;检测到疑似机密材料时拒绝发布、从源头脱敏、重新生成并再次复核;运行时不可用时输出标注缺失动态证据的部分包;被要求用户源码时以计数、哈希或合成复现替代。