使用 AI 翻译书籍、字幕和文档——本地或云端均可。

无大小限制。 可处理任意长度的文档，从单页到千页长篇小说皆可。智能分块系统能够处理无限内容，同时保持各段落之间的上下文连贯性。

完美保留原貌。 您的文档输出与输入完全一致：EPUB 格式、样式和结构均保持原样。SRT 时间码也始终保持同步。每一个标签、每一处时间戳、每一条格式细节都会被完整保留。

随时恢复进度。 翻译过程中断了？您可以从上次停止的地方继续。检查点系统会自动保存您的进度。

支持格式：EPUB、SRT、DOCX、TXT

服务提供商：

                 

• Ollama（本地 / 云端）
• Poe ⭐ 推荐——设置简单，支持多种 AI 模型
• OpenRouter（200+ 模型）
• OpenAI（兼容 LM Studio）
• Mistral
• DeepSeek
• Gemini

翻译质量基准测试 —— 为您的目标语言找到最佳模型。

---

快速入门

下载可执行文件（无需 Python！）

1. 下载并解压适合您平台的压缩包
2. 安装 Ollama（用于本地 AI 模型）
3. 运行 TranslateBook.exe（Windows）或 ./TranslateBook（macOS）
4. 在浏览器中打开 http://localhost:5000

注意： 首次运行时会创建一个包含配置文件的 TranslateBook_Data 文件夹。

macOS： 首次启动时，请前往“系统设置” > “隐私与安全性”，然后点击“仍要打开”。

---

给技术宅们——从源码安装

先决条件： Python 3.8+、Ollama、Git

git clone https://github.com/hydropix/TranslateBooksWithLLMs.git
cd TranslateBookWithLLM
ollama pull qwen3:14b    # 下载一个模型

# Windows
start.bat

# Mac/Linux
chmod +x start.sh && ./start.sh

Web 界面将在 http://localhost:5000 打开。

---

LLM 服务提供商

服务提供商	类型	设置
Ollama	本地	ollama.com
Poe ⭐	云端（推荐）	poe.com/api_key
OpenAI 兼容	本地	llama.cpp、LM Studio、vLLM、LocalAI...
OpenRouter	云端（200+ 模型）	openrouter.ai/keys
OpenAI	云端	platform.openai.com
Mistral	云端	console.mistral.ai
DeepSeek	云端	platform.deepseek.com
Gemini	云端	Google AI Studio

OpenAI 兼容服务器： 使用 --provider openai 并指定您的服务器端点（例如，llama.cpp：http://localhost:8080/v1/chat/completions，LM Studio：http://localhost:1234/v1/chat/completions）。

详细设置说明请参阅 docs/PROVIDERS.md。

---

命令行工具

# 基本用法（自动生成“book (Chinese).epub”）
python translate.py -i book.epub -sl English -tl Chinese

# 使用 OpenRouter
python translate.py -i book.txt --provider openrouter \
    --openrouter_api_key YOUR_KEY -m anthropic/claude-sonnet-4 -tl French

# 使用 OpenAI
python translate.py -i book.txt --provider openai \
    --openai_api_key YOUR_KEY -m gpt-4o -tl French

# 使用 Gemini
python translate.py -i book.txt --provider gemini \
    --gemini_api_key YOUR_KEY -m gemini-2.0-flash -tl French

# 使用本地 OpenAI 兼容服务器（llama.cpp、LM Studio、vLLM 等）
python translate.py -i book.txt --provider openai \
    --api_endpoint http://localhost:8080/v1/chat/completions -m your-model -tl French

主要选项

选项	描述	默认值
-i, --input	输入文件	必填
-o, --output	输出文件	自动：{name} ({lang}).{ext}
-sl, --source_lang	源语言	英语
-tl, --target_lang	目标语言	中文
-m, --model	模型名称	mistral-small:24b
--provider	ollama/openrouter/openai/gemini	ollama
--text-cleanup	OCR/排版清理	关闭
--refine	第二次润色以提升文学性	关闭
--tts	生成音频（Edge-TTS）	关闭

更多选项（TTS 音色、语速、格式等）请参阅 docs/CLI.md。

---

配置文件 (.env)

将 .env.example 复制到 .env 并进行编辑：

# 服务提供商
LLM_PROVIDER=ollama

# Ollama
API_ENDPOINT=http://localhost:11434/api/generate
DEFAULT_MODEL=mistral-small:24b

# API 密钥（如果使用云端服务）
OPENROUTER_API_KEY=sk-or-v1-...
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...

# 性能
REQUEST_TIMEOUT=900
MAX_TOKENS_PER_CHUNK=400  # 基于 token 的分块（默认：400 tokens）

---

Docker

docker build -t translatebook .
docker run -p 5000:5000 -v $(pwd)/translated_files:/app/translated_files translatebook

更多选项请参阅 DOCKER.md。

---

故障排除

