用途：对 Figma API 集成做负载测试，找出当前套餐的速率上限（Figma 采用漏桶算法），并为高并发读取做容量规划。
主要能力：
- 提供 k6 负载脚本，用 constant-arrival-rate 执行器探测速率上限，统计错误率、P95/P99 延迟，并在返回 429 时读取 Retry-After 后重试。
- 提供容量规划函数，按测算上限与当前用量计算余量并给出建议（余量大于 50% 监控即可、20%–50% 需缓存与批处理、低于 20% 需升级套餐或降低请求量）。
- 给出扩展策略：相同文件的并发请求合并（RequestCoalescer）、用 p-queue 限制并发与每秒请求数、在低峰时段预取并缓存。
- 提供基准报告模板，记录各端点测算上限、首次 429 出现位置、Retry-After 与延迟分位。
- 常见错误处理：请求过于激进导致全部 429、共享令牌导致的限额不一致、并行 VU 过多造成连接错误、漏桶状态导致结果波动（建议两次测试间隔 5 分钟）。
必要用法：需安装 k6（brew install k6 或 apt install k6），准备 Figma 测试 PAT（勿用生产令牌）与测试文件。运行命令示例：k6 run --env FIGMA_PAT="${FIGMA_PAT}" --env FIGMA_FILE_KEY="${FIGMA_FILE_KEY}" figma-load-test.js，可加 --out json=results.json 导出结果。测试端点使用 https://api.figma.com/v1/files/${FILE_KEY}?depth=1。
适用场景：基准测试 API 吞吐、验证速率限制行为、为大规模文件同步做容量规划。
限制：资料未给出具体套餐的官方限额数值与价格，表中数值为示例测得值；不要用生产令牌或生产设计文件进行压测。官方文档与相关可靠性模式可参见文末资源。