Zhengdao — AI skill for Claude Code

证道（Zhengdao）

**简体中文** ｜ [English](README.en.md)

安卓上的轻量级 AI Agent 运行环境——免 root、零命令、一键安装你自己的 Agent。

让普通用户在 Android 手机上拥有一套真实的 Linux 环境（Debian 13.7），并在其中一键运行 Claude Code、Hermes Agent、OpenCode 等官方 CLI Agent。

⚠️ **门槛（先看这个）：需要 Android 16（API 36）或更高 ＋ arm64 手机 —— 不符合就别下了，装了也跑不起来。**（详见下方「系统要求」）

**Agent 支持状态（2026-10-11，荣耀 Magic 5 Pro 真机验收）**：**OpenCode 内置**（抱朴 Tab 直达对话界面，bionic 宿主版零 PRoot 开销，按需下载约 65MB）；**Hermes Agent 支持**（一键安装 → 启动 → TUI，`hermes update` 可用；它自带一套 Python 工具链，安装阶段需要联网，依赖环境损坏可在怡然一键修复）；Claude Code 与 AGY CLI（Antigravity）在终端自由安装（走各自官方脚本）。

**界面结构**（四 Tab，`main` 上，2026-10-14 起）：底部 **抱朴**（OpenCode 对话，真实）/ **逍遥**（终端，自由）/ **玄览**（浏览器，期望）/ **怡然**（Agent 管理，幸福）；设置从右上角齿轮进入，首次进入落在怡然。 ⚠️ **v2.1.1 及更早的发布版仍是三 Tab——太极 / 终端 / 丹房**：改名与玄览批次都攒在 `main` 上、**尚未发版**，随下一版一起出去。下文历史版本条目里的「太极」「丹房」，就是现在的抱朴 / 怡然。 **文件边界**：Agent 产出统一放工作区（默认手机 `Download/证道`，可在设置页更换），手机文件管理器直接可见、卸载证道后仍保留。

系统要求

• Android 16（API 36）或更高版本
• arm64-v8a 架构设备（绝大多数现代安卓手机和平板）
• 已在 荣耀 Magic 5 Pro（MagicOS 10.0.0.175 / Android 16，机型代号 PGT-AN10） 上完成实测

**⚠️ 关于其他 Android 版本** 本项目目前**仅在 Android 16 上完成真机实测**，其他版本（Android 15 及以下）**未做适配和验证**，可能存在兼容性问题。 如果你在非 Android 16 设备上尝试安装，请自行评估风险并测试，**不保证能正常运行**。 由于是个人业余项目，精力实在有限，无法对所有 Android 版本提供适配支持，**请多多包涵**。

**🔒 关于 targetSdk 28（2026-10-15 重大更正）** 证道**当前仍以 targetSdk 28 打包**，但这**已不是「必须 ≤ 28」的生死线**——该必然性已于 2026-10-15 被真机原型**证伪**（`docs/ERRATA.md` **E-134**）：

• 现行理由（口径已改）：targetSdk 28 是证道现行打包方式的前提——Termux 四件套打进 jniLibs（安装时落进只读可执行的 nativeLibraryDir）、rootfs 走 assets/ → files/。它是当下的做法，不是「只能这样」的架构铁律。
• 被证伪的旧说法：「Android 10 起系统禁止 targetSdk ≥ 29 的应用从自己的可写数据目录执行文件（W^X），只有 targetSdk 28 能豁免 ⇒ 抬高 targetSdk = 整个 Linux 环境变成无法执行的死文件」。原型 proot-jnilib-proto 在与真机同型号（荣耀 PGT-AN10 / Android 16）上以 targetSdk 36 跑通四件套（PROOT_LOADER 显式指向 nativeLibraryDir），四判据全过：环境自检 / 解压 rootfs / echo + uname / apt-get update 联网（Hit:1..3 deb.debian.org）。四件套 SHA256 与 terminal/ProotLauncher.kt:123-127 里 pin 的值逐字节一致。
• *后续