06 Dec 11:44

zz6zz666

c00010d

AstrBot 安卓 app v1.5.3 更新日志 Latest

Latest

新特性

✅ 支持两次返回手势/点按返回按钮回到桌面

Assets 4

06 Dec 02:27

zz6zz666

v1.5.2

87fce5d

AstrBot 安卓 app v1.5.2 更新日志

新特性

✅ 从设置页面 “更新或重装 NapcatQQ” 选项重新安装时，支持保留先前 napcat 登录配置，包括 快速登录 QQ 等

Assets 4

05 Dec 13:53

zz6zz666

v1.5.1

e12a852

AstrBot 安卓 app v1.5.1 更新日志

新特性

✅ 终端支持多标签页：用户可在终端页面自由创建、切换多个标签页，与内置 Ubuntu 环境交互
更新日志支持 Markdown 渲染

问题修复

✅ 修复 NapCat 安装后，首次不能自动启动的问题
✅ 修复镜像站更新时 URL 被重复拼接导致请求失败的问题
移除已失效的 App 更新下载镜像站
修复 AstrBot 终端日志溢出至顶部白色区域的问题，正确限制在终端标签页组件以下

其他更新

统一应用内部版本控制逻辑：更新检查、启动脚本拷贝等操作，版本号均由运行时动态确定

Assets 4

04 Dec 18:46

zz6zz666

v1.5.0

04851fd

v1.5.0

🚀 AstrBot Android v1.5.0 —— 更稳定 · 更智能 · 更易用

重构页面逻辑并新增大量实用功能，支持更广泛的安卓版本（Android 8–16），带来前所未有的兼容性、可控性与用户体验升级。

✅ 全面适配 Android 8–16
实测支持 Android 10+，完美运行于最新 Android 16 系统

💡 底层由 proot-distro 迁移至原生 proot 容器 启动，显著提升启动鲁棒性与安卓版本兼容性

🌐 核心体验升级

🔝 全新底部导航栏

支持快速切换：AstrBot WebUI、napcat 仪表盘（可选显示）、自定义 WebView 页面、终端日志、设置页
支持添加任意数量本地 WebUI 插件页面：
- 输入端口自动补全为 http://127.0.0.1:PORT
- 也支持完整 URL（如使用 https，外接服务）
新增「一键返回 AstrBot 主页并刷新」功能

🔐 QQ 自动登录增强

基于 napcat 自动登录机制，通过设置页面设定默认 QQ 账号
启动即自动登录，告别重复扫码
在设置中可查看登录 Token 并复制本地访问 URL（亦可在局域网通过 ip 地址访问）

🖼️ WebView 智能增强

✅ 支持选择并上传本地文件至 WebUI（例如 AstrBot 插件管理页面）
✅ 密钥自动保存 + 表单自动填充（避免重复输入密码）
✅ 一键清空缓存 & 已保存密码
✅ 禁用缩放、拦截非本地跳转（外部链接自动唤起系统浏览器，保障安全与可回溯）

⚙️ 运维与开发支持

📦 容器与环境管理

Ubuntu 文件系统直接挂载至 Android「文件」应用
- 用户可将其添加至 MT 文件管理器侧栏，实现快捷访问内部文件
- 新增入口：从设置页直接跳转“文件”应用查看容器内容
启动脚本支持版本感知升级
- 依据应用版本自动更新容器内启动脚本，同时保留用户自定义 git clone 命令（便于调试 fork 分支）

🔄 AstrBot 生命周期管理（全新运维套件）

✅ 一键更新/重装 AstrBot
- 清除旧组件 → 拉取最新 tag → 自动恢复备份 + 扫描安装插件依赖
✅ 一键更新/重装 napcat
- 快速更新 napcat 版本（需重新配置自动登录账号）
✅ 一键清除 AstrBot 数据
- 保留 AstrBot 框架，清除配置、插件等数据
- 重启后自动恢复最新备份，并重建 Python 环境
✅ 重置 Python 环境
- 保留 AstrBot 框架与用户配置、插件，清除现有 Python 环境
- 重启后重建 Python 环境，并扫描安装插件依赖
- 用于安装又删除大量插件导致的 Python 环境冗杂庞大
✅ 覆盖安装插件依赖
- 下次启动时遍历全部已安装插件，执行 uv pip install -r requirements.txt

💡也可通过文件管理器手动调整 Ubbuntu 容器中内容

🖥️ 终端日志体验优化

