翻译您的项目

Coroid使用其自身支持的十三种语言相同的引擎来翻译您的产品。您的目录文件会存储在代码库中。对它们的任何更改都会作为普通任务提交，生成对应的pull request，且仅新添加、已变更或损坏的字符串才会被发送给模型处理。

翻译内容存储在Quality Control → 翻译。该列表会显示每个项目的情况、是否已完成翻译配置以及最新的扫描结果。打开项目即可进入其工作台。

代码库所需的内容#

Coroid可读取以下格式的目录文件：

您暂时还不需要翻译功能。如果项目尚未集成i18n，Coroid可以帮您引入相关功能。

设置#

该设置标签页会引导您完成三个步骤。

1. 检测。Coroid会生成一个检测任务。它会用指定的翻译引擎扫描您的代码库，记录技术栈、目录文件、源语言以及无法确定信息的部分。
2. 选择。选择沿用现有i18n以保留现有的框架和目录文件，同时添加Coroid的检查机制和增量引擎。选择引入i18n让Coroid为您配置框架、提取代表性字符串，并添加多语言路由、回退机制及从右到左排版支持。
3. 创建。Coroid会根据规范及验收标准生成设置任务，最终生成的pull request可像其他任务一样供您审核。

一旦该pull request被合并到默认分支，设置即完成，Coroid会同步相关内容。在此之前，工作台中的其他功能不会依赖已完成的设置。

代码库文件#

设置过程会写入.coroid/i18n.json。该文件用于描述您的代码库信息，因此会存储在代码库中，并通过拉取请求进行更新：

{
  "version": 1,
  "cli": { "version": "1.7.0", "sha256": "…" },
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "ja", "ar"],
  "catalogs": [
    {
      "id": "ui",
      "format": "i18next-json",
      "source": "messages/{locale}.json"
    }
  ],
  "localeTier": { "ja": "escalation" }
}

• cli它会指定引擎的确切版本及校验和。每次运行时，Coroid都会下载并验证该版本，避免更新意外改变翻译输出结果。
• sourceLocale可以是任意语言。例如瑞典语源文本翻译成英语和德语的流程完全一致。
• localeTier用于指定某个语言区域所需的更高级别的翻译服务等级。您可自行选择等级，而非指定具体模型。

该文件还可存储术语表、受保护的术语、产品背景信息及各语言区域的特殊说明。

如需修改，可在配置标签页中编辑，然后选择提议更改。Coroid会生成一个任务，应用该文件内容并修复受更改影响的翻译。

同一标签页还包含属于Coroid而非代码库的设置：允许哪些站点打开建议选择器、建议是否默认需经过审核，以及项目的翻译费用上限。

检查每项更改#

翻译内容会通过两项Quality Control机制纳入验证流程。可从概览标签页添加相关内容。

• 翻译会在任务QA环节及拉取请求中运行。它仅检查本次更改涉及的字符串。
• 翻译审计会按预定计划运行。它会检查所有目录文件及语言区域，还可包含对相应语言页面的浏览器测试，以验证从右到左排版、内容溢出及页面未翻译文本等情况。

添加控制规则时会生成策略草案。审核通过后，即可在质量策略下发布以启用该功能。

每个问题都会生成带有问题代码的发现结果：

您可以在控件设置中选择需要屏蔽的代码。当您的文件配置了术语表、长度及禁用词规则时，系统会针对这些规则返回对应的代码。

当翻译查找过程阻塞了任务时，开发者智能体每次都会采用相同的方式修复：它会为该任务开启一个翻译会话，并对变更的字符串运行引擎，绝不会手动编辑目标目录。

Translator模型#

翻译在AI配置文件中拥有独立的角色，Translator，与架构师、开发者、QA及审核员并列。默认情况下它使用Hy-MT2翻译模型，在符合贵组织政策的前提下会以GPT-6 Luna作为备用模型。您可以像调整其他角色一样，在AI配置文件中修改其映射关系。

引擎还会按照大小对字符串进行批量处理，验证每条回复是否符合您设定的占位符及复数规则，若回复不合格则会重试或升级处理该字符串。

费用#

所有套餐均支持翻译功能。翻译请求会通过Coroid的翻译网关转发，产生的费用将计入贵组织的模型使用费，与智能体运行费用性质相同。设置类任务也会像其他任务一样，占用套餐规定的智能体运行时长配额。

采用默认的Translator路由时，每1000个字符串每种语言的翻译成本约为两美分。经测算，将包含2000个字符串的目录翻译成10种语言的成本约为0.33美元。

• 仅变更部分才会产生费用。引擎会以源文本为键保存缓存，因此未变更的字符串不会再被重新发送。
• 每个任务都设有翻译数量上限。会话会在达到任务的花费上限后停止，默认上限为1美元。项目可在此处设置更低的上限： 配置 → 访问权限与花费。
• 检查项不会产生模型调用。翻译控件和审计功能会读取您的目录内容，但不会执行翻译操作。

在Coroid之外进行翻译#

引擎是一款命令行工具，coroid-i18n。您自己的CI系统可以运行相同版本的引擎，并搭配专属的OpenRouter密钥。在Coroid内部，任务始终通过翻译网关处理，因此花费和限制规则会统一管控。

相关主题#

• 通过建议功能维护翻译内容
• 质量策略与审核关卡
• 检查项、运行流程与发现结果
• AI配置文件