RenpyBox

使用 AI 能力一键翻译 Ren'Py / 视觉小说文本的工具箱

README 🌍

• 中文（本页）

概述 📢

• RenpyBox：PyQt + Fluent UI 打造的 Ren'Py 本地化工具箱，提取、翻译、修复、打包于一体的Ren'Py 专用翻译解决方案
• 目标用户：视觉小说开发者、同人翻译组、Ren'Py翻译者

特别说明 ⚠️

• 若涉及商业用途，请先联系作者获取授权

功能优势 📌

• 一键翻译向导：自动检测 game/tl/<lang>，支持增量/全量提取、断点续译、暂停/继续
• 术语与禁译：角色名提取、术语表/禁译表本地管理，支持文本保护、前后替换、混合语清理
• 多引擎并发：内置 OpenAI/DeepSeek/Anthropic/Google/火山等模板，可在“接口管理”添加自定义端点
• 高保真格式：AST 补全 + 缺失文本扫描 + miss_patch，同步生成 replace_text*.rpy 补丁，保留既有译文
• Ren'Py 工具链：RPY 格式化、缩进/引号检查与修复、尾空格清理、批量字体替换、RPA 解包/打包、语言入口/默认语言设置、安卓打包（安卓外壳打包）
• 进度可视化：并发控制、速率限制、token/进度仪表盘。

工具箱模块 🧰

• 一键翻译 / 翻译提取 / 直接翻译 RPY/源码 / 增量翻译
• 本地术语表、文本保护、前后替换、名称字段提取、局部重翻、批量修正
• RPA 解包/打包、字体注入、默认语言/入口配置、格式化与错误修复、HTML/Excel/JSON 导入导出

支持的文本格式 🏷️

• Ren'Py 导出 .rpy、本地术语表/替换规则
• 其他格式持续补充，欢迎在 Issues 提交需求

近期更新 📅

2026-2-04 v0.4.7：

• 源码翻译统一走 Engine，支持术语库/禁翻表/缓存与断点续译
• 新增 Ren'Py 源码读写流程
• 修复源码翻译不走引擎导致结果为空的问题

常见问题 📥

• 运行日志位于 ./log，反馈问题请附相关日志
• 缓存存放在 output/cache，可在暂停后直接继续任务或导出已完成部分
• 若外部接口超时/限速，可在“接口管理”调整并发与速率限制

反馈与支持 💬

• 欢迎通过 Issues/PR 反馈问题或贡献功能
• 反馈问题的时候请附上log日志，日志文件位于 ./log 目录下
• QQ 群：821152470

致谢 🙏

此项目继承LinguaGacha 它的UI和翻译引擎(本人太懒了没有灵感写额外的UI😂)。

由于目的是专注于Ren'py的翻译,所以此项目并不是LinguaGacha的分支版本。

相较于LinguaGacha，本项目的独特优势是Renpy相关的工具使用。

• 相关代码取于AiNiee
• 模块的设计理念来自于renpy-translator
• 教程请看RenpyBox使用教程
• 文档请看Renpy汉化教程