启动跳转时机精准对齐：
- 调整至 QQ 登录成功 + AstrBot WebUI 就绪 后，立即切换至主界面
- 避免适配器就绪前，插件加载导致跳转前等待时间太久
日志过滤策略同步 WebUI：
- 默认过滤非彩色文本（与 AstrBot 网页控制台日志输出保持一致）
- 可在设置中手动开启「显示终端纯文本日志」
界面交互优化：
- 禁用终端页交互式输入，防止输入法软键盘误弹出
- 启动前杂项输出自动清除，聚焦 AstrBot 核心日志流

🔔 系统集成与稳定性

🔔 通知保活强化

即使用户手动划掉或系统强制清除（如充电完成清理），通知栏将自动重建
新增「停止运行」按钮，一键终止应用服运行

🔋 后台续航保障

新增「电池豁免检查」入口
- 弹窗以便授予后台运行权限

🛡️ 应用级健壮性

全局禁用物理返回键 & 手势返回，防止误退出关键页面
设置页提供「退出应用」选项，优雅终止所有服务
隐私政策入口直达，符合 GDPR 与国内合规要求

📥 实用工具新增

🔄 内置更新中心

设置页支持「检查更新」→ 自动跳转浏览器下载
提供多镜像源选择：GitHub / GHfast / gitmirror 等镜像加速下载

💾 数据备份与恢复

一键备份 AstrBot 全量数据（配置、插件、token、日志等）至 Download/AstrBot/backup/
支持从该目录自动识别并恢复「最新一次备份」
- 包括插件依赖还原，真正做到“断点续用”（也可用于跨设备同步）

🕰️ 时区修复

彻底修复 AstrBot 服务端时差问题
同步系统时区，日志时间戳与定时任务更准确可靠

🔧 推荐运行环境

Android 8+（建议 10+）

AstrBot Android — 让你在移动设备上轻松部署、管理和使用基于 AstrBot + napcat 的自动化生态 QQ Bot。

✅ 总结改进亮点

本次更新重点强化了：

系统兼容性与稳定性（proot 启动重构 + 启动时机优化）
用户自主控制力（文件访问、生命周期管理、备份恢复）
开发者友好性（自定义 git、插件依赖全覆盖）
长期运行可靠性（通知保活、电池豁免、时区同步）

我们致力于打造一个 开箱即用、持久稳定、易于维护 的移动端 Bot 运行平台。欢迎提出建议，共同推进开源生态发展！

Assets 4

14 Nov 17:52

zz6zz666

v1.2.0

11fe960

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

🌟 版本核心亮点

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

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

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

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

📋 环境要求

建议 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 终端输出，请立即重置并重新初始化。）

登录与配置流程

启动后，应用将请求通知权限，必须允许（否则无法后台持续运行）。
NapCatQQ 与 AstrBot 同步启动，出现 NapCatQQ 登录二维码。
✨ 体验优化：扫码时可自由切换后台（如截图、打开 QQ 扫码），切换回应用后 WebView 监听正常生效，可顺利进入后续页面。
使用移动端 QQ 扫码登录，登录成功后二维码弹窗自动消失。
AstrBot 启动成功后，通知栏将显示 “正在运行” 常驻通知（禁止手动关闭，关闭将导致后台运行终止）。
进入控制台页面，默认用户名 / 密码均为 astrbot，请及时修改密码。
控制台 “机器人” 栏中，pre-config 为内置通信接口，禁止修改或删除。
前往配置页面填写 LLM 大模型 token（详情参考 A strBo t 文档）。

📌 核心特性

一键启动：无需复杂配置，点击即可启动 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 版本）

下一版本功能

优化 WebView 显示：AstrBot 仪表盘页面将恢复显示状态栏，提升操作体验。
更改容器工具，弃用proot-distro，以提升安卓系统版本兼容性 紧急。
修复 napcat QQ 的强制重复扫码登录逻辑。
修复内置 webview 中 AstrBot 控制台日志不更新的问题。（当前用户如需获取应用日志，请在手机浏览器访问 AstrBot 仪表盘中的控制台 http://localhost:6185 ）
考虑将应用内部存储挂载至文件访问应用，以便用户调试。

🙏 致谢

感谢 Cod e LFA 提供的 Android 端 Ubuntu 容器环境，A strBo t 团队的聊天机器人框架，以及 napca tQQ 团队的 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

14 Nov 12:28

zz6zz666

v1.1.0

13e1c65

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