RTranslator 离线翻译部署教程手动放置模型文件10 分钟完成首次配置【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator第一次安装 RTranslator 却不能马上使用它在首次启动时要下载 1.2GB 的模型文件网络受限时进度条可能数小时不动。本教程用文件手动放置俗称 sideloading即直接把模型文件拷进应用目录的方式帮你绕开应用内下载完成 RTranslator 离线翻译模型的部署。这个项目解决什么问题RTranslator 是一款在 Android 手机上本地运行的开源实时翻译应用翻译使用 Meta 的 NLLB-Distilled-600M 模型语音识别使用 OpenAI 的 Whisper-Small-244M 模型两者都转成了 ONNX 格式一种通用的神经网络模型存储格式并量化后直接跑在手机里。连接另一部装有该应用的手机后双方可以像对方会说你的语言一样对话另外还有对讲机模式单机快速对话和纯文本翻译模式。音频不离开设备断网也能用隐私政策见 privacy/Privacy_Policy_en.md。动手前检查环境是否满足检查项要求说明Android 版本7.0 及以上应用 minSdkVersion 为 24内存RAM6GB 及以上低于此值有崩溃风险官方明确建议可用存储空间约 2GB应用会检查内部和外部存储都需有 1.25GB 模型 0.8GB 转移余量电脑 USB 数据线必须Android 限制应用访问自身的 Android/data 目录只能从电脑侧拷入应用版本2.0.3 及以上当前仓库版本为 2.1.2TTS 引擎可选推荐 Google TTS文字转语音把译文读出来依赖系统 TTS质量取决于它模型文件共 10 个.onnx文件来源是项目 2.0.0 版本的发布资产大小如下数值取自应用下载进度条所用的近似值仅用于核对完整性模型用途文件名大小约翻译 NLLBNLLB_cache_initializer.onnx24 MB翻译 NLLBNLLB_decoder.onnx171 MB翻译 NLLBNLLB_embed_and_lm_head.onnx500 MB翻译 NLLBNLLB_encoder.onnx254 MB语音识别 WhisperWhisper_cache_initializer.onnx14 MB语音识别 WhisperWhisper_cache_initializer_batch.onnx14 MB语音识别 WhisperWhisper_decoder.onnx173 MB语音识别 WhisperWhisper_detokenizer.onnx0.5 MB语音识别 WhisperWhisper_encoder.onnx88 MB语音识别 WhisperWhisper_initializer.onnx不足 0.1 MB合计约 1.2GB。NLLB 负责把文字翻译成目标语言Whisper 负责把语音转成文字两者缺一不可。手动放置模型的完整流程第 1 步安装应用。从项目发布页下载 2.0.3 及以上版本的 APK 并安装当前仓库版本为 2.1.2。 预期结果应用可以打开进入引导/下载界面。第 2 步在电脑上下载模型。到项目 2.0.0 版本的发布资产页把上表 10 个.onnx文件全部下载到电脑的一个文件夹中。 预期结果文件夹内正好 10 个文件总大小约 1.2GB。少一个文件后面校验都会失败。第 3 步启动应用一次并关闭。打开 RTranslator接受通知权限申请通知只用于在会话或对讲机模式下后台运行时提示状态然后直接关闭应用不要继续后续配置。 预期结果应用创建好存放模型的目录。这一步不能省目录不存在就无从拷入。第 4 步把文件拷入手机。用 USB 线连接电脑如果手机此前已连接过电脑先拔下再重新插上否则刷新也看不到刚创建的目录。在文件管理器中找到Android/data/nie.translator.rtranslator/files把 10 个.onnx文件全部复制进去。 预期结果该目录中出现 10 个模型文件。若手机装有 SD 卡且不确定该放内部存储还是 SD 卡看哪个存储下的files目录里带有一个 readme 文件就放哪里官方安装指南见 Sideloading.md。第 5 步重新打开应用继续。再次启动 RTranslator 走到模型下载界面应用会直接从这个目录提取文件并逐一校验完整性只有校验不通过的文件才会重新走下载。 预期结果屏幕显示提取与校验进度而不是下载进度全部完成后你放进files目录的那 10 个文件会消失——它们已被转入应用私有内部存储属正常现象。部署成功的验证标准场景正常表现异常表现下载界面显示提取/校验进度无网络下载量出现真实下载进度说明有文件缺失或损坏应用只补下损坏的部分files目录10 个文件消失已转入私有存储文件仍在说明应用没有成功读取检查是否放错存储应用主体进入加载界面后到达主界面可选择语言开始翻译提示模型加载错误提示文字为“某些文件可能损坏按修复按钮只会重新下载损坏文件”翻译功能文本模式下输入一句话数秒内出译文卡死或闪退通常与内存不足有关见下一节部署过程中的常见报错处理现象电脑里找不到Android/data/nie.translator.rtranslator/files目录。原因目录是应用首次启动才创建的且手机已连接过电脑时新目录不会自动刷新。解决先完成第 3 步启动并接受权限后关闭再拔插一次 USB 重新连接。现象应用内下载界面提示error_download下载出错。原因手机网络不稳定或源站访问慢。解决不要反复点重试直接改用本文的手动放置方式网络问题由电脑承担。现象提示error_transfer外部存储到内部存储转移失败。原因转移过程中 SD 卡等外部存储被弹出。解决重新插好存储设备保持应用前台打开按重试按钮继续。现象提示error_storage存储空间不足。原因应用要求内部、外部存储各自有约 2GB 可用空间1.25GB 模型 0.8GB 转移余量缺一个都会触发。解决清理空间后重试。现象部署完成但应用闪退或翻译明显卡顿。原因RAM 低于 6GB 或 CPU 性能不足。解决内存偏小的设备可在设置中开启“支持低质量语言”选项Whisper 模型会切换到 0.5GB 内存的轻量模式11 秒音频的识别耗时约 2.1 秒比 0.9GB 模式的 1.6 秒略慢详见 README.md 的性能说明。进阶选项可选可选扩大支持语言范围。默认支持 31 种语言含中、英、日、韩、法、德、西、俄等在设置中开启“支持低质量语言”后可再加 40 种语言其中一部分仅限文本翻译语音识别和翻译质量会下降。可选更换 TTS 引擎。应用设置“输出”区域点击“文字转语音”会跳转到系统设置在其中选择默认 TTS 引擎推荐 Google TTS改完后重启 RTranslator 生效。写在最后模型文件放对位置、校验通过RTranslator 就能在完全离线的状态下完成语音与文本翻译后续重装之外的日常使用不再依赖这次下载。下一步建议部署完成后先在文本翻译模式输入一句目标语言短句试译确认无误再连接第二台手机练习会话模式。【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
