SuperAPI AI 工具集

rhdh-translation-deploy

部署与运维

查看项目

更新于 10-19 19:51

技能介绍

RHDH Translation Deploy 是 rhdh-skills 仓库中的一个翻译部署技能,主要用途是从 TMS(Memsource)下载已完成的翻译任务,合并到正确的目标仓库与文件,并准备相应的 PR。

用途与部署目标 该技能按来源仓库区分部署目标:rhdh-plugins 在仓库内就地合并 .ts 文件,生成 changesets 并创建 PR;community-plugins 同样就地合并 .ts 文件并生成 changesets 与 PR,同时还会把 JSON 合并到 rhdh/translations/ 下;backstage 只做 JSON 合并到 rhdh/translations/backstage-{locale}.json,不向上游 backstage 提交 PR;rhdh 则合并为 rhdh/translations/rhdh-{locale}.json。

.ts 文件的合并规则 合并 .ts 文件时明确不使用 translations-cli 的 i18n deploy,因为该命令会重写文件并删除未变更的键。正确流程是:加载某插件与语言下载得到的 JSON;打开已有的语言文件(如 de.ts);对每一个下载得到的键,若文件中已存在则更新其值,若不存在则跳过;绝不删除键,也不改动导入/导出语句;含撇号的字符串使用双引号;提交前对改动文件运行 Prettier。合并过程中不做增量比较,也不使用 ref.ts 门禁;开发者在上传后新增的键保持不动。

子命令 preflight:检查仓库、工具与 TMS 凭据。 download:通过 translations-cli 下载已完成的任务。 validate:对下载内容做基础 JSON 与结构检查。 update-translated-sot --sprint S:修正 TMS 的 en → 实际语言映射,合并到 rhdh/translations/,并在 rhdh 上创建 PR。 deploy:对 rhdh-plugins 与 community-plugins 执行就地 .ts 合并。 pr --sprint S:按真实包名写入 changesets,并报告哪些仓库已就绪可供 /mutation-gate 处理。

使用方式 技能入口会加载 workflows/download-and-deploy.md 工作流文件,按该流程执行下载、校验、合并与 PR 准备。

边界与完成报告 字符串提取与上传到 TMS 由 /rhdh-translation-upload 负责;仓库位置与分支上下文由 /rhdh-context 负责;创建 PR、推送分支等外部写操作统一经由 /mutation-gate。完成后按仓库报告:改动文件、更新/跳过的键数量、changesets,以及创建后的 PR URL,并注明 backstage 没有上游 PR。

适用场景与限制 适用于 RHDH 多仓库多语言翻译的落地合并与 PR 准备,尤其需要保持 .ts 文件键稳定、避免误删未变更文案的场景。限制在于:它依赖 TMS 已完成任务与正确凭据;.ts 合并只更新已存在键,新增键不会被写入;backstage 不产生上游 PR;外部写操作需经过 /mutation-gate。费用、平台版本等细节资料未提供。