## 项目简介
**AstrBot for Android(AstrBot 运行管理器)** 是面向 Android 设备的 AstrBot 本地部署及运行管理应用。单个 APK 提供 PRoot Ubuntu、AstrBot 与通用运行依赖,支持环境初始化、服务启停、状态监控、日志查看、备份恢复及独立在线更新,无需 Root。
应用采用 Kotlin 与 Jetpack Compose 构建原生管理界面,支持简体中文与英文。从首页接入 QQ 官方机器人和微信官方 ClawBot,通过内置 WebView 配置 AstrBot 的模型、插件与人设;终端和任务页用于运行自行部署的 Ubuntu 程序,另提供局域网访问、SSH、Linux QQ 和 cpolar 等扩展。
当前最新正式版为 **1.5.1**:支持直接离线导入 AstrBot 上游更新包,修复首次登录设密跳转,并改进 Linux QQ 启动兼容、任务日志和内置网页操作。升级影响及完整变更见[更新记录](docs/CHANGELOG.md)。
### 关于 NapCat 与 SnowLuma
早期版本曾提供 NapCat 内置接入和 SnowLuma 部署、运行入口。近期上游公开源码与下载渠道发生变化:截至 2026-11-18,[NapCat 原仓库](https://github.com/NapNeko/NapCatQQ)的默认分支仅保留 README,[SnowLuma 原仓库](https://github.com/SnowLuma/SnowLuma)已无法公开访问。为明确第三方授权与分发边界,并降低后续维护的不确定性,**从 1.5.0 起,本项目不再内置或提供这两个组件的专用安装、启停及部署教程**,重点维护 AstrBot、QQ 官方机器人、微信官方 ClawBot 和通用运行环境。
升级会停用旧版内置接入,保留 AstrBot 数据、账号资料及用户手动安装的软件;通用终端、任务和独立 Linux QQ 继续可用。Linux QQ 用于原版客户端登录与聊天,与机器人接入独立。旧 Release 描述的是对应历史版本,详见[旧版本升级](docs/使用指南.md#旧版本升级)。
## 界面预览
以下手机实机截图展示首页、任务、网页、分类设置、扩展、权限及内置后台。
首页、任务、网页、设置、扩展和 QQ 官方机器人配置展示 1.5.0 的界面布局,其余展示现有通用功能。