工作原理

了解一次内容变更如何从源内容出发,借助已保存的翻译指导,最终生成可用、可检查的结果。

撰写和修改内容时,你会思考:希望读者理解什么,哪些内容需要进一步解释,哪些论点能打动他们。翻译也应在另一种语言中,同样准确地传达原意和说服意图。Lingo.dev 使用语言模型翻译你的内容,并结合已保存的产品、术语和品牌语调指导。

你提供源内容和所需语言,再选择负责翻译的本地化引擎。API 调用方通过 engineId 指定引擎;CLI 或集成则使用配置中选定的本地化引擎。这一选择决定了请求可使用的模型和共享指导。译文会通过发起请求的工具返回,质量测量和人工审核则沿着你配置的路径进行。

从内容和目标语言开始 #

你提供的内容是源内容,每个翻译版本都是一份目标内容。源内容可以来自文件、应用中的结构化数据,或已连接的内容系统。请求中指定的源语言区域和目标语言区域,决定了涉及哪些语言。

语言区域用于标识语言,并在需要时明确地区或文字系统。请明确指定目标受众:请求 pt-BR 指定的是巴西葡萄牙语,而非未指定地区的葡萄牙语。源语言区域和目标语言区域也帮助 Lingo.dev 选择适用的翻译指导。语言区域解析介绍了这些匹配规则。

内容的结构与语言同样重要。应用通过消息键查找文本,通过变量插入值;文档则包含标题、链接和格式。API 调用方直接提供结构化数据;CLI 和格式处理器从文件中提取可翻译文本,再重建目标文件。无论走哪条路径,返回的内容都必须仍能被接收系统使用。

存储翻译或日后排查问题时,请将对应的源内容版本与输出一并保留。作者一旦改变了原意,对上一版本而言准确的翻译,就可能不再传达当前想表达的信息。

保存后续请求需要的知识 #

语言模型懂得如何处理语言,却不会自动了解你的产品术语、团队约定的要求,或公司与读者沟通的方式。本地化引擎保存模型选择,并关联可复用的指导,让每次请求都能利用这些知识,无需重新发送全部信息。

不同类型的指导解决不同的问题:

  • 术语表记录术语及其预期含义、首选措辞,以及需要保留原文的名称,帮助模型区分产品概念与同一词语的其他用法。
  • 规则集包含翻译指令,用来表达术语列表无法涵盖的共通要求,包括译文必须保留的含义差异。
  • 品牌语调描述公司与读者沟通的方式,包括表达风格和正式程度。

术语表、规则集和品牌语调属于你的组织,可以关联到多个本地化引擎。相关工作流可以共享术语,同时根据需要选用不同的模型或品牌语调。修改共享资源可能影响所有使用它的本地化引擎,因此更改指导时,请先检查资源的关联情况。

每次请求时,Lingo.dev 都会从选定的本地化引擎中选取相关术语、匹配的指令、品牌语调变体和候选模型。JSON 文档还可以通过 format.options.context 描述受众或用途,并通过 format.options.hints 为各个键提供说明。这样,你既能在本地化引擎中保留共享知识,也能说明当前待翻译内容的具体特点。翻译上下文详细介绍了这些选项。

创建表单的默认设置 #

网页应用的创建表单采用以下默认设置。完成创建前,你可以更换模型,并选择现有的指导资源。

设置表单默认值
模型推荐的主模型和备用模型适用于所有语言区域对。你可以更换模型,也可以单独配置某个语言区域对。
术语表、规则集和品牌语调默认未选择任何关联资源。你可以在创建时选择现有资源,也可以稍后关联。
流水线仅翻译。可选的改写和人工审核阶段默认关闭。
术语表和指令评分;建议自动评分、建议生成和自动应用建议默认关闭。

现有本地化引擎保存的设置可能有所不同。请检查调用方实际使用的引擎,不要假定其配置仍与默认设置一致。创建和配置本地化引擎介绍了模型选择和资源关联。

生成目标内容并返回给调用方 #

选定的语言模型会接收源内容和适用的上下文。如果配置的第一个模型无法完成请求,本地化引擎可以尝试使用备用模型。备用模型只是提供另一次尝试,并不会比较两份译文,再选出质量评分更高的一份。

使用 API 时,你先创建并启动翻译任务,再下载已完成的目标内容。JSON 输出会保留文档的消息键,由你的应用决定将输出存储在哪里、如何使用。使用 CLI 时,推送和拉取会帮你完成这套文件工作流。各项集成有各自的回写方式,例如创建翻译拉取请求。集成介绍了每种连接会读取和写入哪些内容。

返回内容的结构让翻译能够衔接后续工作。请检查应用能否加载消息目录、替换其中的变量,或正确呈现文档的链接和格式。这些检查能确认接收系统是否可以使用输出;衡量译文的语言质量,则需要另一类依据。

在实际使用结果的工作流中检查结果 #

根据内容中最重要的方面选择测量项。检查原意是否保留,需要同时查看源内容和译文,并有足够的上下文来理解作者的意图。拼写检查则只需目标内容。检查的问题不同,所需依据也不同。只有能看清检查了什么,并查看结论所依据的段落,结果才有实际价值。

引擎的流水线可以在任务生成最终输出前加入人工审核。请阅读审核策略,了解覆盖范围、路由和超时处理方式:已完成的目标内容可能跳过了审核,也可能在审核超时后继续处理。独立的质量测量会另行运行,因此翻译完成不代表质量报告已完成,也不能证明结果已获人工批准。

测量也可以检查 Lingo.dev 之外生成的译文。你可以保留现有的生成系统,并通过测量了解有哪些受支持的方式可以检查其输出。测量针对提供的文本回答一个明确的问题;你的团队则决定这一结果对实际使用意味着什么。

如果审核发现反复出现的术语问题,请修正当前译文,并考虑另行调整术语表或指令,以改善后续翻译。更新共享指导不会重写所有历史译文。建议介绍了指导变更提案的处理方式。

要翻译应用中的内容,请发起你的第一个 API 请求。这份操作指南以少量请求数据为例,带你完成设置、翻译,并检查已保存的目标文件。如果源内容已存储在文件中,CLI 快速入门则会带你走完文件处理流程,直到取回结果。