欢迎使用开源免费的 RenpyLens！本软件专为 Ren'Py 引擎开发的游戏（大多为视觉小说 / Visual Novels）打造，能够实时无损抓取游戏文本，并通过 AI 大语言模型 进行高质量实时翻译。 不需要复杂的代码知识，只需简单几步即可让游戏角色顺利“说人话”！
🎮 软件开源
🌍 已在 GitHub 完全开源：https://github.com/liuyuan-wen/RenpyLens
👉 也可以直接【私信】滴滴我即可，看到就回。
🆕 版本更新 (v1.1.0)
-
翻译准度和遵循指令升级: 大幅增强内置通道模型翻译速度和精准度，更好地遵循指令（如：不翻译人名）。
-
重构 Hook 逻辑: 全面升级了注入 Hook 脚本，修复了之前部分基础版游戏引擎可能无法触发、显示弹窗的问题，兼容性更广。
-
浮窗视觉表现强化:
-
支持显示原文角色名的控制。
-
支持斜体排版渲染，让含心理活动的文字更直观。
-
支持强力置顶功能，解决部分全屏游戏遮挡翻译界面的痛点。
-
🚀 第一步：准备与启动软件
- 准备一台Windows电脑（最好是Win11）+ RenpyLens软件 + 生肉 Ren'Py 游戏
- 双击运行软件 RenpyLens.exe。
🎛️ 主界面四大核心模块一览
- 核心拖拽区 (中央虚线框)
- 作用：游戏导入入口。在这里，你可以直接将想玩的游戏本体（.exe 文件）拖拽进来，或点击虚线框手动选择游戏文件。只有在这里选中了游戏，才能进行后续的启动和翻译！
2. 状态与启动控制区 (中间三个大按钮)
-
装载 Hook 并开始游戏：一旦拖入游戏并配好翻译引擎，点击它！软件会自动帮你打开游戏并开始注入翻译。
-
卸载 Hook：游戏通关后，点击这里就可以彻底清理掉我们偷偷塞进游戏目录里的翻译脚本。
-
清除缓存：如果觉得刚才的机翻效果不好，点击它，可以让下次弹出的翻译重新生成。
3. 引擎配置区 (下半部分)
-
翻译引擎 / 模型：用来切换为你提供翻译的 AI 提供商。如果你是小白，直接选【内置通道】即可；老手也可以在这里或设置中配置各类大厂模型。
-
获取试用API / 状态：在这里点击一下，就能免费领到专属的白嫖翻译 Key，看到绿色的“✅ API已就绪”就可以畅玩啦！
4. 系统功能区 (顶部与底部)
-
⚙️ 设置：点击这里可以进入高级面板，配置你自己的其他大厂 API 密钥（如 DeepSeek、Claude 等），以及调整软件各类功能。
-
📌 置顶：开启后，翻译器的主界面会永远显示在其他窗口最上方。
-
📋 日志：如果游戏在运行中遇到什么奇怪的问题翻译不出来，点击底部展开日志，可以把最近的内容复制下来发给我诊断。
🔑 第二步：配置翻译引擎（二选一）
软件提供了内置的翻译通道，也支持你填入自己的 API（如果你知道怎么弄的话）。
选项 A：我是小白，我想直接用内置试用通道（推荐）
- 在界面的【翻译引擎】下拉框中，选择 “内置通道”。
- 点击右侧的 “🔑 获取试用 API” 按钮。
- 等待几秒钟，如果出现绿色的提示“✅ 试用 Key 已获取并填入”，说明配置成功！可以直接跳到第三步。
选项 B：我有自己的大厂 API 密钥 / 自己部署的模型
如果你有 Claude、DeepSeek、ChatGPT 或者通义千问等 API 密钥，翻译效果可能会更好：
- 将【翻译引擎】切换为你对应的模型厂商（例如 DeepSeek），如果是自己部署的模型，则选择“Ollama”或者“自定义”。
- 点击左上角的 “⚙️ 设置” 按钮，在弹出的窗口中，填入你自带的【API 地址】和【API 密钥】。
- 点击右下角的 “保存”。
🎯 第三步：导入游戏并开始翻译
- 拖入游戏 找到你要游玩的 Ren'Py 游戏主程序，直接拖拽到软件中间的虚线框。 或者也可以直接点击虚线框，手动在弹出的窗口里选中游戏的 .exe 文件。
- 一键启动 当软件界面提示“已选择”后，点击下方的：“▶ 装载 Hook 并开始游戏”。 此时软件会自动将翻译脚本注入游戏，并帮你把游戏启动起来，你不需要自己去双击游戏本体了。
💬 第四步：调整浮窗
游戏启动后，一旦画面中出现对话文本，RenpyLens 就会随之在屏幕上弹出一个半透明的黑色悬浮窗，那就是翻译结果啦！
- 移动浮窗 只需 鼠标左键按住浮窗上的文字，即可在整个屏幕范围内随意拖动它的位置。
- 更多设置（右键菜单） 当你的鼠标在浮窗的翻译文字上单击右键时，会弹出一个功能菜单，你可以对浮窗进行更多调整。
🧹 常见问题与清理
1. 游戏玩完了，如何移除翻译器？
关闭游戏后，回到 RenpyLens 的软件界面，点击 “📤 卸载 Hook” 即可。这会将所有注入游戏的脚本彻底删除，恢复游戏原汁原味的状态。
2. 翻译卡住了，或者前面的翻译出错/太烂，我想让它重新翻？
由于软件自带记忆缓存（翻译过的句子下次秒出，不再耗费 AI 重新翻译），如果遇到了错误的翻译卡住了，你可以点击主界面的 “🗑️ 清除缓存” 按钮，或者在游戏重启前进行此操作，然后让 AI 重新为你翻译一遍这段剧情即可。
如果您在使用过程中遇到任何其它无法解决报错弹出，请带上软件界面底部（如果点击“📋 日志”展开的话）的报错文字联系我！联系方式在 “设置” -> “关于“。