mcpField
Q
qt-translation-assistant

qt-translation-assistant

github.com/re2zero开发738 次安装12 周前更新
代码仓库

关于 qt-translation-assistant

Qt Translation Assistant 是使用 AI API 翻译 Qt TS 本地化文件的技能。它并行处理翻译批次，并通过备份和校验保护原文件及 XML 结构。

主要功能

  1. 01识别未完成的 TS 翻译
  2. 02并行批次处理
  3. 03支持多种 AI 提供方
  4. 04可配置批次大小和工作线程
  5. 05指数退避自动重试
  6. 06仅修改翻译文本

适用场景

  1. 01翻译 Qt TS 文件目录
  2. 02翻译单个 TS 文件
  3. 03通过缩小批次处理大文件
  4. 04保持本地化术语一致

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/re2zero/deepin-skills --skill qt-translation-assistant

安装后在 Claude Code 中输入/qt-translation-assistant确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

qt_translation_config.json
README.md
translate.py

详细介绍

Qt 翻译助手技能

铁律

  1. 绝不在未备份的情况下修改原始 TS 文件 - 始终保留原始内容
  2. 验证 AI 翻译质量 - 确认译文准确且符合上下文
  3. 保持翻译一致性 - 在所有译文中使用统一术语
  4. 尊重文件编码 - 保留 UTF-8 编码和特殊字符
  5. 最小化修改原则 - 只修改翻译内容，保留 XML 结构

危险信号

  • 用户要求翻译非 TS 文件
  • 用户要求在未正确配置 AI 的情况下进行翻译
  • 要求在未经验证的情况下覆盖现有译文
  • 要求翻译成不受支持的语言代码

合理化说辞表

借口回应
“赶快把所有内容都翻译了吧”本地化质量至关重要——必须正确配置 AI 并进行验证
“术语不需要保持一致”翻译不一致会损害用户体验——一致性至关重要
“原始文件不需要备份”始终保留原始文件——翻译错误可能损坏内容
“重写整个文件”只应修改翻译文本——git diff 会显示其他改动

快速参考

核心命令
# Translate entire directory of TS files
python translate.py /path/to/ts/files/

# Translate specific file
python translate.py /path/to/file.ts

# With custom batch size and workers
python translate.py /path/to/ts/files/ --batch-size 30 --max-workers 3

# Create configuration file
python translate.py --create-config
配置
{
  "api_url": "http://localhost:8080/v1/chat/completions",
  "api_key": "sk-uos-12345",
  "model": "qwen3-coder-flash",
  "temperature": 0.3
}

常见错误与修复方法

错误：AI 提供商配置不正确

修复方法：使用 --create-config 创建 qt_translation_config.json，并配置有效的 API 凭据

错误：大文件导致 API 超时

修复方法：调整 --batch-size 参数（尝试 20-50）和 --max-workers（尝试 2-5）

错误：未能正确检测语言代码

修复方法：确保 TS 文件遵循标准命名约定（例如，project_zh_CN.ts、project_de.ts）

错误：翻译质量问题

修复方法：在配置文件中调整模型选择和温度设置

错误：Git diff 显示许多不必要的更改

修复方法：该工具只修改翻译内容——任何其他更改都意味着存在需要修复的错误

架构

此技能采用并行处理架构：

  • TranslationWorker：处理 AI API 调用，并自动重试和采用指数退避
  • QtTranslationAssistant：负责并行批处理的主协调器
  • ThreadPoolExecutor：管理并发翻译工作器（默认为 3 个）

相较于子 Agent 架构的性能提升：

  • 直接调用 API，无需子进程开销（速度约快 5-10 倍）
  • 批量大小更大（默认为 30，之前为 10）
  • 并行工作器（3 个并发 API 调用，而非顺序调用）
  • 错误隔离（单个批次失败不会影响其他批次）

主要功能

  • 智能解析 TS 文件，识别未完成的译文
  • 使用 ThreadPoolExecutor 进行并行批处理
  • 支持多个 AI 提供商（OpenAI、Anthropic、DeepSeek、本地服务）
  • 可配置批量大小和工作器数量
  • 自动重试并采用指数退避
  • 兼容 Git diff 的修改方式（只修改翻译内容）

评论

支持 Markdown