热门搜索:
ghcr.io/hydropix/translatebookswithllms:sha-4cde2cc
ghcr.iolinux/amd64sha-4cde2cc大小: 未知更新于 2026年5月3日
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
使用LLM翻译书籍
使用AI翻译书籍、字幕和文档——本地或云端均可。
无大小限制。 处理任意长度的文档——从单页到千页小说均可。智能分块系统可处理无限内容，同时保留段落间的上下文。
完美保留格式。 文档输出与输入完全一致：EPUB格式、样式和结构保持完整。SRT时间码保持完美同步。所有标签、时间戳和格式细节均被保留。
随时恢复翻译。 翻译中断？可从上次中断处精确继续。checkpoint系统自动保存进度。
支持格式：EPUB、SRT、DOCX、TXT
提供商：
- Ollama（本地/云端）
- Poe ⭐ 推荐——设置简单，支持多种AI模型
- OpenRouter（200+模型）
- OpenAI（兼容LM Studio）
- Mistral
- DeepSeek
- Gemini
[!NOTE] https://github.com/hydropix/TranslateBooksWithLLMs/wiki — 为您的目标语言找到最佳模型。
快速开始
下载可执行文件（无需Python！）
- 下载并解压适用于您平台的压缩包
- 安装Ollama（用于本地AI模型）
- 运行
TranslateBook.exe（Windows）或./TranslateBook（macOS） - 在浏览器中打开 http://localhost:5000
[!NOTE] 首次运行会创建一个包含配置文件的
TranslateBook_Data文件夹。[!NOTE] macOS：首次启动时，前往系统设置 隐私与安全性，点击“仍要打开”。
技术人员专用——从源码安装
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-Compatible | 本地 | 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 |
[!NOTE] 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 | 源语言 | English |
-tl, --target_lang | 目标语言 | Chinese |
-m, --model | 模型名称 | mistral-small:24b |
--provider | 提供商（ollama/openrouter/openai/gemini） | ollama |
--text-cleanup | OCR/排版清理 | disabled |
--refine | 二次润色（提升文学性） | disabled |
--tts | 生成音频（Edge-TTS） | disabled |
详见 docs/CLI.md 获取所有选项（TTS语音、速率、格式等）。
配置文件（.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 # 基于令牌的分块（默认：400个令牌）
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 model-name |
详见 docs/TROUBLESHOOTING.md 获取更多解决方案。
文档
| 指南 | 描述 |
|---|---|
| docs/PROVIDERS.md | 提供商详细设置（Ollama、LM Studio、OpenRouter、OpenAI、Gemini） |
| docs/CLI.md | 完整命令行参考 |
| docs/TROUBLESHOOTING.md | 问题解决方案 |
| DOCKER.md | Docker部署指南 |
链接
- https://github.com/hydropix/TranslateBooksWithLLMs/issues
- OpenRouter模型
许可证： AGPL-3.0
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"