屏译 v0.4.7 配置教程：从截屏授权到 OCR 与翻译排障

屏译（Screen Translator，overlay-translator）是无需 ROOT 的 Android 屏幕翻译工具。它的处理过程可以拆成截屏、OCR、翻译、渲染四步。配置时按这条顺序建立最小可用流程，排障时就能判断问题停在哪一段，避免一遇到没有译文就反复更换模型。

本文以官方 v0.4.7 的说明与配置为依据，目标是完成第一次翻译，再根据识别文本和显示结果调整。端侧模型、联网接口与系统权限的条件分别说明，不把它们合并成一组"必装依赖"。

当前发行仅有 arm64-v8a APK，最低 Android API 26，即 Android 8.0。32 位 ARM、x86 设备不支持。安装前先确认处理器架构；遇到安装失败，不应仅凭文件后缀是 APK 就排除设备条件。

端侧 LLM 与应用本身的最低系统要求不同。构建配置明确将该运行路径限制在 API 33 及以上，即 Android 13 及以上，同时还需满足设备内存等条件。Sakura、Hy-MT2 的模型约为 GB 级，低内存设备可能加载失败。

先准备所用语言的识别与翻译资源。PaddleOCR、日漫 OCR 以及离线翻译模型按需取得，不能把安装完成视为模型完成。应用代码采用 Apache-2.0；可选模型与外部服务仍有各自条款、费用和网络条件。

安装时按系统提示允许当前来源安装应用。初次引导中选定源语言、目标语言和显示方式，授予悬浮窗等必要权限，然后在主页截屏服务卡片启动服务，确认 MediaProjection 的系统授权。

回到一页静止文字，点击悬浮球，查看能否识别并显示结果。主页"当前状态"适合核对服务与权限。没有圆球，先查悬浮窗和后台限制；能点圆球却没有文字，再查选区、OCR 模型和识别语言。

Android 14 及以上启动截屏时可能出现系统授权提示，不应将正常提示归为软件故障。Shizuku 是可选截屏路径，需另行准备并授权；采用普通系统截屏路径时不用先配置它。音量双键触发与输入翻译涉及无障碍权限，也不必为基本点击翻译一开始就全部启用。

遇到受保护页面黑屏，核对是否为设置 FLAG_SECURE 的画面。项目不提供绕过。普通页面正常而某个页面黑屏，与所有页面都无法截屏，应作为不同问题处理。

OCR 阶段先产生可阅读的原文。ML Kit 适合其支持的中日韩英等文字；PaddleOCR 与日漫 OCR 提供不同识别路径，需要相应模型就绪。要识别日文时，PaddleOCR v6 tiny 不适用，v6 small 才包含日文支持，不能仅按体积小来选择。

在原文中检查漏字、错字与段落顺序。竖排漫画顺序错误，先核对方向识别和手动排列设置；周边 UI 干扰较大，缩小选区再看。默认速度优先可以保留，小字持续漏检时再切精度优先，比较实际识别文本，而不只比较等待时间。

翻译阶段选择本机 ML Kit、端侧 LLM 或联网服务。只有本机 OCR 加本机翻译，并提前准备好全部资源，才能在断网时完成文字翻译。连接局域网 Umi-OCR 则需要手机能访问对应电脑，这与全部在手机执行也有区别。

云端 OCR 会提交截图；本机 OCR 配云翻译则在设备识字后向翻译服务提交文字。需要控制数据去向时，分别检查这两个配置。ML Kit 的设备端输入处理，也不等于 SDK 永远不进行模型更新或不发送不含输入输出的运行统计。

已有兼容服务时，在翻译引擎中选择 OpenAI 兼容或 Anthropic 兼容方式，按服务提供的信息填写服务地址、API Key 和模型名。OpenAI 兼容地址通常有对应版本路径，应沿用服务要求，不要把文档示例当成自己账号的配置。

截图中的服务与模型名称只是配置示例。实际填写自己已开通的模型，然后点击"测试连接"。先确认接口可用再进入目标应用，能减少把账号、额度或地址问题误判成 OCR 故障的情况。费用与限流由服务商决定，客户端不会使这些条件消失。

若连接成功、原文也正确，但译文的上下文不合适，可再检查所用模式。快速模式、同屏与连续模式需要的上下文不同；连续模式会参考上一画面，也可能延续前一轮误译，不应仅因上下文更多就默认质量更高。

译文盖住按键，先切换到悬浮窗口，调整位置与大小后锁定。需要保留原文位置关系时，再选择紧贴原文。自动适配会处理颜色、字号和漫画气泡，失败时回退原矩形渲染，不把背景修复作为每次必定出现的结果。

划词默认是框选、精细调整、点击翻译，关闭精细调整才是松手直接执行。常规机器翻译多返回译文；完整词典解释依赖 LLM。这个区别有助于判断"为什么卡片没有词性例句"，它未必意味着功能出错。

默认点击译文条隐藏、长按选择复制，也能在设置中改为点击打开选择面板。处理竖排文字时，不能期待长按选择一小段朗读；可以用选择面板的扬声器读整段原文或译文。

一页内容稳定后保存预设，记录当前语言、识别、翻译与显示组合。缺模型的系统预设会明确提示，先准备完成再应用。更改关键项后，当前配置会回到未保存预设状态，需要重新保存，不能只看旧预设名称判断设置已经一致。

循环默认停稳触发，也有固定间隔和等待文字完整。相同画面会跳过重复处理，相似画面仍会核对文字变化；有动画的背景不等于文字持续更新。先在一段固定内容上选合适触发方式，再观察是否存在漏翻或过早翻译。

批量截图任务则从主页新建，选预设后台处理，在任务列表核对进度。配置迁移可用 .otsettings，但密钥、Token 与模型文件不在包内；另一台设备必须重新准备自己的凭据和模型，导入配置本身不足以验证运行环境恢复。

排障记录建议保留设备架构、Android 版本、所选 OCR、翻译方式，以及错误发生在截屏、原文、译文还是显示阶段。应用支持导出脱敏诊断报告；对已经定位的接口错误或模型缺失，先解决该环节，再恢复整条流程。官方使用边界以单机、视觉小说和漫画为主，不建议将截屏翻译用于反作弊网游。

项目参考：ciddwd/overlay-translator。界面图：ciddwd，Apache-2.0。

下载链接