用途：通过 Figma API 自动化迁移设计数据，支持在 Figma 文件之间迁移、从其他工具迁入 Figma，以及把 Figma 样式迁移为 Variables API 变量。流程覆盖盘点、提取、转换和校验。
主要能力：盘点源文件（页面、组件、样式、节点数量）；提取 FILL、TEXT、EFFECT 等样式；将样式转换为设计令牌 JSON（颜色、排版、效果）；通过 Variables API 写入目标文件；对比源与目标进行迁移校验。
使用方式：需准备源与目标 Figma 文件 key，以及具备 file_content:read 和 file_variables:write（Enterprise）权限的 FIGMA_PAT。步骤为：盘点源文件、提取样式、转换映射为令牌、写入目标 Variables API、校验。示例命令：node migrate.js --source ${SOURCE_FILE_KEY} --target ${TARGET_FILE_KEY} --dry-run，去掉 --dry-run 后执行写入。
适用场景：设计令牌跨文件迁移、变量同步、样式转变量、迁移前干跑审查映射。
限制：Variables API 写入仅限 Enterprise，非企业版会返回 403，需改用 JSON 导出；目标存在重名变量需加前缀或后缀；节点在读取前被删除会缺数据；文件超过 100MB 可能超时，建议用 /nodes 端点按页面处理；渐变填充等无变量对应项会被跳过并保留为样式。