用途：处理 Figma REST API 的弃用与破坏性变更，重点是 files:read 权限弃用改为细粒度权限，以及 Webhooks V1 迁移到 V2。
主要能力：
- 权限迁移：files:read 弃用后，按端点映射到替代权限——GET /v1/files/:key 与 GET /v1/images/:key 用 file_content:read；GET /v1/files/:key/comments 用 file_comments:read；GET /v1/files/:key/dev_resources 用 file_dev_resources:read；GET /v1/files/:key/versions 用 file_versions:read。步骤为审计端点、映射权限、生成新 PAT、更新 OAuth 应用权限列表、测试、吊销旧令牌。
- Webhooks 迁移：V1 的 POST /v1/webhooks 弃用，改用 POST /v2/webhooks，V2 支持将 webhook 绑定到团队、文件或项目。事件类型包括 FILE_UPDATE、FILE_DELETE、FILE_VERSION_UPDATE、FILE_COMMENT、LIBRARY_PUBLISH。
- OAuth 应用发布流程：在 Figma 开发者面板完成应用信息、重定向 URL，公开应用提交审核、私有应用激活，并适配新令牌格式。
- 代码库审计：检查弃用权限、V1 webhook 端点、旧令牌格式等。
必要用法示例： 查找代码中的 Figma API 调用：grep -rn "api.figma.com" --include=".ts" --include=".js" src/ | grep -oP '/v\d/[a-z_/]+' | sort -u 查找弃用权限：/usr/bin/grep -rn "files:read" --include='*.{ts,js,json,yml}' . | /usr/bin/grep -v node_modules 创建 V2 webhook：curl -s -X POST https://api.figma.com/v2/webhooks -H "X-Figma-Token: ${FIGMA_PAT}" -H 'Content-Type: application/json' -d '{"event_type":"FILE_UPDATE","team_id":"'"${FIGMA_TEAM_ID}"'","endpoint":"https://example.com/figma/webhook","passcode":"'"${WEBHOOK_PASSCODE}"'"}' | jq '{id, event_type, status}'
适用场景：从弃用权限迁移、更新 webhook 版本、适配 Figma API 变更的集成项目。
限制：需现有 Figma 集成可运行、Git 版本控制、Figma 开发者设置访问权限。常见问题包括权限变更后 403（缺少对应权限）、webhook 不触发（V1 仍激活）、OAuth 流程中断（未完成发布流程）、令牌格式不匹配（需生成 figd_ 前缀的新 PAT）。