Skip to content

AstrBot-Android-App v1.2.0 正式发布 🚀

Choose a tag to compare

View all tags
@zz6zz666 zz6zz666 released this 14 Nov 17:52
· 81 commits to master since this release
v1.2.0
11fe960

🌟 版本核心亮点

✅ 安装稳健性升级：优化初始化恢复机制，安装中断 / 失败后重启可自动恢复进程，大幅降低安装损坏风险（仅极端情况需重置初始化）；Astrbot 的 git clone 改为原子操作，保障资源下载完整性。

✅ 扫码登录体验修复：彻底解决扫码时切换后台（如截图、切换 QQ 扫码）导致的 WebView 切换失效问题，切换回应用后可正常进入 WebView 页面（进入 AstrBot 控制台），无需依赖快速切换操作。

✅ 致命 bug 修复（延续 v1.1.0）：前台通知机制持续生效，应用在后台 / 息屏状态下稳定运行，机器人消息接收与响应不中断。

✅ 简化初始化条件（延续 v1.1.0）：无需保持初始化时前台 / 屏幕常亮，息屏、切换应用不影响安装与运行（保留通知栏常驻通知即可）。

Screenshot_20251114-023227 AstrBot Screenshot_20251114-023211 AstrBot Screenshot_20251114-023214 AstrBot Screenshot_20251114-020817 AstrBot Screenshot_20251114-012715 AstrBot

📋 环境要求

  • 建议 Android 12 及以上版本

  • 至少 4GB 可用内存（保障容器与服务稳定运行）

  • 兼容架构：仅支持 arm-v8a（64 位 arm 架构，32 位 arm-v7a 不适用）

  • 必需权限：通知权限（每次启动将监测并引导开启，未开启将无法正常后台运行）

🔧 启动与初始化指南

网络要求

  • 首次启动需在通畅网络环境下进行（推荐流量或家用宽带）。

  • 避免使用校园网等内网或速度受限网络，防止资源下载失败。

初始化注意事项

  • 应用启动时会联网下载依赖资源，点击屏幕可在白色进度条页面与模拟终端切换。【建议在首次启动初始化时打开并人工监视终端输出】

  • 进度条长时间不更新时，请点击查看终端输出是否为网络受阻，若网络受阻，可尝试重启，会继续初始化。

  • （尤其是 napcat 的安装，其安装时间较长且可能下载失败，下载阻塞时可放心关闭再启。）

  • ✨ 新增稳健性优化：Astrbot 的 git clone 改为原子操作，无需过分担心下载过程中网络中断导致的文件损坏；初始化中断 / 失败后重启，系统将自动恢复初始化进程，更难出现安装损坏。

  • 若出现极端情况（如安装软件包损坏，多次关闭重启依然无法正确初始化），需清除应用数据后重新初始化。

  • ✨ 核心优化（延续 v1.1.0）：初始化期间无需保持应用前台 / 屏幕常亮，息屏、切换应用均不影响安装完整性。

  • 若多次尝试重启均无法修复问题，请清除应用数据后重新初始化。（特例情况：如遇到安装软件包时中断导致的 dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem 终端输出，请立即重置并重新初始化。）

登录与配置流程

  1. 启动后，应用将请求通知权限，必须允许（否则无法后台持续运行）。

  2. NapCatQQ 与 AstrBot 同步启动，出现 NapCatQQ 登录二维码。

  3. ✨ 体验优化：扫码时可自由切换后台（如截图、打开 QQ 扫码），切换回应用后 WebView 监听正常生效，可顺利进入后续页面。

  4. 使用移动端 QQ 扫码登录，登录成功后二维码弹窗自动消失。

  5. AstrBot 启动成功后，通知栏将显示 “正在运行” 常驻通知（禁止手动关闭，关闭将导致后台运行终止）。

  6. 进入控制台页面，默认用户名 / 密码均为 astrbot，请及时修改密码。

  7. 控制台 “机器人” 栏中，pre-config 为内置通信接口，禁止修改或删除。

  8. 前往配置页面填写 LLM 大模型 token（详情参考 AstrBot 文档）。

