SuperAPI AI 工具集

figma-debug-bundle

设计与创作

查看项目

更新于 10-15 23:25

技能介绍

用途:在遇到 Figma REST API 持续性问题或准备提交支持工单时,收集排查所需的全部诊断数据,输出一个脱敏归档包。

主要能力:脚本会采集环境信息(Node、npm、操作系统、PAT 是否配置及长度、文件 key)、API 连通性测试(GET /v1/me 的状态码与耗时)、文件访问测试(GET /v1/files,需提供文件 key)、速率限制响应头,并对敏感数据做脱敏处理。

使用方式:需先设置 FIGMA_PAT 环境变量,并确保 curl 与 jq 可用,同时准备一个用于测试的 Figma 文件 key。创建脚本 figma-debug-bundle.sh 后执行 chmod +x figma-debug-bundle.sh 与 ./figma-debug-bundle.sh。可用 tar -tzf figma-debug-*.tar.gz 检查内容,解压后查看 summary.txt。

输出:figma-debug-YYYYMMDD-HHMMSS.tar.gz,内含 summary.txt(环境、连通性、速率限制状态)、me-redacted.json(已脱敏邮箱的认证用户信息)、file-meta.json(提供文件 key 时的文件元数据)。

错误处理:/v1/me 响应码可判断令牌有效性(403 表示 PAT 过期或无效);/v1/files 响应码可判断文件访问(404 表示 key 错误,403 表示未共享);速率限制头可反映限流状态,Retry-After 显示当前是否被限流;响应时间超过 2 秒可能提示网络或服务器问题。

限制与注意:分享前务必脱敏,包括个人访问令牌(figd_*)、邮箱地址、OAuth 客户端密钥及文件内容(除非与缺陷相关);可安全包含 HTTP 状态码与响应时间、错误消息文本、节点 ID 与文件 key、速率限制头值。其他细节暂未提供。