Administrator
Published on 2026-11-08 / 12 Visits
0
0

手机 Agent 的进程内 Runtime:PhoneBuddySDK 双时间点审计

手机 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 时,可以使用四级状态:

  1. 项目自述:README 或设计文档说明某项控制存在。
  2. 静态实现:固定 commit 的代码真实实现该控制。
  3. 重复测试:固定 release 资产在 Core、FFI、Swift、Kotlin、模拟器和真机测试中通过。
  4. 产品证据:签名宿主应用完成生命周期、权限、故障恢复和对应商店审核。

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、版本、功能配置和审核日期的公开工件。

参考资料


Comment