能力标签

🤖 Agent 👁 OCR 🌐 翻译 🔗 REST API 🖼 视觉 🔊 TTS ✨ GPT 🖥 本地 LLM

🛠

AI工具

安卓屏幕翻译

基于 Kotlin · 开源免费，本地部署，数据完全自主可控

英文名：overlay-translator

⭐ 27 Stars 🍴 3 Forks 💻 Kotlin 📄 Apache-2.0 🏷 AI 8.0分

8.0AI 综合评分

AndroidOCRLLMDeepL

📺 TG 频道

✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：安卓屏幕翻译是一款优质的AI工具。AI 综合评分 8.0 分，在同类工具中表现稳健。如果你正在寻找可靠的AI工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

安卓屏幕翻译是一款基于 Kotlin 的开源工具，在 GitHub 上收获 0k+ Star，是Android、OCR、LLM、DeepL领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
安卓屏幕翻译依赖 Kotlin 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Kotlin 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪安卓屏幕翻译的版本更新，及时通知重要功能变化。

📋 工具概览

安卓屏幕翻译是一款基于 Kotlin 开发的开源工具，专注于 Android、OCR、LLM 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars

⭐ 27

开发语言

Kotlin

支持平台

Windows / macOS / Linux / Android

维护状态

轻量级项目，按需更新

开源协议

Apache-2.0

AI 综合评分

8.0 分

工具类型

AI工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

开源免费，支持本地部署，数据完全自主可控
活跃的 GitHub 开源社区，持续迭代更新
提供详细文档和使用示例，新手友好
支持自定义配置，灵活适配不同使用环境
可作为基础组件集成进现有技术栈或进行二次开发

🎯 主要使用场景

本地部署运行，保护数据隐私，满足合规要求
自定义集成到现有系统，扩展技术栈能力
作为开源基础组件进行商业化二次开发

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 克隆仓库
git clone https://github.com/ciddwd/overlay-translator
cd overlay-translator

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用

📋 安装步骤说明

访问 GitHub 仓库页面
按照 README 文档完成依赖安装
根据系统环境完成初始化配置
参考官方示例或文档开始使用
遇到问题可在 GitHub Issues 中查找解答

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 查看帮助
overlay-translator --help

# 基本运行
overlay-translator [options] <input>

# 详细使用说明请查阅文档
# https://github.com/ciddwd/overlay-translator

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# overlay-translator 配置说明
# 查看配置选项
overlay-translator --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export OVERLAY_TRANSLATOR_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 78/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

简体中文 · English

✨ 功能

📦 安装

到本仓库的 Releases 页下载最新 ScreenTranslator-x.y.z.apk
在 Android 设备上点击安装（首次需在系统设置允许"安装未知来源应用"）
启动后依次授予 悬浮窗、通知权限

只发布 arm64-v8a（64 位 ARM） 架构。armeabi-v7a / x86 暂不支持——端侧 OCR（PaddleOCR / ML Kit）的 native lib 体积大；且 32 位 ARM 缺 64 位 NEON 优化、可用寄存器少，推理慢一档，OCR 等待时间会明显拉长。如有 32 位设备需求请在 Issue 反馈。

每个 APK 同时附带 .sha256 校验文件，可对照本地 Get-FileHash / sha256sum 输出确认下载完整性。

🚀 使用

启动 App，点 启动截屏服务，确认系统弹出的"开始截屏？"对话框
切到任意游戏 / 视觉小说 / 漫画 App
点屏幕上的圆形悬浮按钮 → 2~3 秒内底部出现译文
长按悬浮按钮 → 打开弧形菜单，可切换循环模式、重选截图区域、切源语言/目标语言、切翻译预设，或在整屏翻译与划词翻译之间切换（默认循环 2 秒一次，dHash 跳过静止画面）
单击译文条 → 隐藏

可选： - 在系统"无障碍"里启用本应用，同时按下音量加 / 音量减并按住 300ms 作为全局触发，免去手指点屏（不读屏 / 不解析 View 树） - 安装 Shizuku 并授权后，在设置切换到 Shizuku 截屏路径，免去每次的系统授权弹窗 - 在设置顶部选择系统预设方案，例如「离线日语漫画 OCR → 简中」。预设需要的模型未就绪时，会显示缺失项并提供下载入口 - 若只想查一个词，先在弧形菜单把主球操作切到「划词翻译」，再框选屏幕上的单词 / 短语；也可以在其它 App 中选中文本后从系统菜单调用屏译

📸 截图

实际译文叠加 —— Discord 沟通规则页，OCR 紧贴原文渲染：

经典深色主题	浅色纸张主题
<img src="docs/screenshots/overlay-discord-dark.png" width="320" alt="经典深色译文叠加" />	<img src="docs/screenshots/overlay-discord-light.png" width="320" alt="浅色纸张译文叠加" />

