halseyyang Manual Translator
Overview
将 docx 格式的说明书翻译成指定语言，并重新截取应用程序界面截图替换文档中的原图。支持 Web 应用、本地 EXE、项目启动等多种应用类型。
优化版翻译流程
Step 1: 收集信息
用户需要提供：
- docx 文件路径: 要翻译的说明书文档
- 目标语言: 如英文(EN)、日文(JA)、韩文(KO)等
- DeepLX API Key (可选): 用于翻译
Step 2: 分段翻译 (推荐)
为避免 API 限流或超时，建议使用分段翻译：
# 分批翻译，每批50项
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 应用:
- 直接访问 URL
- 寻找语言切换设置
项目路径:
- 前端:
pnpm dev - 后端:
pnpm start或npm run start:dev
关键提示
- 分段翻译: 每50项一批，每批保存，防止中途失败
- 表格翻译: 逐表格翻译并保存
- 错误处理: 使用 try-except 捕获异常，继续处理下一项
- 保留格式: 只替换文本内容，保留段落格式、表格结构、图片