Coroid您的 AI 软件工厂
文档

通过建议功能维护翻译内容

让母语使用者自行修复您网站上的措辞问题，审核他们的建议，再通过常规的拉取请求应用这些修改。

模型能正确翻译大多数字符串，但母语读者仍能发现它出错的部分。借助建议功能，这类读者可直接在您的网站上修复措辞问题，您在Coroid中审核后，相关变更会以普通的pull request形式进入您的代码库。

这就是Coroid用十三种语言维护自身产品的方式。下述步骤的前提是项目已按相关说明完成设置。翻译您的项目。

启用贡献功能

贡献功能需要两项配置：.coroid/i18n.json：项目的建议绑定机制，以及支持该机制的引擎版本。在贡献者标签页中，选择提议启用贡献功能。Coroid会创建一个任务来添加这两项配置，您合并其生成的pull request即可。在此之前，该标签页会说明还缺少哪些配置。

邀请贡献者

选择邀请贡献者，输入邮箱地址以及他们可翻译的语言即可。

  • 审核。保持在应用建议前先审核选项对新贡献者保持启用状态。关闭该选项后，建议会立即被批准，但仅当建议的源文本与您同步的代码库内容一致时才会如此。
  • 无需占用席位。贡献者不会被添加到您的组织中，也不会占用成员席位。其访问权限仅局限于该项目及选定的语言。
  • 邀请会过期。受邀人需使用被邀请的邮箱地址登录或创建账户，并在七天内接受邀请。

撤销访问权限会停止新的建议提交，但会保留该人的历史记录。

您网站上的选择器

贡献者可在您的网站上提交建议，他们能在上下文环境中查看相关文本。

  1. 在配置 → 站点来源中，逐行添加每个站点地址（每个HTTPS来源占一行）并启用该功能。新来源在所有者或管理员启用前处于禁用状态。
  2. 在贡献者标签页中，选择准备站点集成任务。该任务会将Coroid的选择器包添加到您的网站。只有当页面地址包含?coroid-translate=1时，该包才会加载，因此普通访客无需下载任何内容。
  3. 贡献者使用该参数打开您的网站，点击某个字符串后，Coroid的弹出窗口便会弹出，显示对应的键、源文本及当前译文。
ACMENeuheitenAngeboteMarken
Weiter zur Kasse gehen

Kostenloser Versand ab 50 € und 30 Tage Rückgabe.

Bestellung prüfen
翻译模式点击任意文本即可退出
建议新增翻译内容
关键词
ui · cart.checkout
英语源文本
Proceed to checkout
当前翻译
Weiter zur Kasse gehen
您的翻译
Zur Kasse

请保持大括号与尖括号内的内容与原样一致。

提交建议

处于翻译模式的客户站点：贡献者点击标题后，可在 Coroid 弹出框中提出更优的德语表述。仅为示例数据。

弹出窗口会在发送前检查占位符。贡献者需在弹出窗口中登录Coroid；您的网站不会处理他们的凭证。匿名建议不会被接受。

审核

“建议“建议”标签页会列出所有建议，包含对应的键、语言、来源、当前译文以及拟定的译文。可按状态或语言筛选，随后批准或驳回每条建议；也可批量驳回多条建议。

门店页面
已配置 · 源语区：en · 4个目标语区
概览设置配置贡献者建议自动化
待审核已批准已应用
准备修正任务
  • cart.checkoutdeLena · 德语
    en
    Proceed to checkout
    de
    Weiter zur Kasse gehen
    de
    Zur Kasse
    批准驳回
  • product.inStockfrHugo · 法语
    en
    In stock
    fr
    En stock
    fr
    Disponible
    批准驳回
  • nav.dealsdeLena · 德语

    提交的源文本与仓库中同步的文本不一致。

    en
    Weekly deals
    de
    Angebote
    de
    Angebote der Woche
    批准驳回

建议页：等待审核的修正内容，会与同步后的源文本进行比对。仅为示例数据。

Coroid会将每条建议的来源与同步后的默认分支内容进行对比。若贡献者查看建议后来源内容发生变更，则无法批准该建议，对应行也会标注相关提示；此时可驳回该建议，供贡献者重新提交。

状态含义
待审核等待审核人处理
已批准就绪，可安排下一次修正任务
已排队正在执行修正任务
已应用内容编写于pull request中；合并并部署后即可生效。
来源已变更在应用前原文内容发生了变更
无效未通过引擎校验，例如存在损坏的占位符。
已驳回审核人拒绝了该提议

应用已批准的修改建议

将已批准的修改建议转化为 pull request 有两种方式。两种方式均使用同一校正任务：它会运行指定的引擎的apply-claim命令，重新检查每个源文本，仅写入目标目录，并反馈哪些内容已被应用、哪些已过时以及哪些无效。

  • 立即执行。在修改建议选项卡中，选择准备校正任务单个任务最多可包含项目中已获批的 500 条建议。
  • 每晚执行一次。在自动化任务“审核”标签页中，选择安装夜间修正内容该计划于 UTC 时间 02 点运行。:00该计划不会调用模型，仅当有内容获批时才会创建任务。可在 Factory 中暂停或恢复该计划。

字符串在 Coroid 之外合并。

人员也会在 Coroid 未生成的拉取请求中修改字符串。请安装翻译在Coroid之外合并的字符串在自动化任务标签页中。当此类pull request合并到你的默认分支时，Coroid会读取它此前在pull request上执行的翻译检查结果。如果存在遗漏或过时的字符串，它会为该合并请求创建一个翻译任务。若无需翻译任何内容，则不会触发任何操作。

这需要翻译功能对拉取请求的控制以及审核每个PR自动化流程，确保检查在合并前执行。

审计与通知

该翻译审计控制功能会按预定计划检查每个目录。如需获知检查失败的情况，请安装审计失败通知在自动化任务标签页中。它会通过你所在组织已连接的消息工具（如Slack或电子邮件）发送一条消息。任务质量检查和拉取请求中的失败情况不会触发通知；相关信息会直接显示在相关工作区域。

将设置迁移至其他组织

设置导出与导入功能会携带夜间调度计划和两类钩子自动化规则。它们会在目标项目中处于暂停状态，站点源也会被禁用，且贡献者信息不会被同步：需在新组织中重新邀请他们。