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-08-16 v0.7.6：

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

• 2026-08-10 v0.7.5：

  • 新增游戏模组管理，可安装、查看状态和卸载 URM、画廊解锁与简易界面修改器
  • 新增错误扫描与修复工具，支持检查语法、缩进、引号和重复翻译条目
  • 新增译文复用工具，可从旧翻译目录匹配并应用已有译文，同时创建目标备份
  • 优化接口卡片的信息层级与快捷操作，当前激活状态更直观
  • 修复接口分组之间出现白色横向空隙的问题

• 2026-08-08 v0.7.4：

  • 重构 Ren'Py 增量翻译，按文件和对话作用域识别语句，源文变化时只重译变化内容，避免同一句台词跨场景误用译文
  • 一键翻译可提取游戏程序中的隐藏界面文本，并支持运行时增量补全；已有译文不会被覆盖
  • 应用译文改为后台执行并显示进度，提取或写回失败时可恢复原始翻译目录和备份
  • 增加判定不译清单清除入口和大写缩写二次确认开关，减少短信、会员、编号等界面文本被误判为无需翻译
  • 修复重复条目、空翻译块、纯注释文件误删、自然语言误跳过以及提示词内容被写入游戏等问题
  • 优化应用内更新下载进度显示，百分比、主题色和下载状态更清晰

完整记录见 CHANGELOG.md

常见问题 📥

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

反馈与支持 💬

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

致谢 🙏

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