Crowdin 测量来源
在 Radar 中收集 Crowdin 翻译活动,通过已定义的测量分析文本和编辑过程。
继续在 Crowdin 中翻译和审核,同时用 Lingo.dev 分析翻译质量。Crowdin 连接会接收受支持的字符串级事件,并将事件中的文本作为测量依据提供给 Radar。翻译和发布工作流仍在 Crowdin 中进行。
在 Studio 2.5 的导航中,请打开 Studio 2.5 → 集成,而非 设置 → 集成。现有的连接和配置链接仍可正常使用。
源文本变更、新建议、批准操作和导出目标文本的更新,分别反映了工作的不同环节。该连接会保留这些区别,让测量能够分析实际所需的文本或变更。它不会生成翻译,也不会将修正后的文本发回 Crowdin。
连接来源 #
- 在要使用的 Lingo.dev 组织中,打开 设置 → 集成,选择 Crowdin 的 连接。如果该功能不可用,请检查组织的功能访问权限。
- 输入连接的 名称。如果使用 crowdin.com,请将 Enterprise 域名 留空。如果使用 Crowdin Enterprise,请输入
.crowdin.com前面的部分,例如acme,然后选择 连接。 - 复制提供的 webhook URL。在每个需要测量的 Crowdin 项目中,打开 工具 → Webhook,使用该 URL、POST 方法和 JSON 请求体添加 webhook。选择下方列出的受支持字符串事件。
请像保护凭据一样保护 webhook URL:接收端会使用其中的密钥验证传入事件是否获得授权。不要将该 URL 写入工单或仓库文件。一个组织连接可以接收多个项目的事件,每个事件都带有项目标识。请记录已配置的项目,以便明确后续报告的覆盖范围。
选择所需的字符串事件 #
在 Crowdin 中订阅受支持的字符串级事件:
| Crowdin 事件 | 提供的依据 |
|---|---|
string.added, string.updated, string.deleted | 源字符串活动。 |
suggestion.added, suggestion.updated, suggestion.deleted | 候选翻译活动。 |
suggestion.approved, suggestion.disapproved | 针对建议的审核操作。 |
translation.updated | 导出的目标文本新旧版本之间的变更。 |
对于导出的翻译,旧值为空、新值存在表示创建;新旧值均存在表示更新;旧值存在、新值为空表示删除。建议获批与导出的目标文本发生变更是两个独立事件。
此适配器不会将 file.approved 和 file.translated 等文件级事件转换为字符串测量依据。不受支持的事件类型,以及缺少项目或字符串标识的事件,可能会被跳过。首次验证时,请使用受支持的字符串事件,不要仅凭 webhook 投递成功就认定已获得可用的测量依据。
追踪一次翻译变更的测量过程 #
首次测试请使用内置的 编辑距离 测量。它会在目标文本创建或更新时运行,将新的目标文本与该字符串之前的翻译进行比较。创建测试活动前,请先在 Radar 中启用该测量。
- 选择一个已知的项目和字符串,以及一个已有翻译的目标语言。记录现有翻译和您准备批准的文本。
- 通过 Crowdin 的常规审核工作流批准一条编辑后的建议,并检查
translation.updated是否已投递到配置的 webhook。 - 在 Lingo.dev 中找到对应的目标文本事件。对照记录的两段文本,核对事件的项目、可读键、语言区域和目标文本。如果测量使用的先前翻译不是您预期的比较对象,请先检查该字符串更早的事件,再解读距离值。
- 打开编辑距离结果,确认测量定义、参与比较的文本和计算完成后的数值结果。内置测量参考说明了其分母和字符单位的限制。
此测试将服务提供方的一次操作与您之后要解读的结果对应起来。字符串的首次翻译没有更早的版本,因此编辑距离的结果为 0。批准操作本身会记录为 suggestion.approved,不会触发任何编辑类测量。内置的术语表和规则检查使用本地化已完成事件,而不是 Crowdin 的编辑或批准事件。要测量其他事件类型,请针对该事件及其可用依据配置自定义测量;内置触发器不能改为其他事件。
事件的时间戳和身份信息有助于将记录与其来源关联,但其含义取决于具体活动。翻译和建议事件(包括批准)使用译文的 createdAt;今天收到的批准可能显示在较早的创建日期下。接收时间用于区分对同一条建议的多次否决,并在时间戳缺失或无效时作为替代;每条建议的批准只记录一次。筛选事件或选择历史测量时段时,请查看记录的 eventAt。没有时间戳,后续的文本提取就无法可靠地重新匹配每个事件。即使缺少作者信息,也不能在没有证据的情况下将事件归于某个人或模型。
结合覆盖范围解读结果 #
Webhook 从活动投递时起收集已配置的活动,无法完整反映此前的翻译、源文本修订或项目历史。请求体缺少文本、不受支持的事件和未配置的项目,都可能减少可供测量的内容。重复投递的审核事件可能生成独立的依据记录,因此事件数量不一定等于去重后的已审核翻译数量。
请区分不符合某项条件的记录,以及符合适用条件但缺少必要文本的记录。对于评估,还应区分已完成且结果明确的评估、已完成但结果无法判定的评估,以及尚未得出结果的评估工作。无法判定的结果说明评估工作已完成,但既不能判为通过,也不能判为不通过。
报告通过率时,请以明确的评估结果为分母,并说明符合条件的内容中有多少获得了明确结果。缺少评估并不意味着翻译质量差;Crowdin 中的批准反映的是该项目的审核流程,不能独立证明语义正确。设计翻译质量测量进一步介绍了计算和解读方法。
修复投递或停用来源 #
如果不再出现新的测量依据,请检查项目的 webhook 订阅、事件类型、投递错误和目标 URL。确认请求使用 POST 方法,以 JSON 格式发送到连接当前的 webhook URL。该连接不会自动补回遗漏的事件。要评估 Lingo.dev 已收集的事件,请使用历史测量工作流。
如果 webhook URL 已泄露或需要更换,请在 设置 → 集成 中打开该连接,选择 轮换,再选择 轮换 URL 确认。旧 URL 会立即失效。将新 URL 复制到每个已配置的 Crowdin 项目中,然后验证受支持事件的投递情况及其在 Radar 中的测量依据。
断开连接后,该连接将停止提供新的测量依据,已记录的测量仍会保留。请另行移除 Crowdin 项目的 webhook。Crowdin 中的翻译和审核操作不会改变。如果报告的时间范围跨越断开连接的时段,请将未收集数据的时段纳入考虑,不要将其解读为没有开展翻译工作的时段。