CLI v0 中的并行处理

管理旧版工作线程池,恢复部分输出,不以提供商容量无限为前提。

V0 将语言区域与文件的组合转化为翻译任务,并分配给客户端工作线程池。更多工作线程意味着更多任务可以同时运行,但不会提高提供商的配额,也不会让整个项目成为一个事务。

使用较小的线程池排查问题 #

lingo.dev@0.138.10 默认使用 10 个工作线程。排查限流问题或面对不熟悉的后端时,请从较少的线程开始:

sh
lingo run --concurrency 2 --target-locale es

提高并发数之前,请检查提供商返回的错误、内存使用情况和已完成的输出。帮助文档注明上限为 10,但参数校验也接受更大的正数。除非已验证所安装的版本与后端能正常配合运行,否则请将线程数控制在 10 或以下。

先减少不必要的工作 #

使用文件、语言区域、存储桶和键选择器来限定实际任务范围。--source-locale 会更改本次运行使用的源内容。请用引号括起通配符选择器,并检查扫描发现的已配置路径。

强制模式会改变待翻译的增量内容,冻结模式则只检查同步状态,不执行翻译。两者都不会改变工作线程数。如果问题在于需要审核的输出过多,缩小增量范围、只保留相关内容通常是最有帮助的调整。

失败后保留已完成的成果 #

Lingo.dev 处理路径会将较大的数据载荷分块,并可能在所有任务完成前写入已返回的数据块。即使某个任务失败,其他任务仍可能完成。请保留差异,找出失败的语言区域/文件组合,并先重试相关范围,再考虑对整个项目执行强制翻译。

限定目标语言区域或键范围的输出不会更新现有的源内容校验和基线。请审慎地确定基线;目标内容写入完成,并不代表所有语言区域都已更新到最新状态。

按文件进行的 I/O 协调会在单次运行中串行执行对共享文件的写入,但无法阻止另一个 CLI 进程或编辑器写入该文件。请避免针对同一配置和 Lockfile 同时执行相互冲突的运行。取消操作不会恢复先前的内容,而在重试前清除数据则是另一项具有破坏性的决定。