尧图网页设计 
TranslateBooksWithLLMs命令行完全手册一行命令批量翻译EPUB、DOCX与TXT【免费下载链接】TranslateBooksWithLLMsTranslate full-length books and documents with Ollama, OpenAI-compatible, Gemini, Mistral, DeepSeek, Poe or OpenRouter. Preserves formatting. Resumes where you left off. No file size limits.项目地址: https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMsTranslateBooksWithLLMsTBL是一款开源的 AI 书籍翻译工具支持通过命令行一行命令批量翻译EPUB、DOCX、TXT、SRT、PDF文件。基于translate.py入口脚本你可以调用 Ollama、OpenAI、Gemini、Mistral、DeepSeek、Poe 或 OpenRouter 等模型提供商翻译完整保留原文档排版支持断点续翻、术语表锁定和二次润色且没有任何文件大小限制——从单页文档到千页长篇小说都能处理。本手册面向新手带你从零跑通第一条翻译命令到掌握多提供商切换、并行加速、术语表与 TTS 语音等全部 CLI 玩法。 第一步安装与环境准备快速克隆仓库git clone https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMs cd TranslateBooksWithLLMs pip install -r requirements.txt依赖清单见 requirements.txt核心为 Flask、httpx、lxml、tiktoken 等命令行翻译功能不依赖 Web 界面只装 Python 依赖即可使用。两种模型接入方式方式适用场景说明本地 Ollama默认免费、隐私优先ollama pull qwen3:14b后直接可用无需 API Key云端提供商翻译质量更高OpenAI / Gemini / DeepSeek / Poe / OpenRouter 等需 API Key首次运行前可用curl http://localhost:11434/api/tags测试 Ollama 是否正常运行更多排查方法见 docs/TROUBLESHOOTING.md。 核心命令一条命令完成整本书翻译CLI 的完整定义位于 translate.py最简用法只有一个必填参数-i# 翻译 EPUB 小说自动生成 novel (Chinese).epub python translate.py -i novel.epub -sl English -tl Chinese # 翻译 TXT / DOCX / SRT / PDF 同理 python translate.py -i book.txt -tl Chinese python translate.py -i report.docx -tl Chinese python translate.py -i movie.srt -tl Chinese 不指定-o时输出文件自动命名为{原文件名} ({目标语言}).{扩展名}若文件已存在会自动追加编号不会覆盖旧文件。上图即 Web 界面中的「暂停翻译」面板翻译中断后可精确续传并支持中途更换模型——同样的检查点机制在命令行下同样生效。⚙️ 常用参数速查表基础参数参数说明默认值-i, --input输入文件.txt / .epub / .srt / .docx / .pdf必填-o, --output输出文件路径自动生成-sl, --source_lang源语言自动检测-tl, --target_lang目标语言自动按浏览器语言-m, --model模型名称qwen3:14b--provider提供商ollama / openai / gemini / mistral / deepseek / poe / openrouter / nim / litellmollama--parallel N并发分块数仅云端生效1提示词增强选项参数说明--text-cleanupOCR/排版清洗修复扫描文档的断行、空格、标点--refine追加第二轮润色提升文学性与流畅度--refine-only仅对已翻译文件做润色跳过翻译阶段--glossary 文件.json/csv注入术语表锁定专有名词译法--auto-glossary自动从文档提取一次性术语表无需文件--auto-style自动从文档提取文风指令 切换模型提供商一行命令换引擎本地 Ollama默认无需 Keypython translate.py -i book.txt -m qwen3:14b云端提供商示例# OpenAI python translate.py -i book.txt --provider openai \ --openai_api_key sk-xxx -m gpt-4o -tl French # Gemini python translate.py -i book.txt --provider gemini \ --gemini_api_key xxx -m gemini-2.0-flash -tl French # DeepSeek python translate.py -i book.txt --provider deepseek \ --deepseek_api_key xxx -m deepseek-v4-pro -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 多 API Key 自动轮换任何--*_api_key参数都支持逗号分隔多个 Key遇到 429 限流自动切换下一个——非常适合串联多个免费额度账号python translate.py -i book.txt --provider gemini \ --gemini_api_key key1,key2,key3 -m gemini-2.0-flash详细机制见 docs/API_KEY_ROTATION.md各提供商的 Key 获取方式见 docs/PROVIDERS.md。 高级玩法让翻译质量更上一层楼术语表全书专名一致LLM 逐块翻译、块间无记忆同一角色名可能在不同章节被译成不同写法。用--glossary注入 JSON 或 CSV 术语表规则只会在术语实际出现的分块中注入不浪费 tokenpython translate.py -i novel.epub -sl Chinese -tl English \ --glossary my_glossary.json不想手工建表加--auto-glossary --auto-style工具会各花一次额外 LLM 调用从文档本身自动派生术语表和文风指令无需任何文件python translate.py -i novel.epub -sl Chinese -tl English --auto-glossary --auto-style术语表的完整格式、名词性别标注等高级特性见 docs/GLOSSARY.md。并发加速--parallel云端提供商下用--parallel同时翻译多个分块可显著提速本地 Ollama 会自动强制为 1单实例串行。值越大越快但可能触发限流python translate.py -i long_novel.epub -tl Chinese --parallel 4 TTS翻译完直接生成有声书# 自动按目标语言选音色 python translate.py -i book.txt -tl French --tts # 指定音色、格式与语速 python translate.py -i book.txt -tl French \ --tts --tts-voice fr-FR-DeniseNeural --tts-format mp3 --tts-rate 10%TTS 基于 Edge-TTS支持opus/mp3输出详见 TTS 选项分组translate.py。⚡ 关键机制断点续翻与自动检查点翻译长书时最担心的是中途断网、限流或停电。TBL 内置检查点系统src/persistence/checkpoint_manager.py自动保存进度重新运行同一条命令即可从上次中断处继续已完成的分块不会重复消耗 token。若中途发现当前模型翻得不好可在 Web 界面暂停任务后直接「Change model」换模型续翻见文首截图命令行下同样只需重新执行命令即可续传。 .env 配置一次设置长期免参数不想每次手敲参数在项目根目录创建.env文件即可固化默认值完整模板见 docs/CLI.md# 提供商与模型 LLM_PROVIDERollama DEFAULT_MODELqwen3:14b API_ENDPOINThttp://localhost:11434/api/generate # 云端 Key支持逗号分隔多 Key 轮换 GEMINI_API_KEY... DEEPSEEK_API_KEY... # 性能 MAX_TOKENS_PER_CHUNK450 PARALLEL_TRANSLATIONS1配置项的加载逻辑位于 src/config.py。✅ 批量翻译实战清单把上面各节组合起来就是一套完整的命令行工作流安装克隆仓库 pip install -r requirements.txt试水python translate.py -i sample.txt -tl Chinese本地 Ollama 直接跑换引擎--provider openai --openai_api_key sk-xxx -m gpt-4o提质量加--glossary terms.json --refine提速云端加--parallel 4多 Key 防限流出声加--tts生成有声书场景推荐命令片段扫描版文字清洗--text-cleanup文学类润色--refine已有译文再打磨--refine-only长书断点续翻重跑原命令即可完整参数参考docs/CLI.md排错指南docs/TROUBLESHOOTING.mdDocker 部署docs/DOCKER.md一行命令千页长书格式不丢、进度可续——这就是 TranslateBooksWithLLMs 命令行模式的全部价值。【免费下载链接】TranslateBooksWithLLMsTranslate full-length books and documents with Ollama, OpenAI-compatible, Gemini, Mistral, DeepSeek, Poe or OpenRouter. Preserves formatting. Resumes where you left off. No file size limits.项目地址: https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TranslateBooksWithLLMs命令行完全手册：一行命令批量翻译EPUB、DOCX与TXT
TranslateBooksWithLLMs命令行完全手册一行命令批量翻译EPUB、DOCX与TXT【免费下载链接】TranslateBooksWithLLMsTranslate full-length books and documents with Ollama, OpenAI-compatible, Gemini, Mistral, DeepSeek, Poe or OpenRouter. Preserves formatting. Resumes where you left off. No file size limits.项目地址: https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMsTranslateBooksWithLLMsTBL是一款开源的 AI 书籍翻译工具支持通过命令行一行命令批量翻译EPUB、DOCX、TXT、SRT、PDF文件。基于translate.py入口脚本你可以调用 Ollama、OpenAI、Gemini、Mistral、DeepSeek、Poe 或 OpenRouter 等模型提供商翻译完整保留原文档排版支持断点续翻、术语表锁定和二次润色且没有任何文件大小限制——从单页文档到千页长篇小说都能处理。本手册面向新手带你从零跑通第一条翻译命令到掌握多提供商切换、并行加速、术语表与 TTS 语音等全部 CLI 玩法。 第一步安装与环境准备快速克隆仓库git clone https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMs cd TranslateBooksWithLLMs pip install -r requirements.txt依赖清单见 requirements.txt核心为 Flask、httpx、lxml、tiktoken 等命令行翻译功能不依赖 Web 界面只装 Python 依赖即可使用。两种模型接入方式方式适用场景说明本地 Ollama默认免费、隐私优先ollama pull qwen3:14b后直接可用无需 API Key云端提供商翻译质量更高OpenAI / Gemini / DeepSeek / Poe / OpenRouter 等需 API Key首次运行前可用curl http://localhost:11434/api/tags测试 Ollama 是否正常运行更多排查方法见 docs/TROUBLESHOOTING.md。 核心命令一条命令完成整本书翻译CLI 的完整定义位于 translate.py最简用法只有一个必填参数-i# 翻译 EPUB 小说自动生成 novel (Chinese).epub python translate.py -i novel.epub -sl English -tl Chinese # 翻译 TXT / DOCX / SRT / PDF 同理 python translate.py -i book.txt -tl Chinese python translate.py -i report.docx -tl Chinese python translate.py -i movie.srt -tl Chinese 不指定-o时输出文件自动命名为{原文件名} ({目标语言}).{扩展名}若文件已存在会自动追加编号不会覆盖旧文件。上图即 Web 界面中的「暂停翻译」面板翻译中断后可精确续传并支持中途更换模型——同样的检查点机制在命令行下同样生效。⚙️ 常用参数速查表基础参数参数说明默认值-i, --input输入文件.txt / .epub / .srt / .docx / .pdf必填-o, --output输出文件路径自动生成-sl, --source_lang源语言自动检测-tl, --target_lang目标语言自动按浏览器语言-m, --model模型名称qwen3:14b--provider提供商ollama / openai / gemini / mistral / deepseek / poe / openrouter / nim / litellmollama--parallel N并发分块数仅云端生效1提示词增强选项参数说明--text-cleanupOCR/排版清洗修复扫描文档的断行、空格、标点--refine追加第二轮润色提升文学性与流畅度--refine-only仅对已翻译文件做润色跳过翻译阶段--glossary 文件.json/csv注入术语表锁定专有名词译法--auto-glossary自动从文档提取一次性术语表无需文件--auto-style自动从文档提取文风指令 切换模型提供商一行命令换引擎本地 Ollama默认无需 Keypython translate.py -i book.txt -m qwen3:14b云端提供商示例# OpenAI python translate.py -i book.txt --provider openai \ --openai_api_key sk-xxx -m gpt-4o -tl French # Gemini python translate.py -i book.txt --provider gemini \ --gemini_api_key xxx -m gemini-2.0-flash -tl French # DeepSeek python translate.py -i book.txt --provider deepseek \ --deepseek_api_key xxx -m deepseek-v4-pro -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 多 API Key 自动轮换任何--*_api_key参数都支持逗号分隔多个 Key遇到 429 限流自动切换下一个——非常适合串联多个免费额度账号python translate.py -i book.txt --provider gemini \ --gemini_api_key key1,key2,key3 -m gemini-2.0-flash详细机制见 docs/API_KEY_ROTATION.md各提供商的 Key 获取方式见 docs/PROVIDERS.md。 高级玩法让翻译质量更上一层楼术语表全书专名一致LLM 逐块翻译、块间无记忆同一角色名可能在不同章节被译成不同写法。用--glossary注入 JSON 或 CSV 术语表规则只会在术语实际出现的分块中注入不浪费 tokenpython translate.py -i novel.epub -sl Chinese -tl English \ --glossary my_glossary.json不想手工建表加--auto-glossary --auto-style工具会各花一次额外 LLM 调用从文档本身自动派生术语表和文风指令无需任何文件python translate.py -i novel.epub -sl Chinese -tl English --auto-glossary --auto-style术语表的完整格式、名词性别标注等高级特性见 docs/GLOSSARY.md。并发加速--parallel云端提供商下用--parallel同时翻译多个分块可显著提速本地 Ollama 会自动强制为 1单实例串行。值越大越快但可能触发限流python translate.py -i long_novel.epub -tl Chinese --parallel 4 TTS翻译完直接生成有声书# 自动按目标语言选音色 python translate.py -i book.txt -tl French --tts # 指定音色、格式与语速 python translate.py -i book.txt -tl French \ --tts --tts-voice fr-FR-DeniseNeural --tts-format mp3 --tts-rate 10%TTS 基于 Edge-TTS支持opus/mp3输出详见 TTS 选项分组translate.py。⚡ 关键机制断点续翻与自动检查点翻译长书时最担心的是中途断网、限流或停电。TBL 内置检查点系统src/persistence/checkpoint_manager.py自动保存进度重新运行同一条命令即可从上次中断处继续已完成的分块不会重复消耗 token。若中途发现当前模型翻得不好可在 Web 界面暂停任务后直接「Change model」换模型续翻见文首截图命令行下同样只需重新执行命令即可续传。 .env 配置一次设置长期免参数不想每次手敲参数在项目根目录创建.env文件即可固化默认值完整模板见 docs/CLI.md# 提供商与模型 LLM_PROVIDERollama DEFAULT_MODELqwen3:14b API_ENDPOINThttp://localhost:11434/api/generate # 云端 Key支持逗号分隔多 Key 轮换 GEMINI_API_KEY... DEEPSEEK_API_KEY... # 性能 MAX_TOKENS_PER_CHUNK450 PARALLEL_TRANSLATIONS1配置项的加载逻辑位于 src/config.py。✅ 批量翻译实战清单把上面各节组合起来就是一套完整的命令行工作流安装克隆仓库 pip install -r requirements.txt试水python translate.py -i sample.txt -tl Chinese本地 Ollama 直接跑换引擎--provider openai --openai_api_key sk-xxx -m gpt-4o提质量加--glossary terms.json --refine提速云端加--parallel 4多 Key 防限流出声加--tts生成有声书场景推荐命令片段扫描版文字清洗--text-cleanup文学类润色--refine已有译文再打磨--refine-only长书断点续翻重跑原命令即可完整参数参考docs/CLI.md排错指南docs/TROUBLESHOOTING.mdDocker 部署docs/DOCKER.md一行命令千页长书格式不丢、进度可续——这就是 TranslateBooksWithLLMs 命令行模式的全部价值。【免费下载链接】TranslateBooksWithLLMsTranslate full-length books and documents with Ollama, OpenAI-compatible, Gemini, Mistral, DeepSeek, Poe or OpenRouter. Preserves formatting. Resumes where you left off. No file size limits.项目地址: https://gitcode.com/gh_mirrors/tr/TranslateBooksWithLLMs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考