SuperAPI AI 工具集

translate

通用与其它

查看项目

更新于 10-15 23:41

技能介绍

用途:这是一个处理 XLF 翻译文件的技能,用于把翻译文件中标记为 state="new" 的新增条目找出来,结合代码上下文给出译文建议,供人工审核后写入。

主要能力与用法:

  1. 提取新条目:用 Bash 运行 python3 skills/translate/scripts/find_new_translations.py,输出 JSON,包含变更的 XLF 文件及 state="new" 条目的翻译 ID、源/目标文本、行号和占位符;若 files 数组为空则说明未发现新翻译。
  2. 查找源码上下文:对每个翻译 ID 用 Grep 搜索 @@{ID},文件模式 /*.ts 用于查找 $localize 字符串,/*.html 用于查找 i18n 属性,再用 Read 读取匹配文件前后 5-10 行上下文。
  3. 生成并审核:逐条展示翻译 ID、文件、目标语言、源文本、上下文与建议译文,等待用户确认;用户可接受、给出替代译文或跳过。
  4. 应用译文:将 <target> 内容替换为获批译文,并把 state="new" 改为 state="ai"。

目标语言依据文件名识别,如 messages.de.xlf 为德语、.fr 为法语、.es 为西班牙语、.hu 为匈牙利语。处理时须原样保留 XML 占位符元素,如 <x id="INTERPOLATION" equiv-text="{{...}}"/>、<x id="PH"/>、<x id="LINE_BREAK" ctype="lb"/> 及 HTML 标签占位符,只翻译其周围文本。应参照文件内已有译文保持风格一致,注意领域术语(出行/交通、UI 元素、业务术语),德语通常使用正式的 Sie 形式。多条待译时按文件分组,逐条处理并汇总变更。

限制与异常处理:找不到变更文件时提示运行 git status;无 state="new" 条目时说明翻译已最新;无上下文时仍可依据源文本给出译文并注明缺少上下文;文件解析出错则报告并跳过该文件。