97 lines
2.3 KiB
Markdown
97 lines
2.3 KiB
Markdown
# EPUB 双语翻译程序 v0.07
|
||
|
||
一个基于 OpenRouter/OpenAI API 的 EPUB 双语翻译工具，采用**全局编号系统**和**真并发翻译**。
|
||
|
||
## ✨ 核心特性
|
||
|
||
### 🎯 全局编号系统
|
||
- **每个段落分配全局唯一ID**（格式：`p_0001`, `p_0002`...）
|
||
- **ID贯穿全流程**：提取 → 翻译 → 组装
|
||
- **精确对应保证**：绝不出现中英文错行问题
|
||
|
||
### ⚡ 真并发翻译
|
||
- **asyncio.gather 并发执行**：高效利用 API 速率限制
|
||
- **智能速率控制**：基于 Token 桶的 RateLimiter
|
||
- **实时进度显示**：Rich 进度条显示翻译状态
|
||
- **断点续传**：自动记录进度，随时中断随时继续
|
||
|
||
### 🛡️ 安全与稳定
|
||
- **环境隔离**：支持 `.env` 配置，API Key 不落地
|
||
- **鲁棒重试**：集成 `tenacity` 处理网络波动
|
||
- **缓存系统**：基于 Hash 的持久化缓存，跨天复用
|
||
|
||
### 🎨 极致排版
|
||
- **盘古之白**：自动在中文与西文数字间添加空格
|
||
- **样式注入**：注入专用 CSS 优化阅读体验
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 2. 配置环境
|
||
|
||
复制 `.env` 模板并填入你的 API Key：
|
||
|
||
```bash
|
||
# .env 文件
|
||
V3_API_KEY=sk-xxxxxx
|
||
OPENROUTER_API_KEY=sk-or-xxxxxx
|
||
```
|
||
|
||
### 3. 开始翻译
|
||
|
||
```bash
|
||
# 默认使用 OpenRouter
|
||
python main.py input/book.epub
|
||
|
||
# 使用 V3 Provider
|
||
python main.py input/book.epub -p v3
|
||
|
||
# 测试模式（只翻译前3个块）
|
||
python main.py input/book.epub --test
|
||
```
|
||
|
||
## 📂 目录结构
|
||
|
||
```
|
||
.
|
||
├── config/ # 配置文件
|
||
│ ├── config.json # 主配置
|
||
│ └── prompts.json # 提示词模板
|
||
├── input/ # 输入 EPUB 目录
|
||
├── output/ # 输出 EPUB 目录
|
||
├── cache/ # 缓存目录 (Manifest, Translations)
|
||
├── logs/ # 运行日志
|
||
└── src/ # 源代码
|
||
```
|
||
|
||
## ⚙️ 核心配置 (config.json)
|
||
|
||
```json
|
||
{
|
||
"translation": {
|
||
"chunk_size": 5000,
|
||
"temperature": 0.3
|
||
},
|
||
"providers": {
|
||
"v3": {
|
||
"base_url": "https://api.gpt.ge/v1",
|
||
"models": { "fast": "gpt-4o-mini" },
|
||
"rate_limits": { "requests_per_minute": 500 }
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 📄 许可证
|
||
|
||
MIT License
|
||
|
||
---
|
||
|
||
**版本**: v0.07
|
||
**更新**: 2026-01-13 |