悬浮出境助手

悬浮出境助手是一个开源 Android 悬浮工具，面向中国用户出国使用。它保留原来的悬浮球交互逻辑：单击翻译当前屏幕，双击切换模式，长按打开菜单；本版本主要将语言方向和 GPT/API 提示词改为出境场景。

当前主线版本：Chinese Outbound v0.7.5

版本选择

本项目保留两个独立版本，方便不同用户下载：

版本	适合用户	主要方向	GitHub 标签/分支	APK 名称
English / Inbound China	外国用户在中国使用	中文页面 -> 英文说明/沟通	v0.6.5-english / english-v0.6.5	FloatingScreenTranslator-v0.6.5-english-debug.apk
Chinese Outbound	中国用户出国使用	海外 App 外语 -> 中文说明，沟通句按目标语言生成	v0.7.5-outbound-cn / main	FloatingScreenTranslator-ChineseOutbound-v0.7.5-debug.apk

如果你是中国用户出国旅行，请下载 ChineseOutbound APK。如果你是外国用户在中国使用，请下载带 english 标记的 APK。

功能

• 屏幕翻译：点击悬浮球截图 OCR，将海外 App 页面外语翻译成中文，并以不透明图片翻译层覆盖显示。
• 区域识别：双击进入区域识别，拖动/调整选框后点击 ✓，识别餐饮、景点、门票、酒店、交通或商品区域。
• 问一下：独立中文问答窗口，不默认绑定上一张图；追问商品结果时才使用该商品上下文。
• 目标语言：支持英语、法语、阿拉伯语、斯瓦希里语、葡萄牙语、印尼语、马来语、泰语、越南语、孟加拉语。
• 可复制沟通文本：中文解释给用户看，可复制内容按当前目标语言生成。
• 悬浮语言标签：悬浮球旁显示 EN/FR/AR/SW/PT/ID/MS/TH/VI/BN，点击可循环切换目标语言。

操作

默认是翻译模式。点击悬浮球翻译当前屏幕；翻译层显示时点击 返 返回原 App。

双击悬浮球进入区域识别模式，再双击进入问一下模式，再双击回到翻译模式。

长按悬浮球打开菜单，可执行：关闭菜单、关闭悬浮助手、翻译模式、区域识别、问一下、切换目标语言、识别此区域、显示识别结果、翻译结果面板、设置。

翻译方向

• 屏幕翻译：海外 App 外语内容 -> 中文。
• 商品/区域识别：中文解释 + 当前目标语言沟通句。
• 问一下：中国用户中文输入 -> 中文回答 + 当前目标语言沟通句。

隐私

• 不使用 root、hook、Xposed、Frida。
• 不自动点击、不下单、不付款、不发送消息。
• GPT/API 商品识别只在用户同意后上传选定区域图片和 OCR 摘要，不默认上传全屏。
• 独立问一下默认只发送用户问题和当前问答上下文。
• Google 翻译会发送待翻译 OCR 文本。
• API Key 当前测试版使用 Android SharedPreferences 保存，不属于生产级密钥存储。

构建

需要：

• JDK 17
• Android SDK 35
• Git LFS

git lfs install
.\gradlew.bat clean test assembleDebug

Debug APK 输出：

app/build/outputs/apk/debug/app-debug.apk

本次打包后的本地 APK：

FloatingScreenTranslator-ChineseOutbound-v0.7.5-debug.apk

限制

OCR、翻译、GPT/API 和本地规则都可能出错。价格、营业时间、退改政策、清真/过敏安全、护照核销和现场规则必须以商家、官方页面或现场工作人员确认为准。

离线内置模型仍是旧版中译英兜底模型；出境版外语转中文建议使用 Google 图片翻译或 GPT/API。

许可证

本项目使用 MIT License，见 LICENSE。