用途:把 Persona-Version 当作契约迁移处理。由于请求头会覆盖密钥配置的版本,且兼容版本可能新增或重排数据,需同时迁移解析器、Webhook 处理与运维证据。
主要能力:冻结基线,记录密钥配置版本、显式请求头、端点、模板、响应哈希、事件、看板与消费者假设;读取提供方变更,映射破坏性与兼容性变更到每个请求、JSON:API 映射器、事件处理器、策略规则、测试与数据导出;在切换请求头前,让解析器容忍新资源、新字段、新类型、新事件类型与数组顺序变化;构建双版本固件,覆盖成功、错误、分页、inquiry session、验证与 Webhook;对显式请求头做金丝雀,比较传输、资源、事件、决策、延迟与配额指标;带回落推进,观察期内保留源版本兼容,并记录回滚触发条件。
使用方式:先用 Read 与 Grep 检查应用配置、提供方文档、固件、schema、测试与脱敏运维证据,再提变更;Write 或 Edit 仅用于已批准的实现、配置、测试、运行手册或脱敏回执。未经操作者明确批准,不得创建、恢复、批准、拒绝、脱敏、轮换、吊销、部署或以其他方式变更生产 Persona 资源。
适用场景:需要在带日期的 Persona API 版本间迁移并控制风险时。
限制:需具备源与目标版本、端点到消费者的清单、代表性脱敏固件及可回滚发布机制;显式请求头是该请求的权威来源,意外回退到密钥默认值即为门禁失败;请求成功不等于身份决策成功;文档未提供收费或价格信息。