Andee lives on your phone or Mac and uses any app like you do—no integrations, no root, any model; memory and passwords never leave your device | Andee 住进你的手机或 Mac,像你一样操作任何 App——无需集成、无需 Root、支持任意模型,记忆和密码绝不离开设备。
权限说明
这一页解释 Andee 为什么要那些权限、每个权限对应你能得到的什么功能、以及你拒绝之后会发生什么。
写这么细的原因很直接:Andee 申请的权限组合,和安卓银行木马的检测特征高度重合 —— 无障碍 + 悬浮窗 + 通知监听 + 短信 + 通话记录 + 通讯录 + 应用列表,任何一个安全研究者扫一眼 Manifest 都会把它标红。这是合理的警觉,不是误判。
所以这一页要做的事只有一件:把"看起来一样"和"实际不一样"分别讲清楚,并且每一条都能在代码里核对。
先看区别在哪
| 典型国产 App / 恶意软件 | Andee | |
|---|---|---|
| 要权限的时机 | 启动时一次性全要 | 按次申请:用到哪个功能才要哪个 |
| 你拒绝之后 | 不让用 / 反复弹窗 | 功能降级,其余照常用,并且告诉你为什么没做成 |
| 权限和功能的对应 | 不解释 | 见下表,每项都能对应到一个具体工具 |
| 敏感数据去了哪 | 不说明 | 凭据加密存在本机(config/Vault.kt),模型读不到;5 个私人笔记工具根本不外发(ToolSchemas.forHub() 过滤) |
| 凭据怎么用 | — | 模型只能让设备"去填",它自己永远拿不到密码原文(fill_secret) |
代码里能核对这件事的两处:
device/PermissionsController.kt—— 权限清单 + 每项的人话说明 + 引导跳转device/DeviceCommsController.kt—— 每个工具在动手之前先ensurePermission(),没授权就直接返回denied("sms")这样的结果,不会崩、也不会偷偷换个方式做
权限总表
「用户得到什么」一列是应用里实际显示的原文(res/values/strings.xml 的 dev_perm_feature_*)。
| 权限 | 用户得到什么 | 对应工具 | 你拒绝了会怎样 |
|---|---|---|---|
悬浮窗SYSTEM_ALERT_WINDOW |
悬浮窗(我的脸) | 球、字幕、设置面板本身 | 应用起来什么都看不到。 这是唯一一个"不开就完全不能用"的 |
无障碍服务BIND_ACCESSIBILITY_SERVICE |
看屏幕、点界面、打字 | get_screen_element / tap_screen_element / swipe_by_coordinates / type_text / submit_input / take_screenshot 等全部 screen.* |
除 screen.screenshot 外,所有 screen.* 都报错 —— 截屏有 MediaProjection 兜底:只能读,没有瞄准网格、没有元素列表、不能点。这条权限买的是「能操作屏幕」 |
麦克风RECORD_AUDIO |
语音说话、用户自己录的唤醒词 | 流式 ASR + 本机唤醒词匹配 | 点球没反应;唤醒词监听不启动(顺带:Android 12+ 的绿点也不会出现) |
通知监听BIND_NOTIFICATION_LISTENER_SERVICE |
通知感知(微信来消息我知道) | get_notifications |
来消息不会主动知道;其余功能不受影响 |
位置ACCESS_FINE_LOCATION |
位置(在哪/导航) | get_location |
问"我在哪"答不出来 |
运动步数ACTIVITY_RECOGNITION |
运动步数 | get_step_count |
问步数答不出来 |
通讯录READ_CONTACTS |
通讯录(打电话找人) | search_contacts |
说"打电话给老王"找不到人 |
拨号CALL_PHONE |
直接拨号 | dial |
能找到人但拨不出去 |
通话记录READ_CALL_LOG |
通话记录 | get_call_log |
查不了最近谁打的电话 |
读短信READ_SMS |
读短信(验证码) | read_sms |
读不了验证码 |
发短信SEND_SMS |
发短信 | send_sms |
发不了 |
读日历READ_CALENDAR |
日历(日程提醒) | get_calendar |
看不了今天的日程 |
写日历WRITE_CALENDAR |
写日历(记日程) | add_calendar_event |
记不了日程 |
摄像头CAMERA |
看(拍照识物 / 扫码) | camera_turn / scan_code |
这两条用不了 |
应用列表QUERY_ALL_PACKAGES |
知道装了哪些应用 | list_installed_apps / launch_app |
打不开指定应用 |
通知栏POST_NOTIFICATIONS |
到点提醒你,以及那条常驻通知 | 待办到期的提醒,以及无障碍被撤销后回来的路 | 应用发出的通知一条都不会出现 —— 到点不提醒,也没有那条常驻通知,而它同时是接回屏幕操作的入口。待办不会丢 |
开机自启RECEIVE_BOOT_COMPLETED |
重启后待办还在 | 重建 AlarmManager 闹钟 |
重启后待办不再提醒 |
电池优化豁免REQUEST_IGNORE_BATTERY_OPTIMIZATIONS |
到点提醒准时 | 待办定时 | 息屏状态下提醒会迟到 |
改系统设置WRITE_SECURE_SETTINGS |
换输入法(备用打字通道用) | ADBKeyboard 兜底通道的前置步骤 | Android 13 及以上没影响 —— 打字走的是无障碍输入法。Android 12 及以下则 type_text 直接失败,并明确告诉你失败原因,不会假装成功 |
Wi-Fi 状态、组播ACCESS_WIFI_STATECHANGE_WIFI_MULTICAST_STATE |
在同一个 Wi-Fi 里找到朋友的 Andee(mDNS) | list_friends / ask_friend |
普通权限,安装即授予。加朋友或打开「允许其它设备找到我」之前,什么都不监听、不广播 |
Android 13 及以上不需要这条。 应用用自己无障碍服务的输入连接打字:不用装键盘、不用切默认输入法,你自己的键盘全程照用。
WRITE_SECURE_SETTINGS是特殊的一个:它装完不生效,必须用 adb 手动授予:adb shell pm grant net.kuafuai.andee android.permission.WRITE_SECURE_SETTINGS这是系统限制,不是应用的选择。Android 12 及以下打字靠它;以上版本它只给兜底通道用 —— 碰上正常通道进不去的输入框才会走到。
装机必须手动开的三个开关
这三个不在应用内,Android 不允许应用自己翻。少一个就有对应功能不能用:
- 悬浮窗 —— 设置 → 应用 → Andee → 权限 → 显示在其他应用上层
- 无障碍服务 —— 设置 → 无障碍 → 已安装的服务 → Andee(会弹一个大红框警告,这是系统标准流程)
- 麦克风 —— 首次点球时系统会自己弹
部分厂商 ROM(小米 / 华为 / 荣耀)每次系统更新或强制停止应用后会自动关掉无障碍,需要重开。这是 ROM 行为。
凭据是怎么保管的(这是最该被问的一条)
Andee 有一个保险箱(config/Vault.kt),用来存你自己填进去的账号密码。设计上有三条硬规则:
- 加密落盘。 AES/GCM,密钥由 Android KeyStore 生成并保管,不出设备。换台机器即使拿到密文也解不开(代码里有对应的兜底:"vault: decrypt failed — entries are unreadable on this install")。
- 模型永远拿不到密码原文。
get_vault返回的条目里,标记为 secret 的字段不下发;模型只能用fill_secret,由设备自己把密码打进输入框。也就是说密码不经过模型、不进模型的上下文。 - 界面上打码。 保险箱页面显示的是
Vault.mask()之后的结果。
它不防什么(要说清楚): 密钥没有绑定设备解锁(没用 setUserAuthenticationRequired)。所以能解锁你手机的人,就能通过界面看到保险箱内容。它防的是"数据被提取走"和"密码被模型读到",不防"捡到你手机的人"。
数据会去哪("你们会不会收集我的数据")
结论:没有统计 SDK、没有崩溃上报、没有埋点、没有广告 ID;但"本项目收不到你的任何数据"也不对 —— 有且只有一处例外,就是下面表里最后那一行「版本自检」。 这几句都要说清楚,只讲一半等于误导。
先说不含的那部分(可以自己 grep 验证): 没有统计 SDK、没有崩溃上报、没有埋点、没有广告 ID —— app/build.gradle 与 app/src/main/ 里 firebase / analytics / sentry / crashlytics 全部为零。你不动自检页上的「重新检查」,App 平时也不会往外发任何东西。
但数据按设计会离开设备:
| 什么数据 | 去哪 | 默认值 |
|---|---|---|
| 语音识别(你说的话)、语音合成(他说的) | 你选的那家语音服务商 —— 默认是火山引擎(字节跳动),也可以选 Google | 看 ⚙ → 后端 → 语音服务商 选了谁:火山 → openspeech.bytedance.com;Google → aiplatform.googleapis.com。打包时内置了 Google 密钥的构建默认走 Google;源码检出默认走火山 |
| 对话内容,以及全部工具返回结果 | 你配置的"大脑" | 全新安装默认走 CodeFlying → 就是这台包构建时配的那台服务器(如果有的话)。没配服务器的包(比如本仓库 Release 挂的那几个)无处可发,它会明说,直到你填一个 CodeFlying key 或改选别的后端。改选本机后:中文界面走 api.deepseek.com、英文界面走 api.openai.com;hub 模式下走你自己的 hub_url |
私人笔记本(config/Notebook.kt:记住的你、答应过的事) |
只在本机 | 是 localOnly,不进 hub 载荷 |
| 版本自检:当前版本号、手机型号 / 品牌 / 系统版本、界面语言、一个随机安装 ID | 维护者自己的一台服务器(不是第三方) | 首次启动一次,以及在自检页点「重新检查」时一次;同一 IP 每天最多 10 次 |
| 你发给朋友的请求,以及对方的回报 | 直接到那台设备,走你 Wi-Fi 里的端到端加密连接,中间没有服务器 | 只有模型写进请求里的内容。它被要求不传你的记忆、账号、通讯录,除非你让它传;朋友发到你设备上的请求,在看不到这些的地方运行 |
第二行要说透:工具返回结果就是对话的一部分。 他读到的短信正文、通讯录、通话记录、通知内容、定位,以及他对屏幕的"理解",都会随对话发到你配的那个端点。
最后那一行也要说透,因为它和前两行性质不同: 前两行发给你自己配的端点,这一行是我们自己收。它带的是版本号、机型、品牌、系统版本、界面语言,以及这个安装自己生成的随机 ID(body-xxxxxxxx,重装即换,不是 ANDROID_ID);服务器还必然看得到你的 IP,并由它解析出国家 / 地区 / 城市。它不带:对话内容、屏幕内容、你装了哪些应用、通讯录、定位、崩溃日志、广告 ID。
关不掉,这一点必须写清楚。 服务地址是写死在代码里的常量(device/SelfCheck.kt 的 VERSION_API_BASE = https://api.heyandee.com),没有设置项、没有编译开关、local.properties 里也没有对应键。要停掉它,只能自己改那一行源码再重新编译。这里之所以不做成可开关:一个能被静默配错的检查,就是一个会静默失效的检查;这一行要么对所有人开,要么对所有人关。所以别指望"设置里关掉"——它不存在。
所以"本机模式"不等于"本地处理" —— 它换的是大脑的目的地,不是"数据留在设备上"这件事。真要数据不出门,你得自己把 asr_endpoint / tts_endpoint / llm_base_url / hub_url 全指向你自己控制的机器。
完整的责任划分与免责条款见 ../DISCLAIMER.zh-CN.md;禁止用途见 acceptable-use.zh-CN.md。
已知风险:调试用的 WebSocket 端口对局域网开放
这一条请务必读完再用。
应用启动时会开一个 WebSocket 服务,监听 0.0.0.0:9008(net/BodyWsServer.kt,端口是 ScreenBodyService.WS_PORT 常量)。
问题在于:它不验证任何身份。 onOpen() 把每一条进来的连接都当作合法的控制端收下。任何能访问到这台设备 IP 的主机,都可以连上来发命令 —— 点屏幕、打字、读界面、读通知、读短信和通话记录,还能让它把保险箱里的密码填进任意应用的输入框。
什么时候会被打: 只要无障碍服务开着,而设备又在一个你控制不了的网络上 —— 咖啡厅、酒店、机场、会议室、公司大内网 —— 就存在这个风险。
现在能做的缓解:
- 只在你信得过的网络上用,或者干脆让路由器/防火墙挡住这个端口
- 用
adb forward驱动设备,别让它从网络上可达 - 把开了无障碍服务的设备,当成不敢随手放在陌生网络里的设备
彻底修法(还没做):连接时校验一个共享密钥,并把监听地址和端口做成可配置、默认只听回环。这件事记为待办;在它落地之前,上面这条限制一直有效。
相关但轻一些的第二条:应用连大脑 hub 那条链路(
net/BodyWsClient.kt)同样没有鉴权,且是明文ws://。所以hub_url只填你自己控制的地址。用local大脑模式可以完全避开这条链路 —— 模型请求由应用自己走 HTTPS 发出,设备上不存在对外的命令通道。
为什么不做"一次全要"
因为那才是木马的做法。
Andee 的做法是:你要什么功能,才要什么权限;你不给的,它就降级,并且告诉你降级了。 这一条能在代码里逐条核对 —— 每个工具在动手前都过一遍 ensurePermission(),拒绝就返回明确的失败原因,而不是换个更隐蔽的路子把事办了。
如果你想看得更深,../SECURITY.md(英文)里有完整的安全模型和漏洞上报渠道。
其他语言: English