translate-manual 是一款专为技术文档本地化设计的自动化工具，能够将 docx 格式的说明书高效翻译成指定语言，并同步完成界面截图的替换工作。它特别适用于需要将软件使用手册、操作指南等文档进行多语言适配的开发团队或技术支持人员。该工具支持 Web 应用、本地 EXE 程序以及项目启动类应用的说明文档处理，覆盖了绝大多数常见的应用类型。通过结合 DeepL API 和内置翻译能力，系统可在保证翻译质量的同时灵活应对不同网络环境。
整个翻译流程经过优化设计，分为信息收集、分段翻译、表格处理和最终合并四个核心阶段。其中分段翻译机制有效规避了大型文档因单次请求过大导致的 API 限流或超时问题，建议每50项文本为一组进行分批处理，并在每组完成后保存中间结果，确保任务中断后仍可恢复进度。对于包含大量数据表格的说明书，工具会单独识别并逐表翻译，避免格式错乱或内容丢失。
此外，系统在保留原始文档结构方面表现出色——不仅维持原有的段落排版、字体样式和图片位置，还能智能替换其中的中文文本为译文，同时更新对应的界面截图，使最终输出的文档在视觉和语义上均保持专业一致性。这种“文本+图像”协同更新的能力，使其成为跨国团队协作和全球化产品发布场景中的理想选择。
核心功能特点
- 支持将 docx 格式说明书翻译成多种目标语言（如英文、日文、韩文等）
- 自动识别并翻译文档中的表格内容，保持原有结构不变
- 可重新截取应用程序界面截图并替换文档中原有图片
- 采用分段翻译策略，每50项一批处理，防止 API 限流和任务中断
- 保留原始文档的段落格式、字体样式和图片布局，仅替换文本内容
- 兼容 Web 应用、本地 EXE 及项目启动类应用的文档处理需求
适用场景
translate-manual 最典型的应用场景是跨国软件开发团队在进行产品国际化时对技术文档的批量处理。例如，一个面向日本市场推出的 SaaS 平台，其用户手册最初以中文编写，需快速转化为日文版本并配以对应语言的界面截图。使用该工具可一次性完成全文翻译与截图替换，大幅缩短本地化周期。类似地，若企业计划将一款本地桌面软件推向欧洲市场，也可借助此工具将中文操作手册翻译为德语或法语，并确保截图中的按钮文字、菜单名称与实际界面一致。
另一个高频使用场景是开源项目的文档维护。许多 GitHub 上的中文开源项目希望扩大国际影响力，但受限于人力难以持续维护多语言 README 或安装指南。此时，开发者可将 docx 格式的贡献者手册提交给 translate-manual 处理，自动生成英文版本并附带清晰的界面截图，显著降低非中文母语用户的参与门槛。此外，教育培训机构在制作多语种教学材料时，也能利用该工具快速生成符合目标用户认知习惯的操作教程。
值得一提的是，该工具特别适合需要频繁更新文档内容的敏捷开发环境。当软件版本迭代导致界面发生变化时，只需重新运行截图替换流程，即可同步更新所有语言版本的说明文档，避免人工逐一修改带来的遗漏风险。无论是初创公司还是大型企业，只要涉及多语言技术文档的生产与维护，translate-manual 都能提供高效、可靠的解决方案。