恢复中断的本地化运行

查明已提交的运行实际完成了哪些工作,取回可恢复的输出,并在处理剩余问题时保留本地修正。

在 lingo push --wait 期间关闭终端,并不会自动停止服务器端的运行。翻译可能仍在进行,也可能正在等待审核,或已经完成。再次提交相同内容前,请先确认运行状态。

本指南适用于已提交的工作。如需进行新的修正,请使用限定范围的更新。如果需要让已接受的目标译文在常规变更后继续保留,请参阅保留指南。

保留排查依据和本地状态 #

记录终端输出的运行 ID、源内容修订版本、所选文件和语言区域,以及最后已知的状态。保留 checkout 中的运行状态、Lockfile 和所有本地目标译文修改。先删除这些记录,可能会丢失恢复工作所需的信息。

如果一次运行提交了两个目标语言区域的工作,请分别检查每个目标,不要假定终端断开就意味着两者都在同一阶段中断。

重新开始前,先检查能否取回结果 #

在提交该运行的 checkout 中,使用其中记录的运行:

bash
lingo pull --dry-run

这会检查即将写入本地的内容,但不会更改文件。它可以轮询未完成的工作,并报告等待审核、失败或输出可用等状态。拉取操作会在某个文档的所有语言区域都完成后写入该文档,但不会改动仍在等待人工审核的文档;审核者完成审核后,再次运行即可。请在对应的审核工作流中完成所需审核,不要反复提交源内容。

输出就绪后,先检查冲突,再取回结果:

bash
lingo pull

拉取操作使用本地记录的状态,不会搜索其他机器上的任意运行。对于已在其他位置提交的翻译,请通过版本控制获取。运行状态参考和拉取说明了已安装 CLI 使用的具体文件和冲突处理规则。

使用 push 重试失败的工作 #

修正所报告的问题原因后,在提交该运行的 checkout 中使用相同参数,再次执行原来的 push。对于常规源内容更新:

bash
lingo push --wait

如果之前的 push 尚未取回结果,且请求没有变化,push 会复用之前的请求,避免重复提交相同工作。仍在运行的任务会重新关联,已完成的任务会取回结果,失败的任务则会被一个带有新 ID 的新任务替代。失败前已取回的文档已记录在 Lockfile 中,因此重试只会请求仍然缺失或已发生变化的工作。

重试后,检查各目标的结果和取回的文件,再确认还有哪些工作未完成。在现有项目中补齐缺失的目标文件之前,请先完成、取回并检查现有目标的常规源内容更新。使用 lingo push --backfill-missing --wait 补齐缺失文件时,保持该源内容修订版本不变;添加语言说明了操作顺序。现有文件中已更改的键,则需要通过相应的常规更新或限定范围的更新来处理。

根据失败原因选择修复方式 #

本地记录缺失与服务器端运行失败是两类不同的问题。内容无效需要修正,授权被拒需要获取访问权限,等待审核需要作出决定。如果网络响应不明确,请先检查服务器是否已接受工作,再决定是否重新提交。

不要仅为了重试失败的运行而更改源内容。保留旧运行 ID,并确认新输出的任务 ID 与之前不同。CLI 恢复流程介绍了如何验证输出,以及再次返回同一个失败任务时如何寻求支持。

如果只获得了部分结果,请保留成功且已审核的目标译文,并单独列出失败的目标。如果需要发起新的运行,请记录它为何接续或替代之前的运行,以及所用的源内容修订版本,以免将迟到的结果误认为当前输出。

处理本地差异 #

如果目标译文相较于记录的版本已有改动,拉取操作可能会拒绝替换。请对照各自的源内容修订版本,比较本地修改和待取回的输出,再通过审核确定采用的措辞。

lingo pull --force 会绕过这一保护机制,覆盖存在差异的目标译文。请先保存本地工作,并明确决定是否替换。对于共享资源目录,请保护整个文件,包括源内容和未修改的语言区域。

以可用的输出完成恢复 #

核对取回的路径、语言区域、变量和差异。在应用或渲染器中加载结果,检查其含义。文件能够取回,并不代表它已获准使用。

保留恢复后的运行 ID、已接受的修订版本、Lockfile 和目标译文,作为下一次工作的基准。只有在剩余失败均已得到处理或明确说明,且已接受的输出与预期源内容一致时,恢复才算完成,而不只是某条命令成功返回。