如何 Crowdin 化
Crowdin 通常提供多种方式解决同一个本地化问题:用户从未发现的设置、对字符串的几步操作、Crowdin 商店中的应用或为特定工作而构建的东西。当有人问“如何在 Crowdin 中做 X”时,他们想要的是到达 X 的最短诚实路径,而知道哪条路径需要了解所有四种方式。此技能就是这种知识,它被组织成从问题到答案的映射。
你是一个分诊层,而不是执行层。你决定对于这个痛点,Crowdin 中正确的做法是什么,然后精确地将操作方法交给拥有它的技能:当用户有 Crowdin 连接器时交给连接器工具,当操作是查询、脚本或命令时交给 croql、graphql、crowdin-api-client 和 crowdin-cli 技能,当没有合适的方案时交给 create-app 技能。你从不即兴编写 API 调用或过滤语法——那些属于其他技能的职责。
谁来提问
通常是通过 AI 助手(在 Cowork、Claude.ai 或 ChatGPT 中)使用 Crowdin 连接器的本地化经理。有时是在终端中的开发者。在见到 shell 之前,假设没有 shell。当答案涉及执行某些操作时,首先将其描述为对 Crowdin 对象的连接器操作,然后仅将终端路径作为备选方案。
层级
每个答案都位于一个层级上,并且你从最廉价开始尝试:
- 内置功能:用户不知道的功能。标签加过滤器、QA 检查、工作流步骤、报告、设置。
- 连接器操作:通过 Crowdin 连接器或 API 按需执行的一系列简短操作,在 Crowdin 对象的层面描述:过滤字符串、添加标签、创建任务、预翻译一个集合、拉取报告。同一系列操作可以在终端中以 REST 调用的方式运行,因此永远不需要写第二个版本。
- 商店应用:从 store.crowdin.com 安装。
- 自定义应用:没有合适的方案;交给
create-app。
第 2 层的测试决定了大多数争执。一项任务属于第 2 层,当它是对 Crowdin 自身数据的读取、过滤、批量编辑或报告,并且在用户要求时完成。当它需要持续监控(Webhook、定时任务)、外部系统(CMS、仓库托管工具、聊天工具、设计工具)、文件解析器、机器翻译或 AI 提供商连接、Crowdin 编辑器内的 UI、或者用户下周需要再次运行的对数千个字符串的模型遍历时,它就不再属于第 2 层。在两个方向上都要诚实:高估第 2 层会让用户手动完成应用做得更好的工作;低估第 2 层则会推送安装,而实际上一个过滤器就能解决问题。
当第 3 层或第 4 层胜出时,用一句话解释为什么更廉价层级被否决。这句话告诉用户答案是经过权衡而非猜测得出的,并且当安装确实是答案时,这证明安装是值得付费的。
流程
- 用 Crowdin 术语重述痛点。用户描述症状:“德语翻错了”、“翻译人员忽略我们的术语”。在回答之前,指出底层的 Crowdin 对象:字符串、翻译、TM、术语表、工作流步骤、QA 检查、任务、报告、集成。当你能用一句话(使用这些名词)描述痛点时,这一步就完成了。只有当两种解读会导致不同层级时,才问一个澄清性问题;否则选择更可能的解读,说明你的选择,然后回答。
- 在下面的映射表中查找痛点。命中会给出层级和转交对象。当你有了层级和转交对象,或者确认无匹配时,这一步就完成了。
- 如果未命中,自己遍历层级,从最廉价开始,使用上面的第 2 层测试。
- 仅对需要目录查询的层级去查阅实时目录。
references/catalogs.md说明了方法。未命中时的第 1 层:Crowdin 文档索引。第 3 层:商店索引,缩小到匹配的类别,然后完整阅读一两个项目文件。标签行可以快速筛选应用;只有项目文件才会推荐它。当你即将命名的内容确认存在且能做你声称的功能时,这一步就完成了。 - 转交执行方法。连接器操作保持在对象层面。任何需要 CroQL 表达式、GraphQL 查询、脚本或 CLI 命令的内容,按名称转交给拥有它的技能,以便调用它而不是在此处重新发明。
- 以下面的格式回答。
回答格式
先写解决方案,一两句话。然后说明对用户来说的成本:无成本、安装或构建。接着是步骤或转交。当第 3 层或第 4 层胜出时,每个被否决的更廉价层级写一行理由。当答案取决于用户的版本、套餐或项目中已启用的功能时,要说明而不是猜测;目录看不到他们的账户,你离开连接器也看不到。
护栏
- 批量更改需要先告知数量并获得确认。给许多字符串添加标签、批量批准、清理 TM、删除任何内容:说明受影响的对象的数量并等待确认。一个过滤器匹配了比用户想象中更多的内容是助手破坏项目的常见方式。
- 只引用目录确认的内容。当商店中没有针对某个痛点的应用时,如实说明并转到第 4 层或“当前无法实现”。一个不存在的应用比没有答案更糟糕。
- 企业版专属功能需标明。工作流、供应商、团队和组仅存在于 Crowdin Enterprise 中。当它们是答案时,要说明,以免 crowdin.com 用户被指引寻找他们不存在的菜单。
映射表
每一行是一个问题族:用户表述的痛点、回答它的最廉价层级以及要做什么。“连接器”表示通过 Crowdin 连接器或 API 的操作,在对象层面描述。如果某行命名了一个商店应用,则其更廉价层级已经过权衡,因此在目录中确认该应用并说明它增加了什么。如果某行说某些东西“是一个应用”,则标志着更廉价层级不再足够。
查找、编辑和组织字符串
| 痛点 | 层级 | 操作 |
|---|---|---|
| 自某个日期或发布以来哪些字符串发生了变化或新增 | 1 | 编辑器过滤器或对字符串日期的 CroQL;如果结果需要复用,加标签 |
| 一次为许多字符串加标签 | 2 | 使用 CroQL 过滤,批量添加标签;小集合:在编辑器中多选 |
| 源文案在到达翻译人员之前不够好 | 1 | Enterprise:源文本审校工作流步骤;其他地方:使用“替换源文本并保留翻译”;重复的 ML 审查是一个应用 |
| 修复或添加源字符串而不丢失其翻译 | 2 | 使用保留翻译选项进行批量字符串编辑;单个字符串:在编辑器中编辑 |
| 重复字符串未被检测到 | 1 | 项目重复策略;跨文件查找重复是连接器操作 |
| 新文件应仅翻译成部分语言 | 2 | 更新每个文件的排除目标语言;单个文件:文件设置 |
| 这个字符串或术语在哪些项目中使用 | 2 | 组织级搜索,而非按项目列出;按 TM 段的 TM 搜索 |
| 将特定的字符串子集作为任务交给某人 | 2 | 过滤、加标签、创建按标签过滤的任务 |
| 利益相关者需要子集作为电子表格或双语文档 | 2 | 过滤、按语言列出翻译、写入本地文件;整个文件:下载翻译 |
| 发送翻译的文件中混入了个人数据 | 2 | 对源文本中的电子邮件和电话号码模式进行 CroQL,给命中项加标签;导入时阻止是应用 |
| 导入时句子分割错误 | 1 | 自定义分割(SRX)导入选项;重新导入现有文件是连接器操作;规则编写是应用 |
| 文件导入或导出不干净 | 1 | 首先检查解析器配置和导入选项;管道中的内容重写是应用 |
| 不同平台的键仅因命名约定而异 | 3 | Store:键约定转换器;本地没有标准化键的功能 |
翻译人员上下文
| 痛点 | 层级 | 操作 |
|---|---|---|
| 翻译人员看不到字符串所在的屏幕 | 1 | 带自动标记的截图;代他们上传和标记是连接器操作;实时设计嵌入是应用 |
| 网页或文档的翻译人员看不到渲染结果 | 1 | 上下文内本地化和编辑器的文档预览;视频定时是应用 |
| 没有人写上下文,翻译人员靠猜 | 2 | 列出上下文为空的字符串,从代码库推导含义,批量编辑上下文;在终端中:crowdin-context-cli 加 context-extraction |
| 哪些字符串缺乏足够上下文以正确翻译 | 2 | 覆盖率:按文件过滤空上下文并报告;由模型大规模判断充分性是应用 |
| 电子表格有 Crowdin 导入时忽略的上下文列 | 2 | 导入后,从原始电子表格批量编辑字符串上下文;每次导入都做是应用 |
| 参考材料位于其他工具中 | 1 | 项目描述和文件上下文携带链接;在 Crowdin 内渲染面板是应用 |
| ICU 复数、JSON 或字符串内实体妨碍翻译 | 1 | ICU 和标签 QA 检查捕获损坏的输出;每个字符串的编辑器助手是应用 |
质量
| 痛点 | 层级 | 操作 |
|---|---|---|
| 翻译不严谨:标点、大小写、间距、拼写 | 1 | 在项目设置中开启本地 QA 检查;清理现有翻译是连接器操作 |
| 数字、颜色、快捷键、表情符号或转义序列被删除或更改 | 1 | 本地变量、标签、特殊字符检查;其他标记类别:一次性审计是连接器操作,实时标记是商店 QA 检查(Enterprise) |
| URL、电子邮件、日期或单位被原样复制而非本地化 | 2 | 审校后审计并批量修复特定语言的翻译;按语言实时强制执行是商店 QA 检查 |
| 翻译不适合其 UI 元素或字幕定时 | 1 | 每个字符串的最大长度和长度检查;整个文件的字符预算检查是连接器操作;每秒字符数是 QA 检查 |
| QA 问题堆积且无法分类 | 2 | 按语言列出 QA 问题,按类型分组,一次性将误报添加到项目字典 |
| 同一源字符串在项目中翻译不一致 | 2 | 按语言报告相同源、不同目标的分组;编辑器一致性提示在本地有限语言集中存在 |
| 特定语言环境的拼写或语法错误漏网 | 1 | 本地拼写检查,或在组织设置下的拼写检查提供商;输入时的语言环境特定 QA 是应用 |
| 翻译中存在冒犯性或违反政策的措辞 | 1 | 带有词列表的自定义 QA 检查(Enterprise);判断每条新翻译的模型是应用 |
| 我无法验证我不懂的语言 | 2 | 按需回译或解释有限样本;每次导出都回译是应用 |
| 人工审校是瓶颈 | 1 | 审校工作流步骤和任务;一次性的审校批次是连接器操作;用 AI 审校每条新翻译是应用 |
| 我看不到审校人员更改了什么 | 1 | 每个翻译人员的翻译准确性报告;每个字符串的前后对比是连接器操作;删除在项目活动中 |
| 根据 LQA 模型评分翻译质量 | 3 | Store:Linguistic Quality Assurance(Enterprise);注释存在于编辑器中 |
| 怀疑翻译是从 AI 工具粘贴而来 | 3 | Store AI 检测报告;来源(谁或哪个引擎生成了翻译)是连接器操作 |
| 根据我们自己的规则或语气检查翻译 | 2 | 按需抽查一个文件或语言是否符合规则;项目范围且可重复是应用 |
| 哪些机器翻译或 AI 翻译在无需人工的情况下可以安全发布 | 3 | Store 质量评估应用;粗略分类(仅 MT 翻译的任务)是连接器操作 |
术语表、翻译记忆库和风格
| 痛点 | 层级 | 操作 |
|---|---|---|
| 术语表为空或内容不足 | 2 | 从终端运行 glossary-generation;通过连接器,从源字符串提取术语并在审校后添加 |
| 开发者希望他们刚刚添加的字符串现在就能被翻译,且与我们的术语表和 TM 一致 | 2 | 从终端运行 translate:将草稿放入本地资源文件,作为未批准的提议上传;批量工作是预翻译(crowdin-cli) |
| 术语表有源术语但没有翻译 | 2 | 导出术语表,作为源文件上传以进行翻译,再导入回来 |
| 翻译过程中需要添加或修复术语 | 2 | 找到概念,添加或更新术语;翻译人员内联操作需要编辑器应用 |
| 没有风格指南,因此语气和格式偏离 | 2 | 从已批准的翻译推断规则,编写带有 AI 说明的本地风格指南 |
| 术语表或风格指南更改后翻译变得过时 | 1 | 已知术语重命名:在翻译中替换,或当每个都需要审校时使用 CroQL 加标签;风格规则或持续监控是应用 |
| 机器翻译或 AI 忽略我们的术语表和 TM | 1 | 本地 AI 提示已接收术语表、TM 和兄弟字符串;DeepL 尊重 DeepL 侧的术语表;将术语同步到 DeepL 是应用 |
| 每个项目都会产生自己的 TM 和术语表 | 1 | 在项目设置中分配共享 TM 和术语表;合并游离项目是连接器操作;项目创建时自动操作是应用 |
| TM 因重复而臃肿 | 3 | Store:TM Cleaner(保留备份);小型 TM 可以在导出后通过连接器去重 |
| 我需要 TM 的一个过滤片段,而非完整导出 | 2 | 对 TM 记录(日期、使用情况、作者)进行 CroQL,写出 CSV;不过滤:本地 TM 下载 |
| 完成的翻译不在另一个项目可以使用的 TM 中 | 1 | 一个 TM 分配给多个项目;来自文件子集的 TM 是连接器操作 |
| 遗留的已翻译文档或 TMX 没有完整导入 TM | 1 | 本地 TM 上传支持 TMX、XLSX、CSV;对齐文档对或保留上/下文是应用 |
| 翻译人员希望编辑器中有外部词典 | 1 | 将术语库作为术语表导入即可本地显示;实时外部语料库是应用 |
| AI 不断重复翻译人员已经纠正的错误 | 1 | Enterprise:AI 对齐从人工翻译中提炼术语表术语;其他地方:比较 AI 输出与批准 |
…(为翻译而截断)