xunbu/docutranslate

文档(小说、论文、字幕)翻译工具(支持 pdf/word/excel/json/epub/srt...)Document (Novel, Thesis, Subtitle) Translation Tool (Supports pdf/word/excel/json/epub/srt...)

DocuTranslate – 基于本地 LLM 的文档翻译工具

功能简介 – DocuTranslate 是一个基于 Python 的工具,让您能够使用大型语言模型 (LLMs) 在自己的机器上翻译多种文件类型 (PDF, DOCX, XLSX, MD, TXT, JSON, EPUB, SRT, ASS, …)。它会解析原始文档,将文本拆分为块,发送至基于 LLM 的翻译服务,然后重新组装结果,同时尽量保留原始布局与格式。

主要功能

  • 多格式支持 – 处理纯文本与富文本格式;DOCX/XLSX 输出可保留样式。
  • PDF 处理 – 使用 MinerU 引擎(在线或自托管)提取表格、公式与代码,先将 PDF 转换为 markdown(可能会丢失布局)。
  • 术语表 – 可选的自动生成术语表,以保持术语一致性。
  • 异步与并发 – 采用 asyncio 构建;您可以并行执行多个翻译请求(默认为 10 个并发 LLM 调用)。
  • 局域网 / 多用户 – 单一实例可通过 Web UI 或 REST API 为局域网上的多位用户提供服务。
  • MCP 服务器 – 提供 Model Context Protocol (MCP) 端点,供其他工具流式传输翻译作业。
  • 便携式二进制文件 – Windows 与 macOS 软件包小于 40 MB。

如何使用

  1. 安装 – pip install docutranslate (可选 [mcp] 额外功能) 或拉取 Docker 镜像。
  2. 配置 – 设置您的 LLM 提供商环境变量 (DOCUTRANSLATE_API_KEY, BASE_URL, MODEL_ID 等)。
  3. 运行 – docutranslate -i 启动 Web UI;加入 --host 0.0.0.0 可在局域网上公开。
  4. 翻译 – 通过 UI 上传文件或调用 REST API (/translate)。您也可以使用 Python SDK:
    from docutranslate.sdk import Client
    client = Client(api_key='...', base_url='https://api.openai.com/v1', model_id='gpt-4o')
    result = client.translate('paper.pdf', convert_engine='mineru', mineru_token='...')
    result.save(fmt='html')
    
  5. 进阶 – 使用底层的 Workflow 类进行细粒度控制(自定义块大小、插入模式、JSONPath 选择等)。

典型工作流程

  • 检测文件类型 → 选择适当的 Workflow → 可选的 PDF → markdown 转换 → 拆分为块 → 发送每个块至 LLM → 收集翻译后的块 → 以原始格式重建文档(或导出为 HTML/markdown/base64)。

支持的 LLM 提供商 – 任何遵循标准 OpenAI 兼容 API 的服务(OpenAI, Azure, Zhipu 等)。provider 字段可设为 auto 或特定名称。

限制

  • PDF 转换为 markdown 会舍弃精确的页面布局。
  • 不原生支持旧版 .doc 或 .xls 文件。
  • 术语表生成为选配功能,可能需要额外的 LLM 调用。

适用对象 – 需要翻译学术论文的研究人员、本地化小说的作家、以及需要在不将数据发送至第三方 SaaS 平台的情况下进行内部文档批量翻译的团队。

资源 – GitHub 发布页面包含可直接运行的软件包;README 链接至 MCP 文档、Docker 使用方式以及用于支持的 QQ 社区。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目