編輯點評：手機一鍵部署QQAI機器人，泡泡版無需電腦服務器接入各類大模型
AstrBot泡泡版是下载輕量化安卓QQAI機器人應用，專門解決傳統機器人需要電腦、泡泡版複雜代碼部署的下载難題，基於成熟AstrBot開源框架打造，泡泡版整合NapCatQQ適配協議，下载在手機容器內完整運行機器人服務，泡泡版支持個人QQ私聊智能應答、下载群聊多人互動，泡泡版可自由接入市麵上主流大語言模型，下载海量社區插件一鍵安裝拓展群管理、泡泡版問答、下载生成等功能，泡泡版全程可視化操作，下载不用專業技術知識，泡泡版普通用戶安裝完成後簡單配置就能擁有專屬AIQQ機器人。
登錄及配置流程
1、允許通知權限
啟動後 App 會請求通知權限，必須點擊“允許”。
若拒絕，機器人將無法在後台持續運行。
2、添加NapCat賬號
可指定監聽端口，可留空自動分配
啟動賬號，等待二維碼彈出
3、掃碼登錄QQ賬號
使用你手機上的 QQ 掃碼登錄。
體驗優化：掃碼時可自由切換後台（如截圖、切換到 QQ 掃碼），返回 App 後仍能正常進入控製台。
4、啟動AstrBot
主頁點擊啟動AstrBot
5、查看通知欄狀態
成功運行後，通知欄將顯示“正在運行”常駐通知。
禁止手動清除該通知，否則服務將終止。
6、首次登錄控製台
默認用戶名和密碼均為：astrbot
登錄後請按提示立即修改密碼，確保賬戶安全。
7、保留預設通信接口
在“機器人” → “通信接口”中，pre-config 是內置的 NapCatQQ 連接通道。
請勿修改或刪除此接口，否則機器人將無法與 QQ 通信。
8、填寫大模型 API 密鑰
前往模型提供商頁麵，新增並填入你的模型服務商提供的 Token（API Key）。
這是你唯一需要動手配置的地方，請自行搜索，或參考 AstrBot 官方文檔的 “接入大模型服務” 頁麵。
支持 OpenAI、Anthropic、Ollama、智譜、DeepSeek、Dify 等平台。
配置完成後保存並重啟機器人即可。
AstrBot泡泡版初始化失敗怎麽辦
1、首次啟動環境安裝
主頁->環境管理 依次安裝“基礎命令”、“uv”、“NapCat”、“AstrBot”
安裝完成，點擊刷新，圖標右下顯示綠色勾則安裝成功
2、強烈建議人工監視終端輸出
雖然過程自動化並可後台自動運行，但我們強烈建議你在首次啟動時切入終端日誌頁麵，持續觀察安裝進度。
這樣可以第一時間發現網絡阻塞、下載失敗等問題，避免長時間等待無果。
3、napcat 安裝可能耗時較長且易失敗
特別是 napcat 組件（負責 AstrBot 與 QQ 協議通信），其安裝時間較長，且對網絡穩定性要求高。
若發現卡住或報錯，可直接關閉 App 再次啟動，係統會從中斷處繼續安裝。
4、安裝中斷可自動恢複
新增穩健性優化：AstrBot 的代碼倉庫克隆已改為“原子操作”，避免因網絡中斷導致文件損壞。
初始化失敗後重啟，大部分情況下係統將自動恢複進程，大幅降低安裝損壞風險。
5、極端情況處理方式
若多次重啟仍無法完成初始化，可能是係統包損壞。
此時需進入手機設置 → 應用管理 → 找到 AstrBot App → 清除應用數據 → 重新啟動。
6、特例警告
終端輸出顯示正在安裝係統軟件包（而非 uv, napcat 等資源下載）時，請務必避免操作中斷！！
若終端出現如下提示：
dpkg was interrupted, you must manually run 'dpkg --configure -a' to correct the problem， 這表明係統軟件包配置中斷。雖然你可以按提示嚐試修複，但我們建議你： 立即清除應用數據並重新初始化。
關於前台與息屏運行的說明
首次初始化期間：雖然理論上支持息屏、切換後台，但強烈建議保持屏幕常亮並人工監視日誌輸出，以便快速排查問題。
初始化完成後：機器人可穩定在後台運行，息屏、切換 App 均不影響服務，隻要保證通知欄常駐通知不被關閉即可。
機器人頻繁離線掉線怎麽解決
1、將AstrBot泡泡版加入手機電池白名單，關閉係統自動休眠、後台清理限製。
2、開啟應用前台常駐通知功能，維持係統前台進程避免被殺。
3、更換網絡環境，使用穩定WiFi或流量，減少網絡波動造成的連接中斷。
適用人群及場景
1、普通QQ用戶，想要低成本打造專屬AI聊天機器人，實現私聊、群聊智能自動回複。
2、社群運營人員，利用機器人實現群問答、自動管理、定時推送內容，減輕人工維護壓力。
3、AI愛好者，想要在手機端便捷測試各類大語言模型，體驗本地化QQ機器人交互效果。
4、零基礎用戶，無電腦與編程基礎，需要簡單易上手的移動端機器人部署工具。
更新日誌
0.1.0更新
修複bot接收圖片報錯rkey異常、400問題。舊版本需要更新最新版APP，到環境管理下載最新腳本，重裝napcat並勾選”同時重裝QQ“。新用戶直接正常安裝即可
修複大部分情況wifi網絡安裝環境報403問題，如果還是遇到請更換為流量
獨立安裝腳本，從腳本倉庫拉取最新安裝腳本。防止更新腳本需要更新APP
修複在webui界麵點返回會回到桌麵的bug，當前為回到網頁的上一頁
優化一些界麵交互邏輯和顯示效果