问题	解决方案
Ollama 无法连接	检查 Ollama 是否正在运行，测试 curl http://localhost:11434/api/tags
未找到模型	运行 ollama list，然后 ollama pull 模型名

更多解决方案请参阅 docs/TROUBLESHOOTING.md。

---

文档

指南	描述
docs/PROVIDERS.md	详细的提供商设置（Ollama、LM Studio、OpenRouter、OpenAI、Gemini）
docs/CLI.md	完整的命令行界面参考
docs/TROUBLESHOOTING.md	问题解决方案
DOCKER.md	Docker 部署指南

---

链接

• 报告问题
• OpenRouter 模型

---

许可证: AGPL-3.0

TranslateBooksWithLLMs 快速上手指南

TranslateBooksWithLLMs 是一款利用大语言模型（LLM）翻译书籍、字幕和文档的开源工具。它支持本地部署或云端调用，无文件大小限制，并能完美保留 EPUB、SRT 等文件的原始格式与结构。

环境准备

系统要求

• 操作系统: Windows, macOS (Intel/Apple Silicon), Linux
• Python: 3.8+ (仅源码安装需要)
• Git: 用于克隆代码仓库 (仅源码安装需要)

前置依赖

1. Ollama (推荐本地运行):
   • 下载地址：https://ollama.com/download
   • 安装后拉取一个模型（例如 Qwen3 或 Mistral）：

     ollama pull qwen3:14b
     

2. API Key (若使用云端服务):
   • 如需使用 Poe, OpenRouter, DeepSeek, Gemini 等云服务，请提前在对应官网获取 API Key。
   • 国内开发者提示: 推荐使用 DeepSeek 或 OpenRouter (聚合了多种模型)，网络连通性相对较好。

---

安装步骤

你可以选择下载预编译包（无需 Python 环境）或从源码安装。

方式一：下载预编译包（推荐新手）

1. 根据你的操作系统下载最新 release 版本：

   • Windows: Download Windows
   • macOS Intel: Download macOS Intel
   • macOS Apple Silicon (M1/M2/M3/M4): Download macOS AppleSilicon

2. 解压下载的压缩包。

3. 确保已安装并运行 Ollama (如果使用本地模型)。

4. 运行程序：

   • Windows: 双击 TranslateBook.exe
   • macOS/Linux: 终端执行 ./TranslateBook

   macOS 用户注意: 首次运行若被拦截，请前往 系统设置 > 隐私与安全性 点击“仍要打开”。

5. 在浏览器中访问：http://localhost:5000

方式二：从源码安装（适合开发者）

# 1. 克隆仓库
git clone https://github.com/hydropix/TranslateBooksWithLLMs.git
cd TranslateBookWithLLM

# 2. 拉取本地模型 (以 qwen3:14b 为例)
ollama pull qwen3:14b

# 3. 启动服务
# Windows
start.bat

# Mac/Linux
chmod +x start.sh && ./start.sh

启动成功后，访问 http://localhost:5000 使用 Web 界面。

---

基本使用

方法 A：Web 界面操作 (最直观)

1. 打开浏览器访问 http://localhost:5000。
2. 在设置中选择提供商（如 Ollama 或 DeepSeek）并填入对应的 API Key（如需）。
3. 上传文件（支持 .epub, .srt, .docx, .txt）。
4. 设置源语言和目标语言（例如：English -> Chinese）。
5. 点击开始翻译，进度会自动保存，支持中断后继续。

方法 B：命令行操作 (CLI)

如果你更喜欢命令行，可以使用以下命令进行快速翻译。

基础用法 (使用默认本地 Ollama 模型):

python translate.py -i book.epub -sl English -tl Chinese

说明：自动读取 book.epub，将其从英文翻译为中文，输出文件名为 book (Chinese).epub。

使用云端模型 (以 DeepSeek 为例):

python translate.py -i book.txt --provider openai \
    --api_endpoint https://api.deepseek.com/v1/chat/completions \
    --openai_api_key YOUR_DEEPSEEK_KEY \
    -m deepseek-chat -tl Chinese

注意：DeepSeek 接口兼容 OpenAI 协议，故 provider 设为 openai 并指定 endpoint。

使用 OpenRouter (访问多种模型):

python translate.py -i novel.epub --provider openrouter \
    --openrouter_api_key YOUR_OPENROUTER_KEY \
    -m anthropic/claude-sonnet-4 -tl French

常用参数说明

参数	说明	示例
-i	输入文件路径	-i my_book.epub
-sl	源语言	-sl English
-tl	目标语言	-tl Chinese
--provider	服务提供商	ollama, openrouter, openai, gemini
-m	模型名称	-m qwen3:14b
--refine	开启二次润色 (提升文学性)	--refine
--tts	生成有声书音频	--tts

更多高级配置可参考项目根目录下的 .env.example 文件，复制为 .env 后修改默认模型或超时设置。