概览

TranslatePro 是一款专业级翻译与本地化能力，可自动将内容适配至 100 多种语言，同时保持品牌语调、文化语境与技术准确性。该能力面向内容创作者、全球化营销人员、软件团队及企业用户设计，通过集成的翻译记忆库系统，消除人工翻译瓶颈，并确保各语言对之间的术语与风格一致性。

为何 TranslatePro 至关重要

• 一夜之间实现全球规模化：将英文内容在数分钟内（而非数周）译为 50 多种语言
• 保留语调与语境：在所有翻译中维持统一的语气、术语和品牌一致性
• 即插即用式集成：支持 WordPress、Contentful、Slack、GitHub、Google Workspace 及 REST API
• 成本高效：混合策略结合缓存翻译记忆库与 AI，使交付速度提升 60–70%
• 质量保障：内置术语校验、术语表强制执行及回译验证机制

真实应用场景

1. 电商平台：自动翻译商品描述、价格、物流详情及客户评论
2. SaaS 本地化：适配 UI 字符串、帮助文档及面向 20+ 市场的营销文案
3. 内容营销：将博客文章、白皮书及视频字幕复用于目标语言
4. 法律/合规场景：为受监管行业（医疗健康、金融科技、政府）维护专用术语表

快速上手

立即尝试以下提示词：

提示词 1：带语言检测的基础翻译

将以下英文产品描述翻译为西班牙语、法语和德语：
"Our premium noise-canceling headphones deliver studio-quality sound with 
30-hour battery life. Perfect for professionals and audiophiles alike."

西班牙语使用正式语态（usted）。品牌名称保持不变。

提示词 2：含文化适配的本地化

为日本、阿拉伯语及葡萄牙语市场本地化以下邮件主题行：
"50% OFF - Black Friday Sale Ends Tonight!"

适配文化参照、数字格式及所在时区；保留紧迫感，同时尊重当地敏感性。

提示词 3：翻译记忆库 + 术语表一致性保障

使用以下配置将该技术文档翻译为德语：
- 翻译记忆库：existing-glossary.tmx
- 强制术语映射："Dashboard" → "Instrumententafel"，"API" → "API"（保持不变）

源文本：
"Access the API through the Dashboard settings panel to configure webhook URLs."

提示词 4：批量内容本地化

将我的整站产品网站本地化为简体中文、泰语和韩语：
- 输入目录：/content/pages/
- 文件类型：.md、.html
- 保留 HTML 结构与属性
- 输出格式：/localized/{language_code}/
- 所有语言均采用专业（正式）语体

能力特性

1. 多引擎翻译

• Google Translate API：支持 100+ 种语言，实时更新，高性价比
• DeepL API：针对 29 个语言对提供卓越神经网络翻译，质量最高
• 智能降级机制：高风险内容路由至 DeepL，批量内容交由 Google 处理
• 自定义引擎选择：可在配置中按语言指定首选引擎

示例用法：

使用 DeepL（医疗领域精准翻译）译为法语：
"The patient shows signs of acute myocardial infarction."
Engine: deepl
Domain: medical

2. 翻译记忆库（TM）集成

• 支持 TMX/XLIFF 格式：可从 Trados、memoQ、SDL 等 CAT 工具导入现有翻译记忆库
• 缓存术语：复用历史译文，确保术语一致
• 模糊匹配：利用记忆库中 ≥75% 的匹配结果，加快交付、降低成本
• 增量式构建 TM：每次翻译均自动扩充组织级记忆库

示例：

从 CAT 工具加载 TM：
源路径：/translations/memories/global-brand.tmx
支持语言对：en-es、en-de、en-fr、en-ja
匹配阈值：75%
自动接受模糊匹配：是

3. 术语表与术语管理

• 强制执行自定义术语表：防止专有术语、品牌名、缩略语误译
• 多层级术语体系：涵盖品牌术语、产品名称、领域专用词汇
• 自动校验：对偏离术语表的内容标注置信度评分
• 双向术语表：支持源→目标映射及上下文感知型定义

示例：

应用企业术语表：
- "Platform" → "Plataforma"（非 "Plataforma de software"）
- "Cloud sync" → "Sincronización en la nube"（非 "Sincronización de nube"）
- "Bandwidth" → "Ancho de banda"（仅限技术语境）
语言对：en-es
严格程度：HIGH（要求 80% 匹配度）

4. 内容类型专属翻译

• 纯文本：简洁快速，不保留格式
• HTML/XML：保留结构、属性与语义标签
• Markdown：完整保留格式、代码块、链接等元素
• 视频/字幕文件：支持 SRT、VTT、SUB 格式，精确保留时间轴
• JSON/YAML：仅翻译值（value），保留键（key）与整体结构
• Office 文档：支持 DOCX、XLSX、PPTX，保留排版布局

