控制台、懸浮窗與熒幕保護

Android 宿主把「控制」和「顯示」分開了：控制台負責配置，懸浮窗負責隨手操作，熒幕保護負責在不看熒幕時省電與防燒屏。

頁面

設定頁：外觀、下載源、權限、保活與熒幕保護開關。截圖來自 Android 倉庫。

頁面	內容
主頁	Runtime 狀態、部署進度、啟動/停止、遠程綁定入口
掛機	虛擬熒幕畫面、實例選擇、任務開始/停止
控制台	內嵌 WebUI（與桌面版同一前端）
日誌	宿主 / Runtime / 特權服務三路日誌
設定	外觀、下載源、運行與安全、保活、熒幕保護、關於

主頁右上角的綁定按鈕可以直接進入遠程 AP 配對，不需要先部署本機 Runtime。

懸浮窗

基於 FloatingX 的全局浮窗，在任意應用或桌面之上可用：

操作	效果
單擊	展開/收起面板
啟動 / 停止	控制當前實例
隊列	查看調度隊列與當前任務
切換實例	在多實例間切換目標
日誌	實時滾動最近的運行日誌

懸浮窗是獨立 Window，讀不到 Activity 的 Configuration 或 ViewModelStore。它通過 AppThemeState 與 OverlayController 獲取狀態，所以主題切換後浮窗會跟着變，但不會共享頁面的臨時狀態。

懸浮窗不顯示

檢查「懸浮窗」權限是否授予。部分廠商 ROM 還有單獨的「後台彈出介面」開關。

熒幕保護（防燒屏）

後台掛機時熒幕長期點亮，OLED 設備有燒屏風險。熒幕保護提供：

行為	參數
背景	黑色低亮度
進入方式	手動開啟，或任務啟動時自動進入
漂移	無操作 30 秒後，每 10 秒上下移動 16dp
退出	向右拖動解鎖條到末端並鬆手

漂移是週期性小幅位移，不會影響遊戲畫面（熒幕保護覆蓋在虛擬熒幕之上，遊戲仍在後台運行）。LCD 設備同樣可用，只是收益不如 OLED 明顯。

桌面小組件

支援 Glance / RemoteViews 小組件，可顯示運行狀態並快速啟停。

部分舊版廠商系統不能可靠解析 ?attr 矢量着色與 cornerRadius，因此小組件使用顯式 drawable 資源，不依賴主題屬性。

保活

後台掛機最大的敵人是系統省電策略。宿主提供三層：

1. 前台服務：Runtime 或虛擬熒幕活躍時保進程，通知欄常駐。
2. 多路徑保活：KeepAliveManager 按設定啟用多條路徑，可重複啟停，設定開關是最終裁決。
3. 電池優化白名單：需要你手動授權。

建議同時設定：

• 系統設定 → 電池 → 應用 → AzurPilot → 不受限制。
• 廠商的「自啟動」「後台運行」白名單。
• 關閉「省電模式」對後台的限制。

保活不是萬能的

部分 ROM 會在極端省電或記憶體壓力下強殺進程。這時任務會中斷，Runtime 需要重新啟動。把日誌匯出後能看出是被系統殺死還是自身崩潰。

日誌

三路日誌分開歸檔：

日誌	位置	內容
宿主日誌	應用私有目錄	Compose、網關、部署、更新
Runtime 日誌	proot/session.log + 上游 log/	調度器與業務
特權啟動鏈	獨立時間線	ADB 啟動、Binder 回投、虛擬熒幕

特性：

• 異常時自動儲存當前畫面快照。
• 預設 7 天輪轉，過期清理。
• 一鍵打包匯出為 zip。

匯出前確認壓縮包裏沒有 config/deploy.yaml、password.txt、remote-access.json。這些檔案在 Runtime 的 config/ 下，匯出日誌時不會自動包含，但手動打包整個目錄時會。

設定項速查

分組	內容
外觀	Material / Miuix、明暗模式、動態取色
下載	CNB / GitHub 直連 / 鏡像 / 自定義前綴
運行與安全	內置 Shizuku、Root、外部服務、啟用狀態
保活	前台服務、電池優化引導
熒幕保護	自動進入、亮度、漂移
OCR	加速後端、執行緒數、失敗回退
關於	版本、提交、開源許可

常見問題

現象	原因
浮窗點擊無反應	懸浮窗權限被回收，或省電策略限制後台
熒幕保護不漂移	系統關閉了動畫（開發者選項），或處於省電模式
小組件顯示舊狀態	啟動器快取，重新添加小組件
息屏後任務停止	電池優化未放行
日誌匯出為空	日誌已輪轉清理，或匯出目錄無權限