Manual Translator

概述

将 docx 格式的说明书翻译成指定语言，并重新截取应用程序界面截图替换文档中的原图。支持 Web 应用、本地 EXE、项目启动等多种应用类型。

优化版翻译流程

步骤 1: 收集信息

用户需要提供：

• - docx 文件路径: 要翻译的说明书文档
• 目标语言: 如英文(EN)、日文(JA)、韩文(KO)等
• DeepLX API Key (可选): 用于翻译

步骤 2: 分段翻译 (推荐)

为避免 API 限流或超时，建议使用分段翻译：

python

分批翻译，每批50项

batch_size = 50
for i in range(0, total, batch_size):
batch = texts[i:i+batch_size]
for text in batch:
# 翻译...
# 每批保存中间结果
doc.save(foutput_part{batch+1}.docx)

步骤 3: 表格翻译

Docx 文档中的表格需要单独处理：

python

遍历所有表格

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)

步骤 4: 合并与输出

1. 1. 合并所有分节翻译结果
2. 替换原文档中的中文内容
3. 保留文档格式、图片、表格结构

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 应用:

• - 直接访问 URL
• 寻找语言切换设置

项目路径:

• - 前端: pnpm dev
• 后端: pnpm start 或 npm run start:dev

关键提示

• - 分段翻译: 每50项一批，每批保存，防止中途失败
• 表格翻译: 逐表格翻译并保存
• 错误处理: 使用 try-except 捕获异常，继续处理下一项
• 保留格式: 只替换文本内容，保留段落格式、表格结构、图片