--- slug: "universal-translate-paid" name: "universal-translate-paid" version: 1.0.1 displayName: "通用翻译工具(专业版)" summary: "面向团队的企业级本地化平台,含批量翻译、术语库、对话模式与CI集成,支持多文件并行。。通用翻译工具专业版为团队与企业提供端到端本地化工程能力,涵盖批量文件翻译、术语库管理、对话模式、API集" summary_zh: "面向团队的企业级本地化平台,含批量翻译、术语库、对话模式与CI集成,支持多文件并行。。通用翻译工具专业版为团队与企业提供端到端本地化工程能力,涵盖批量文件翻译、术语库管理、对话模式、API集" license: "MIT" edition: "pro" description: |- 通用翻译工具专业版为团队与企业提供端到端本地化工程能力,涵盖批量文件翻译、术语库管理、对话模式、API集成与CI/CD流水线集成。核心能力: - 批量文件翻译(多文件并行处理) - 术语库管理(统一样式与命名) - 对话模式(实时双语交替翻译) - 多目标语言并行翻译 - 翻译记忆(TM)与复用 - CI/CD本地化流水线集成 - 翻译质量报告与审查 适用场景: - 中大型团队多语言文档本地化 - 企业产品界面与文档同步本地化 - 跨国团队对话翻译辅助 - 持续本地化流水线(CI集成) 差异化... tags: - 翻译 - 本地化 - 企业开发 - 文档工程 - CI/CD - 团队协作 - 语言 - 工具 - report_file - pro tools: - read - exec - write homepage: "" category: "Knowledge" --- # 通用翻译工具(专业版) ## 付费版专享能力 | 能力 | 免费版 | 付费版 | |---|---|---| | 基础功能 | 支持 | 支持 | | 多租户管理与权限分配 | 不支持 | 支持 | | 操作审计与合规日志 | 不支持 | 支持 | | 自定义仪表盘与报表 | 不支持 | 支持 | | API开放与第三方集成 | 不支持 | 支持 | | 资源配额管理与计费统计 | 不支持 | 支持 | ## 核心能力 | 能力 | 说明 | 是否兼容免费版 | |:-----|:-----|:-----| | 基础翻译 | 免费版全部文本翻译、自动检测、格式保留 | 完全兼容 | | 批量文件翻译 | 多文件并行翻译与汇总报告 | Pro 新增 | | 术语库管理 | 统一样式、命名与禁用词 | Pro 新增 | | 对话模式 | 实时双语交替翻译 | Pro 新增 | | 多目标语言并行 | 一次源文本翻译到多个目标语言 | Pro 新增 | | 翻译记忆(TM) | 复用历史翻译,保证一致性 | Pro 新增 | | CI/CD 集成 | 本地化流水线自动化 | Pro 新增 | | 翻译质量报告 | 字数、覆盖率、术语一致性统计 | Pro 新增 | ### 基础翻译 针对基础翻译,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. **输入**: 用户提供基础翻译相关的配置参数、输入数据和处理选项. **输出**: 返回基础翻译的处理结果。- 验证返回数据的完整性和格式正确性 - 参考`基础翻译`的配置文档进行参数调优 ### 批量文件翻译 针对批量文件翻译,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. **输入**: 用户提供批量文件翻译相关的配置参数、输入数据和处理选项. **输出**: 返回批量文件翻译的处理结果。- 验证返回数据的完整性和格式正确性 - 参考`批量文件翻译`的配置文档进行参数调优 ### 术语库管理 针对术语库,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. **输入**: 用户提供术语库管理相关的配置参数、输入数据和处理选项. **输出**: 返回术语库管理的处理结果。- 验证返回数据的完整性和格式正确性 - 参考`术语库管理`的配置文档进行参数调优 # ## 快速开始 1. 确认运行环境满足依赖说明中的要求 2. 在AI Agent对话中调用本技能,提供必要的输入参数 3. 检查输出结果,根据需要进行后续处理 > 详细的输入输出格式请参考下方章节说明。 ## 适用场景 ### 场景 1:批量文档本地化 为团队批量翻译整个文档目录到多种目标语言. ```bash #!/usr/bin/env bash # （请参考skill目录中的脚本文件） — 批量翻译文档目录 set -euo pipefail # ... SOURCE_DIR="docs" TARGET_LANGS=("zh" "ja" "ko" "es" "fr" "de") REPORT_FILE="reports/translation-$(date +%Y%m%d).md" # ... mkdir -p reports { echo "# 批量翻译报告" echo "" echo "- 源目录: $SOURCE_DIR" echo "- 目标语言: ${TARGET_LANGS[*]}" echo "- 执行时间: $(date)" echo "" echo "## 翻译结果" echo "" echo "| 文件 | 目标语言 | 输出文件 | 字数 | 状态 |" echo "| --- | --- | --- | --- | --- |" } > "$REPORT_FILE" # ... for lang in "${TARGET_LANGS[@]}"; do TARGET_DIR="${SOURCE_DIR}.${lang}" mkdir -p "$TARGET_DIR" # ... for src_file in $(find "$SOURCE_DIR" -name "*.md" -type f); do rel_path="${src_file#$SOURCE_DIR/}" target_file="${TARGET_DIR}/${rel_path}" mkdir -p "$(dirname "$target_file")" # ... # 调用 Agent 翻译(此处为示意,实际通过 Agent 接口) echo "翻译 $src_file → $target_file ($lang)" # ... # 统计字数 word_count=$(wc -w < "$src_file") # ... echo "| $src_file | $lang | $target_file | $word_count | 完成 |" >> "$REPORT_FILE" done done # ... echo "" echo "## 汇总" >> "$REPORT_FILE" echo "- 总文件数: $(find "$SOURCE_DIR" -name "*.md" | wc -l)" >> "$REPORT_FILE" echo "- 总语言数: ${#TARGET_LANGS[@]}" >> "$REPORT_FILE" echo "- 总翻译产物: $(find "${SOURCE_DIR}."* -name "*.md" 2>/dev/null | wc -l)" >> "$REPORT_FILE" # ... echo "报告已生成: $REPORT_FILE" ``` ### 场景 2:术语库管理 通过术语库统一样式、命名与禁用词,保证多文件多语言翻译一致性. ```yaml # glossary.yaml — 团队术语库 version: "1.0" domain: "SaaS 产品文档" # ... terms: # 强制术语:必须按指定译法翻译 - source: "Dashboard" translations: zh: "仪表盘" ja: "ダッシュボード" ko: "대시보드" note: "不要译为'控制台'" # ... - source: "Subscription" translations: zh: "订阅" ja: "サブスクリプション" ko: "구독" note: "不要译为'认购'" # ... - source: "API Key" translations: zh: "API 密钥" ja: "APIキー" note: "不要译为'API钥匙'" # ... # 禁用词:不得出现在译文中 forbidden: - source: "国民的" reason: "政治敏感" - source: "master/slave" reason: "使用 primary/replica 替代" # ... # 保留原文:不翻译 preserve_as_is: - "TypeScript" - "React" - "Docker" - "Kubernetes" - "GitHub" ``` ### 场景 3:对话模式(实时双语交替) 进入对话模式后,每条消息自动翻译到对方语言,适合跨国团队沟通. ``` 启动中英对话翻译模式 ``` ```text **[对话模式:中文 ↔ 英语]** > 输入 "停止翻译" 退出 # ... 你: 大家好,今天的会议主要讨论产品路线图. **[中文 → 英语]** Hello everyone, today's meeting is mainly to discuss the product roadmap. # ... 对方: Thanks. Let's start with Q1 priorities. **[英语 → 中文]** 谢谢。让我们从优秀季度的优先事项开始. # ... 你: 好的,优秀季度我们重点关注用户增长和留存. **[中文 → 英语]** OK, in Q1 we focus on user growth and retention. ``` ### 场景 4:多目标语言并行翻译 一次源文本同时翻译到多个目标语言,并排展示. ``` 把 "Hello, how are you?" 翻译成西班牙语和葡萄牙语 ``` ```text **英语 → 西班牙语 / 葡萄牙牙** # ... 西班牙语: Hola, ¿cómo estás? 葡萄牙语: Olá, como você está? ``` ## 使用流程 ### 优秀步:声明本地化上下文 在对话中说明团队、源语言、目标语言与术语需求,例如: ``` 我们是一个面向全球的SaaS团队,需要把英文文档站批量本地化为 中文、日语、西班牙语。需要术语库统一"Dashboard/租户/API Key" 等关键术语,并把翻译集成到CI流水线. ``` ### 第二步:获取工程方案 工具会输出术语库模板、批量翻译脚本、CI 集成 YAML 与质量报告格式. ### 第三步:落地与持续本地化 ```bash # 初始化术语库 cp glossary.yaml docs/.glossary.yaml # ... # 执行批量翻译 bash （请参考skill目录中的脚本文件） # ... # 查看翻译报告 cat reports/translation-$(date +%Y%m%d).md ``` # ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |---:|---:|---:|---:| | content | string | 否 | universal-translate处理的内容输入 |, | | mode | string | 否 | 处理模式, 可选: json/text/markdown, | | max_retries | integer | 否 | 单步最大重试次数, 默认: 2 | | skip_steps | array | 否 | 跳过的步骤编号(用于断点续传), 默认: [] | ## 输出格式 ```json { "success": true, "data": { "final_result": { "translate_result": "translate_result_value", "translate_metadata": "translate_metadata_value", "translate_status": "translate_status_value" }, "execution_log": [ { "step": 1, "name": "按流程执行", "status": "completed", "duration_ms": 1200, "output_summary": "按流程执行" }, { "step": 2, "name": "按流程执行", "status": "completed", "duration_ms": 3500, "output_summary": "按流程执行" }, { "step": 3, "name": "按流程执行", "status": "completed", "duration_ms": 2100, "output_summary": "按流程执行" }, { "step": 4, "name": "按流程执行", "status": "completed", "duration_ms": 800, "output_summary": "按流程执行" } ], "total_duration_ms": 7600, "gates_passed": 3, "gates_total": 3 }, "error": null } ``` 中间产物模板参考: `assets/universal-translate_template` ## 异常处理 | 错误场景 | 原因 | 处理方式 | |:---:|:---:|:---:| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | ## 依赖说明 ### 运行环境 - **Agent 平台**:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等) - **操作系统**:Windows / macOS / Linux - **Python**:建议 3.10+(用于质量检查脚本) - **Bash**:用于批量翻译脚本(Windows 用 Git Bash 或 WSL) - **CI 平台**:GitHub Actions / GitLab CI / Jenkins ### 依赖说明(补充) | 依赖项 | 类型 | 是否必需 | 获取方式 | |:------|------:|:------|:------| | Python | 运行时 | 推荐 | 官方安装包 | | PyYAML | Python 包 | 推荐 | `pip install pyyaml` | | yaml-lint | npm 包 | 可选 | `npm i -D yaml-lint` | | 翻译 API | API | 可选 | 可选集成外部翻译 API | | LLM API | API | 必需 | 由 Agent 内置 LLM 提供 | ### API Key 配置 - 本 Skill 核心翻译能力由 Agent 内置 LLM 提供,基础LLM由Agent平台提供 - 如集成外部翻译 API(如 DeepL、Google Translate),配置对应平台的 `TRANSLATE_API_KEY` 环境变量 - CI 中访问私有仓库需配置 `GITHUB_TOKEN` 或对应平台的访问令牌 ### 可用性分类 - **分类**: MD+EXEC(纯 Markdown 指令,部分功能需要 exec 命令行执行能力) - **说明**: 基于自然语言指令驱动 Agent 完成翻译;批量脚本与 CI 集成需在仓库中落地并由本地或 CI 执行 ## 案例展示 ### CI/CD 本地化流水线 ```yaml # .github/workflows/localization.yml name: Documentation Localization on: push: branches: [main] paths: ['docs/**', 'glossary.yaml'] schedule: - cron: '0 2 * * 1' # 每周一凌晨自动同步 # ... jobs: translate: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: '20' - run: npm ci # ... - name: 校验术语库 run: | if [ ! -f docs/.glossary.yaml ]; then echo "术语库缺失" && exit 1 fi npx yaml-lint docs/.glossary.yaml # ... - name: 批量翻译 env: TRANSLATE_API_KEY: $相关信息 run: bash （请参考skill目录中的脚本文件） # ... - name: 翻译质量检查 run: | # 检查术语一致性 python3 （请参考skill目录中的脚本文件） docs/ docs.zh/ # 检查禁用词 python3 （请参考skill目录中的脚本文件） docs.zh/ # ... - name: 生成翻译报告 run: | echo "## 翻译报告" >> $GITHUB_STEP_SUMMARY cat reports/translation-*.md >> $GITHUB_STEP_SUMMARY # ... - name: 提交翻译产物 run: | git config user.name "Localization Bot" git config user.email "bot@example.com" git add docs.* reports/ git commit -m "chore: sync localized docs [skip ci]" || true git push ``` ### 翻译记忆(TM)结构 ```json { "version": "1.0", "source_lang": "en", "entries": [ { "source": "Welcome to our platform", "target": "zh", "translation": "欢迎使用我们的平台", "context": "登录页", "last_used": "2024-12-01" }, { "source": "API Key", "target": "zh", "translation": "API 密钥", "context": "设置页", "last_used": "2024-12-15" } ] } ``` ## 常见问题 ### Q1: 批量翻译如何处理大型文档目录? 推荐分批次翻译:按目录或文件大小分片,在 CI 中并行执行多个翻译任务。每个任务处理一个子目录,降低单次内存占用与超时风险. ### Q2: 术语库如何与现有翻译协同? CI 中运行术语一致性检查脚本,对比译文与术语库,输出未遵循术语的清单。对历史译文,可安排专项治理批次逐步统一. ### Q3: 翻译记忆如何更新? 每次翻译完成后,将新的翻译对写入 TM 文件。下次翻译相似句子时优先匹配 TM,保证一致性并加速翻译. ### Q4: 对话模式支持多少种语言? 理论上支持所有有书面文字的语言。对话模式可指定两种语言交替(如中英、日英),也可指定多种语言轮询. ### Q5: Pro 版与免费版如何协同? Pro 版完全兼容免费版的所有翻译结果与格式保留规则。个人用户可继续使用免费版,团队场景启用 Pro 版获得批量、术语库与 CI 集成能力。两个版本可在同一仓库并存. ### Q6: 如何度量本地化质量? 跟踪四个指标:术语一致性(译文符合术语库的比例)、翻译覆盖率(目标语言已翻译文件占比)、TM 复用率(复用历史翻译的比例)、禁用词违规数。四者共同反映本地化质量. ## 错误处理 | 错误场景(续)| 原因 | 处理方式 | |----:|:----|----:| | LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 | | 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 | | 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 | | 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 | ## 已知限制 - 本地运行，不支持多设备同步