用途:为 Figma API 集成配置开发、预发布(staging)与生产三套环境,使各环境使用独立的 PAT、目标文件和缓存策略,避免开发环境误操作生产资源。
主要能力:按环境区分 PAT 权限范围(开发仅 file_content:read,预发布增加 file_comments:read,生产增加 webhooks:write)、Figma 文件键、缓存 TTL(10s/60s/300s)与最大并发(1/3/5);提供配置加载函数 getFigmaConfig(),依据 NODE_ENV 读取对应环境变量,缺失 token 或 fileKey 时抛错;提供 requireProduction 与 blockInProduction 两类环境保护,限制仅生产可执行的操作与禁止在生产执行的危险操作。
使用方式:在 .env.development、.env.staging 中写入 FIGMA_PAT_DEV、FIGMA_FILE_KEY_DEV 等变量,生产变量存入密钥管理器而非仓库,并提交 .env.example 作为模板。密钥可用 GitHub Actions 环境级 secret(gh secret set FIGMA_PAT_PROD --env production --body "figd_...")或 Google Cloud Secret Manager(gcloud secrets create figma-pat-prod --data-file=-)管理,Cloud Run 通过 --set-secrets 注入。
适用场景:同一集成在本地指向预发布文件、在 CI 指向生产文件;按环境注册 webhook(POST /v2/webhooks)。
限制与注意:需为每个环境准备独立 PAT 与密钥管理方案,并在应用中实现环境检测;PAT 有 90 天有效期,需按环境设置轮换提醒;需确认 NODE_ENV 已设置,否则配置无法加载。资料未提供具体价格、平台支持范围或效果数据。