用途：为生产级 Figma REST API 集成提供参考架构，适用于设计新的 Figma 集成、规划项目结构或建立通用模式。
主要能力：覆盖三类常见场景——设计令牌流水线、资源导出系统、Webhook 驱动自动化。给出分层项目结构（src/figma 客户端与类型、src/services 令牌提取与资源导出、src/webhooks 事件路由与校验、src/api 端点、scripts CLI、output 产物、tests 测试）。数据流从 Figma Cloud 的 Files API、Images API、Webhooks V2 经提取器/导出器/处理器，经 LRU 缓存与事件队列，输出 tokens.css、tokens.json、icons/ 及 Slack/Jira。
关键组件：FigmaClient 单例，含重试、限流处理与缓存，方法如 getFile、getFileNodes、getImages、getComments、getLocalVariables；令牌提取流水线 file→styles→nodes→CSS/JSON；资源导出流水线 file→查找组件→渲染图像→下载；Webhook 处理器校验 passcode 后按 FILE_UPDATE、LIBRARY_PUBLISH、FILE_COMMENT 路由。
配置：通过环境变量 FIGMA_PAT、FIGMA_FILE_KEY、FIGMA_WEBHOOK_PASSCODE 注入；缓存 TTL（文件 5 分钟、图像 URL 24 小时）、最大条目 500；API 最大并发 3、重试 3 次、超时 30 秒。
错误处理：429 按 Retry-After 重试；403 提示令牌过期并优雅失败；缓存击穿用 stale-while-revalidate；Webhook 重复事件按时间戳幂等；图像渲染为空则跳过并记录警告。
限制：需了解 Figma REST API 端点、TypeScript 项目环境并确定部署平台；Variables API 同步标注为 Enterprise；多环境配置需参考 figma-multi-env-setup。具体收费、价格与效果资料暂未提供。