GalTransl-for-ASMR:ASMR专用语音翻译工具完全指南
【免费下载链接】GalTransl-for-ASMRAutomated translation solution for visual novels supporting GPT-3.5/GPT-4/Newbing/Sakura. 支持GPT-3.5/GPT-4/Newbing/Sakura等大语言模型的Galgame自动化翻译解决方案项目地址: https://gitcode.com/gh_mirrors/ga/GalTransl-for-ASMR
一、核心功能解析
1.1 多模态翻译引擎架构
GalTransl-for-ASMR(ASMR专用语音翻译工具)采用模块化设计,核心功能由三大引擎构成:
- 语音识别引擎:基于whisper/目录下的Whisper.dll实现音频转文字,支持100+语言实时听写
- 大模型翻译引擎:整合GalTransl/Backend/中的GPT3Translate.py、GPT4Translate.py等模块,支持GPT-3.5/4、Newbing等多模型切换
- 字幕处理引擎:通过prompt2srt.py和srt2prompt.py实现字幕格式双向转换,支持时间轴自动对齐
💡实用贴士:引擎配置文件位于project/config.yaml,可通过修改model_selection参数切换翻译模型
1.2 核心组件地图
功能模块 | 关键文件路径 | 主要作用 -----------------|-------------------------------------|-------------------------- 用户交互层 | app.py | 图形界面与核心控制逻辑 翻译服务层 | GalTransl/Backend/ | 大模型API封装与调用 语音处理层 | whisper/、whisper-faster/ | 语音识别与音频处理 插件系统 | plugins/text_common_normalfix/ | 文本规范化与预处理 配置中心 | project/config.yaml | 全局参数与路径配置二、零基础环境准备
2.1 5分钟快速部署
# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ga/GalTransl-for-ASMR cd GalTransl-for-ASMR # 安装依赖 pip install -r requirements.txt2.2 跨平台兼容性配置
- Windows系统:直接运行ffmpeg.exe进行音视频处理,无需额外配置
- Linux系统:需通过系统包管理器安装ffmpeg依赖:
sudo apt install ffmpeg - macOS系统:使用Homebrew安装必要组件:
brew install ffmpeg
💡实用贴士:首次运行前需检查llama/目录下是否存在模型文件,缺失会导致本地翻译功能不可用
三、核心操作指南
3.1 核心入口解析
主程序入口app.py支持多种启动参数:
# 基础启动 python app.py # 指定模型路径 python app.py --model-path ./llama # 启用调试模式 python app.py --debug True常见启动问题及解决方案:
- 模块缺失错误:执行
pip install -r requirements.txt补全依赖 - 模型加载失败:检查llama/param.txt中的模型路径配置
3.2 完整工作流程
- 文件导入:通过界面拖拽或输入视频链接(支持B站BV号/YouTube URL)
- 语音处理:系统自动调用whisper/whisper-cli.exe生成原始字幕
- 翻译配置:在设置面板选择翻译模型(GPT-3.5/4/Sakura)
- 执行翻译:点击"运行"按钮,处理进度实时显示在输出区域
- 结果导出:通过"打开下载文件夹"获取生成的SRT字幕文件
图1:GalTransl-for-ASMR主操作界面,展示文件拖放区域与核心功能按钮
💡实用贴士:对于长视频建议先使用summarize.py生成内容摘要,提高翻译效率
四、定制化配置指南
4.1 高级参数调优
在project/config.yaml中可配置:
# 翻译参数 translation: temperature: 0.7 # 控制译文随机性(0-1.0) max_tokens: 1000 # 单次翻译最大字符数 batch_size: 5 # 批量处理句子数量 # 语音识别参数 speech_recognition: language: "ja" # 源语言代码 model_size: "medium" # 模型规模(tiny/base/small/medium/large)4.2 环境变量设置
通过环境变量覆盖配置文件参数:
# Linux/macOS export GALTRANS_MODEL=gpt-4 export GALTRANS_PROXY=http://127.0.0.1:7890 # Windows(命令提示符) set GALTRANS_MODEL=gpt-3.5-turbo set GALTRANS_PROXY=http://127.0.0.1:7890💡实用贴士:敏感信息(如API密钥)建议通过环境变量设置,避免直接写入配置文件
五、性能优化策略
5.1 本地模型加速
对于llama/目录下的本地模型:
- 选择对应CPU架构的动态链接库(如Intel CPU使用ggml-cpu-skylakex.dll)
- 修改llama/param.txt中的
n_threads参数为CPU核心数的1.5倍
5.2 缓存机制配置
通过GalTransl/Cache.py控制缓存行为:
- 启用句子级缓存:
cache_enabled: true - 设置缓存有效期:
cache_ttl: 86400(单位:秒)
💡实用贴士:定期执行"清空缓存"功能可解决翻译结果异常问题,缓存文件位于程序运行目录的.cache文件夹
【免费下载链接】GalTransl-for-ASMRAutomated translation solution for visual novels supporting GPT-3.5/GPT-4/Newbing/Sakura. 支持GPT-3.5/GPT-4/Newbing/Sakura等大语言模型的Galgame自动化翻译解决方案项目地址: https://gitcode.com/gh_mirrors/ga/GalTransl-for-ASMR
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考