本文档是面向Xliff工具的开发者和使用者的实践指南。本指南的目的是充分发挥Xliff工具的潜力。请使用本指南作为参考，并将其整合到您的工作流程中。
翻译最佳实践
翻译可以通过两种模式进行：机器学习（ML）翻译或基于大型本地模型的翻译。前者更受青睐，具体说明如下：
ML翻译
无需额外成本。
在离线模式下运行时，翻译完全是在本地进行的，确保强大的隐私性。
翻译是直接的，准确率很高。
翻译速度很快。
本地大语言模型翻译
无需额外成本。
翻译是在本地进行的，确保强大的隐私性。
可以通过提示词对翻译进行优化，但由于本地大语言模型的局限性，翻译质量可能不稳定，有时甚至无法将翻译结果翻译成目标语言。
不同模型对不同语言的翻译质量水平有所不同，可能需要通过搜索来找到最合适的模型。
翻译速度因机器配置和所选模型的规模而异，但通常比ML翻译要慢。
验证最佳实践
有两种验证方法：直接验证和交叉验证。建议使用交叉验证。
源文上下文
在 macOS 上打开 Xcode 导出的 .xcloc 文件时，Xliff Tool 可以自动查找或让您选择对应的 Xcode 项目。之后，您可以查看字符串附近的源代码片段、在 Xcode 中打开对应位置，并使用这些上下文辅助翻译或验证字符串。
对于在线模型，Xliff Tool 会在发送这些小段源代码到模型服务器前请求许可。您可以拒绝并继续使用不带源文上下文的功能。本地 Ollama 模型则可以通过本地服务器使用这些上下文。
推荐流程
翻译的一般流程为：从Xcode导出、翻译、验证翻译结果，然后将其导入Xcode。
对于熟悉的语言，可以先使用ML翻译，然后进行人工审查和验证。
对于不熟悉的语言，可以先使用ML翻译，然后通过大语言模型进行验证。通过交叉验证可以提高大语言模型验证的准确性。
大语言模型交叉验证是指使用已经验证过的目标语言来验证翻译结果，而不是使用源语言。
例如，英语单词“check”有两个含义：检查和银行支票。假设我们需要将英语单词“check”翻译成日语。在验证过程中，仅依赖源语言中的“check”并不能告诉我们翻译成日语应该是“检查”还是“银行支票”。在这种情况下，我们可以使用已经验证过的第三方语言进行验证。例如，如果我们已经有了英语到中文的翻译，我们可以使用中文翻译来验证日语。如果中文翻译是“检查”，而日语翻译是“银行支票”，则表明日语翻译中存在错误，需要人工纠正。
以下是翻译步骤的详细描述。
1. 从Xcode导出多语言文件到iCloud中的Xliff工具文件夹
Xliff工具使用CloudKit来同步其内部数据库，这不包括从Xcode导出的xcloc文件。因此，如果您也想同步这些文件，需要将它们放在一个可以自动同步的文件夹中。Xliff工具在iCloud Drive中创建了一个专用的应用文件夹，建议使用该文件夹。
您也可以使用其他同步服务，如Dropbox或OneDrive。
2. 打开需要翻译的文件
3. 人工智能翻译
建议在macOS上下载常用语言的离线翻译包，这样可以提高翻译速度。具体使用方法，可以参考这篇文章：使用ML翻译。
大语言模型翻译有时会对要翻译的内容进行过度解释。因此，在验证过程中需要更多的努力。
4. 审查翻译结果
对于熟悉的语言，建议使用人工审查来提高准确性。此外，人工审查的结果也可以用于大语言模型交叉验证，从而提高用户不熟悉的语言的翻译准确性。
对于不熟悉的语言，可以使用大语言模型交叉验证。
在macOS上，用户可以使用cmd + enter来确认审查结果。 在iOS/iPadOS上，用户可以在目标文本编辑视图上方向左滑动以确认审查结果。
5. 保存
所有翻译完成后，用户可以保存结果。
可以在任何时候保存。如果翻译不完整，保存的结果将是不完整的。需要注意的是，即使没有确认所有的翻译结果，只要内容已经翻译完成，就会保存下来。但是，此时获得的只是翻译后的内容，而不是确认和修改后的最终结果。
将翻译完成的多语言文件导入Xcode，翻译过程就完成了。
关于同步
Xliff工具需要同步两部分数据。一部分是从Xcode导出的多语言文件；另一部分是Xliff工具存储的内部数据库。
对于前者，Xliff工具并不处理同步，但它在iCloud Drive中创建了一个专用的文件夹，您可以使用该文件夹。该文件夹通过iCloud自动同步。您也可以使用其他同步解决方案。
对于后者，Xliff工具使用CloudKit进行同步。
如果您在同一时间在多个设备上打开同一文件，默认行为是在两个设备上以相同的顺序提示您进行操作，您在其中一个设备上进行的任何翻译或确认操作都会反映到另一个设备上。