用途:提升 Anima 设计转代码的吞吐量,在降低生成延迟、优化批量组件生成时使用。核心原则是缓存命中或输出变小本身不算成功,结果必须仍匹配已批准的设计版本、无障碍预期与项目构建约定。
主要能力:基于文件的生成缓存(带 TTL);按 Figma 节点变更做增量生成,仅重新生成发生变化的组件;记录输出字节数与摘要,不做破坏性改写。
使用方式:先准备代表性 staging 夹具与基线测量(生成时长、缓存命中率、失败率、生成代码校验结果),并建立与 Figma 源版本、节点 ID、生成设置绑定的版本感知缓存键与保留策略。ANIMA_TOKEN 与按源限定的 FIGMA_TOKEN 只在后端 worker 中加载,性能测试使用合成白名单源。缓存键由 fileKey、sourceRevision、nodeId 与 settings 经 sha256 生成;增量检测通过 Figma 节点接口读取 lastModified 判断变更。
适用场景:设计转代码流水线的延迟与批量组件生成优化。
限制:不得为完成基准测试而扩大凭据范围或重试授权失败;缓存条目无法证明源版本、后处理改变必需行为或触发限流时应停用优化并回退到先前已验证的生成路径;并发升高导致提供方失败或限流时需降低并发、有界退避并保留用户可见任务状态。具体延迟或配额数值不得当作 Anima 服务等级目标,需以团队自身夹具与提供方协议为准。