Alpine 沙箱：F-Droid 版的本地执行环境

沙箱是什么

Alpine 沙箱是 Agora 的一个本地隔离执行环境：在手机上划出一块受控空间，模型的代码执行类操作在里面跑，出不了沙箱边界——误删文件、危险命令的伤害被限制在沙箱内部。它基于 Alpine（一个极小的 Linux 发行版）构建。

为什么分渠道

这是全应用最特殊的功能：只有 F-Droid 渠道的版本集成了 Alpine 沙箱，Google Play 与 GitHub Releases 版本没有。官方手册在安装一节明确提示「不同分发渠道功能可能有差异」。原因与分发要求有关——沙箱依赖的引导组件携带 GPL 组件，打包方式在部分渠道不便。

想要这个能力：从 F-Droid 渠道安装即可，具体渠道对比见版本与分发渠道。

沙箱能干什么

• 给模型一个安全的代码执行环境：跑脚本、验证代码片段、处理数据；
• 隔离实验：不确定后果的操作先在沙箱里试；
• 配合其他工具形成完整工作流：搜索资料 → 沙箱里写代码处理 → 结果回对话。

沙箱的边界

• 沙箱是独立的：它不参与 llama.cpp 本地模型推理——本地推理不依赖沙箱，没有沙箱一样离线跑模型；
• 沙箱内部的网络行为有独立边界，与应用主进程的网络（代理、直连）互不覆盖；
• 沙箱内的文件与环境是临时的，重启后重置——需要持久化产物记得让模型导出。

渠道差异的取舍参考

相关页面

• 远程设备执行与沙箱的分工，见SSH 设备与远程 Shell；
• 各渠道构建的版本背景，见v2.x 的变化。