游戏场景 —— Sandship UI 的中文识别与覆盖：

漫画 / 字幕场景 —— 漫画气泡按列识别后译文紧贴覆盖：

韩文漫画	日文竖排漫画
<img src="docs/screenshots/overlay-manga.png" width="320" alt="韩文漫画译文叠加" />	<img src="docs/screenshots/overlay-manga-jp.png" width="320" alt="日文竖排漫画译文叠加" />

设置页：

语言 / 主题 / 系统预设	翻译后端
<img src="docs/screenshots/settings-top.png" width="280" alt="设置顶部与系统预设" />	<img src="docs/screenshots/settings-translator.png" width="280" alt="翻译后端设置" />
OCR 引擎 / 自动方向判别	译文样式与字体
<img src="docs/screenshots/settings-ocr.png" width="280" alt="OCR 引擎与方向模型设置" />	<img src="docs/screenshots/settings-display.png" width="280" alt="译文显示与字体设置" />
弧形菜单按钮	悬浮窗口模式选项
<img src="docs/screenshots/settings-arc-menu.png" width="280" alt="弧形菜单按钮设置" />	<img src="docs/screenshots/settings-display-floating.png" width="280" alt="悬浮窗口模式设置" />
段落合并 / 悬浮球
<img src="docs/screenshots/settings-floating.png" width="280" alt="段落合并与悬浮球设置" />

悬浮窗口模式 —— 把所有原文 / 译文集中到一个可拖拽缩放的浮窗里，避免「贴原文」模式下译文挡住游戏操控（虚拟摇杆 / 按键 / 对话推进键）。窗口支持锁定：解锁时可拖动、可缩放、带 X 关闭按钮和底部缩放手柄；锁定后只剩文字内容，不响应任何手势，彻底防误触。

解锁（可拖拽 / 缩放 / 关闭）	锁定（防误触，只剩内容）
<img src="docs/screenshots/floating-window-unlocked.jpg" width="420" alt="悬浮窗口解锁状态" />	<img src="docs/screenshots/floating-window-locked.jpg" width="420" alt="悬浮窗口锁定状态" />

长按悬浮球的弧形子菜单 & 划词翻译卡片 —— 左：长按弹出菜单，循环 / 选区 / 在「全屏翻译」和「划词翻译」之间切换 / 回主页（按钮顺序可在设置里拖动重排）；右：圈出屏上一个词后弹出的卡片，连读音、词性、多条释义、例句一起呈现（使用大语言模型时才能拿到这套完整字典）。

长按弹出的弧形菜单	划词翻译卡片（带字典）
<img src="docs/screenshots/arc-menu.png" width="320" alt="长按悬浮球弹出弧形菜单" />	<img src="docs/screenshots/word-select.png" width="320" alt="划词翻译字典卡片" />

⚙️ 配置

启动 App 后进入"设置"。设置页顶部可切换 应用语言 与 主题模式；任意 section 都可用搜索图标按关键字（中英文都行）快速跳转。

编辑 local.properties，把 sdk.dir 改成本机 Android SDK 路径

./gradlew installDebug # 装到已连接设备 ```

需 JDK 17 + Android SDK 35。Android Studio 打开会自动同步并补 Gradle wrapper jar；命令行环境需先 gradle wrapper --gradle-version 8.10.2。

📊 对比同类应用

仅作粗略参考，按 2026 年公开信息整理，可能与对方最新版本有差异。欢迎 PR 指正。

维度	屏译 (本)	Gaminik / 爱译客（闭源同源）	Google 翻译	沉浸式翻译
完全免费 / 无广告	✅	订阅或内购	✅	✅
开源	✅ Apache 2.0	❌	❌	部分
屏幕悬浮球叠加翻译	✅	✅	❌	❌（移动端弱）
端侧 OCR（图片不上传）	✅ ML Kit + PaddleOCR	❌（云端为主）	✅	❌
多 OCR 引擎自选	✅ 端侧 / 本地 HTTP / 云端多路径	有限	❌	❌
多翻译引擎自选	✅ 云端 LLM / 端侧 LLM / DeepL / DeepLX / 有道 / Google / 火山 / 百度 / 腾讯	1–2 家固定	❌	翻译侧多
自架翻译后端（deeplx / 端侧 GGUF / 自定义 Bearer）	✅	❌	❌	❌
悬浮窗口模式（可锁定防误触）	✅	❌	❌	❌
漫画竖排 / 方向判别 / 振假名 / 字幕段落合并	✅	❌	❌	❌
划词翻译卡片（音标 / 词性 / 释义 / 例句）	✅ 使用大语言模型时完整	❓	⚠️ 仅 Google 翻译 App 内	⚠️ 移动端弱
在任意 App 长按选词直接翻译	✅ 系统选中文本菜单入口	❓	✅「点按翻译」	❌
悬浮球菜单按钮可自定义顺序与分页	✅	❌	❌	❌