aitf 0.1.9

AI Translation Framework - CLI tool for batch translation.

AITF

English | 简体中文

AITF (AI Translation Framework) 是一个强大的命令行翻译工具，支持批量文档翻译、润色和导出。

---

性能展示

本项目为极致的性能释放和稳定性而生。

下图展示了一个约 20,000 行的待翻译文件，在 50 并发线程下仅用约 4 分钟即可完成翻译任务：

50 并发 + DeepSeek API | 20k 行 | ~4 分钟完成 | 99.6% 成功率 | 397k TPM

---

核心特性

运行时稳定性

• IO 流清洗与接管：重构标准输出流捕获逻辑，屏蔽底层依赖库冗余日志，防止 TUI 界面撕裂或崩溃
• 智能错误恢复：内置异常拦截与自动重试机制，支持断点续传，适合长时间挂机运行
• 跨平台兼容：支持 Windows / Linux / macOS / Android (Termux)，Headless 服务器友好

智能格式处理

• 全自动格式转换：支持 .mobi / .azw3 / .kepub / .fb2 等格式的"识别 - 转换 - 翻译 - 还原"闭环
• 多格式原生支持：Epub、Docx、Txt、Srt、Ass、Vtt、Lrc、Json、Po、Paratranz 等 20+ 格式
• Calibre 中间件集成：自动调用 Calibre 处理复杂电子书格式

实时任务控制中心

• 动态并发调整：通过 + / - 键实时增减并发线程数
• API Key 热切换：通过 K 键强制触发 API Key 轮换，应对限流
• 任务中途监控：通过 M 键启动 WebServer 并自动打开浏览器
• 系统状态监控：底部状态栏实时显示运行状态，边框颜色联动
• 成本与时间预估：任务启动前自动预估 Token 消耗、API 费用及完成时间

多配置文件系统

• Profile 隔离存储：支持创建、克隆、切换多套配置方案
• 场景化配置：可区分"快速翻译"与"精细润色"等不同场景
• 配置热重载：修改配置后无需重启即可生效

插件化架构

• 模块化扩展：无需修改核心代码即可安全扩展功能
• 内置 RAG 插件：自动检索历史译文，为长篇内容提供上下文参考，提升术语和风格一致性
• 翻译检查插件：自动检测漏译、错译、格式异常等问题
• 集中化管理：CLI 主菜单和 Web UI 均提供插件管理页面

智能任务队列

• 批量任务配置：预先配置多个不同文件或翻译策略的任务
• 动态队列调度：支持拖拽排序（Web）和键盘交互重排（TUI）
• 任务热修改：队列执行中可实时修改待处理任务参数
• 自动顺序执行：适合大批量翻译工作流

上下文缓存

• 多平台支持：Anthropic / Google / Amazon Bedrock 上下文缓存
• 费用优化：缓存系统提示词和术语表，显著降低 API 调用费用
• 智能降级：自动检测 API 兼容性，不支持时自动关闭并提示

思考模式增强

• 全平台兼容：支持所有主流在线 API 平台及第三方中转站
• 智能参数配置：为在线 API 和本地模型提供不同的兼容性提示
• 深度推理支持：支持 DeepSeek R1、Claude 3.5 等模型的深度思考模式

API 故障转移

• 多 API 池管理：支持配置多个备用 API
• 自动切换：主 API 失败时自动切换到备用 API
• 阈值控制：可配置故障转移触发阈值

高并发性能释放

• 异步请求模式：基于 aiohttp 的异步 I/O，突破线程池瓶颈，支持 100+ 并发
• 智能错误分类：区分"硬伤错误"（格式/认证问题）与"软伤错误"（限流/超时），硬伤不重试，软伤智能等待
• Provider 指纹记录：自动检测并记录各 API 的功能支持情况，下次启动静默降级
• 信号量保护：高并发时保护本地系统资源（文件描述符、端口数），确保稳定运行
• 自动提示：当并发数 ≥15 时，自动建议启用异步模式以获得更好性能

---

快速开始

方式一：PyPI 安装（推荐）

# 安装
pip install aitf

# 运行
aitf --help

方式二：一键启动

1. 获取代码

git clone https://github.com/louloulin/tf.git
cd AiNiee-Next

2. 环境准备（首次运行）

Windows:

双击 prepare.bat

Linux / macOS:

chmod +x prepare.sh && ./prepare.sh

3. 启动应用

Windows:

双击 Launch.bat

Linux / macOS:

./Launch.sh

---

方式三：手动配置

1. 安装 uv

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Linux / macOS:

curl -LsSf https://astral.sh/uv/install.sh | sh

Android (Termux):

pkg update && pkg upgrade
pkg install python
pip install uv

2. 获取代码并启动

git clone https://github.com/louloulin/tf.git
cd tf
uv run aitf

---

命令行参数

支持通过命令行参数直接启动任务，适用于脚本集成与自动化。

翻译任务示例：

uv run aitf translate input.txt -o output_dir -p MyProfile -s Japanese -t Chinese --resume --yes

队列任务示例：

uv run aitf queue --queue-file my_queue.json --yes

主要参数：

• translate / polish / export / queue: 任务类型
• -o, --output: 输出路径
• -p, --profile: 配置 Profile 名称
• -s, --source: 源语言
• -t, --target: 目标语言
• --type: 项目类型 (Txt, Epub, MTool, RenPy 等)
• --resume: 自动恢复缓存任务
• --yes: 非交互模式
• --threads: 并发线程数
• --platform: 目标平台
• --model: 模型名称
• --api-url: API 地址
• --api-key: API 密钥

---

Web 控制面板

本项目集成基于 React 构建的 Web 控制面板，已进入稳定阶段。

启动方式：

1. 运行 uv run aitf 进入主菜单
2. 选择 15. Start Web Server
3. 程序将自动启动服务（默认端口 8000）并打开浏览器

功能：

• 可视化看板：实时图表展示 RPM、TPM 及任务进度
• 网络访问：支持局域网远程监控
• 配置管理：网页端创建、切换配置 Profile
• 队列管理：拖拽排序、实时编辑任务参数
• 插件中心：启用/禁用 RAG 等高级功能

开发说明：Web 控制面板已稳定运行，但功能相对 TUI 模式较少。本项目以 CLI/TUI 交互为核心开发方向，Web 端功能更新将在后续版本中逐步跟进。

---

架构说明

本项目采用 Wrapper / Adapter 模式：

• Core: 核心翻译引擎
• Adapter Layer: aitf 作为防腐层，负责环境隔离与异常拦截
• Runtime: 由 uv 托管，确保依赖环境一致性

---

免责声明

• 本工具仅供个人学习与合法用途使用

---

Made by ShadowLoveElysia