用途:为可复现的 Anima 或 Figma 集成故障收集范围受限、可脱敏的诊断产物,用于提交支持工单和排查代码生成问题。
主要能力:生成 JSON 调试包,包含时间戳、Node 版本、Anima SDK 版本、ANIMA_TOKEN 与 FIGMA_TOKEN 的存在状态(仅显示 SET/NOT SET,不输出值)、Figma API 访问验证结果、SDK 加载测试结果。输出目录默认 .private-debug,文件权限 0o600,目录权限 0o700。
使用方式:需准备范围受限的开发凭据、可复现问题的临时或预发布设计夹具、预期文件/节点/设置元组、时间戳和脱敏错误或请求 ID,以及支持分享审查流程和凭据轮换负责人。在本地构建调试包,检查字段,运行密钥扫描,经支持负责人确认安全后再分享。示例代码位于 src/debug/anima-debug.ts,使用 node:fs、node:path、node:module 和 @animaapp/anima-sdk,通过 fetch 调用 https://api.figma.com/v1/me 验证 Figma 访问。
适用场景:提交 Anima 支持请求、调试代码生成问题、排查 Figma 集成故障。
限制:不得输出令牌值、完整设计载荷或私有文件名;若审查发现敏感内容或无法在预发布环境安全复现,应隔离文件、轮换凭据、减少捕获字段并重新生成,不得上传。凭据缺失或无效时停止运行并修正密钥绑定,不打印值。Figma 或 SDK 检查失败时仅记录状态/错误类别。无法在预发布复现时,升级并提供最小非敏感元数据,而非收集生产设计内容。
资源:Anima Support、Anima SDK GitHub Issues。