lingo push
提交源文件变更、补齐缺失的目标文件,或按需刷新选定的翻译。
完成首个文件的设置后,使用 lingo push --wait 处理日常源文件修改。CLI 会逐字节比较源文件与基线,提交变更部分的处理请求,并下载已完成的目标文件。字节内容完全相同的源文件会被跳过。
其他模式各有用途。请根据需要变更的内容选择模式,不要把每次推送都当作全量翻译。
选择要处理的内容 #
| 调用方式 | 行为 |
|---|---|
| 无有效基线时普通推送 | 存储源文件的字节内容;不会自动请求首次翻译。 |
| 有基线时普通推送 | 增量翻译源文件中的变更内容。 |
lingo push 'locales/en.json' | 按指定范围规划,不执行常规的前次源文件差异比较;可采用现有目标文件。 |
lingo push --backfill-missing | 为所有已配置的源文件创建缺失的目标文件。 |
使用 --force 按指定范围推送 | 重新生成选定的独立目标文件,不保留现有目标内容作为上下文。 |
使用 --key 推送 | 选择现有目标文件中具有稳定键的单元;是否复用未变更的值取决于文件格式。 |
补齐操作不会向已存在的普通目标文件添加新增或变更的键。它会对基线之后的源文件变更发出警告;请先通过普通推送完成这些常规更新,再进行补齐,确保现有语言的内容保持最新。仅覆盖部分已配置语言区域的文档会保留现有源文件基线,因此后续普通推送仍可处理其他语言区域尚未处理的修改。共享的 XCStrings 目录采用按语言区域规划。位置参数模式只匹配配置范围内的文件,不接受任意文件。
选项 #
| 选项 | 作用 |
|---|---|
| 位置参数模式 | 选择已配置的文件;命令行通配符需用引号括起。 |
--force, -f | 替换整份文件的翻译;需使用明确的文件模式或补齐操作。 |
--backfill-missing | 初始化缺失的目标文件。 |
--key <pattern> | 选择稳定单元,可多次指定。 |
--yes, -y | 跳过强制替换确认。 |
--wait, -w | 等待并下载结果,而非提交后立即返回。 |
--estimate | 规划工作并估算费用,不执行翻译,也不创建任务。 |
--with <stage> | 仅在本次推送中运行指定阶段;可重复使用。 |
--without <stage> | 仅在本次推送中跳过指定阶段;可重复使用。 |
--review-*, --content-length | 调整阶段设置,仅对本次推送生效。 |
布尔标志默认为假。目标语言区域由配置决定;推送不提供语言区域标志。整份文件的强制替换会要求确认,除非使用自动确认、键范围或估算选项跳过确认。未提供位置参数模式时,--force 会选择所有已配置的源文件和目标语言区域。大范围替换前,请使用明确的文件模式,并通过 --estimate 检查范围。对于独立文件格式,强制替换会清除当前目标内容的上下文,因此可能覆盖手动修改的目标内容。XCStrings 目录和 CSV 表格仍可复用共享源文件中内嵌的翻译。
刷新选定的键 #
当已保存的指导规则发生变更但源文本未变,或明确需要重新翻译某个子集时,请使用键刷新:
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait键使用点号或方括号表示路径,选择一个对象会包含其下的所有字符串:auth.login 包含 auth.login.title,但不包含 auth.login_url。* 代表一个完整的路径段。早期 CLI 使用的斜杠形式(如 auth/login)也受支持。JSON、JSONC、TypeScript 和 PHP 会重新生成选定的字符串,即使源文本未变。YAML 和根键 YAML 支持键选择,但当源内容与已保存的基线一致时,可能复用当前目标值。要修正 YAML 的措辞,请直接编辑目标文件;要在指导规则变更后进行更大范围的重新生成,请保存已接受的目标内容,并使用整份文件的 --force,不要使用 --key。
缺失的目标语言区域和不具备稳定键的格式会被跳过,并显示相应提示;其他格式会报错并停止推送。请单独初始化缺失的目标文件。为 --key 添加 --force 不会改变按键范围规划的方式,也不会阻止 YAML 复用。
按键范围推送不会改变整个源文件的基线,无论结果由 push --wait 还是后续的 pull 收取。因此,尚未处理的常规源文件修改仍会在下一次普通推送时得到处理。范围介绍了格式支持矩阵和键语法。
大范围替换前先估算 #
lingo push 'locales/en.json' --force --estimate估算会精确规划增量,不执行翻译,也不创建任务。它会上传服务器执行该计划所缺少的文件,因此会实际调用产品服务,并非离线试运行。它不会替换已保存的拉取指针或已完成的基线。首次推送仅存储源文件,因此其估算结果会提示没有可估算的内容,并指向 lingo push --estimate --backfill-missing。
输出会列出计划费用、待生成和可复用的翻译、输出词元数,以及各语言区域的明细。后续修正可能产生的费用,以及由您自己的 AI 提供商收取的费用,会单独列出,不计入计划总额;随后会通过警告说明估算未涵盖的内容。标有 ~ 的金额为近似值,反映的是计划,而非实际用量或报价。如果推送规模过大而无法估算,操作会失败,并显示服务器给出的原因;可传入文件模式,仅估算其中一部分。
更改单次推送的阶段 #
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-edit阶段标志只会更改本次推送的引擎流水线,让你无需编辑或重新创建引擎,就能尝试不同配置。未通过标志指定的设置均沿用引擎配置,包括人工审核池。
--with 和 --without 可接受 pre-edit、rephrase、human-review、post-edit、content-length 或 back-translation。翻译阶段始终运行。--without 还会跳过依赖于被跳过阶段的其他阶段:--without human-review 会跳过 AI 评估和译后编辑。
| 设置 | 值 |
|---|---|
--review-level | everything 将所有单元发送给审核者;strict、medium 或 lax 仅发送在 AI 评估中被标记为相应严重程度的单元。 |
--review-pool <name> | 审核使用此池,不再使用引擎的审核池。 |
--review-languages <locales> | --review-pool 池审核的语言区域,以逗号分隔;默认审核所有语言区域。 |
--review-timeout <hours> | 审核者可用的审核时长,以小时计。 |
--content-length <rule> | source、match:<percent> 或 max:<columns>。 |
设置只会调整阶段,不会启用阶段。因此,如果该阶段未运行,推送就会失败:请添加 --with human-review 或 --with content-length。在未配置审核池的引擎上使用 --with human-review 时,还需提供 --review-pool。如果请求运行的阶段不在你的套餐范围内,推送会失败,而不会跳过该阶段。本次推送会像其他推送一样写入结果;添加 --force 或 --key 可重新翻译未更改的单元,添加 --estimate 可先估算该配置的费用。重试时必须使用相同的阶段标志。
添加新语言时,请先完成现有目标文件的常规源文件更新。然后将新语言添加到 targetLocales,检查 lingo push --backfill-missing --estimate,并在不改变源文件版本的情况下请求补齐。添加语言介绍了从上述操作到应用检查的完整流程。移除语言区域会停止后续选择,但不会删除文件。不要对共享的 XCStrings 目录执行语言区域清除操作。
收取结果与恢复 #
不使用等待模式时,请保留 checkout 和本机指针,直到 拉取取得输出。再次推送可能替换该指针。使用等待模式时,请检查失败或部分失败的结果,以及实际下载的文件。当所有尚未完成的目标都在等待人工审核时,等待会停止;请在审核者完成审核后运行拉取。在等待模式下直接收取结果期间,请勿编辑目标文件,因为这种方式不会像拉取那样重新比较本地修改。
要重试失败的工作,请先解决导致失败的问题,再按照失败运行恢复流程操作:保留状态,重新执行相应的推送,确认显示的任务 ID,然后检查输出结果。如果先前的推送尚未收取结果且请求未变,推送会复用该请求,而不是重复创建:正在运行的任务会重新关联,已完成的任务会收取结果,失败的任务则会由新任务替代。