使用 AI 能力一键翻译 Ren'Py / 视觉小说文本的工具箱
- RenpyBox:集文本提取、翻译、校对、修复与打包于一体的 Ren'Py 本地化工具箱。桌面端(Electron + Web 界面)是唯一前端;旧的 Python / Qt5 界面与打包流程已移除,仓库只保留无界面的 Python 后端与桌面壳。
- 目标用户:视觉小说开发者、同人翻译组、Ren'Py翻译者
- 建议使用硅基流动 进行翻译
0.9.1 桌面版;项目、译文与进度为演示数据
- 本工具仅限合法使用。任何利用本工具实施违法、侵权或违法牟利活动的行为,均不受项目方认可或支持;相关法律责任由行为人依法自行承担
- 桌面界面:翻译任务、平行校对台、Ren'Py 工具箱、角色 / 世界观工作台、Agent 助手;支持浅色 / 深色主题与中英文界面切换(部分文案仍可能显示中文)
- 一键翻译向导:自动检测
game/tl/<lang>,支持增量/全量提取、断点续译;任务页可「停止」「继续任务」「写入译文文件」「重翻失败项」 - 术语与禁译:角色名提取、术语表 / 禁翻表本地管理,支持文本保护、前后替换、混合语清理;工作台可维护角色卡与世界观,并预览 / 编辑翻译提示词
- 免费翻译:内置微软必应、谷歌和哔哩哔哩的免费翻译接口,无需申请 Key。微软必应和谷歌也可用于本地词库。
- 多引擎并发:内置 OpenAI/DeepSeek/Anthropic/Google/火山等模板,可在「接口管理」添加自定义端点;并发任务阈值与 RPM 等在「基础设置」调整
- 高保真格式:AST 补全 + 缺失文本扫描 + miss_patch,同步生成
replace_text*.rpy补丁,保留既有译文 - Ren'Py 工具链:RPY 格式化、缩进/引号检查与修复、尾空格清理、批量字体替换、RPA 解包/打包、RPYC 反编译、语言入口/默认语言设置、安卓打包(安卓外壳打包)
- 进度可视化:翻译任务页展示 token / 进度与任务状态
- Agent 一条龙:在「Agent 助手」里一句话完成解包 → 反编译 → 抽取 → 翻译 → 回填 → 兜底,只确认一次;也可逐步指挥,上下文与轮次上限按所选模型的容量自动推导
- 剧情蓝图:按章节把全部剧情摊开查看,每段剧情标注所在文件行号、台词量与已译进度,配当时的场景画面,并画出「选项 / 跳转」的去向与来源;翻译前就能用来摸清结构,翻译中用来定位还没翻的段落
- 角色关系图谱:从
.rpy里按称谓原文挖出角色关系,不需要先翻译或生成世界观;没有数据时按体检结果告诉你下一步该做什么(是没绑工程、没解包,还是还没扫)
桌面版「Ren'Py 工具箱」共 26 项,分为四组:
- 推荐流程(9):继续翻译、一键翻译、检查与润色、应用翻译到游戏、字体注入、添加语言入口、设置默认语言、术语表、禁翻表
- 翻译方式(7):RPY 抽取设置、翻译抽取到 TL、直接翻译 RPY、HOOK 翻译、源码翻译、补全翻译、文本提取 JSON
- 资源与词表(4):称呼桥接、终极结构导出、批量修正、姓名提取
- 工程与修复(6):解包/打包、脚本修复、更新翻译复用、安卓打包、网页 / AI 翻译向导、游戏模组注入
校对可从工具箱「检查与润色」进入,或在翻译任务页打开「平行校对台」。校对保存到翻译缓存;写回游戏请使用「写入译文文件」或「应用翻译到游戏」,编辑校对本身不会自动改写游戏文件。
- Ren'Py 导出
.rpy、本地术语表/替换规则 - 其他格式持续补充,欢迎在 Issues 提交需求
从 GitHub Releases 获取 Windows x64 安装程序或免安装 ZIP。桌面版已附带运行环境,无需另装 Python,详细步骤见桌面版使用说明。
发布资产区分:
| 文件 | 用途 |
|---|---|
RenpyBox-0.9.4-x64.exe |
Windows 安装程序,推荐使用 |
RenpyBox-0.9.4-x64.zip |
免安装包,完整解压后运行其中的程序 |
桌面正式包通过应用内检查更新下载完整安装包,一次跳到最新版(含大小与 SHA-256 校验,校验通过才允许安装);不提供差分/增量下载。应用配置位于 %APPDATA%\RenpyBox(旧版 RenpyBox-newUI 目录会在首次启动时自动迁移);从旧 Python 版迁移时,在「接口管理」点击「新增接口 → 从旧版导入」选择旧版程序目录下的 config.json 即可,密钥保存在系统凭据管理器中,会自动沿用。
旧版 SQLite / JSON 翻译缓存仍可使用,升级不会强制转换。需要备份或换机继续时,可在「项目设置 → 工程文件(.rbox)」操作:
- 先绑定对应游戏,点击「从旧版数据创建工程文件」,选择旧输出目录或其中的
cache目录;支持游戏目录以外的旧数据。 - 确认预览中的来源、格式、条目数与当前游戏,再选择保存位置。此步骤只新建
.rbox,不会修改旧数据,也不会替换当前缓存;文件中的项目设置来自当前应用,不会自动读取旧程序的配置。 - 在目标位置绑定同一个游戏,点击「导入工程文件」,检查预览后确认。导入会先备份当前缓存,失败时自动恢复。
.rbox 是手动快照,继续翻译或修改设置后需再次保存。它包含翻译缓存和允许迁移的项目设置,不包含游戏源文件、接口与密钥;游戏文件请另行保留,接口迁移使用上面的「从旧版导入」。
- 在「接口管理」选择或添加翻译接口并测试。首次使用默认选中微软必应翻译(免费);谷歌免费翻译在中国大陆通常需要代理。「哔哩哔哩(免费)」使用
Index-Translate-35B-A3B,同样无需 Key。若提示限流或额度耗尽,可稍后重试,或切换网络出口 IP / 代理节点。若旧版必应接口测试报NoneType/xpath,请更新 RenpyBox;新版直接请求www.bing.com,避免旧中国域名的重定向导致空响应。 - 在「项目设置」选择输入目录与语言,或打开工具箱「一键翻译」选择游戏目录完成准备。
- 进入「翻译任务」,确认当前接口与输入 / 输出目录后开始翻译;可用「停止」「继续任务」,失败条目可「重翻失败项」。
- 通过工具箱「检查与润色」或任务页「打开平行校对台」校对;确认后使用「写入译文文件」。校对不会自动写入游戏文件。
- 需要时再使用「应用翻译到游戏」、字体注入、添加语言入口或设置默认语言。
-
2026-11-20 v0.9.14:
- 更新下载支持断点续传:网络中断或取消后保留已下载部分,再次更新从断点继续;网络抖动自动退避重试并切换备用镜像,已下完的安装包不再重复下载
- 更新下载默认走加速镜像(fastgit.cc / cors.isteed.cc):实测 235MB 安装包 7~10 秒下完,GitHub 直连与旧的 ghfast.top 在国内已基本不可用;某条镜像 12 秒无数据会自动换下一条
- 设置页新增「更新镜像」:可自行增删镜像地址,留空即用内置默认;镜像只影响下载速度,安装包仍做完整 SHA-256 校验
- 抽取不再卷入工程里其它语言的译文:多语言工程不再因自带的 japanese / korean 译文报「翻译已存在」,抽取期间临时隔离并在结束后自动恢复,那些译文不会被改动
- 官方抽取失败不再谎报成功,提示会指出重复原文在哪个语言、哪个文件、第几行,不再建议删除 tl 文件夹
- 绑定工程后自动创建并绑定 .rbox,切换工程不残留旧绑定;解除绑定后再导入不再报「找不到工程文件」
- .rbox 默认保存到工程根目录,不再套 RenpyBox_Translation 子文件夹
-
2026-11-19 v0.9.13:
- 新增哔哩哔哩免费翻译接口(Index-Translate-35B-A3B),无需申请 Key,可在「接口管理」直接选用
- 新配置默认选中微软必应免费翻译,不改动老用户已选的接口
- 修复必应免费翻译因中国大陆域名重定向返回空响应的问题,接口测试不再报 NoneType / xpath
-
2026-11-15 v0.9.12:
- 术语表支持勾选删除:最左列独立行选择框,按勾选批量删除;翻页保留勾选与总数,搜索或替换后自动清空
- 术语与人名提取支持断点续跑:中断后接着未完成的进度继续,显示复用块数与本轮请求数,也可选择重新开始
- 术语提取与人名提取合并为「Agent 提取术语与人名」,一次提取两类候选;结果可先预览再加入草稿,只显示当前最多 20 条,只追加草稿里还没有的条目,保留原有词条与顺序,预览不自动保存,由你审核后显式保存
- 写入游戏脚本前先做重复条目预检:全量与增量应用共用同一套判断,只整理模板注入引起的重复,无法安全合并时标出文件与行号并停止写入
- 提取的阶段进度、候选预览与警告收进可展开小窗,开始后自动收起,矮窗口下仍能看到完整行与停止按钮
- 修复提取取消后仍显示进行中、某一块超时导致整轮卡住、字体一键替换校验或备份失败仍改写脚本
完整记录见 CHANGELOG.md
- 桌面版正式包的应用配置与壳日志默认位于
%APPDATA%\RenpyBox(旧版为%APPDATA%\RenpyBox-newUI,首次启动会自动迁移)。反馈问题请优先在「运行日志」中导出或打开对应文件。 - 翻译缓存位于当前输出目录下的
cache子目录(不是固定的应用output/cache)。暂停后可直接继续任务,或导出已完成部分。 - 若外部接口超时 / 限速,请在「基础设置」调整并发任务阈值与每分钟任务数量(RPM)等,而不是在「接口管理」里改。
- 欢迎通过 Issues/PR 反馈问题或贡献功能
- 反馈问题时请附上相关日志:用「运行日志」导出 / 打开
- QQ 群:821152470
- 部分代码与架构参考 AiNiee和 LinguaGacha
- 模块的设计理念来自于renpy-translator
- 本工具使用教程请看RenpyBox使用教程
- 本工具使用文档请看Renpy汉化教程




