重新翻译选定的 CLI v0 内容

源内容或翻译要求变化后,更新旧版译文,同时控制更新范围,保护已认可的修改。

源内容有变化时,使用普通运行。源内容没有变化,但译文需要体现新指令或替换不满意的值时,使用强制运行。这两种方式都可能覆盖普通的手动修改。

由源内容的变化决定普通运行的处理范围 #

sh
lingo run
源内容/目标内容状态v0 普通运行结果
源值的校验和与之前不同翻译已更改的值。
目标内容中缺少某个源键翻译缺失的内容。
某个源键已被移除移除其受管理的目标条目。
新键的源值校验和与已移除键的源值校验和相同在当前处理的上下文中复用该译文。
目标值已存在,且源内容未更改保留目标值。

普通的手动修正只在源内容未更改时保留,并不会在之后的每次更新中都保留。受保护的键则会保留一个由人工单独维护的值。

更新单条受影响的译文 #

更改模型、提示词、术语表或规则后,先从受影响的语言区域和键入手:

sh
lingo run --force --target-locale es --key welcome/title

这里,welcome/title 用于定位 welcome 中的 title。在 0.138.10 中,运行命令支持精确键、按边界匹配的前缀以及通配模式。为 --key 'welcome/**' 加上引号,即可选中其下级条目,且不会触发 shell 展开。

先将译文与源内容对照检查,再在应用中加载查看效果。按语言区域或键限定的处理不会更新现有的共享基线。请遵循 Lockfile 同步规则,避免后续普通运行意外重复处理同一次源内容变更。

在大型项目中划定可控的处理范围 #

--target-locale、--bucket、--file 和 --key 都是可重复使用的选择器。--source-locale 会更改本次运行所用的源内容。请先从已配置的分组/路径清单出发,再逐步缩小范围,而不是随意指定一个未配置的文件。

sh
lingo run --target-locale es --bucket json --file 'apps/web/**'

运行命令的文件匹配器支持对已发现的配置路径进行子字符串匹配或 minimatch 匹配。清除命令的文件匹配器仅支持子字符串匹配,其键匹配器也有所不同。在两个命令之间复用选择器前,请先检查实际选中的条目。

如需有计划地进行更大范围的更新:

sh
lingo run --force --bucket json --target-locale es

这会重新生成所有选定的西班牙语 JSON 译文。不加任何限定的 lingo run --force 会覆盖已配置的整个项目。扩大范围前,请先保留已认可的输出;使用 Lingo.dev 后端时,请估算相同强制处理范围的用量。

进行大规模变更时,分别限定文件范围和语言区域范围,能让差异更易于审核。如果中途失败,请保留已成功处理的分块输出,先重试相关范围,再考虑强制重新处理全部内容。并行处理只影响吞吐量,与选择范围或回滚无关。

将 UI 文案目录和文档分别放入各自的格式分组,并排除生成内容和草稿内容。如果目标或本地化引擎不同,请使用独立的软件包配置。在 CI 中,lingo run --frozen 只会对照可信基线进行检查,不执行翻译;出现失败时应排查原因,而不是重建校验和来掩盖问题。当前的运行器配置方案使用的是不同的软件包和配置,请先完成迁移再采用。

仅在确实需要删除时使用清除命令 #

以往“先清除再运行”的做法,会让目标键变为缺失状态,再交由普通运行的补缺逻辑处理。但这种做法会在重新生成成功之前就删除输出,而且并无依据表明它能提升性能。请查阅清除命令参考,确认其独特的选择器行为以及对源语言区域的风险;在重新生成和审核均顺利完成之前,请保留一份可恢复的副本。