示例：

将 Markdown 文件译为西班牙语：
输入：/blog/kubernetes-guide.md
需保留：代码块、YAML、链接、图片
输出格式：/blog/es/kubernetes-guide.md

5. 质量保障与校验

• 回译（Back-translation）：反向译回源语言以识别错误
• 语调分析：确保正式/非正式语体匹配目标受众
• 术语一致性检查：全项目扫描术语表违规项
• 字符数限制执行：遵守 UI 约束（按钮、标题、短信等）
• 占位符保护：完整保留 {variable}、{{handlebars}}、${env_vars}

示例：

西班牙语译文 QA 检查：
- 回译至英文（若偏差 >15%，则告警）
- 校验：所有 {variables} 均被保留
- 校验：字符数 ≤ 120（符合短信限制）
- 校验：语体正式性（tú vs. usted）
- 报告：按严重等级标注偏差项

6. 工作流自动化

• 批量处理：并行翻译 500+ 文件（自动遵守 API 速率限制）
• 定时任务：每晚自动翻译 CMS 中新增内容
• 集成 Webhook：监听内容变更，自动触发本地化流程
• 状态追踪：大型项目实时进度可视化

示例：

WordPress 本地化自动化：
触发条件：英文文章发布
执行动作：自动译为 es、de、fr、ja
目标位置：WPML 插件自定义字段
通知渠道：/slack #translation-updates
降级策略：若置信度 < 85%，标记为人工复核

配置说明

环境变量

# 必填项
export GOOGLE_TRANSLATE_API_KEY="your-google-api-key"
export DEEPL_API_KEY="your-deepl-api-key"

# 可选项
export TRANSLATION_MEMORY_PATH="/path/to/translation-memories/"
export GLOSSARY_PATH="/path/to/glossaries/"
export OUTPUT_LANGUAGE_CODES="es,de,fr,ja,pt,zh"
export DEFAULT_ENGINE="deepl"  # 或 "google"
export QA_BACK_TRANSLATION="true"
export CONFIDENCE_THRESHOLD="0.85"
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
export RATE_LIMIT_REQUESTS_PER_MINUTE="100"

配置步骤

步骤 1：获取 API 密钥

• Google Translate：访问 https://console.cloud.google.com → 启用 Translation API
• DeepL：访问 https://www.deepl.com/pro/change-plan → 在账户设置中获取 API 密钥

步骤 2：准备翻译记忆库（可选）

# 从现有 CAT 工具（Trados、memoQ、SDL）导出
# 保存为 TMX 或 XLIFF 格式
mkdir -p ~/.translatepro/memories/
cp your-glossary.tmx ~/.translatepro/memories/

步骤 3：创建术语表

{
  "glossaries": [
    {
      "name": "brand-terms",
      "language_pair": "en-es",
      "terms": {
        "Dashboard": "Panel de Control",
        "API": "API",
        "Webhook": "Webhook"
      }
    }
  ]
}

步骤 4：测试连接

claw test-skill translatepro --api-key $GOOGLE_TRANSLATE_API_KEY
# 输出：✓ Google Translate API connected
# 输出：✓ DeepL API connected
# 输出：✓ Translation Memory loaded (1,247 entries)

示例输出

示例 1：产品描述翻译

输入（英文）：

Our premium wireless earbuds feature active noise cancellation, 
8-hour battery life, and seamless Bluetooth 5.3 connectivity. 
Ideal for commuters, athletes, and music enthusiasts.

输出（西班牙语）：

Nuestros auriculares inalámbricos premium cuentan con cancelación 
activa de ruido, 8 horas de autonomía y conectividad Bluetooth 5.3 
sin interrupciones. Ideales para viajeros, atletas y amantes de la música.

输出（日语）：

プレミアム ワイヤレスイヤホンは、アクティブノイズキャンセレーション、
8時間のバッテリー寿命、シームレスな Bluetooth 5.3 接続を備えています。
通勤者、アスリート、音楽愛好家に最適です。

输出（德语）：

Unsere Premium-Wireless-Ohrhörer bieten aktive Geräuschunterdrückung, 
8 Stunden Akkulaufzeit und nahtlose Bluetooth 5.3-Konnektivität. 
Ideal für Pendler, Sportler und Musikbegeisterte.

示例 2：网站本地化报告

PROJECT: E-commerce Site Localization
SOURCE: English (1,247 strings)
TARGETS: Spanish, French, German, Japanese

