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。
如何使用
- 安装 –
pip install docutranslate(可选[mcp]额外功能) 或拉取 Docker 镜像。 - 配置 – 设置您的 LLM 提供商环境变量 (
DOCUTRANSLATE_API_KEY,BASE_URL,MODEL_ID等)。 - 运行 –
docutranslate -i启动 Web UI;加入--host 0.0.0.0可在局域网上公开。 - 翻译 – 通过 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') - 进阶 – 使用底层的 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 社区。
相关
- 项目
- 项目
- 项目
- 项目
- 项目