JunWan666/astrbot-for-android

选用指南

AI 根据 README 整理 · 2026/10/27 10:41:32

使用方式

通过 Android 应用使用，内置 WebView 访问 AstrBot 和 NapCat 的 WebUI，支持局域网访问和 SSH 终端。

查看 README 依据

应用采用 Kotlin 与 Jetpack Compose 构建原生管理界面，支持简体中文与英文，通过内置 WebView 访问 AstrBot 和 NapCat 的 WebUI，在手机端完成 QQ 登录、模型接入与插件配置，并提供人设管理、局域网访问、SSH 终端与 cpolar 内网穿透扩展。 ## 界面预览 当前正式版本为 **v1.0.0**。主分支和下方截图包含开发中的中英文界面、cpolar 扩展与存储提醒调整，相关功能将在后续版本发布。 <table width="100%" align="center"> <tr> <td align="center" width="33%"> <img src="./docs/images/home.webp" alt="首页：双服务启停、应用内存与手机总内存" width="144" /> <p align="center"><strong>首页 · 服务与资源</strong></p> </td> <td align="center" width="33%"> <img src="./docs/images/personas.webp" alt="人设：市场入口、手动添加与本地列表" width="144" />

<p align="center"><strong>AstrBot · 内置后台</strong></p> </td> <td align="center" width="300"> <img src="./docs/images/napcat-webui.webp" alt="App 内置 WebView 中的 NapCat 后台" width="144" /> <p align="center"><strong>NapCat · 内置后台</strong></p> </td> </tr> </table> ## 功能特性 | 功能 | 说明 | | --- | --- | | 双服务管理 | AstrBot / NapCat 独立或一键启停，查看运行、连接和异常状态 | | 内置后台 | 直接打开原 WebUI，预填有效的初始凭据，也可使用外部浏览器 | | 固定缩放 | 默认 75%，支持 100% / 75% / 50% / 25%，关闭双指缩放 | | 本机互联 | 新装准备 `ws://localhost:6199/ws`、空 token 的 OneBot 配对，已有配置保留 | | 局域网访问 | 两套 WebUI 可分别开放局域网访问，显示可复制地址，保留后台鉴权 |

部署要求

需要 Android 8.0 / API 26 及以上，ARM64 架构，无需 Root。完整 APK 约 720 MiB，安装后需预留空间。

查看 README 依据

1. 从 [Releases](https://github.com/JunWan666/astrbot-for-android/releases/latest) 下载完整 APK，在 ARM64 Android 手机上安装，打开 App 完成环境初始化。 2. 点击“启动全部”，等待 AstrBot 和 NapCat 就绪。 3. 打开 NapCat 后台登录 QQ，在 AstrBot 后台配置模型、平台和插件。 4. 按“设置 → 后台运行”的引导调整手机权限，再按需使用人设、备份、SSH 和 cpolar。 完整包内置运行环境，初始化无需另外下载 Ubuntu 或安装项目依赖。QQ 登录、模型调用和在线更新需要网络，账号与 API Key 直接在对应 WebUI 中配置。更多操作见[使用指南](docs/使用指南.md)。 ### 设备与空间 - Android 8.0 / API 26 及以上，ARM64 架构，无需手机 Root。 - 完整 APK 约 **720 MiB**，安装后还需为运行环境、QQ 数据和备份预留空间。 - 环境准备空间不足时显示预估提醒，可选择“仍然继续”；实际可写空间耗尽仍会导致操作失败。 - 运行占用随插件、模型调用及 QQ 状态变化；首页显示实际应用内存，不预分配虚拟机内存。

已知限制

应用不提供开机自动启动，持续运行需要按系统设置后台权限。cpolar 扩展需单独下载安装，服务能力以 cpolar 账号套餐为准。

查看 README 依据

- 持续运行需要按手机系统设置后台权限，应用目前不提供开机自动启动。 cpolar 在“设置 → 扩展组件”中单独下载安装，客户端不打入 APK。登录官方 WebUI 后自动保存令牌，可管理三个默认隧道；隧道目标服务需在 App 中启动，服务能力以 cpolar 账号套餐为准。 ## 源码构建 使用 JDK 17、Android SDK 35、NDK 和 Python 3.11+。编译应用源码： ```powershell ./gradlew.bat :core:compileKotlin :app:compileBootstrapReleaseKotlin ``` 完整 APK 需要另外准备运行镜像、原生资源和许可输入，大型资源与本机配置不进入 Git。准备好输入和长期签名后，Windows 双击根目录 `build.bat`，其他系统执行 `python3 -B tools/build_release.py`，即可完成正式构建、签名和校验。默认输出到 `dist/`，具体步骤见[构建指南](docs/构建指南.md)。 长期密钥及密码位于 Git 已忽略的 `.local/signing/`，后续版本持续复用；首次创建与备份方法见[一键构建正式包](docs/构建指南.md#一键构建正式包)。 ## 更新