关键要点
- TranslateBooksWithLLMs(github.com/hydropix/TranslateBooksWithLLMs),简称"TBL",是一款用于翻译整本书、字幕和文档的免费开源应用
- 由使用GitHub用户名hydropix的开发者构建;本评测未在该项目背后发现任何公司、融资记录或商业赞助方
- 采用AGPL-3.0许可证,已通过GitHub代码仓库的许可证元数据核实
- 支持EPUB、DOCX、TXT和SRT格式,通过智能的、基于token的分块方式保留格式和字幕时间码,因而没有文件大小限制
- 可免费搭配本地Ollama模型使用,也可搭配云端提供商——OpenAI、Google Gemini、Mistral、DeepSeek、Poe、OpenRouter、NVIDIA NIM——以及llama.cpp、LM Studio、vLLM等任何兼容OpenAI的本地服务器
- 配有检查点/续传系统,以及可选的术语表和写作风格提取功能,以在整本书中保持术语和语气一致;还提供通过Edge-TTS实现的可选文本转语音输出
- 截至本评测撰写时GitHub星标数超过2,400,fork数319;代码仓库创建于2025年5月22日
📍 简单一句话
TranslateBooksWithLLMs(TBL)是一款免费开源(AGPL-3.0)应用,提供Windows/macOS桌面应用、Web界面和命令行工具,可用本地Ollama模型或云端LLM提供商翻译整本书、字幕和文档(EPUB、DOCX、TXT、SRT),没有文件大小限制,并配有可恢复中断任务的检查点系统。
💬 简单来说
TranslateBooksWithLLMs不需要把书逐章粘贴进聊天窗口,而是读取整个文件,在后台将其拆分为可管理的片段,在保留上下文和格式的同时翻译每个片段,再重新组装出完整文件——如果过程中被中断,还会自动继续。
📌注: 本评测基于TranslateBooksWithLLMs自身的GitHub代码仓库、README和文档,而非PromptQuorum独立进行的翻译质量测试。该项目在其GitHub Wiki上链接了自有的、由社区维护的翻译质量基准测试——应将其视为自行发布的一手数据,而非经独立审核的基准测试。
TranslateBooksWithLLMs是什么?
TranslateBooksWithLLMs是一款围绕单一任务构建的免费开源应用:用LLM翻译一整本书、文档或字幕文件,而不是逐页或逐条聊天消息翻译。 其自身的GitHub描述指出,它能"使用Ollama、兼容OpenAI的模型、Gemini、Mistral、DeepSeek、Poe或OpenRouter翻译整本书和文档",并且"保留格式,从中断处继续,没有文件大小限制"。
- 产品类型:一款独立的翻译应用,提供三种界面——打包的桌面应用、本地Web界面和命令行工具——而不是其他程序的插件
- 开发者:使用GitHub用户名hydropix的开发者;截至本评测撰写时,代码仓库中未公开任何法律名称或公司名称
- 许可证:AGPL-3.0,一种著佐权开源许可证,已通过GitHub代码仓库的许可证元数据核实
- 代码仓库:github.com/hydropix/TranslateBooksWithLLMs,创建于2025年5月22日
- 规模:截至本评测撰写时,GitHub星标数超过2,400,fork数319,贡献者11位,未解决issue25个
- 核心引擎:一条Python翻译流水线,将输入文本分块,把每个块发送到你配置的LLM提供商,并在保留结构的同时重新组装输出
项目历史与版本里程碑
TranslateBooksWithLLMs的GitHub代码仓库创建于2025年5月22日,此后持续发布更新,从一个以命令行为主的翻译脚本,发展为一款拥有共享的多设备Web工作区的完整桌面应用。下方的版本号来自项目自身的GitHub发布记录;对于本评测发布日期之后推出的任何内容,请直接查看发布页面。
- 1代码仓库创建——2025年5月22日
Why it matters: 该项目最初是一款围绕Ollama及其他LLM提供商构建的基于Python的图书与文档翻译工具。 - 2v1.4.x系列——2026年5月至8月
Why it matters: 根据GitHub发布列表,截至2026年年中,一系列小版本发布(v1.4.1至v1.4.11)持续推出,表明功能和修复正在稳定、渐进地交付。 - 3v1.5.0——2026年8月2日
Why it matters: 根据GitHub发布列表,新的次版本系列开始;具体改动请查看GitHub上对应的发布说明。 - 4v1.5.6至v1.5.9——2026年8月9日至24日
Why it matters: 根据GitHub发布列表,2026年8月期间持续进行补丁级别的迭代。 - 5v1.5.10——2026年9月6日:本评测撰写时最新的标记版本
Why it matters: 本评测撰写时的当前版本;本评测中描述的桌面应用、检查点/续传系统、术语表和风格提取功能,以及多提供商支持,均已在此版本中具备。
用TranslateBooksWithLLMs能做什么?
TranslateBooksWithLLMs的功能集核心在于,即便文档长度远超单次聊天上下文窗口,也能从LLM那端得到一份完整、格式正确的翻译文件。以下是根据项目自身的README和文档,各部分实际的功能。
- 通过分块实现不限长度的翻译——应用将输入拆分为基于token的块(根据文档中的
.env配置,默认为450个token),在保留片段之间上下文的同时翻译每一块,因此书籍长度的输入并不构成硬性限制 - 格式保留——根据项目自身的描述,翻译输出会保留EPUB的结构和样式、DOCX的格式以及SRT字幕的时间码
- 检查点与续传——中断的翻译(应用关闭、连接中断、达到速率限制)可以从中断处继续,而不必从头重新开始
- 可复用的写作风格预设——从样例书籍中提取一个风格预设(或手动编写一个),并将其应用于新翻译的每一块,以在整本书中保持一致的语域和语气
- 自动术语表与风格提取——如果没有现成的预设,选择"Auto"会在任务开始前额外调用一次LLM,直接从待翻译文档中提取术语表和风格档案
- 多提供商支持——免费使用本地Ollama模型,或任何兼容OpenAI的本地服务器(llama.cpp、LM Studio、vLLM、LocalAI),或云端提供商:OpenAI、Google Gemini、Mistral、DeepSeek、Poe、OpenRouter或NVIDIA NIM
- API密钥轮换——为单个提供商配置以逗号分隔的API密钥列表,当某个密钥触发速率限制时,应用会自动切换到下一个密钥
- 多设备共享的Web工作区——Web界面没有用户账户;指向同一台运行中服务器的每个浏览器都能近乎实时地看到相同的任务进度、历史记录和大多数偏好设置
- 可选的文本转语音输出——除翻译文档本身外,还可通过Edge-TTS从翻译文本生成音频
- 通知——长时间翻译任务完成时,通过ntfy、Discord、Slack、gotify或自定义HTTP webhook接收推送通知
使用示例:TranslateBooksWithLLMs的三种用法
以下是基于上文TranslateBooksWithLLMs自身文档化功能构建的具体工作流程,而非假设性用例。
下载TranslateBooksWithLLMs
TranslateBooksWithLLMs为Windows和macOS(Intel和Apple Silicon)提供打包的桌面版本;Linux用户则从源码或通过Docker运行,而非使用预构建的二进制文件。 以下链接来自项目的最新GitHub发布——由于构建URL会随每次发布变化,请始终直接前往该页面核实。
平台 | 下载 |
|---|---|
| Windows | TranslateBook-Windows.zip |
| macOS(Apple Silicon) | TranslateBook-macOS-AppleSilicon.zip |
| macOS(Intel) | TranslateBook-macOS-Intel.zip |
| Linux/任意系统(从源码) | 克隆GitHub仓库,运行./start.sh(需要Python 3.8+,本地模式需要Ollama) |
| Docker | 先执行docker build -t translatebook .,再执行docker run -p 5000:5000 translatebook——参见docs/DOCKER.md |
在macOS上,由于截至本评测撰写时桌面版本尚未通过Apple公证,首次启动时需要在"系统设置 > 隐私与安全性 > 仍要打开"中进行批准。无论选择哪种安装方式,通过Ollama进行本地翻译还需要另外通过Ollama本身下载一个模型——TranslateBooksWithLLMs本身不附带任何模型。
TranslateBooksWithLLMs的价格与许可
TranslateBooksWithLLMs本身免费且开源,采用AGPL-3.0许可证。 该应用没有付费层级、订阅或账户注册要求。实际费用完全取决于你翻译时使用的模型提供商。
- 该应用是免费的,项目本身不设任何使用限制、水印或功能门槛
- 使用本地Ollama模型翻译,成本仅为你自己的硬件和电费——不会向TranslateBooksWithLLMs或Ollama支付任何按字或按token计费的费用
- 使用云端提供商(OpenAI、Gemini、Mistral、DeepSeek、Poe、OpenRouter或NVIDIA NIM)翻译,费用取决于该提供商对API使用的收费标准;其中多家提供商公布了免费额度,但TranslateBooksWithLLMs并不控制或保证这些定价
- 许可证:AGPL-3.0,已通过GitHub代码仓库的许可证元数据核实——这是一种带有网络使用条款的著佐权许可证,意味着如果你修改代码并将其作为面向他人的网络服务运行,通常也需要公开你修改后的源代码;这与MIT或Apache 2.0等宽松型许可证有实质区别,如果这项义务与你的使用场景相关,请自行查阅许可证文本
- 本评测未发现该项目背后存在融资记录、公司或商业赞助方的证据——其自身README链接了一个用于自愿捐赠的Ko-fi页面,这与一个独立维护、由社区支持的开源项目相符
TBL中本地(Ollama)与云端翻译对比
TranslateBooksWithLLMs同时支持通过Ollama实现的完全本地翻译路径和云端提供商路径,两者的主要差异在于速度、成本和隐私——而不在于可用的文件格式或功能。
成本
- 本地(Ollama):
- 除自身硬件/电费外免费
- 云端提供商:
- 按提供商的API使用量计费;部分提供免费额度
隐私
- 本地(Ollama):
- 翻译不会将文本发送到任何地方——文本留在你的机器上
- 云端提供商:
- 文本会根据提供商自身的数据处理条款发送至其服务器
并发
- 本地(Ollama):
- 串行处理——一次一块(
PARALLEL_TRANSLATIONS会被忽略) - 云端提供商:
- 支持
--parallel N并发翻译多个块,受限于提供商自身的速率限制
配置
- 本地(Ollama):
- 需要先安装Ollama并在本地拉取一个模型
- 云端提供商:
- 只需所选提供商的API密钥
翻译质量
- 本地(Ollama):
- 取决于本地模型的规模和语言覆盖范围
- 云端提供商:
- 取决于所选云端模型;通常有更多规模更大的模型可选
该项目在其GitHub Wiki上链接了按目标语言分类的自有社区翻译质量基准测试——请直接查看该页面,针对你的目标语言比较具体的本地模型和云端模型,而不要依赖关于本地与云端质量的一般性假设。
谁适合使用TranslateBooksWithLLMs?
TranslateBooksWithLLMs适合需要端到端地翻译整本书、文档或字幕文件,并保持格式和术语一致的用户,而不是只需要把一小段文字粘贴进聊天窗口的用户。
竞品与替代方案
在PromptQuorum当前的评测目录中,专门面向整本书篇幅的LLM图书翻译工具是一个很小的细分领域——在本站现有的FeatureAppPost评测中,TranslateBooksWithLLMs没有功能相匹配的近似竞品。 目前可用的最接近的比较对象,是其他同样强调在本地处理整篇文档的本地LLM驱动的文档与知识工具,尽管它们都不是专门的翻译工具。
Karakeep
- Best known for:
- 一款可自托管的书签与笔记应用,具备基于AI的标签、摘要生成,以及对已保存文档的搜索功能
- Link:
- Karakeep评测
关于Karakeep的文章(2篇)
- Karakeep Review 2026: Self-Hosted Bookmarks with AI Auto-Tagging更新于 2026年9月18日
- Blinko Review 2026: Self-Hosted AI Notes with RAG Search更新于 2026年9月19日
其他提及:
- Surf Review 2026: Deta's Open-Source AI Notebook更新于 2026年9月19日
Khoj
- Best known for:
- 一款可自托管、开源的个人AI"第二大脑",能就你自己的文档回答问题
- Link:
- Khoj评测
关于Khoj的文章(2篇)
- Khoj Review 2026: Self-Hosted AI Second Brain, No Cloud Left更新于 2026年9月2日
- Vane Review 2026: Self-Hosted AI Answering Engine (Formerly Perplexica)更新于 2026年9月14日
其他提及:
- Agentic Inbox Review: A Self-Hosted Email Client With an AI Agent更新于 2026年9月19日
- Sidekick Review 2026: A Free, Native macOS Local AI Chat App更新于 2026年9月19日
- Surf Review 2026: Deta's Open-Source AI Notebook更新于 2026年9月19日
- SiYuan Review 2026: The Privacy-First, Block-Based Knowledge Base更新于 2026年9月18日
- Hyperlink (Nexa AI) Review 2026: On-Device File Search更新于 2026年9月12日
- Odysseus Review 2026: The Self-Hosted AI Workspace更新于 2026年9月12日
- AnythingLLM Review: Open-Source RAG and Document Chat更新于 2026年9月11日
- Quivr Review 2026: Is the Open-Source "Second Brain" Still Alive?更新于 2026年9月2日
Karakeep和Khoj都不翻译文档——它们被列在此处,是因为它们是PromptQuorum已评测的、以文档为核心的本地LLM驱动生产力工具中最接近的选项,而不是TranslateBooksWithLLMs功能对等的直接替代品。如果日后有更接近的选项加入,请查看本地LLM软件目录获取完整目录。
评估TranslateBooksWithLLMs时的常见误区
关于TranslateBooksWithLLMs的大多数困惑,源自对其许可条款的误解、误以为它像实时聊天翻译工具一样工作,或忽略了本地翻译是逐块进行的这一事实。
常见问题
TranslateBooksWithLLMs是什么?
TranslateBooksWithLLMs(github.com/hydropix/TranslateBooksWithLLMs),简称"TBL",是一款免费开源(AGPL-3.0)应用,可用本地Ollama模型或云端LLM提供商翻译整本书、字幕(SRT)和文档(EPUB、DOCX、TXT)。
TranslateBooksWithLLMs是免费的吗?
是的,应用本身免费且开源,没有付费层级。如果你使用本地Ollama模型翻译,唯一的成本是你自己的硬件和电费。如果你连接云端提供商(OpenAI、Gemini、Mistral、DeepSeek、Poe、OpenRouter或NVIDIA NIM),则需要直接向该提供商支付API使用费用。
如何安装TranslateBooksWithLLMs?
从最新GitHub发布下载适用于Windows或macOS(Intel或Apple Silicon)的打包桌面应用,解压后运行可执行文件——Web界面会在localhost:5000打开。由于截至本评测撰写时没有预构建的Linux二进制文件,Linux用户可通过源码(git clone加./start.sh)或Docker运行。
TranslateBooksWithLLMs能离线使用吗?
可以,如果你通过Ollama使用本地模型。安装好Ollama和一个模型后,翻译本身会完全在你的机器上运行——应用不会将书籍或文档文本发送到外部服务器用于翻译。(它仍可能进行与文档内容无关的常规后台网络通信,例如检查应用更新。)若改用云端提供商,则需要网络连接,且你的文本会被发送给该提供商。
TranslateBooksWithLLMs支持哪些文件格式?
根据项目自身的文档,支持EPUB、DOCX、TXT和SRT(字幕)。翻译输出会保留EPUB的格式和结构、DOCX的样式以及SRT的时间码。
有文件大小限制吗?
没有。TranslateBooksWithLLMs使用基于token的分块系统(默认每块450个token),可以处理任意长度的文档,包括千页级别的书籍,同时在各块之间保留上下文。
我可以恢复中断的翻译吗?
可以。TranslateBooksWithLLMs的检查点系统会自动保存进度,因此因应用关闭、连接中断或触发速率限制而中断的任务,可以从中断处继续,而不必从头重新开始。
TranslateBooksWithLLMs支持哪些云端提供商?
根据项目自身的README,支持OpenAI、Google Gemini、Mistral、DeepSeek、Poe、OpenRouter和NVIDIA NIM,以及llama.cpp、LM Studio、vLLM等任何兼容OpenAI的本地服务器。
TranslateBooksWithLLMs采用什么许可证?
AGPL-3.0,一种带有网络使用条款的著佐权开源许可证。如果你修改代码并将其作为面向其他用户的托管服务运行,通常需要同时公开你修改后的源代码——如果这适用于你计划的用途,请直接阅读许可证文本。
TranslateBooksWithLLMs是谁开发的?
根据代码仓库的所有权信息,是一位使用GitHub用户名hydropix的开发者。本评测未发现任何已公开的法律名称或公司名称,也没有发现该项目背后存在融资记录的证据。