它不是聊天壳，是会动手的智能体。
每一项能力都有真实的执行管线在背后，不是提示词模拟。
- 真正的终端
PRoot 沙箱里跑完整的 Ubuntu 24.04，npx、python、git 在手机上可用。命令走真实进程，输出逐行流回上下文；自研 VT100 模拟器纯 Kotlin 零依赖。
- 长任务自愈
限流、超时、网络断连自动退避重试；工具连续失败时，引擎注入换路提示，让模型换工具、换参数、换方法——任务不轻易死掉。
- 认知记忆
cs-mem 把重复操作蒸馏成可回放的肌肉记忆：第二次干同样的事，直接旁路执行，更快，不花 token。
- 双向 MCP 生态
当客户端：官方 Hub 仓库与 mcp.so 目录一键安装 MCP 服务器，npm 生态经沙箱接入，工具自动注册进引擎。当服务器：逆向 MCP Host 让 PC 上的 Cline / Claude 直接调用手机工具。
- 你掌握一切
Root、Shizuku、无障碍三级权限链；每一步执行可见、可中断。API Key 与会话数据只存在你的设备上，金库密钥绝不经外部通道出入。
从装一个 MCP 到干完活，
全程在手机本地。
这是一段典型会话的结构化示意：安装、连接、检索、执行、验证，每一步都有事件流回放到界面。
一种内核，六种干活姿势。
六个模式共享同一个 ReAct 主循环与工具注册表，按任务形态切换，不是六个产品。
默认干活档
读文件、改配置、批量整理——日常任务的默认选择，工具全开。
何时用 · 不涉及破坏性操作的大多数任务
纯对话档
问答、翻译、写作。不触发工具调用，响应最快、最省 token。
何时用 · 只要嘴，不要手
自主执行档
多步规划、连续工具调用、遇错自愈，长任务的完整智能体闭环。
何时用 · 「帮我从头到尾搞定这件事」
先计划后执行
删除、安装、批量改动前先给出完整计划，你确认了才动手。
何时用 · 高风险操作，想先看方案
规格驱动档
从需求文档到实现的工程化路径：拆解规格、逐步交付、可回溯。
何时用 · 写清楚要什么，让它照着做
复盘档
对已完成的任务做回顾与总结，沉淀进记忆供下次复用。
何时用 · 干完了，让它自己想想哪里能更好
和其它方案比，它站在哪。
PC 端智能体工程深度更强，手机 AI 聊天更轻——它的差异化是「完整闭环装进口袋」。
| 维度 | Android Guru Agent | PC 端编码智能体 | 手机 AI 聊天 App |
|---|---|---|---|
| 运行位置 | 📱 全程在设备上 | 💻 PC / 服务器 | ☁️ 厂商云端 |
| 需要服务器 / PC | 不需要 | 需要 | 需要（厂商云） |
| LLM 可换性 | 任意 OpenAI 兼容端点 / 局域网 Ollama | 固定模型或自配 | 固定 |
| 执行能力 | 109 工具：终端 / 文件 / UI 自动化 / 浏览器 / MCP | 文件 + shell + web | 仅对话 |
| Linux 环境 | PRoot Ubuntu 24.04 沙箱 | 宿主 OS | 无 |
| 跨会话记忆 | 语义图 + FSM 宏 0-token 旁路回放 | 仓库内 markdown | 云端会话 |
| MCP 生态 | 双向：客户端接入 + 逆向 Host 供 PC 调用 | 客户端接入 | 无 |
MCP 双向：手机既是客户端，也是服务器。
同一条 v3 执行管线门控（环境门 → 权限门 → 风险门 → 限流 → 熔断），内外一致，不旁路。
AS CLIENT · 客户端方向
把 npm 生态装进口袋
市场页直连官方 Hub 仓库与 mcp.so 社区目录，一键安装 MCP 服务器；本地命令形态的 server 在 PRoot Ubuntu 沙箱里真实运行。
- 官方
apex-mcp-hub仓库 8 台预编目：context7 · fetch · memory · fs … - HTTP / SSE / 沙箱 STDIO / BUILTIN 四种传输
- 安装 ≠ 启动：显式启动，斜杠菜单只列运行中的服务器
- 工具发现自动注册进引擎（tools/list → ToolRegistry）
AS SERVER · 服务器方向
让 PC 的 AI 调用你的手机
逆向 MCP Host 监听 0.0.0.0:8765：PC 上的 Cline / Claude Desktop 经局域网把手机当一台 MCP Server 调用。
- Bearer Token 常时比较鉴权 + 每地址限速
- 分类白名单：vault 与分享类工具硬拦截，绝不外露
- 外部调用与 Agent 内部调用同一门控链
- 纯 Kotlin JVM 模块，79 个测试用例含真实端口集成
内核是什么做的。
工程上较真，才敢把「自主执行」放进你的手机。
引擎、LLM 适配、工具注册表、编码工作区、终端运行时、MCP Host 各司其职；核心模块纯 JVM，可直接单测。
252 个测试文件、约 4,008 个 @Test：任务运行时、编排器韧性、上下文压缩、市场解析、MCP Host 全部有回归门禁，CI 红了就不合入。
BUILD、CHAT、AGENT、PLAN、SPEC、REFLECTION 共享同一个 ReAct 主循环，按任务形态切换。
802 个文件的纯手写工程；另有 37 个 C++ 文件承载 PTY 与 VT 原生加速层，三 ABI 全覆盖，Android 8.0 起步。
问得最多的几件事。
完整版在 GitHub Wiki 的 FAQ 页；这里只放决定你要不要装的四条。
模型从哪来？要付钱给你们吗？
模型完全自带（BYO-LLM）：设置里填任意 OpenAI 兼容端点——OpenAI、DeepSeek、OpenRouter、中转站，或局域网 Ollama。应用本身免费开源，不经手任何模型费用；API Key 只存在设备私有目录的加密存储里。
为什么提示「应用针对旧版 Android 开发」？
这是预期的：项目钉死 targetSdk = 28。Android 10 起系统禁止应用从可写私有目录执行二进制，而 Ubuntu rootfs 依赖这条路径——Termux 至今钉 28 是同一个原因。升上去，终端就没了。
没有 Root 的手机能用多少？
全部功能可用，只是权限链自动降级：Root → Shizuku（ADB 级，免 Root 授权）→ 应用沙箱 shell。装 Shizuku 后 pm install、settings put、UI 自动化都能跑；什么都不装也有文件操作、终端沙箱和完整对话。
数据会上传到哪里？
只和你自己配置的 LLM 端点通信。会话、记忆库、密钥全在本地 Room 数据库与加密存储；无埋点、无统计、无云端账号。逆向 MCP Host 默认关闭，开启也仅限局域网 + Token 鉴权。
