BallonsTranslator 安装与使用教程:解压运行 launch_win.bat
BallonsTranslator 在 Windows 上最省事的装法:从 GitHub Releases 下载免配置压缩包,解压后运行 launch_win.bat。本文按 README 整理安装方式、首次一键翻译步骤和常见报错处理。
更新:2026-10-16
结论
Windows 用户最简单的装法:从 GitHub Releases 下载 Ballonstranslator_win_minium.zip,解压后双击 launch_win.bat。想让脚本自动配置环境,可以用 README 提供的 PowerShell 一键脚本。README 没写显存下限。下面的步骤全部来自 README,README 没写的细节本文不补充。
安装前了解
| 项目 | 信息 |
|---|---|
| 仓库 | dmMaze/BallonsTranslator(默认分支 dev) |
| 许可证 | GPL-3.0 |
| 最近 commit | 2026-10-04 |
| 硬件 | README 未给出显存下限;有 Nvidia 显卡或 Apple silicon 时默认启用 GPU 加速 |
| 系统 | 下面的方式都不支持 Windows 7。Windows 7 用户需自行安装 Python 3.8 运行源码 |
Windows 安装
方式 B:免配置压缩包
- 打开项目的 GitHub Releases 页面,下载
Ballonstranslator_win_minium.zip。 - 解压。
- 双击
launch_win.bat启动程序。
方式 A:PowerShell 一键配置
脚本会把 BallonsTranslator 装在你运行命令时所在的目录:
irm https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.ps1 | iex
在 cmd.exe 里也可以运行:
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.ps1 | iex"
运行任何联网脚本之前,建议先打开链接看一下脚本内容。
常见报错
遇到 msvcp140.dll、c10.dll 或 [WinError 1114] 相关报错,README 的处理办法是安装或更新 Microsoft Visual C++ Redistributable x64(Visual Studio 2015-2022 版)。
macOS / Linux
curl -fLO https://raw.githubusercontent.com/dmMaze/BallonsTranslator/dev/scripts/install.sh && chmod +x install.sh && ./install.sh
装完会自动启动。之后再启动用 cd BallonsTranslator && ./launch.sh。系统没有 curl 的话,可以用 wget -O 下载脚本。
首次一键翻译
README 建议在命令行终端里运行程序。步骤如下:
- 首次运行先设置源语言和目标语言。
- 打开一个放有图片的文件夹。
- 点击 Run,等待翻译完成。
嵌字的字号、颜色等格式默认由程序决定。想统一格式,可以在设置面板的嵌字菜单里改成全局设置。如果选了需要额外库的模块,程序会提示安装缺少的可选依赖,也可以在设置里打开自动安装。
GPU 与显存
- 有 Nvidia 显卡或 Apple silicon 时默认启用 GPU 加速。AMD 显卡可以按 README 里的 ZLUDA 方案配置,步骤较多,请直接看 README 原文。
- 在本地单卡上跑 Sakura-13B-Galgame 且显存不足时,可以在设置面板勾选
low vram mode(默认已开启)。 - README 没写显存下限,本文不给显卡建议。
数据来源与核验日期
核验日期:2026-10-16。站内详情页:/tools/ballonstranslator/。
合规提示
请仅用于自己拥有合法阅读权的作品。公开分享机翻结果时,如果没有经验译者完整翻译或校对过,README 要求在显眼位置注明是机翻。