13小时极限开发:我在安卓手机上用 AI 造了一个带“看门狗”和“影子沙箱”的 AI Agent

在手机上跑 AI Agent，最怕的就是改错一行代码，系统直接崩溃，连救都救不回来。”

这就是我做这个项目的初衷。

一、项目介绍：Z-Agent-Termux

这是一个运行在 Android 手机 Termux 环境下的自主进化 AI Agent。它的核心使命只有一个：无论代码怎么改，系统永远不能死。

为了实现“不死之身”，我给它设计了双保险架构：

1. 看门狗（boot_guard）：程序启动前自动进行 AST、符号和冒烟自检。如果启动成功，它会自动生成一个“last_good”快照；如果启动失败，它会自动读取最近的快照并原子回滚。

2. 影子沙箱（shadow_test）：在代码真正替换前，它会在隔离的沙箱环境里用“假 LLM”驱动代码跑完整套逻辑。只有断言全部通过，且不存在运行时不变量错误，才允许“基因落盘”。

此外，我把它的架构做了物理隔离（zcore工具库与zguard防御系统分离），确保了看门狗不会被主程序污染。

二、13个小时的极限“造物主”之旅

这个项目不是按部就班写出来的，它是我从今天早上9点一直到晚上10点，足足折腾了13个小时的产物。

· 上午 9:00 - 12:00：踩坑与崩溃。 一开始折腾 API 接口，遇到了 401（密钥错误）、503（服务器过载），甚至因为手滑在 nano 编辑器里误删了关键源码。在一次次崩溃和抢救中，我意识到：手机环境太脆弱了，必须有“自愈”机制。

· 下午 12:00 - 16:00：重构与植入。 借用外部大模型（GLM-5.3）的智力支持，我们开始重构源码。将原本2000多行的单文件巨兽拆分成 zcore 和 zguard。在这个过程中，引入了看门狗（boot_guard）和影子沙箱（shadow_test）。

· 下午 16:00 - 18:00：安全清理与写文档。 为了防止 API 密钥泄露，我对所有的日志和配置文件进行了排查和脱敏。然后，手打了一份极其详尽的中文部署与使用说明书。

· 傍晚 18:00 - 20:00：推广与铺设。 建好了 QQ 交流群，写好推广文案，在 B站发布了动态，又在掘金和知乎同步发布了开源文章。

· 晚上 20:00 - 22:00：Git 同步与发布。 这是最考验人的一步。本地代码和远程 GitHub 仓库产生了冲突（! [rejected]）。经历了多次 git pull --allow-unrelated-histories 和 git push 的拉锯战，最终成功将全部代码、README、徽章、快速上手教程和 llms.txt 推送到了 GitHub。

三、项目亮点与已知边界

· 亮点：系统自带自愈闭环，即便你改崩了源码，重启时也能自动回滚到可启动版本。这意味着你可以在手机上大胆地进行 Agent 实验。

· 已知边界：防“假完成”不防“低质量完成”；影子沙箱目前只对第一个产物证伪；无法模拟真实网络环境。

四、如何体验？

项目已在 GitHub 完全开源，包含全套中文说明书，欢迎感兴趣的朋友来玩，也欢迎提 Issue 交流。

👉 GitHub 地址：https://github.com/zxxzxx1314/Z-agent-termux

💬 交流 QQ 群：1072611451

如果你也对手机端 AI Agent 感兴趣，或者正在寻找一个带安全沙箱的轻量级实验框架，欢迎点个 Star 鼓励一下。开源不易，感谢支持！