📌 核心特性

  • 一键启动：无需复杂配置，点击即可启动 AstrBot 服务。

  • 图形化配置：内置 WebView 直接访问 AstrBot 仪表盘，支持 LLM 对接、插件管理等。

  • 多平台适配：默认支持 QQ 个人账号，可扩展至企业微信、Telegram 等。

  • 主流 LLM 兼容：支持 OpenAI、Llama、Gemini、Dify 等大模型。

  • 本地容器环境：基于 Ubuntu 容器保障依赖稳定性与兼容性。

  • ✨ 特性升级（v1.2.0 新增）：安装恢复机制 + 原子化 git 克隆，提升初始化成功率；扫码后台切换无感知，登录流程更顺畅。

  • ✨ 特性升级（v1.1.0 延续）：前台通知常驻机制，支持后台 / 息屏持续运行，响应不中断。

🛠️ 已知限制与下一版本规划

当前限制

  • AstrBot 仪表盘 WebView 为全屏隐藏状态栏设计。

  • 安卓版本兼容性较差，在较低版本安卓系统无法运行（proot-distro访问路径不存在）且目前已知无法在安卓10及以下版本使用。

  • 内置 webview 中控制台日志不更新。

  • 同一 qq 账号实际无需每次启动重复扫码即可自动登录，但当前软件设计强制用户重新扫码。

  • ⚠️ 上游项目已知问题（重要提醒）：由于 AstrBot （版本 4.5.6 ）自身缺陷，在控制台页面 → 配置文件 → 扩展功能中，请勿开启“分段回复”选项。开启后会导致 QQ 机器人无法通过 NapCatQQ 向用户发出消息，且该问题在关闭选项后仍无法恢复。最方便的修复方式为清除应用数据后重新初始化，会清空已配置的信息和聊天数据，请谨慎操作。【该 bug 已在 AstrBot 版本 4.5.8 中修复】（⚠️注：app 端会在初始化时选择当前最新版本的 AstrBot 和 napcat 进行安装，后续可通过 AstrBot 仪表盘的设置页面手动切换 AstrBot 版本）

下一版本功能

  1. 优化 WebView 显示：AstrBot 仪表盘页面将恢复显示状态栏，提升操作体验。

  2. 更改容器工具，弃用proot-distro，以提升安卓系统版本兼容性 紧急。

  3. 修复 napcat QQ 的强制重复扫码登录逻辑。

  4. 修复内置 webview 中 AstrBot 控制台日志不更新的问题。（当前用户如需获取应用日志，请在手机浏览器访问 AstrBot 仪表盘中的控制台 http://localhost:6185 ）

  5. 考虑将应用内部存储挂载至文件访问应用，以便用户调试。

🙏 致谢

感谢 Code LFA 提供的 Android 端 Ubuntu 容器环境，AstrBot 团队的聊天机器人框架，以及 napcatQQ 团队的 QQ 消息适配器支持。

感谢用户反馈的安装稳定性与扫码切换问题，助力产品快速迭代优化！

特别感谢 Operit 项目的开发者 AAswordsman，他为此次的app开发提供了不少建议和帮助。

Operit 项目是 “📱 移动端首个功能完备的 AI 智能助手应用，完全独立运行，拥有强大的工具调用能力 📱”，其 “完全独立运行于您的 Android 设备上（除 API 调用），拥有强大的工具调用能力、深度搜索、智能记忆库，并支持人设定制与角色卡等高度自定义功能。它不仅仅是聊天界面，更是与 Android 权限和各种工具深度融合的全能助手，内置 Ubuntu 24 环境，提供前所未有的强大功能。” 你尤其可以尝试使用 Operit AI 让 LLM 大模型在本地的 Ubuntu 环境中编写并运行代码（支持 C/C++, Python, Ruby, Go, Rust, JavaScritp 等多种主流编程语言），以实现编程教学、演示，或解决包含大量计算（利用 Numpy, Scipy 等库的支持）的复杂工程问题。

（注：文档部分内容可能由 AI 生成）

Assets 3
Loading