RTranslator 离线翻译模型部署指南：1.2GB 模型不靠下载的落地方法
【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator
RTranslator 是本地运行的离线翻译应用，NLLB 与 Whisper 两套引擎共 10 个 onnx 模型全在设备侧执行。这篇指南只解决一件事：把这 10 个模型文件弄到手、放到正确目录，完成 RTranslator 离线翻译的模型部署。
先按你的条件选路径
下面三条路径都能独立完成模型文件获取与放置，选一条即可：
| 你的情况 | 走哪条路径 | 预计耗时 |
|---|---|---|
| 有电脑，设备无需 Root | A：通过 MTP 把 onnx 文件拷到 Android/data 指定目录 | 10 分钟 |
| 有电脑、已开启 USB 调试，习惯命令行 | B：用 adb push 模型文件批量落地 | 8 分钟 |
| 设备已 Root，想跳过应用内校验转移环节 | C：root 直写应用内部存储 | 8 分钟 |
设备侧部署：onnx 文件的获取与放置
路径 A：通过 MTP 手动拷贝到指定目录
在电脑上从官方发布页或可信的 RTranslator 模型下载镜像源拿到 2.0.0 模型压缩包（约 1.2GB），解压。
核对文件名，10 个缺一不可：
# 作用：确认解压结果是 10 个 onnx 文件 ls -lh *.onnx | wc -l手机开启 USB 调试和 MTP，用文件管理器进入
Android/data/nie.translator.rtranslator/files/。首次安装该目录可能不存在，先启动一次 RTranslator 再退出。把 10 个 .onnx 全部拷入，文件必须与
DOWNLOAD_NAMES清单完全同名。回看应用：它会逐个做完整性校验，通过的文件自动转入内部存储，损坏的直接删除并提示。
看到 10 个文件都出现在目标目录了吗？少一个就回第 4 步，应用只校验、不会替你补下缺漏。
路径 B：adb push 模型文件批量推送
电脑上确认设备在线：
adb devices列出你的设备序列号。在模型目录执行：
# 作用：一次性推送 10 个模型文件 adb push *.onnx /sdcard/Android/data/nie.translator.rtranslator/files/校验落盘数量：
adb shell ls /sdcard/Android/data/nie.translator.rtranslator/files/*.onnx | wc -l输出应为 10。若提示权限拒绝，说明该版本 Android 禁止 adb 直写 Android/data，回路径 A 用 MTP 拷贝。
路径 C：Root 设备直写内部存储
su提权后把文件直接写进应用内部目录，省掉外部目录校验与转移环节：
adb shell "su -c 'cp /sdcard/*.onnx /data/data/nie.translator.rtranslator/files/ && ls /data/data/nie.translator.rtranslator/files/'"写完后用ls输出确认 10 个文件齐全再启动应用。
部署流程
排障速查
| 现象 | 大概率原因 | 处理动作 |
|---|---|---|
| 看不到 nie.translator.rtranslator 目录 | 应用没运行过，目录尚未创建 | 先启动一次 RTranslator 再退出，重连电脑 |
| adb push 提示 Permission denied | 新版 Android 限制 adb 写 Android/data | 改用 MTP 拷贝，或走 Root 路径 |
| 应用提示模型文件校验失败 | 传输不完整或镜像源文件损坏 | 换源重下，用 md5sum 比对后再拷入 |
| 拷贝中途空间不足 | 1.2GB 模型加转移过程峰值接近 2.5GB | 预留 2GB 以上可用空间 |
| root 直写后启动闪退 | 文件 SELinux 上下文与属主不符 | 放弃直写，改路径 A 让应用自行转移 |
性能微调
低内存设备可在设置中关闭高质量语言支持，Whisper 的内存占用会从约 0.9GB 降到 0.5GB，语音识别质量有轻微下降。存储紧张时删掉电脑上的模型副本即可，设备侧最终只保留一份 1.2GB 的模型。
部署完成后，RTranslator 可完全离线运行，无需联网。打开应用选对话模式，连两台设备试一下实时翻译。
【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
