RenpyBox

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

README 🌍

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

概述 📢

• 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 解包/打包、RPYC 反编译、语言入口/默认语言设置、安卓打包（安卓外壳打包）
• 进度可视化：并发控制、速率限制、token/进度仪表盘。

工具箱模块 🧰

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

支持的文本格式 🏷️

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

近期更新 📅

• 2026-09-13 v0.7.8：

  • 优化深浅色界面、任务监控和一键翻译步骤，修复“应用生效”页面多余滚动与空白
  • 改善 Agent 长会话、消息显示和缓存统计，简化角色与世界观编辑及双语校对操作
  • 完善自动解包、反编译与漏翻补丁生成，减少重复抽取
  • 合并重复入口为“写入译文文件”，修复点击闪退并显示实际写入目录
  • 修复继续翻译的行数设置不生效、译文复用误报冲突、剩余时间丢失及游戏菜单报错

• 2026-08-25 v0.7.7：

  • 新增带插画启动页，启动期间立即显示 RenpyBox 加载画面
  • 默认翻译并发调整为 16，暂停后继续任务会读取最新并发和速率限制设置
  • 项目路径、直接翻译路径和模式保存统一收口，减少页面之间的配置覆盖
  • 优化自动更新器校验、增量更新和更新失败恢复，并加强密钥与配置保存安全
  • 增加翻译进度合并和通知去重，修复多个更新与配置边界问题

• 2026-08-16 v0.7.6：

  • 新增内置 AI Agent 助手，可检查项目、扫描问题并在确认后执行 RPA 解包和一键翻译
  • RPA 打包支持按大小自动拆分为多个归档文件
  • 主导航、Ren'Py 工具箱、一键翻译、工作台和常用工具补全中英文界面
  • 工作台新增角色筛选、资料导入导出和草稿批量应用，并优化一键翻译自动解包流程
  • 修复连续编辑角色资料导致界面卡死，以及 Agent 确认取消闪退、消息裁切等问题

完整记录见 CHANGELOG.md

常见问题 📥

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

反馈与支持 💬

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

致谢 🙏

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