FAQ

FAQ

🚀 入门 · 🏠 首页 › FAQ

---

📑 本页目录

• 1️⃣ 需要 Root 吗？
• 2️⃣ 必须配置 API Key 吗？支持哪些模型？
• 3️⃣ 我的 API Key 和记忆数据存在哪？会隐私泄露吗？
• 4️⃣ 终端的 Ubuntu 会很费流量 / 存储吗？
• 5️⃣ 为什么仓库里没有 gradlew？
• 6️⃣ "肌肉记忆"是什么意思？真的省 token 吗？
• 7️⃣ 为什么 targetSdk 还是 28？是没人维护吗？
• 8️⃣ 支持哪些 ABI？x86_64 模拟器能跑吗？
• 9️⃣ 为什么 APK 这么大？
• 🔟 计算器一般的工具（cron/json path/base 转换）为什么自己实现？
• 1️⃣1️⃣ 可以商用吗？
• 1️⃣2️⃣ 我想给它加能力，走哪条路？
• 1️⃣3️⃣ 它会不会自己删文件/装应用？
• 1️⃣4️⃣ 后台老是断？

高频问答。没有答案的问题请提 Issue。

1️⃣ 需要 Root 吗？

不需要。 三级权限链会自动降级：无 Root 时优先用 Shizuku（ADB 级， 免 Root 装应用 / 改设置 / 模拟输入），再不行就用普通应用沙箱 shell。 Root 只是解锁全系统操作（/system、SELinux、ptrace 等）的上限增强。详见 权限执行链。

2️⃣ 必须配置 API Key 吗？支持哪些模型？

需要一个任意 OpenAI 兼容端点的 Key（OpenAI / DeepSeek / OpenRouter / 中转 / 局域网 Ollama 均可）。 未配置时应用以 NoOpLlmClient 优雅降级、界面提示而不崩溃。 DeepSeek-R1 / Qwen3-thinking / o 系列 / GLM-Z1 的原生思维链（reasoning_content）会透传到 UI 实时显示。 详见 LLM 适配层。

3️⃣ 我的 API Key 和记忆数据存在哪？会隐私泄露吗？

• Key 与记忆全部只存应用私有目录（filesDir / SharedPreferences），不上传任何自有服务器 —— 本项目没有服务器；
• GitHub PAT 经 EncryptedSharedPreferences（AES-256-GCM）加密存储；
• 会话内容会直连你配置的 LLM 端点（这是智能体工作的必要通道），用局域网 Ollama 即可做到全链不出内网。

详见 安全与隐私。

4️⃣ 终端的 Ubuntu 会很费流量 / 存储吗？

自 v1.2.0 起 Ubuntu rootfs 内置在 APK 里，安装完成后无需再下载，完全离线； 只有 apt install 装新包时才联网。PRoot 是用户态沙箱，不修改系统分区。 详见 Ubuntu rootfs 供给。

5️⃣ 为什么仓库里没有 gradlew？

仓库未锁定 wrapper。一条命令现场生成（见 快速开始）， 或直接下载 CI 产出的 debug APK 工件（保留 14 天），零环境开箱体验。

6️⃣ "肌肉记忆"是什么意思？真的省 token 吗？

任务成功后，TraceDistiller 把 ReAct 轨迹蒸馏成 FSM 宏技能。之后再次遇到 相同界面指纹时，BypassExecutionEngine 直接回放动作序列 —— 完全绕过 LLM， 0 token、微秒级返回。App 升级导致指纹漂移时，由拓扑同胚迁移通过别名桥保鲜。 详见 cs-mem。

7️⃣ 为什么 targetSdk 还是 28？是没人维护吗？

恰恰相反，这是被战役级注释保护的红线：Android 10（API 29）起禁止应用从私有目录执行二进制， Ubuntu rootfs 依赖 execve + ptrace，一旦升级就整个终端链路失效。 详见 终端运行时。

8️⃣ 支持哪些 ABI？x86_64 模拟器能跑吗？

支持 arm64-v8a / armeabi-v7a / x86_64 三种 ABI，每种都随包提供 PRoot 二进制 （armhf 还额外提供 32 位 loader）。模拟器（x86_64）同样可跑 Ubuntu。

9️⃣ 为什么 APK 这么大？

主要来自：内置 Ubuntu rootfs 归档（每 ABI 约 30MB）+ PRoot 二进制 + Compose/Haze/Vico 等依赖。 想要更瘦的版本用 -PapexAbi=arm64-v8a 打单 ABI 包。

🔟 计算器一般的工具（cron/json path/base 转换）为什么自己实现？

确定性。LLM 做日期算术、进制转换、UUID 生成、diff 都不可靠， 这些工具是纯 JVM / 离线 / 确定性的，既省 token 又不会算错。详见 工具系统。

1️⃣1️⃣ 可以商用吗？

许可证尚未确定（TBD），商业化使用前请先开 issue 与作者对齐。

1️⃣2️⃣ 我想给它加能力，走哪条路？

想要	走
一条工具	工具系统
可分享的能力包	技能
独立分发 / 独立进程	插件 SDK
外部工具服务器	MCP（mcp_connect / mcp_list / mcp_call）

1️⃣3️⃣ 它会不会自己删文件/装应用？

破坏性工具会经过风险门（RiskAwareToolGate）要求人工确认； 想要"先批准计划再执行"用 Plan 模式， 想要"遇到选择必须问我"用 Assist 模式。

1️⃣4️⃣ 后台老是断？

Android 的永久后台不可达。项目用前台服务 + WorkManager 看门狗 + 开机广播做诚实降级的保活， 受厂商策略限制。真正需要长时间跑的任务建议保持在终端会话或前台。

---

🏠 返回首页 · 📚 文档索引 · ❓ FAQ · 🔧 故障排查 · 🗺️ 路线图 · 🐛 提 Issue

_{Android Guru Agent · v1.4.4 · Kotlin 2.0.21 · Compose · PRoot · Room}