lingo pull
获取本地记录的最新运行结果,避免意外覆盖已偏离原版本的目标内容修改。
推送时若未使用 --wait,请在同一台机器的同一项目根目录下运行 lingo pull。它会读取该绝对路径对应的最新运行指针,并收集所记录运行的结果。不支持指定任意运行 ID,也不会自动搜索项目历史记录。
lingo pull --dry-run
lingo pull试运行会报告写入决策,但不会修改文件或 Lockfile。它仍可能连接服务器并轮询尚未完成的任务。--force(-f)允许覆盖已偏离原版本的本地目标内容;使用前请先保存这些修改。两个选项的默认值均为 false。
本地修改如何影响结果收集 #
拉取时,会将每个目标当前的字节内容与服务器结果、推送时保存的目标内容以及 Lockfile 进行比较:
| 当前目标 | 决策 |
|---|---|
| 不存在 | 创建目标。 |
| 与服务器上已完成的产物一致 | 已同步。 |
| 与推送时保存的目标内容一致 | 可安全替换为服务器结果。 |
| 与 Lockfile 中记录的哈希值一致 | 可安全替换。 |
| 与上述各项均不一致 | 冲突。 |
未启用强制覆盖或试运行时,任何冲突都会中止所有目标的写入。提交修改不会改变其字节内容,也不会消除这项比较发现的冲突。请保存这些修改并解决冲突,或在收集结果前恢复到已知版本。
成功收集结果后,会记录已完成目标的哈希值。只有当已完成的文档覆盖所有已配置的目标语言区域,且未限定键范围时,才会更新现有的源内容基线。如果只收集部分语言区域的结果,则会保留现有的源内容哈希值;若该哈希值不存在,则会将其初始化。键刷新仅记录目标哈希值,因此尚未处理的常规源内容修改仍会在下一次普通推送中提交。直接使用 push --wait 会记录相同的哈希值,但不会重新执行这项冲突检查。
读取未完成和失败的结果 #
拉取会轮询待处理任务,直到所有未完成的目标均已完成或正在等待人工审核,然后按文档收集结果:每份文档的所有语言区域都完成后,才会写入该文档。仍在等待审核的文档会保持不变;审核者完成审核后,再次运行 lingo pull 即可写入其余文档。
即使运行失败,也会先写入已完成的文档,再报告失败并以非零退出码退出。如果某份文档有一个语言区域处理失败,则该文档的所有语言区域都不会写入,其源内容基线也会保留,因此下次推送该文件时会再次请求处理。请查看失败信息,并确认预期文件是否符合要求。缺失的翻译或必需的审核需要通过相应的工作流操作处理,不能靠再次尝试下载来解决。
找不到运行时 #
指针存储在 ~/.lingo/runs/ 下,并依赖于项目根目录的绝对路径。移动 checkout、使用其他运行器或再次提交推送,都可能改变本地可用的运行。在认定远程输出缺失之前,请先检查该状态和项目绑定。
旧版 CLI 提交的运行可能无法由当前安装的版本读取;此时,拉取会给出提示,再次执行 lingo push 会重新提交任务。Lockfile 与缓存介绍了可移植的基线和机器本地状态。