手机 Agent 需要一套接受移动平台约束的 Runtime。它不能默认启动 Shell 和子进程,不能把整个文件系统当工作区,也不能假设退到后台后仍会持续执行。模型、工具、脚本和任务状态最终都必须服从宿主应用的容器、权限、生命周期和商店规则。
PhoneBuddySDK 是一个值得研究的实现样本。它把 Agent 循环、Rust 工具、JavaScript 解释器、子任务和原生绑定放进同一应用进程。2026 年 8 月 23 日对提交 c661ba0 的首次审计发现了有效的静态控制,也发现两项证据不匹配:README 声称通过 Apple 与 Google 的沙箱安全审核,却没有链接审核工件;文档声称 FFI 使用 catch_unwind,当时源码没有实现。
2026 年 11 月 8 日复核显示,项目已经发生实质变化。最新版 release 为 v0.2.0,当前 main 为 0c7bdd7;FFI 源码已经引入 catch_unwind,但只在部分入口使用,常规发布构建仍采用 panic = "abort"。这比原提交增加了一层捕获代码,还不足以证明文档承诺的完整 FFI panic containment。商店审核自述仍没有公开证据,仓库仍没有 GitHub Actions workflow。
这次变化恰好说明移动 Runtime 应怎样验收:结论必须绑定代码快照,代码修复、测试通过和产品审核是三种不同状态。
两个时间点的结论
| 检查项 | 2026-08-23,c661ba0 |
2026-11-08,0c7bdd7 |
当前判断 |
|---|---|---|---|
| 最新 release | v0.1.2 | v0.2.0,发布于 2026-08-25 | 旧文的 release 描述已过期 |
| FFI panic 边界 | 文档写 catch_unwind,源码未实现,release profile 为 panic=abort |
FFI 增加三类 catch helper,但只覆盖部分入口;release 与其派生的 ios-dist 仍为 panic=abort,Android 也使用 release |
部分源码路径改善,完整发布边界仍未证明 |
| 自动化测试回执 | 仓库定义 Rust 测试,缺公开 workflow | GitHub API 仍返回 0 个 Actions workflow | 测试代码存在,持续集成结果未知 |
| 商店审核 | README 自述已通过,未链接工件 | 自述保留,仍未链接具体 App、审核记录或 track | 继续标记为项目自述 |
| 运行时范围 | 基础 Agent、文件、网络、脚本、任务和原生桥接 | 新增长期 Runtime、路由、Host LLM、更多 FFI 与传输能力 | 审计面扩大,旧快照不能代表当前全部能力 |
英文公开页仍然是 2026 年 8 月 23 日的固定提交审计。本文中文 v2 保留那份历史证据,同时补上当前状态。这样既不把过去的发现改写成从未发生,也不把已修复问题继续写成当前事实。
进程内架构解决的真实问题
桌面 Agent 常把操作系统当作工具箱:启动命令、安装依赖、派生进程、访问广泛目录,并长时间保持运行。移动平台的默认条件正好相反。
Apple App Review Guidelines要求应用保持自包含并限制下载或执行会改变功能的代码。后台执行只针对明确场景开放。Google Play 的 Device and Network Abuse政策禁止从 Play 之外下载 dex、JAR 和 native library;解释器代码存在条件性例外,但脚本能够完成的动作仍受全部政策约束。
进程内 Runtime 的价值在于把隐含系统动作变成宿主应用内的显式能力:
宿主 UI、权限与生命周期
-> 类型化工具和回调
-> 进程内 Agent 循环
-> 受限文件、网络与脚本
-> 会话、任务和副作用检查点
这套结构消除了对 fork、Shell 和外部运行时的依赖,也为权限检查、超时和恢复提供统一边界。它不能让应用获得系统没有授予的能力,也不能自动满足商店审核。
当前源码支持哪些静态结论
当前 Cargo workspace继续关闭 Tokio process feature,并明确禁止 iOS 上的 fork 假设。项目用 Rust 实现文件、网络、虚拟命令、脚本和异步任务。
首次审计中的多项核心控制仍可在代码中定位:
- 文件工具把操作限制在指定 root,并结合词法路径与真实祖先路径检查。
- SSRF 初筛阻止 loopback、私网和 link-local 等目标。
- Boa JavaScript 执行设置迭代预算,Agent 工具调用具有超时和重复动作检测。
- Swift、Kotlin、JNI 与 C ABI 让宿主应用注入工具和接收事件。
- 当前 main 新增长期
PhoneBuddyRuntime、Host LLM、路由池、provider health 和 one-shot generation,运行时边界比 v0.1.2 更大。
这些都属于源码证据。是否能在 release 资产、模拟器、真机和商店配置中稳定工作,需要更高层验证。
FFI 修复应该怎样解释
首次审计提交的 FFI 文件没有 catch_unwind,而 workspace release profile 使用 panic = "abort"。当时的准确结论是:panic 不会穿过 ABI,但会终止整个进程,无法转换为可恢复错误。
当前 main 的 FFI 实现已经导入 catch_unwind 与 AssertUnwindSafe,并提供 pointer、integer 和 void 三类包装函数。静态核对只能确认部分入口调用这些 helper,文件中仍有大量 C ABI 与 JNI 入口未由它们包裹。
更关键的是,根 Cargo.toml 的 [profile.release] 仍设置 panic = "abort";ios-dist 继承 release 且没有覆盖该项,Android 构建脚本明确使用 --release。Abort 不会进入 catch_unwind。因此,当前证据只支持部分源码入口增加捕获包装,不支持发布二进制已经具备完整可恢复 panic 边界。
要关闭这项缺口,需要先为发布构建提供明确的 unwind-capable 配置,再列出全部导出入口的包装状态,并在 C、Swift、Kotlin 三条路径主动触发 panic,验证返回码、内存释放、回调线程、重复调用和宿主恢复。代码存在说明控制意图已经进入实现;固定构建与故障注入通过才说明边界可依赖。
五组真机边界测试
文件与导入
测试相对路径穿越、绝对路径、已有和新建符号链接、检查后替换、Unicode 混淆名、系统文件选择器与共享扩展交接。应用容器只是外层边界,每个会话还应拥有更窄的 workspace。
网络目的地
测试公网 URL、私网字面地址、DNS 解析到私网、重定向链、IPv6、慢流、超大响应、TLS 失败和取消。预检查与真实连接必须执行同一目标策略,不能只在请求前验证一次域名。
平台接口
iOS 跨应用能力应通过 App Intents、Share Extension、文件选择器或其他公开接口;Android 需要用 Intent、Scoped Storage 和符合政策的前台服务。每个 Host Tool 都应绑定声明权限、用户同意和可撤销状态。
强杀与恢复
分别在模型流式响应、文件写入、Host Tool 调用、界面展示后但会话落盘前强杀进程。重启后检查最后提交步骤、外部副作用和重复执行。协作式 cancellation token 无法代替操作系统强杀测试。
卡死与资源耗尽
测试 JavaScript 死循环、交替工具调用绕过完全重复检测、不响应取消的宿主回调、慢网络和大量并发任务。超时返回后还要确认底层 worker 是否真正停止,以及内存、文件锁和回调是否释放。
调度定义不等于系统唤醒
移动 Agent 很容易把定时任务写入数据库后,就把功能描述成后台自动执行。实际链路至少包含四层:保存意图、向操作系统注册、获得唤醒机会、在受限时间内恢复任务并提交结果。
PhoneBuddySDK 的 scheduler 和 runtime 可以管理意图与宿主事件,但具体 App 仍需接入 iOS BGTaskScheduler 或 Android WorkManager、AlarmManager 等平台机制。操作系统会根据电量、网络、用户行为和配额决定是否以及何时运行。产品文案应区分已保存计划、已注册系统任务、获得唤醒和完成动作。
商店合规为什么不能从源码推导
截至 2026 年 11 月 8 日,仓库 README 仍称项目通过 Apple App Store 和 Google Play 沙箱安全审核。仓库没有链接对应的 App Store 页面、Play listing、TestFlight 回执、审核消息或测试轨道。公开搜索也没有找到能与 APUS-AI-Lab 这一 SDK 绑定的商店工件。
即使未来找到一个已上架宿主 App,也只能证明该 App 在当时启用的功能、权限和脚本配置通过审核。SDK 的全部可选能力、其他宿主应用或后续版本仍需分别验证。
因此,商店证据至少要包含:具体 bundle 或 package identity、版本、启用能力、审核日期和可核验页面。源码符合部分平台原则,与产品通过审核是两条证据链。
四级发布证据
评估移动 Agent Runtime 时,可以使用四级状态:
- 项目自述:README 或设计文档说明某项控制存在。
- 静态实现:固定 commit 的代码真实实现该控制。
- 重复测试:固定 release 资产在 Core、FFI、Swift、Kotlin、模拟器和真机测试中通过。
- 产品证据:签名宿主应用完成生命周期、权限、故障恢复和对应商店审核。
PhoneBuddySDK 当前在多项核心控制上达到第二级。FFI panic 边界从旧提交的纯文档自述,推进到当前 main 的部分入口实现;发布 profile 与覆盖完整性仍不满足第二级的完整边界声明。仓库也缺公开 CI 回执,release 资产与 main 又不是同一快照,因此不能把当前源码自动归入第三级。
最小交付门槛
准备把类似 Runtime 放进真实产品时,至少保留这些工件:
- 固定 commit、release tag 与二进制摘要;
- Core、FFI、Swift、Kotlin、模拟器、仿真器和真机测试回执;
- 文件、网络、脚本、Host Tool 和后台能力的权限与政策映射;
- 路径逃逸、重定向、panic、超时、强杀和重复副作用的故障注入;
- 可持久化任务账本、幂等键和恢复策略;
- README、实际代码、发布包与产品配置之间的对账;
- 具体宿主 App 和启用功能集的商店审核证据。
进程内 Runtime 是适合手机的架构起点。成熟度由系统能否在真实设备上暴露、隔离、恢复并证明失败决定。
常见问题
零子进程是否等于 App Store 合规?
不等于。它消除一项不适合移动平台的桌面假设。动态代码、权限、数据访问、后台执行、跨应用动作和产品体验仍需审核。
当前 PhoneBuddySDK 是否已经修复 FFI panic 问题?
当前 main 已在部分入口加入 catch_unwind,但 release、ios-dist 和 Android 发布构建仍使用 panic=abort,且并非全部导出入口都有包装。现在只能确认局部改善,完整 FFI panic containment 仍未证明。
v0.2.0 是否代表当前 main?
不代表。v0.2.0 tag 为 9fe5278,当前 main 为 0c7bdd7,其后还有 35 个提交,涉及 Runtime、LLM 路由、FFI、传输和任务等大量改动。
README 的通过商店审核表述可以采信吗?
当前只能标记为项目自述。需要能绑定具体宿主 App、版本、功能配置和审核日期的公开工件。