| name | manual-translator |
| description | 将docx说明书翻译成指定语言，并重新截取应用界面截图替换文档中的原图。触发场景：(1) 用户发送docx文档要求翻译，(2) 需要重新截取软件界面截图，(3) 包含截图替换的文档本地化工作 |
Manual Translator
Overview
将 docx 格式的说明书翻译成指定语言，并重新截取应用程序界面截图替换文档中的原图。支持 Web 应用、本地 EXE、项目启动等多种应用类型。
优化版翻译流程
Step 1: 收集信息
用户需要提供：
- docx 文件路径: 要翻译的说明书文档
- 目标语言: 如英文(EN)、日文(JA)、韩文(KO)等
- DeepLX API Key (可选): 用于翻译
Step 2: 分段翻译 (推荐)
为避免 API 限流或超时，建议使用分段翻译：
batch_size = 50
for i in range(0, total, batch_size):
batch = texts[i:i+batch_size]
for text in batch:
doc.save(f"output_part{batch+1}.docx")
Step 3: 表格翻译
Docx 文档中的表格需要单独处理：
for table in doc.tables:
for row in table.rows:
for cell in row.cells:
text = cell.text.strip()
if text and has_chinese(text):
cell.text = translate(text)
doc.save(output_file)
Step 4: 合并与输出
- 合并所有分节翻译结果
- 替换原文档中的中文内容
- 保留文档格式、图片、表格结构
DeepL API 使用
API 格式：
POST https://api.deeplx.org/{API_KEY}/translate
Body: {"text": "原文", "target_lang": "目标语言代码"}
目标语言代码：EN, JA, KO, ZH, FR, DE, ES, IT, PT, RU 等
备用方案: 如果 API 不可用，使用模型自身能力翻译
启动应用 (如需截图)
Web 应用:
项目路径:
- 前端:
pnpm dev
- 后端:
pnpm start 或 npm run start:dev
关键提示
- 分段翻译: 每50项一批，每批保存，防止中途失败
- 表格翻译: 逐表格翻译并保存
- 错误处理: 使用 try-except 捕获异常，继续处理下一项
- 保留格式: 只替换文本内容，保留段落格式、表格结构、图片
