用途：为 @lokalise/node-api 提供可直接复用的生产级代码模式，用于实现或重构 Lokalise 集成。
前提：已安装 @lokalise/node-api v12+，使用 TypeScript 5+ 且开启 strict 模式。
主要能力：客户端单例集中配置并支持分支式项目 ID（"projectId:branchName"）；基于游标的异步生成器分页，减少内存占用；将 SDK 错误包装为带 isRetryable 分类的类型化错误；按每请求 500 键上限分批创建与删除；文件上传后轮询进程状态并回调进度；对 429 与 5xx 做指数退避重试，并以最小间隔限流。
使用方式：从 src/lib/lokalise-client.ts 获取客户端，通过环境变量 LOKALISE_API_TOKEN 或显式 apiKey 初始化；分页使用 paginate/paginateAll；单次调用用 apiCall 包装；重试用 withRetry，顺序批量调用用 rateLimited；上传用 uploadWithProgress 并传入进度回调。分页默认每页间隔 170ms（约 6 req/s），批量间隔 500ms，上传轮询超时 2 分钟。
适用场景：本地化键的批量导入导出、CI 中的文件上传、需要限流与重试保障的自动化同步流程。
限制：资料未提供具体价格、配额数值、错误码清单以外的细节，也未说明除 Node.js/TypeScript 之外的语言支持；仅重试 429 与 5xx，其他错误应直接抛出处理。