┌─────────────┬──────────┬────────┬────────┬──────────┐
│ Language    │ Strings  │ TM Hit │ Engine │ Status   │
├─────────────┼──────────┼────────┼────────┼──────────┤
│ Spanish     │ 1,247    │ 89%    │ DeepL  │ ✓ Done   │
│ French      │ 1,247    │ 92%    │ DeepL  │ ✓ Done   │
│ German      │ 1,247    │ 85%    │ DeepL  │ ✓ Done   │
│ Japanese    │ 1,247    │ 34%    │ Google │ ✓ Done   │
└─────────────┴──────────┴────────┴────────┴──────────┘

QUALITY METRICS:
• Terminology consistency: 98.2% (2 glossary violations flagged)
• Back-translation variance: 3.1% (within acceptable range)
• Character limit violations: 0
• Confidence score (avg): 91.7%
• Estimated cost savings via TM: $4,230 (vs. professional translation)
• Time saved: 38 hours (vs. manual translation)

FLAGGED ITEMS: 
1. Spanish - "API documentation" (confidence: 72%, flagged for review)
2. French - Character limit exceeded in checkout button (47 chars, limit: 45)

示例 3：视频字幕本地化

输入 SRT（英文）：

1
00:00:15,000 --> 00:00:20,000
Welcome to our advanced tutorial series on cloud architecture.

2
00:00:20,000 --> 00:00:25,000
Today we'll explore scalability patterns and best practices.

输出 SRT（西班牙语）：

1
00:00:15,000 --> 00:00:20,000
Bienvenido a nuestra serie de tutoriales avanzados sobre arquitectura en la nube.

2
00:00:20,000 --> 00:00:25,000
Hoy exploraremos patrones de escalabilidad y mejores prácticas.

输出 SRT（简体中文）：

1
00:00:15,000 --> 00:00:20,000
欢迎来到我们的云架构高级教程系列。

2
00:00:20,000 --> 00:00:25,000
今天，我们将探索可扩展性模式和最佳实践。

技巧与最佳实践

1. 利用翻译记忆库保障一致性

• 增量式构建：每次翻译均强化组织级记忆库
• 定期导出：每季度备份 TM；跨团队共享
• 模糊匹配工作流：设定阈值（≥75% 自动采纳；50–74% 需人工复核；＜50% 视为新翻译）
• 指标参考：成熟的 TM 可降低翻译成本 40–60%

2. 构建全面的术语表

• 优先收录高价值术语：品牌名、产品名、缩略语、领域专用词汇
• 记录上下文：“API” 在不同语境下可能需不同译法
• 版本控制：追踪术语表变更；强制同步至全部语言对
• 协作评审：术语表启用前须经母语者审核确认

3. 按任务选择合适引擎

• DeepL：适用于营销文案、面向客户的材料、创意写作等高质量需求场景
• Google Translate：适用于技术文档、大批量内容、语义复杂度较低的文本，兼顾速度与成本
• 混合策略：前 20% 内容（ROI 最高）使用 DeepL，其余交由 Google 处理

4. 针对目标受众优化

• 语调匹配：企业/法律类内容使用“正式”语体；社交媒体内容可采用“随意”语体
• 区域变体：西班牙语在西班牙与拉丁美洲存在显著差异
• 文化适配：日期、货币、计量单位、习语等需超越字面翻译，进行深度本地化
• 母语者测试：预留翻译总工时的 10–15% 用于母语者复核

5. 自动化重复性任务

• Webhook 触发：接入 WordPress、Contentful、GitHub，在内容发布时自动启动翻译
• 定时任务：面向内容密集型平台，每日批量处理新增内容
• API 集成：为特定 CMS 或工作流定制脚本
• 并行处理：同时向 10+ 种语言发起翻译（自动遵守速率限制）

6. 质量保障工作流

1. 机器翻译：首轮翻译（DeepL 或 Google）
2. TM/术语表校验：强制术语一致性
3. 回译检查：偏差 >15% 时发出告警
4. 母语者复核：对关键内容（法律、医疗、营销）抽样 10–20% 进行人工审核
5. 用户实测：在目标市场开展真实场景验证（可选，高 ROI）

7. 成本优化策略

• 缓存译文：复用 TM 匹配结果，减少 50–80% 的 API 调用量
• 批量处理：在低峰时段执行，获得更优的速率限制配额
• 语言优先级排序：按 ROI 优先翻译高价值市场
• 字符数监控：持续跟踪用量，预算达 80% 时触发告警

安全与防护机制

TranslatePro 不会执行的操作

1. 敏感数据处理
   • 不会：翻译或存储个人身份信息（PII），如邮箱、电话号码、社保号、信用卡号
   • 不会：在未加密状态下处理受保护的健康信息（PHI，如病历）或支付卡行业数据（PCI，如支付信息）