用途:围绕 Persona 沙箱行为与捕获的契约夹具构建本地循环,而不是调用生产环境。沙箱不执行真实验证,支持强制通过或失败路径,且不产生用量费用。
主要能力:声明沙箱场景(模板、强制结果、inquiry 状态、预期事件类型、API 版本、清理处置);用唯一 Idempotency-Key 创建沙箱 inquiry;通过沙箱流程强制通过或失败;在 JSON 解析前捕获原始 Webhook 字节(含请求头与正文),脱敏 PII 并保留重复投递与故意乱序夹具;按原始字节校验 HMAC、按事件 ID 去重、按 data.attributes.created-at 排序业务处理,并断言本地终态。
使用方式:使用沙箱 bearer key 发起 REST 请求,使用独立的沙箱 Webhook 密钥做 HMAC 校验;密钥不得出现在隧道 URL、夹具、控制台日志或提交的 .env 中。文件操作上,先用 Read 与 Grep 检查配置、文档、夹具、模式、测试与脱敏证据,再对已批准的实现、配置、测试、runbook 或脱敏回执使用 Write 或 Edit;未经操作者明确批准,不得变更生产 Persona 资源。
适用场景:无生产 PII 的本地开发,如 government-id-fail 场景可创建沙箱 inquiry、强制失败、捕获同一事件两次投递、乱序回放,并证明仅发生一次预期失败状态转换。
限制:错误处理上,隧道若只收到已解析 JSON 需禁用正文转换并保留原始字节;编辑后夹具签名失败需用编辑后的时间戳和原始正文重新生成,不得弱化校验;沙箱与生产设置出现分歧时应记录漂移并暂停推广。验证须对照第一方证据、固定 API 版本、脱敏契约夹具、预期失败路径及文档化回滚路径;请求成功不等于身份决策成功。