RenpyBox

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

README 🌍

• 中文（本页）
• English
• 请不要有中文路径

概述 📢

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

特别说明 ⚠️

• 本工具仅限合法使用。任何利用本工具实施违法、侵权或违法牟利活动的行为，均不受项目方认可或支持；相关法律责任由行为人依法自行承担

功能优势 📌

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

工具箱模块 🧰

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

支持的文本格式 🏷️

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

近期更新 📅

• 2026-10-07 v0.8.1：

  • 修复项目设置里选定的翻译输入目录被改写成 game/tl/<语言>，一键翻译跑完后会写回你原本选择的目录
  • 修复保存项目后立刻打开抽取规则对话框被误判成「项目已变化」而清空候选

• 2026-10-02 v0.8.0：

  • 打开模型列表页不再等待加载全部接口库，切换项目和保存翻译缓存明显更快
  • 校对页筛选、相似度与占位符检查提速，十万级文本项目不再反复停顿
  • 修复翻译未完成却提示成功、任务中断丢失进度、单条校验失败中断整份报告的问题
  • 修复多语言项目的运行时替换补丁互相覆盖、写回中断留下损坏译文、回填未完成静默成功的问题
  • 修复抽取规则对话框与校对定位对话框在暗色主题下残留浅色底
  • RPY 抽取设置按读取的语法分类，并说明每份规则被哪些流程共用；未点应用时明确提示

• 2026-09-27 v0.7.12：

  • 新增 RPY 抽取设置，按源码 RPY / TL RPY 分类管理内置、自定义和组合模式
  • 自定义抽取接入一键翻译、TL 翻译和源码翻译，并提供适合新手的默认入口与高级规则编辑
  • 优化 TL 原文配对和源码安全写回，减少自定义规则误选文本
  • 校对支持准确行定位、上下文预览、直接打开文件，以及批量重译进度与取消
  • 改善大项目加载和 Agent 扫描，修复启动脚本选择并保留不同剧情位置的同文译文

• 2026-09-22 v0.7.11：

  • 新增 Google/Bing 免费翻译，无需申请 Key，一键翻译、TL 翻译、源码翻译、直译页与本地词库均可使用
  • 直译页新增“自动写回文件”开关与手动写回按钮，修复开关打开后标签文字不显示的问题
  • 移除 DeepL/DeepLX/彩云/有道/阿里等不再使用的接口，清理历史遗留的兼容模块

• 2026-09-17 v0.7.10：

  • 修复自动更新替换更新器时提示权限不足、导致更新中断的问题
  • 恢复增量更新，版本匹配且安装文件完整时只下载变化文件，减少下载量
  • 本地缺文件、文件损坏或上次更新中断时，自动使用全量包修复
  • 发布前自动验证增量包能否还原完整新版，更新时保留用户配置和输入文件

完整记录见 CHANGELOG.md

常见问题 📥

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

反馈与支持 💬

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

致谢 🙏

• 部分代码与架构参考 AiNiee和 LinguaGacha
• 模块的设计理念来自于renpy-translator
• 本工具使用教程请看RenpyBox使用教程
• 本工具使用文档请看Renpy汉化教程