astrbot-for-android - 在 Android 手机上本地运行 AstrBot 与 NapCat 的管理器

astrbot-for-android（AstrBot 运行管理器）是一个面向 Android 设备的应用，目标是把 AstrBot 与 NapCat 的部署和运行管理收进一部手机里。按项目自述，它通过单个 APK 集成 PRoot Ubuntu 运行环境与服务组件，提供环境初始化、服务启停、状态监控、日志查看、备份恢复以及独立的在线更新，并且不需要手机 Root。它适合希望在移动设备上本地跑起 AstrBot 与 NapCat、又不想自己折腾 Linux 环境和依赖安装的用户；对愿意用命令行从源码构建的开发者，仓库里也给出了构建路径。

维护者与状态

项目由 JunWan666 维护，仓库创建于 2026-10-26，最后一次提交在 2026-10-28。最新正式版本为 v1.2.0，发布于 2026-10-28。截至 2026-10-29，仓库星标数为 239。

从时间线看，这是一个相当新的项目：创建与最近一次提交相隔两天，最新 release 与最后提交同日。素材中的更新说明称，1.2.0 这一版改善了终端滚动、选字和快捷键，增加了最近任务隐藏与后台凭据重置，简化了 App 更新流程，并完善了 Linux QQ 与 Ubuntu 的运行兼容性。素材中的界面截图标注为 v1.1.0，项目说明也承认截图尚未更新到 1.2.0。

主要能力

以下能力均据项目 README 自述整理，未做独立验证：

• 双服务管理：AstrBot 与 NapCat 可独立或一键启停，并查看运行、连接和异常状态。
• 内置后台：直接打开原 WebUI，预填有效的初始凭据，也可改用外部浏览器访问。
• 本机互联：新装时准备 ws://127.0.0.1:6199/ws、空 token 的 OneBot 配对，同时保留自定义连接方式。
• 局域网访问：两套 WebUI 可分别开放局域网访问，显示可复制地址，并保留后台鉴权。
• 人设库：内置 4 款参考社区精选整理的预设，注明来源与改编内容；支持新增、删除（含内置预设）、搜索、分类与默认切换，并提供外部人设市场入口。
• 实时日志：在服务详情中查看，自动跟随最新输出，可暂停、复制和脱敏导出。
• 资源概览：显示应用及托管进程内存、手机总内存与占比，并可单独查看存储使用情况。
• 备份与恢复：支持本机快照、便携备份和更新回退，自动清理未受保护的旧自动快照。
• SSH 与终端：SSH 扩展默认安装、按需启动，可修改密码、端口和局域网访问设置；内置本机交互终端支持多会话、平滑触摸滚动、方向键与粘贴回车，Android 9 及以上支持选字放大镜。
• Ubuntu 桌面：按需安装轻量桌面与通用编译工具，内嵌 noVNC，可独立安装或更新原版 ARM64 QQ，并保留登录数据。
• cpolar 扩展：按需安装，内嵌官方 WebUI 登录与隧道管理，默认提供 SSH、AstrBot、NapCat 三个隧道。
• 界面与后台引导：支持跟随系统、简体中文与 English；提供通知、电池优化、后台无限制、自启动权限及任务锁定入口，可选择在最近任务中隐藏。
• 更新管理：App 更新统一为检查、查看说明、下载校验后进入系统安装；AstrBot、NapCat 各自独立更新。

使用入口

项目仓库地址为 astrbot-for-android，安装包与说明文档均以该仓库为准。

据项目说明，使用流程大致是：从 Releases 下载完整 APK，在 ARM64 Android 手机上安装，打开应用完成环境初始化；点击「启动全部」，等待 AstrBot 与 NapCat 就绪；打开 NapCat 后台登录 QQ，在 AstrBot 后台配置模型、平台和插件；最后按「设置 → 后台运行」的引导调整手机权限，再按需使用人设、备份、SSH 和 cpolar。完整包内置运行环境，初始化无需另外下载 Ubuntu 或安装项目依赖；QQ 登录、模型调用和在线更新需要网络，账号与 API Key 在对应 WebUI 中配置。

源码构建方面，README 写明需要 JDK 17、Android SDK 35、NDK 和 Python 3.11+。编译应用源码可执行：

./gradlew.bat :core:compileKotlin :app:compileBootstrapReleaseKotlin

完整 APK 还需另外准备运行镜像、原生资源和许可输入，大型资源与本机配置不进入 Git；准备好输入和长期签名后，Windows 可双击根目录的 build.bat，其他系统执行 python3 -B tools/build_release.py 完成正式构建、签名与校验，默认输出到 dist/。

许可与限制

许可证为 MIT。项目自述称原创代码采用 MIT License，版权归 JunWan666，使用或分发时需保留版权声明和许可文本；AstrBot、NapCatQQ、PRoot、Ubuntu、Termux 等第三方组件遵循各自的许可与分发条款，详见仓库的 NOTICE 与第三方声明。

硬件与系统边界方面，据项目说明：需要 Android 8.0 / API 26 及以上、ARM64 架构，无需 Root；完整 APK 约 720 MiB，安装后还需为运行环境、QQ 数据和备份预留空间；空间不足时会显示预估提醒，可选择「仍然继续」，但实际可写空间耗尽仍会导致操作失败。运行占用随插件、模型调用及 QQ 状态变化，首页显示实际应用内存，不预分配虚拟机内存。持续运行需要按手机系统设置后台权限，应用目前不提供开机自动启动。cpolar 需在「设置 → 扩展组件」中单独下载安装，客户端不打入 APK，隧道目标服务需在 App 中启动，服务能力以 cpolar 账号套餐为准。

此外，项目说明提到默认接入其 GitHub 签名更新通道：Releases 存放安装包和 AstrBot 程序包，updates 分支托管签名目录，NapCat 直接下载上游官方 Shell 包；只有 QQ、Python 或底层依赖变化时，才需要匹配的运行环境升级。