用途:优化 Lokalise API 吞吐量,提升翻译流水线性能,适用于 API 响应慢、需要实现缓存策略或批量操作的场景。
主要能力:
- 游标分页:对 5K+ 键的项目,用 cursor 分页替代 offset 分页,limit 最大 500,可减少约 80% 请求数。
- 本地缓存:缓存翻译文件下载,用项目 last_activity 时间戳判断失效。
- 批量键操作:创建、更新、删除键均支持每请求最多 500 个,应批量而非逐个请求。
- 请求限流:Lokalise 限速 6 请求/秒,可用 p-queue 以 5 并发、1 秒间隔留出安全余量,避免 429 错误。
- 异步文件操作:用 webhook 替代轮询进程状态;无 webhook 时可轮询 queuedProcesses,每 2 秒一次。
- 选择性语言下载:用 filter_langs 只下载所需语言,减少带宽与处理时间。
- 基准测试:用 curl 测量各端点响应时间并查看 x-ratelimit 头。
使用方式:需 @lokalise/node-api SDK v9+(ESM)或 REST API 访问,设置 LOKALISE_API_TOKEN 环境变量,了解项目键数与语言数以校准批量大小,可选 Redis 或 LRU 缓存库。
限制:Lokalise 键端点不支持 filter_modified_after,增量导出需本地 diff 或用 webhook;bundle_url 仅约 30 分钟有效,须立即下载;last_activity 粒度可能不足,缓存可能滞后于团队编辑;大批量网络超时可减小批量并加重试。