用途：为 @animaapp/anima-sdk 设计转代码流水线提供生产级封装模式，适合构建可复用的 Anima 客户端包装、输出缓存与错误恢复逻辑。
主要能力：一是单例客户端，通过 getAnimaClient() 惰性创建 Anima 实例，从环境变量读取 ANIMA_TOKEN，并提供 nextjs、vite、reactPlainCss、static 等预设配置（语言、框架、样式、UI 库）。二是基于文件的生成缓存 AnimaCache，用 sha256 对 fileKey、sourceRevision、nodeId 与 settings 生成键，命中则复用，避免重复 API 调用。三是输出规范化 normalizeOutput，可按配置调整组件命名、添加 barrel 导出、注入 cn() 导入、补充类型注解。四是带退避与抖动的重试模式，仅对 429 与 5xx 等可重试错误重试，并限制尝试次数与总耗时。
使用方式：先固定 SDK 与 TypeScript 版本，定义支持的框架预设，准备含合成组件的沙箱 Figma 文件；运行时从密钥管理器注入 ANIMA_TOKEN 与 Figma 凭据。缓存目录 .anima-cache 需私有、排除版本控制与产物上传，并定义保留/删除策略。启用前需设置输入文件/节点 ID 与输出路径白名单、最大缓存大小、重试上限及经负责人批准的规范化配置。
限制与注意：认证失败须与生成失败区分，401/403 不重试；凭据不得硬编码、记录、缓存或写入生成产物。缓存键可标识请求，但缓存的设计源与生成内容不得发送到遥测。缓存未命中属正常，但 JSON 损坏、schema 漂移、设置哈希不匹配或目录外条目应隔离或删除并重新生成。规范化或类型检查失败时，原始结果仅保留在私有隔离区并阻止发布。进程中断或部分写入需原子替换并恢复上一有效条目。资料未提供具体收费、价格与平台支持范围。