chore: snapshot backup before rainycy push (20260624-032434)

Auto-committed by MiMo for migration to git.rainycy.top
Update README.md
2026-06-24 03:26:25 +08:00 · 2026-06-13 12:43:11 +08:00 · 2026-06-13 12:29:18 +08:00 · 2026-06-07 16:27:12 +08:00 · 2026-06-02 00:42:04 +08:00 · 2026-05-29 08:40:20 +08:00
14 changed files with 7316 additions and 1938 deletions
--- a/.codegraph/.gitignore
+++ b/.codegraph/.gitignore
@@ -0,0 +1,16 @@
+# CodeGraph data files
+# These are local to each machine and should not be committed
+
+# Database
+*.db
+*.db-wal
+*.db-shm
+
+# Cache
+cache/
+
+# Logs
+*.log
+
+# Hook markers
+.dirty
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,9 @@
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
--- a/README.md
+++ b/README.md
@@ -1,124 +1,445 @@
 # Backup_script 數據備份腳本
-[![Stars](https://img.shields.io/github/stars/YAWAsau/backup_script?label=stars)](https://github.com/YAWAsau)
-[![Download](https://img.shields.io/github/downloads/YAWAsau/backup_script/total)](https://github.com/YAWAsau/backup_script/releases)
-[![Release](https://img.shields.io/github/v/release/YAWAsau/backup_script?label=release)](https://github.com/YAWAsau/backup_script/releases/latest)
-[![License](https://img.shields.io/github/license/YAWAsau/backup_script?label=License)](https://choosealicense.com/licenses/gpl-3.0)
-[![Channel](https://img.shields.io/badge/Follow-Telegram-blue.svg?logo=telegram)](https://t.me/yawasau_script)

-## 概述
+<p align="center">
+  <a href="https://github.com/YAWAsau/backup_script/stargazers"><img src="https://img.shields.io/github/stars/YAWAsau/backup_script?label=stars&style=flat-square" /></a>
+  <a href="https://github.com/YAWAsau/backup_script/releases"><img src="https://img.shields.io/github/downloads/YAWAsau/backup_script/total?style=flat-square" /></a>
+  <a href="https://github.com/YAWAsau/backup_script/releases/latest"><img src="https://img.shields.io/github/v/release/YAWAsau/backup_script?label=release&style=flat-square" /></a>
+  <a href="https://choosealicense.com/licenses/gpl-3.0"><img src="https://img.shields.io/github/license/YAWAsau/backup_script?label=License&style=flat-square" /></a>
+  <a href="https://t.me/yawasau_script"><img src="https://img.shields.io/badge/Follow-Telegram-blue.svg?logo=telegram&style=flat-square" /></a>
+</p>

-創作該腳本是為了使用戶能夠更加完整地**備份/恢復**應用數據，
-支援設備必須符合以下條件：`Android 8+`+`arm64`。
+---

-由於本人是台灣人所以發布的版本為繁體版
-(CN系統將自動翻譯自身腳本為簡體中文）
+## 📖 概述

+一款專為 Android 設計的完整應用數據備份／恢復 Shell 腳本,支援 SSAID、運行時權限、OBB 數據包、WiFi 設定等完整備份,讓你換機換系統後能無縫還原所有應用狀態。

-## 優勢
+新版增加**完整的遠端備份系統**,支援 WebDAV / SMB 上傳到 NAS / 雲端 / 區網電腦,並可從遠端下載備份回手機直接恢復。支援**流式備份模式**,邊壓縮邊傳輸,數據完全不佔用本機空間。

- 數據完整：在更換系統之後，原有的數據全部保留，無需重新登陸或者下載額外數據包。
- 支援備份SSAID 可完美備份LINE
- 支援備份應用權限 可備份運行時權限與ops權限
- 易操作：簡單几步即可備份應用完整數據！
- 限制少：不限制機型，可跨安桌版本。
- 功能強：可備份恢復`split apk`。
- 算法多：目前支持的壓縮算法有 `tar(默認)`
- `zstd`。
- 速度快：即使使用`zstd`壓縮算法速率依舊快速（對比鈦備份 swift backup）。
- 腳本自帶tools完整性效驗與壓縮包效驗
-## 如何使用
-`請認真閱讀以下說明，以減少不必要的問題`
+> 作者為台灣人,預設發布繁體版本。CN 系統環境下腳本將自動翻譯為簡體中文。

-##### 推薦工具：[`MT管理器`](https://www.coolapk.com/apk/bin.mt.plus)，若使用`Termux`，則請勿使用`tsu`。
+**系統需求:** `Android 8+` · `arm64 架構` · `Root 權限(Magisk / KernelSU)`

-#### !!!以下操作皆須ROOT!!! ####
+---

-1. 首先將下載到的腳本解壓到任意目錄後，可以看到以下目錄結構 警告! 不論備份或是恢復都必須保證tools的存在與完整性 否則腳本失效或是二進制調用失敗。
+## ✨ 功能特色
+
+| 功能 | 說明 |
+|------|------|
+| 📦 完整數據備份 | 換機換系統後原有數據完整保留,無需重新登入或下載額外數據包 |
+| 🔑 SSAID 備份 | 支援 SSAID 備份,可完美備份 LINE 等依賴設備識別碼的應用 |
+| 🛡️ 權限備份 | 支援備份運行時權限(Runtime Permission)與 ops 權限 |
+| 📂 Split APK | 支援備份與恢復 Split APK 格式 |
+| 🎮 OBB 數據包 | 可選備份外部 OBB 數據(如原神、王者榮耀等大型遊戲) |
+| 📡 WiFi 備份 | 支援備份與恢復 WiFi 設定 |
+| 📁 自定義資料夾備份 | 可備份 DCIM、Download、Music 等任意自定義目錄 |
+| 🗜️ 多種壓縮算法 | 支援 `tar`(僅打包)與 `zstd`(高壓縮率高速度) |
+| ⚡ 高速壓縮 | zstd 壓縮速率快速,優於鈦備份、Swift Backup |
+| 🔒 完整性校驗 | 內建 tools SHA-256 校驗與壓縮包完整性驗證 |
+| 🔄 增量備份 | 多維度比對(版本/大小/權限/SSAID),無變化則跳過 |
+| ✅ 最終計數核驗 | 備份結束後逐檔核對存在性,三態顯示結果 |
+| 🖥️ 後台執行 | 支援後台執行模式,可完全關閉終端,log 持續刷新 |
+| 💡 偽裝亮屏 | 備份/恢復期間可偽裝亮屏,避免 IO 因息屏降速 |
+| 🌐 自動更新 | 聯網偵測最新版本,支援 CDN 節點(適合中國大陸用戶) |
+| 🌏 多語言 | 自動識別系統語言環境,支援繁體中文/簡體中文自動切換 |
+| 👥 多用戶支援 | 支援多用戶環境(user 0、999 等),可手動或自動選擇用戶 |
+| ⬛ 黑名單模式 | 黑名單應用可選「完全忽略」或「僅備份安裝包」 |
+| ⬜ 白名單支援 | 支援預裝應用白名單與系統應用白名單,可指定備份範圍 |
+| 📱 進程偵測 | 可設定忽略正在運行中的應用,避免備份數據不一致 |
+| ☁️ 遠程備份上傳 | 支援 WebDAV / SMB 兩種協議,備份完成自動上傳,智能增量 |
+| 🚀 流式備份 | 邊壓縮邊傳輸,數據不落本機,節省本地空間 |
+| 📥 遠程下載恢復 | 可從遠端直接下載備份回手機,點 start.sh 即可恢復 |
+| 🔍 區網掃描 | 自動掃描區網內所有 SMB 主機,免去手動找 IP |
+| 🧪 連線測試 | 三層測試(TCP / 認證 / 路徑),設定不需備份就能驗證 |
+
+---
+
+## 🗂️ 主選單功能
+
+### 備份模式
+
+| 選項 | 功能 |
+|------|------|
+| 生成應用列表 | 掃描已安裝的第三方應用並生成 `appList.txt` |
+| 備份應用 | 根據列表與設定完整備份應用數據 |
+| 備份已更新應用 | 僅備份自上次備份以來有版本更新的應用 |
+| 備份自定義資料夾 | 備份 `backup_settings.conf` 內設定的自定義目錄 |
+| 備份 WiFi | 備份當前設備的 WiFi 設定 |
+| 測試遠端連線 | 驗證 WebDAV / SMB 設定,三層測試(TCP / 認證 / 路徑) |
+| 單獨上傳當前備份 | 上傳現有本地備份到遠端,不重新跑備份流程 |
+| 列出遠端備份 | 連線遠端、產生 `appList_network.txt` 讓你勾選要下載哪些 app |
+| 從遠端下載備份 | 依清單下載備份到本地,可直接執行恢復 |
+| 殺死運行中腳本 | 安全終止正在執行的備份腳本(整棵進程樹) |
+
+### 恢復模式
+
+| 選項 | 功能 |
+|------|------|
+| 重新生成應用列表 | 刷新恢復資料夾內的 `appList.txt` |
+| 恢復備份 | 根據列表完整恢復應用與數據 |
+| 僅恢復包含 SSAID 應用(含數據) | 只恢復有 SSAID 的應用及其完整數據 |
+| 僅恢復包含 SSAID 應用(不含數據) | 只套用 SSAID,不覆蓋現有數據 |
+| 恢復自定義資料夾 | 恢復備份的自定義目錄 |
+| 恢復 WiFi | 恢復已備份的 WiFi 設定 |
+| 壓縮檔完整性檢查 | 驗證備份壓縮包是否完整無損 |
+| 轉換文件夾名稱 | 將備份資料夾名稱格式轉換(用於跨版本相容) |
+| 殺死運行中腳本 | 安全終止正在執行的恢復腳本 |
+
+---
+
+## 📁 目錄結構

-`這是腳本結構與說明`
 ```
 backup_script.zip
 │
-├── tools
-│       ├── Device_List
-│       ├── bc
-│       ├── busybox
-│       ├── classes.dex
-│       ├── cmd             
-│       ├── jq                
-│       ├── find              
-│       ├── keycheck         
-│       ├── soc.json
-│       ├── tar
-│       ├── tools.sh
-│       ├── zip
-│       └── zstd
-├── backup_settings.conf         <--- 腳本默認行為設置
-└── start.sh          <--- 執行腳本
+├── tools/
+│   ├── busybox          # 核心工具集
+│   ├── zstd             # zstd 壓縮工具
+│   ├── tar              # tar 打包工具
+│   ├── curl             # 遠程傳輸工具 (WebDAV)
+│   ├── smbclient        # SMB 遠程傳輸
+│   ├── jq               # JSON 處理
+│   ├── find             # 文件搜索
+│   ├── keycheck         # 音量鍵監聽
+│   ├── cmd              # 系統指令橋接
+│   ├── classes.dex      # Java 功能擴展(詳見下方說明)
+│   ├── soc.json         # 處理器資料庫
+│   ├── Device_List      # 設備型號資料庫
+│   └── tools.sh         # 核心腳本
+│
+├── backup_settings.conf  # 備份行為設定檔
+└── start.sh              # 主執行腳本
 ```

-2. 然後執行`start.sh`腳本音量鍵選擇生成應用列表，等待腳本輸出提示結束，此時會在當前目錄生成一個`appList.txt`，這就是你當前安裝的所有第三方應用(腳本會屏蔽預裝應用，可於backup_settings.conf設置需要備份包名)。
+> ⚠️ **重要:** 無論備份或恢復,都必須確保 `tools/` 目錄完整存在,否則腳本將無法正常運作。

-3. 現在打開生成的`appList.txt`，根據裏面的提示操作後保存，這樣你就設置好了需要備份的軟件。
+備份完成後,每個 app 子目錄會額外生成 `backup.sh` / `recover.sh` / `upload.sh`,可單獨備份、恢復或上傳單一應用。

-4. 最後找到`backup_settings.conf`打開後根據提示設置保存，再打開`start.sh`，音量鍵選擇備份應用，備份結束完成後會在當前目錄生成一個以`Backup_壓縮算法名`命名的資料夾，裡面就是你的軟件備份。把這個資料夾整個保持到其他位置，刷完機后複製回手機，直接執行`Backup_壓縮算法名/start.sh`即可恢復備份的所有數據，同樣道理，裡面也有個`appList.txt`，使用方法跟第3步驟一樣，不需要還原的刪除即可，另外進去備份好的資料夾找到單獨應用資料夾有個 backup.sh and recover.sh可以單獨備份與恢復腳本。
+---

-5. 腳本執行過程中請留意紅色字眼提示有無任何錯誤，並且使用恢復腳本時留意恢復結束後是否提示應用存在ssaid，假設提示存在ssaid請在恢復後立刻重啟已便套用ssaid,假設恢復ssaid後立刻打開應用會導致ssaid套用失敗，因為Android會產生一個新的saaid，如此會導致應用卡白屏或是提示需要登錄，ssaid是判斷應用是否換過環境與設備的判斷之一，保持一致可以減少諸如提示異地登錄或是需要重新登入驗證的方法。
+## ⚙️ 設定檔說明(backup_settings.conf)

+| 設定項 | 說明 | 預設值 |
+|--------|------|--------|
+| `Lo` | 操作方式:`0` 音量鍵 / `1` 音量鍵(強制) / `2` 鍵盤輸入 | `0` |
+| `background_execution` | 後台執行:`1` 可關閉終端 / `0` 需保持終端開啟 | `0` |
+| `setDisplayPowerMode` | 備份期間偽裝亮屏防止 IO 降速 | `0` |
+| `Shell_LANG` | 語言:`0` 繁體中文 / `1` 簡體中文(留空自動偵測) | 自動 |
+| `Output_path` | 自定義備份輸出路徑(留空使用當前目錄) | 空 |
+| `list_location` | 自定義 appList.txt 位置(留空使用當前目錄) | 空 |
+| `update` | 自動更新:`1` 開啟 / `0` 關閉 | `1` |
+| `cdn` | 更新 CDN 節點:`0` 直連 / `1` ghfast.top / `2` workers.dev | `1` |
+| `mount_point` | 屏蔽外部掛載點,多個用 `\|` 分隔 | `rannki\|0000-1` |
+| `user` | 指定用戶 ID(留空自動選擇) | 空 |
+| `Backup_Mode` | 備份模式:`1` 應用+數據 / `0` 僅安裝包 | `1` |
+| `Backup_user_data` | 備份 user 數據:`1` 是 / `0` 否 | `1` |
+| `Backup_obb_data` | 備份 OBB 外部數據:`1` 是 / `0` 否 | `1` |
+| `backup_media` | 備份完成後一併備份自定義資料夾 | `0` |
+| `Background_apps_ignore` | 忽略正在運行中的應用:`1` 忽略 / `0` 備份 | `0` |
+| `Custom_path` | 自定義備份目錄列表(絕對路徑,每行一個) | DCIM / Download 等 |
+| `blacklist_mode` | 黑名單模式:`1` 完全忽略 / `0` 僅備份安裝包 | `0` |
+| `blacklist` | 黑名單應用包名列表 | 空 |
+| `whitelist` | 預裝應用白名單包名列表 | 小米系列預裝 |
+| `system` | 系統應用白名單包名列表 | Google 系列 |
+| `Compression_method` | 壓縮算法:`zstd` 或 `tar` | `zstd` |
+| `rgb_a` / `rgb_b` / `rgb_c` | 終端輸出主色/輔色1/輔色2(256 色代碼) | `220` / `51` / `213` |
+| `remote_type` | 遠程備份協議:`webdav` / `smb`(留空不啟用) | 空 |
+| `smb_url` | SMB 伺服器地址 | 空 |
+| `smb_remote_user` | SMB 認證用戶名 | 空 |
+| `smb_remote_pass` | SMB 認證密碼 | 空 |
+| `webdav_url` | WebDAV 伺服器地址 | 空 |
+| `webdav_remote_user` | WebDAV 認證用戶名 | 空 |
+| `webdav_remote_pass` | WebDAV 認證密碼 | 空 |
+| `remote_keep_local` | 上傳成功後本地檔案:`1` 保留 / `0` 刪除 | `0` |
+| `remote_stream` | 流式備份:`1` 開啟(邊壓邊傳,不佔本機) / `0` 關閉 | `0` |

- ##### 附加說明：如何恢復 以下是關於恢復資料夾內的文件說明?
+---

-1. 找到恢復資料夾內的appList.txt打開 編輯列表 保存退出
+## 🚀 使用方式

-2. 找到start.sh 給予root音量鍵選擇恢復備份後等待腳本結束即可
+> 推薦使用 [MT 管理器](https://www.coolapk.com/apk/bin.mt.plus) 執行腳本。若使用 Termux,請勿使用 `tsu`。

-3. start.sh的重新生成應用列表功能可用於刷新appList.txt內的列表 使用時機為當你刪除列表內的任何應用備份時,抑或者是恢復備份提示列表錯誤時
+### 備份流程

-4. start.sh的終止腳本功能用於突然想要終止腳本或是意外操作時使用 同理備份也有一個，因為腳本無須後台特性不能使用常規手段終結，故此另外寫了一個終止
+**Step 1 — 生成應用列表**

+解壓腳本後執行 `start.sh`,選擇「**生成應用列表**」。執行完畢後,當前目錄會生成 `appList.txt`。

-# 關於如何更新腳本？
- 目前有三種更新方法，有下列方式
- 1.手動將下載的備份腳本zip不解壓縮直接放到腳本任意目錄(不包括tools目錄內)的任意地方執行任何腳本即可更新，腳本將提示
- 2.此備份的任何腳本在執行時均會聯網檢測腳本版本，當更新時會自己提示與下載，根據腳本提示操作的即可(conf update=1時生效),腳本聯網僅作為檢查更新用途，無任何非法操作亦或是下發格機
- 3.將下載的壓縮包不解壓縮直接放在/storage/emulated/0/Download腳本自動檢測更新，並按照提示操作即可
- 4.在QQ群內下載的腳本不解壓縮腳本會自己檢測更新
+**Step 2 — 編輯應用列表**

-## 關於反饋
- 如果使用過程中出現問題，請攜帶截圖並詳細說明問題，建立 [issues](https://github.com/YAWAsau/backup_script/issues)。
- 酷安 @[落葉淒涼TEL](http://www.coolapk.com/u/2277637)
- QQ組 976613477 很少上 盡量來TG
- TG https://t.me/yawasau_script
+打開 `appList.txt`,根據需求調整:
+- 行首加 `#`:注釋掉該應用,不備份
+- 行首加 `!`:僅備份安裝包,不備份數據

-## 答疑
- 一個shell腳本內為什麼有dex?
- dex用來實現腳本難以實現的目的，目前saaid備份恢復，備份恢復運行時權限與ops權限，下載與訪問GitHub api來檢查腳本更新，列出使用者應用名稱與包名，繁體轉簡體均為dex的功能，感謝[Android-DataBackup](https://github.com/XayahSuSuSu/Android-DataBackup) by [XayahSuSuSu](https://github.com/XayahSuSuSu)
+**Step 3 — 設置備份選項**

-## 常見問題
+打開 `backup_settings.conf`,根據上方設定說明調整各選項後儲存。

-Q1：批量備份大量提示失敗怎麼辦？
-A1：退出腳本，刪除/data/backup_tools，再備份一次
+**Step 4 — 執行備份**

-Q2：批量恢復大量提示失敗怎麼辦？
-A2：退出腳本，按照上面同樣操作。 如果還是錯誤，請建立issues，我幫你排除錯誤
+執行 `start.sh`,選擇「**備份應用**」。備份完成後生成 `Backup_<壓縮算法>_<用戶ID>/` 資料夾。

-Q3：微信/QQ 能不能完美備份&恢復數據？
-A3：不能保證，有的人說不能有的人說能，所以備份會有提示。 建議用你信賴的備份軟件針對微信/QQ再備份一次，以防丟失重要數據
+---

-Q4：為什麼部分應用備份很久？ 例如王者榮耀、PUBG、原神、微信、QQ。
-A4：因為連同軟件數據包都給你備份了，例如原神數據包9GB+，當然久到裂開了，恢復也是同理，還要解壓縮數據包
+### 恢復流程

-Q5:腳本每次備份都是全新備份嗎？
-A5;腳本備份時會比對上次備份時的備份SIZE大小 如果有差異就備份,反之忽略備份節省時間
+**Step 1 — 編輯恢復列表**

-備份腳本耗費了我大量時間與精力 如果你覺得好用，可以捐贈XD
-.(https://paypal.me/YAWAsau?country.x=TW&locale.x=zh_TW))
+進入備份資料夾,打開 `appList.txt`,刪除或注釋不需要恢復的應用行。

+**Step 2 — 執行恢復**

-## 銘謝貢獻
- 臭批老k([kmou424](https://github.com/kmou424))：提供部分與驗證函數思路
- 屑老方([雄氏老方](http://www.coolapk.com/u/665894))：提供自動更新腳本方案
- 胖子老陳(雨季騷年)
- XayahSuSuSu([XayahSuSuSu](https://github.com/XayahSuSuSu))：提供App支持,dex支持
+執行備份資料夾內的 `start.sh`,選擇「**恢復備份**」,等待腳本完成。

-`文檔編輯：Petit-Abba, YuKongA`
+**Step 3 — 注意 SSAID**
+
+若恢復結束後提示應用存在 SSAID,請**立刻重啟**後再開啟應用。若先開啟應用,Android 會生成新的 SSAID,導致應用白屏或需要重新登入。
+
+> 💡 備份資料夾內每個應用子目錄都有獨立的 `backup.sh`、`recover.sh`、`upload.sh`,可單獨操作單一應用。
+
+---
+
+## ☁️ 遠程備份
+
+### 設定方式
+
+編輯 `backup_settings.conf`,SMB 與 WebDAV 地址分開設定,切換協議免重輸:
+
+```conf
+remote_type=smb
+
+smb_url=smb://192.168.1.100/Backup
+smb_remote_user=用戶名
+smb_remote_pass=密碼
+
+webdav_url=http://192.168.1.100:8080/dav/
+webdav_remote_user=用戶名
+webdav_remote_pass=密碼
+
+remote_keep_local=0
+remote_stream=0
+```
+
+| 協議 | 地址格式 | 適用場景 |
+|------|----------|---------|
+| SMB | `smb://192.168.1.100/share/` | Windows 共享 / Samba / NAS |
+| WebDAV | `http://192.168.1.100:8080/dav/` | NAS / Nextcloud / rclone serve |
+
+### 遠端目錄結構
+
+腳本在 `remote_url` 下自動建立 `Backup_<壓縮算法>_<用戶ID>/`,與本地結構完全鏡像:
+
+```
+smb://NAS/Backup/
+    Backup_zstd_0/
+        1DM+/
+        LINE/
+        Keep記事/
+        wifi/wifi.json
+        tools/
+        start.sh
+        restore_settings.conf
+        appList.txt
+        MT管理器.apk
+```
+
+不同用戶(0、999)自動分開到 `Backup_zstd_0/`、`Backup_zstd_999/`,互不衝突。
+
+### 特性
+
+- **智能增量** — 多維度比對(版本/大小/權限/SSAID),只上傳本次有變更的 app
+- **遠端預掃** — 單次連線取全部列表 + 批量下載 json,主循環零網路開銷
+- **流式備份** — `remote_stream=1` 邊壓縮邊傳輸,數據完全不佔本機空間
+- **最終核驗** — 備份結束後逐檔核對存在性,缺失檔案列出清單
+- **連線預檢** — 沒網路時 3 秒內判斷並停用上傳,不卡死腳本
+- **失敗保護** — 流式上傳失敗不更新遠端 json,確保下輪整體重備
+
+---
+
+### 流式備份模式
+
+`remote_stream=1` 啟用流式備份,數據直接 `tar | zstd | 傳輸`,本機不產生任何備份檔案:
+
+```conf
+remote_type=smb
+smb_url=smb://192.168.1.100/Backup
+smb_remote_user=用戶名
+smb_remote_pass=密碼
+remote_stream=1
+```
+
+> ⚠️ 流式模式為全量上傳(無本機校驗),建議搭配穩定的區網環境使用。
+
+---
+
+### 從遠端下載備份
+
+**Step 1** — 主選單選「**列出遠端備份**」,產生 `appList_network.txt`
+
+**Step 2** — 打開 `appList_network.txt`,用 `#` 註解掉不要下載的 app
+
+**Step 3** — 主選單選「**從遠端下載備份**」,下載完成後直接執行內附 `start.sh` 恢復
+
+---
+
+### 連線測試
+
+設定完 `backup_settings.conf` 後,主選單選「**測試遠端連線**」:
+
+```
+—————— TCP 連線測試 ——————
+目標: 192.168.1.100:445
+TCP 連線通過
+—————— 認證與列目錄測試 ——————
+SMB 認證通過, share 可存取
+全部測試通過, 可以開始備份
+```
+
+---
+
+## 🔄 腳本更新方式
+
+1. **ZIP 放置更新**:將下載的 `.zip` 不解壓,直接放到腳本任意目錄(`tools/` 除外),執行任何腳本即自動更新
+2. **聯網自動更新**:腳本執行時自動連線 GitHub API 檢查版本(需設置 `update=1`)
+3. **Download 目錄**:將 `.zip` 放置於 `/storage/emulated/0/Download/`,腳本自動偵測並更新
+4. **QQ 群下載**:從 QQ 群下載的腳本不解壓,直接放置後執行即可自動更新
+
+> 🔒 腳本聯網**僅用於檢查更新**,無任何資料收集或非法操作。
+
+---
+
+## ❓ 常見問題
+
+<details>
+<summary><b>Q1:批量備份/恢復大量提示失敗?</b></summary>
+
+退出腳本,刪除 `/data/backup_tools/` 目錄後重新執行。若問題持續,請建立 [Issue](https://github.com/YAWAsau/backup_script/issues) 並附上截圖與 log。
+</details>
+
+<details>
+<summary><b>Q2:微信/QQ 能完美備份恢復嗎?</b></summary>
+
+無法保證。建議同時使用其他你信賴的備份工具針對微信/QQ 額外備份,以防丟失重要數據。
+</details>
+
+<details>
+<summary><b>Q3:為什麼部分應用備份很久?</b></summary>
+
+腳本會一同備份應用的 OBB 數據包,例如原神數據包超過 9GB。可在 `backup_settings.conf` 設置 `Backup_obb_data=0` 跳過 OBB 備份。
+</details>
+
+<details>
+<summary><b>Q4:腳本每次都是全量備份嗎?</b></summary>
+
+否。腳本多維度比對上次備份(版本號/數據大小/權限/SSAID),無差異則跳過,節省時間與空間。
+</details>
+
+<details>
+<summary><b>Q5:為什麼腳本內包含 .dex 檔案?</b></summary>
+
+`classes.dex` 用於實現 Shell 腳本難以達成的功能:
+
+- SSAID 備份與恢復
+- 運行時權限(Runtime Permission)與 ops 權限批量備份恢復
+- GitHub API 更新版本檢查與下載
+- 應用名稱與包名查詢
+- 繁體中文 ↔ 簡體中文自動翻譯
+- 後台執行模式的推送通知
+
+感謝 [XayahSuSuSu](https://github.com/XayahSuSuSu) 的 [Android-DataBackup](https://github.com/XayahSuSuSu/Android-DataBackup) 提供 App 支持。
+</details>
+
+<details>
+<summary><b>Q6:息屏後備份速度變慢?</b></summary>
+
+這是 Android 內核的 IO 節能機制。建議在 `backup_settings.conf` 設置 `setDisplayPowerMode=1` 開啟偽裝亮屏,或備份期間保持螢幕常亮。
+</details>
+
+<details>
+<summary><b>Q7:如何單獨備份/恢復/上傳單一應用?</b></summary>
+
+進入備份資料夾內對應的應用子目錄,直接執行:
+- `backup.sh` — 單獨備份該 app
+- `recover.sh` — 單獨恢復該 app
+- `upload.sh` — 單獨上傳該 app 到遠端
+</details>
+
+<details>
+<summary><b>Q8:WebDAV 上傳顯示 HTTP 423 Locked?</b></summary>
+
+某些雲端網盤的 WebDAV 對大檔有大小限制。建議改用:
+- 自家 NAS / Windows SMB
+- rclone serve webdav
+- 群暉 / Nextcloud
+</details>
+
+<details>
+<summary><b>Q9:WebDAV 上傳顯示 HTTP 404?</b></summary>
+
+請檢查:
+- `webdav_url` 路徑是否含正確的 webdav 端點(例如 `/dav/` 或 `/remote.php/webdav/`)
+- 帳號是否有寫入權限
+</details>
+
+<details>
+<summary><b>Q10:SMB 提示「找不到 share」?</b></summary>
+
+- Windows 端確認 SMB 共享已開啟,且網路設成「私人」而非「公用」
+- 防火牆放行 445 port
+- 主選單啟動時的 `scan_smb` 會自動列出區網 SMB 主機與 share 名,可對照確認
+</details>
+
+<details>
+<summary><b>Q11:沒網路會影響備份嗎?</b></summary>
+
+不會。腳本啟動時做 TCP 預檢(3 秒內判斷),沒網路時自動停用遠端上傳但**完整保留本地備份**,流程繼續跑完。
+</details>
+
+<details>
+<summary><b>Q12:流式備份和一般備份有什麼差別?</b></summary>
+
+| | 一般備份 | 流式備份 |
+|---|---|---|
+| 本機空間佔用 | 先壓縮到本機再上傳 | 不佔用(直接傳輸) |
+| 增量比對 | ✅ 支援 | ✅ 支援 |
+| 本機完整性校驗 | ✅ 支援 | ❌ 不支援(信任傳輸) |
+| 適合場景 | 本機空間充足 | 本機空間有限 |
+</details>
+
+---
+
+## 📬 問題反饋
+
+遇到問題請攜帶截圖與 log 檔,透過以下方式反饋:
+
+- 🐛 [GitHub Issues](https://github.com/YAWAsau/backup_script/issues)
+- 💬 [Telegram 頻道](https://t.me/yawasau_script)
+- 🐧 QQ 群:`976613477`
+- 🧊 酷安:[@落葉淒涼TEL](http://www.coolapk.com/u/2277637)
+
+---
+
+## ☕ 支持作者
+
+備份腳本耗費了大量時間與精力,如果你覺得好用,歡迎贊助支持!
+
+[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square&logo=paypal)](https://paypal.me/YAWAsau?country.x=TW&locale.x=zh_TW)
+
+---
+
+## 🙏 銘謝貢獻
+
+| 貢獻者 | 貢獻內容 |
+|--------|----------|
+| [kmou424](https://github.com/kmou424)(臭批老k) | 提供部分驗證函數思路 |
+| [雄氏老方](http://www.coolapk.com/u/665894)(屑老方) | 提供自動更新腳本方案 |
+| [sakuradairong](https://github.com/sakuradairong)(雨季騷年/胖子老陳) | 新增 WebDAV / SMB 功能與測試 |
+| [XayahSuSuSu](https://github.com/XayahSuSuSu) | 提供 App 支持與 dex 功能支持 |
+
+`文檔編輯:Petit-Abba, YuKongA`
+
+---
+
+<p align="center">
+  <sub>GPL-3.0 Licensed · Made with ❤️ by <a href="https://github.com/YAWAsau">YAWAsau</a></sub>
+</p>
--- a/backup_settings.conf
+++ b/backup_settings.conf
@@ -4,13 +4,13 @@
 Lo=0

 #後台執行腳本
-0不能關閉當前終端，有壓縮速率
-1終端有可能完全無顯示，但是log會持續刷新，可直接完全關閉終端
+#0不能關閉當前終端，有壓縮速率
+#1終端有可能完全無顯示，但是log會持續刷新，可直接完全關閉終端
 background_execution=0

 #腳本語言設置 留空則自動識別系統語言環境並翻譯
 #1簡體中文 0繁體中文
-Shell_LANG=0
+Shell_LANG=

 #備份開始後偽裝亮屏
 #1開啟 0關閉
@@ -19,6 +19,12 @@ setDisplayPowerMode=0
 #自定義備份文件輸出位置 支持相對路徑(留空則默認當前路徑)
 Output_path=""

+#自定義備份目錄後綴(留空則不添加後綴)
+#支持日期時間變量：%yyyymmdd %hhmmss %yyyymmddhhmmss %yyyy %mm %dd
+#例：_daily  → Backup_zstd_0_daily
+#例：_%yyyymmdd  → Backup_zstd_0_20260522
+Backup_suffix=""
+
 #自定義applist.txt位置 支持相對路徑(留空則默認當前路徑)
 list_location=""

@@ -37,7 +43,7 @@ cdn=1
 mount_point="rannki|0000-1"

 #使用者(如0 999等用戶，如存在多個用戶留空強制選擇，無多個用戶則默認用戶0不詢問)
-user=
+user=0

 #備份模式
 #1包含數據+安裝包，0僅包安裝包
@@ -59,23 +65,19 @@ backup_media=0
 Background_apps_ignore=0

 #添加自定義備份路徑 例：Download DCIM等文件夾 請使用絕對路徑，請勿刪除""
-Custom_path="
-/storage/emulated/0/Pictures/
-/storage/emulated/0/Download/
-/storage/emulated/0/Music
-/storage/emulated/0/DCIM/
-#/data/adb
-"
+Custom_path=""

 #黑名單模式(1完全忽略，不備份  0僅備份安裝包，注意！此選項Backup_Mode=1時黑名單模式才能使用)
 blacklist_mode=0

 #備份黑名單（備份策略由「黑名單模式」控制，此處只作為黑名單應用列表）
 blacklist="
-com.esunbank
+com.facebook.orca
+com.facebook.katana
 com.instagram.barcelona
 com.instagram.android
-com.facebook.katana
+com.esunbank.ESUNWALLET
+com.esunbank
 #com.chailease.tw.app.android.ccfappcust"

 #位於data的預裝應用白名單 例：相冊 錄音機 天氣 計算器等(默認屏蔽備份預裝應用，如需備份請添加預裝應用白名單)
@@ -116,9 +118,56 @@ com.android.chrome"
 #zstd擁有良好的壓縮率與速度
 Compression_method=zstd

-#主色
-rgb_a=226
-#輔色
-rgb_b=123
-rgb_c=177
+#色彩設定 (256 色 ANSI 編號)
+#常用值: 39藍 51青 82綠 196紅 208橘 213粉 220黃 165紫
+#主色 (一般資訊, 預設亮黃)
+rgb_a=220
+#輔色1 (提示/進度, 預設亮青)
+rgb_b=51
+#輔色2 (強調/變數值, 預設粉紅)
+rgb_c=213
+
+#遠程備份類型 (留空不啟用)
+#推薦 webdav (穩定)
+#smb 支援 SMB2/SMB3 (本腳本拒絕 SMB1/CIFS, 會自動協商到伺服器支援的最高版本)
+remote_type=
+# 保存原始值, 供連線失敗後 (如中途開 WiFi) 重新檢測用
+_remote_type_orig=
+
+#遠程地址 (兩種協議分開設定, 切換 remote_type 免重輸)
+#SMB例:    smb://192.168.1.100/backup/
+smb_url=
+#認證用戶名
+smb_remote_user=
+#認證密碼
+smb_remote_pass=""
+#WebDAV例: http://192.168.1.100:8080/dav/
+webdav_url=
+#認證用戶名
+webdav_remote_user=
+#認證密碼
+webdav_remote_pass=""
+
+#流式上傳 (邊壓邊傳, 不佔本機空間)
+#1 開啟流式: 數據直接壓縮→管道傳到遠端, 本機不留 tar (省空間, 全量上傳, 不做本機校驗/增量)
+#0 關閉(預設): 先壓到本機→校驗→再上傳 (保留本機檔案, 支援增量)
+#支援 smb / webdav 兩種 remote_type
+remote_stream=0
+
+#流式上傳除錯 (1=失敗時印出 smbclient/curl 的具體錯誤, 用於排查流式失敗原因)
+_stream_debug=1
+
+#遠程備份完成後是否保留本地檔案
+#1保留本地檔案(上傳後不刪除) 0上傳成功後刪除本地檔案
+remote_keep_local=0
+
+#邊備份邊上傳 (每備份完一個應用立即上傳，然後刪除本機檔案再備份下一個，以節省本機空間)
+#1 開啟 0 關閉
+#開啟後：每個應用備份完成 → 立即上傳遠端 → 上傳成功後刪除本機檔案 → 繼續備份下一個
+#關閉後：先備份所有應用 → 全部備份完再統一上傳
+remote_upload_per_app=0
+
+#log 目錄大小上限 (單位 MB), 達到上限會在啟動時自動清空 log/
+#留空或設 0 = 關閉自動清理
+log_max_size_mb=1

--- a/docs/superpowers/plans/2026-05-09-remote-backup.md
+++ b/docs/superpowers/plans/2026-05-09-remote-backup.md
@@ -0,0 +1,246 @@
+# Remote Backup (WebDAV & SMB) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add WebDAV upload and SMB mount backup support to the backup script using built-in busybox tools.
+
+**Architecture:** Four config variables in `backup_settings.conf` control remote backup. Five new functions in `tools/tools.sh` handle SMB mount/unmount and WebDAV upload. A single hook in `backup_path()` triggers remote setup. The existing EXIT trap is extended to handle remote cleanup.
+
+**Tech Stack:** Shell script (Android mksh compatible), busybox (wget, mount, umount)
+
+---
+
+## File Structure
+
+| File | Action | Responsibility |
+|------|--------|---------------|
+| `backup_settings.conf` | Append | Remote backup configuration |
+| `tools/tools.sh` | Modify | Remote backup functions + hook + trap extension |
+
+---
+
+### Task 1: Add remote config to backup_settings.conf
+
+**Files:**
+- Modify: `backup_settings.conf`
+
+- [ ] **Step 1: Append remote backup configuration**
+
+Append after line 123 (`rgb_c=177`), before the trailing newline at line 124:
+
+```conf
+
+#遠程備份類型 (留空不啟用)
+#webdav 或 smb
+remote_type=
+
+#遠程地址
+#WebDAV例: http://192.168.1.100:8080/dav/
+#SMB例:    //192.168.1.100/backup
+remote_url=
+
+#遠程認證用戶名
+remote_user=
+
+#遠程認證密碼
+remote_pass=
+```
+
+Edit command: Use the Edit tool to append these lines after `rgb_c=177`.
+
+- [ ] **Step 2: Verify config file**
+
+Run: Read `backup_settings.conf` lines 120-140 to confirm the config lines are present.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add backup_settings.conf
+git commit -m "feat: add remote backup config (remote_type, remote_url, remote_user, remote_pass)"
+```
+
+---
+
+### Task 2: Add remote backup functions to tools.sh
+
+**Files:**
+- Modify: `tools/tools.sh` (insert after line 465, before `Show_boottime` at line 466)
+
+- [ ] **Step 1: Insert remote functions**
+
+Insert after line 465 (`kill_Serve` call) and before line 466 (`Show_boottime()`):
+
+```sh
+# -------- 遠程備份功能 --------
+mount_smb() {
+	local mnt="$TMPDIR/smb_mount"
+	mkdir -p "$mnt"
+	if busybox mount -t cifs "$remote_url" "$mnt" -o "username=$remote_user,password=$remote_pass,iocharset=utf8,vers=2.0" 2>/dev/null; then
+		SMB_MOUNT="$mnt"
+		[[ $(mount | grep "$mnt") != "" ]] || { echoRgb "SMB掛載失敗: $remote_url" "0"; return 1; }
+		echoRgb "SMB已掛載: $remote_url -> $mnt" "1"
+		return 0
+	fi
+	echoRgb "SMB掛載失敗，回退本地備份" "0"
+	return 1
+}
+
+umount_smb() {
+	[[ -n $SMB_MOUNT ]] && {
+		busybox umount -l "$SMB_MOUNT" 2>/dev/null
+		rm -rf "$SMB_MOUNT"
+		unset SMB_MOUNT
+		echoRgb "SMB已卸載" "2"
+	}
+}
+
+upload_webdav() {
+	local base_url="${remote_url%/}"
+	local auth=$(echo -n "$remote_user:$remote_pass" | busybox base64)
+	local failed=0
+	local list_file="$TMPDIR/.wdav_list"
+	find "$Backup" -type f > "$list_file"
+	while read -r f; do
+		[[ -z $f ]] && continue
+		local rel="${f#$Backup/}"
+		echoRgb "上傳: $rel" "2"
+		if busybox wget -q --method PUT --body-file="$f" --header "Authorization: Basic $auth" "$base_url/$rel" 2>/dev/null; then
+			rm -f "$f"
+		else
+			failed=1
+			break
+		fi
+	done < "$list_file"
+	rm -f "$list_file"
+	if [[ $failed -eq 0 ]]; then
+		echoRgb "WebDAV上傳完成" "1"
+	else
+		echoRgb "WebDAV上傳失敗，本地檔案已保留" "0"
+		return 1
+	fi
+}
+
+remote_setup() {
+	[[ -z $remote_type ]] && return
+
+	case $remote_type in
+	smb)
+		mount_smb || return
+		Backup="$SMB_MOUNT/Backup_${Compression_method}_$user"
+		mkdir -p "$Backup"
+		Backup_path="${Backup%/*}"
+		Output_path=""
+		echoRgb "遠程備份目錄: $Backup" "3"
+		;;
+	webdav)
+		echoRgb "WebDAV模式: 備份完成後將自動上傳" "3"
+		;;
+	esac
+}
+
+remote_cleanup() {
+	case $remote_type in
+	smb) umount_smb ;;
+	webdav) upload_webdav ;;
+	esac
+}
+```
+
+- [ ] **Step 2: Verify insertion**
+
+Run: Read `tools/tools.sh` lines 464-550 to confirm functions are inserted correctly and `Show_boottime()` follows.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add tools/tools.sh
+git commit -m "feat: add remote backup functions (mount_smb, umount_smb, upload_webdav, remote_setup, remote_cleanup)"
+```
+
+---
+
+### Task 3: Wire hook and trap
+
+**Files:**
+- Modify: `tools/tools.sh` (line 462 and line 991-993)
+
+- [ ] **Step 1: Modify EXIT trap in kill_Serve**
+
+Change line 462 from:
+```sh
+    trap "rm -rf '$LOCK_DIR'" EXIT
+```
+to:
+```sh
+    trap "rm -rf '$LOCK_DIR'; remote_cleanup" EXIT
+```
+
+- [ ] **Step 2: Add remote_setup call at end of backup_path()**
+
+Change line 991-993 from:
+```sh
+	echoRgb "$hx備份資料夾所使用分區統計如下↓\n -$(df -h "${Backup%/*}" | sed -n 's|% /.*|%|p' | awk '{print $(NF-3),$(NF-2),$(NF-1),$(NF)}' | awk 'END{print "總共:"$1"已用:"$2"剩餘:"$3"使用率:"$4}')檔案系統:$(df -T "$Backup_path" | sed -n 's|% /.*|%|p' | awk '{print $(NF-4)}')\n -備份目錄輸出位置↓\n -$Backup"
+	echoRgb "$outshow" "2"
+}
+```
+to:
+```sh
+	echoRgb "$hx備份資料夾所使用分區統計如下↓\n -$(df -h "${Backup%/*}" | sed -n 's|% /.*|%|p' | awk '{print $(NF-3),$(NF-2),$(NF-1),$(NF)}' | awk 'END{print "總共:"$1"已用:"$2"剩餘:"$3"使用率:"$4}')檔案系統:$(df -T "$Backup_path" | sed -n 's|% /.*|%|p' | awk '{print $(NF-4)}')\n -備份目錄輸出位置↓\n -$Backup"
+	echoRgb "$outshow" "2"
+	remote_setup
+}
+```
+
+- [ ] **Step 3: Verify EXIT trap**
+
+Run: Read `tools/tools.sh` line 462 to confirm the trap includes `remote_cleanup`.
+
+- [ ] **Step 4: Verify hook**
+
+Run: Read `tools/tools.sh` lines 989-994 to confirm `remote_setup` is inside `backup_path()` before the closing `}`.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add tools/tools.sh
+git commit -m "feat: wire remote backup hook and EXIT trap"
+```
+
+---
+
+### Task 4: Verify changes
+
+**Files:**
+- Check: `tools/tools.sh`, `backup_settings.conf`
+
+- [ ] **Step 1: Verify git diff**
+
+```bash
+git diff master
+```
+
+Expected: ~80 lines added across 2 files:
+- `backup_settings.conf`: +9 lines (remote config)
+- `tools/tools.sh`: +~70 lines (functions, trap modification, hook), 1 line modified (trap), 1 line added (hook call)
+
+- [ ] **Step 2: Verify no syntax errors in shell script**
+
+```bash
+bash -n tools/tools.sh
+```
+
+Ignore "not found" warnings for Android-specific tools — we're only checking syntax.
+
+- [ ] **Step 3: Verify function names don't collide**
+
+```bash
+Select-String -Pattern "^(mount_smb|umount_smb|upload_webdav|remote_setup|remote_cleanup)\b" -Path tools/tools.sh
+```
+
+Expected: Each function name appears once (definition only, not duplicated).
+
+- [ ] **Step 4: Commit any fixes if needed**
+
+```bash
+git add -A && git commit -m "fix: address verification issues"
+```
--- a/docs/superpowers/specs/2026-05-09-remote-backup-design.md
+++ b/docs/superpowers/specs/2026-05-09-remote-backup-design.md
@@ -0,0 +1,136 @@
+# Remote Backup (WebDAV & SMB) 设计文档
+
+**日期:** 2026-05-09  
+**目标:** 在不涉及大范围改动的前提下，为脚本增加备份到远程 WebDAV 和 SMB 的功能。
+
+---
+
+## 需求
+
+- 支持直接备份到远程 WebDAV 和 SMB 设备
+- 使用脚本内置 busybox，不依赖额外工具
+- 配置通过 `backup_settings.conf`
+- 最小化对现有代码的改动
+
+---
+
+## 架构
+
+### 配置
+
+在 `backup_settings.conf` 末尾追加 4 个配置项：
+
+```conf
+#远程备份类型 (留空不启用)
+#webdav 或 smb
+remote_type=
+
+#远程地址
+#WebDAV例: http://192.168.1.100:8080/dav/
+#SMB例:    //192.168.1.100/backup
+remote_url=
+
+#远程认证用户名
+remote_user=
+
+#远程认证密码
+remote_pass=
+```
+
+### 新增函数（tools/tools.sh）
+
+所有函数定义在 `tools/tools.sh` 中，靠近 `kill_Serve()` 之后的位置（~line 465）。
+
+| 函数 | 行数 | 说明 |
+|------|------|------|
+| `mount_smb()` | ~10 | busybox `mount -t cifs` 挂载 SMB 到 `$TMPDIR/smb_mount` |
+| `umount_smb()` | ~5 | 安全卸载 SMB 挂载点 |
+| `upload_webdav()` | ~20 | 遍历备份目录，用 busybox `wget --method PUT` 逐个上传 |
+| `remote_setup()` | ~25 | 入口函数：SMB 挂载后设置 Output_path；WebDAV 注册 trap |
+| `remote_cleanup()` | ~15 | SMB 卸载 / WebDAV 上传+清理本地文件 |
+
+### Hook 点
+
+在 `backup_path()` 调用之后（line 991 附近）插入一行：
+
+```sh
+remote_setup
+```
+
+### 流程
+
+```
+backup_path()      # 确定本地备份路径 $Backup
+       ↓
+remote_setup()     # 如启用远程，挂载 SMB 或准备 WebDAV uploader
+       ↓
+  [SMB]            [WebDAV]
+  mount_smb()      正常本地备份
+  $Backup → mount    ↓
+  正常备份         upload_webdav() (at EXIT)
+    ↓              rm -rf 本地副本
+  umount_smb()
+```
+
+### SMB 实现细节
+
+```sh
+mount_smb() {
+    local mnt="$TMPDIR/smb_mount"
+    mkdir -p "$mnt"
+    busybox mount -t cifs "$remote_url" "$mnt" -o "username=$remote_user,password=$remote_pass,iocharset=utf8"
+    # 若 busybox mount 不支持 cifs，尝试系统 mount
+    # 失败则返回非0，remote_setup 回退到本地备份
+}
+```
+
+挂载成功后，`remote_setup()` 将 `$Backup` 覆盖为 `$mnt/Backup_${Compression_method}_$user`，后续备份流程无需修改。
+
+### WebDAV 实现细节
+
+```sh
+upload_webdav() {
+    local base_url="${remote_url%/}"
+    # 创建远程目录 (MKCOL)
+    busybox wget -q --method MKCOL --header "Authorization: ..." "$base_url/..." 2>/dev/null
+    # 遍历上传
+    find "$Backup" -type f | while read f; do
+        busybox wget -q --method PUT --body-file="$f" --header "Authorization: ..." "$base_url/..."
+        # 上传成功才删除本地文件
+    done
+}
+```
+
+备份先写到本地（正常流程），EXIT 时 `remote_cleanup()` 触发上传，成功后删除本地副本。
+
+### 错误处理
+
+- SMB 挂载失败：回退到本地备份（echo 警告，继续执行）
+- WebDAV 上传失败：保留本地文件不删除（保留数据，用户手动排查）
+- SMB 连接断开：trap EXIT 确保 `umount_smb()` 被调用
+- 网络异常：wget 自带超时，不会永久阻塞
+
+### 恢复支持（后续迭代）
+
+本次仅实现备份到远程。恢复从远程可在后续 PR 中补充，方向是对称实现：
+- SMB：挂载后从挂载点恢复
+- WebDAV：wget 下载到临时目录后恢复
+
+---
+
+## 改动范围
+
+| 文件 | 改动 |
+|------|------|
+| `backup_settings.conf` | +9 行配置 |
+| `tools/tools.sh` | +75 行（5 个函数 + 1 个 hook 调用） |
+
+---
+
+## 测试要点
+
+1. SMB 挂载成功 → 备份文件出现在远程共享目录
+2. SMB 挂载失败 → 回退到本地备份，有警告提示
+3. WebDAV 上传成功 → 远程有备份文件，本地副本已清理
+4. WebDAV 上传失败 → 本地文件保留，有错误提示
+5. EXIT 时 SMB 挂载点被正确卸载（无残留）
--- a/start.sh
+++ b/start.sh
@@ -1,16 +1,12 @@
 #!/system/bin/sh
-if [ ! -f "${0%/*}/tools/tools.sh" ]; then
-	echo "${0%/*}/tools/tools.sh遺失"
-	exit 1
+if [ -f "${0%/*}/tools/tools.sh" ]; then
+    MODDIR="${0%/*}"
+    conf_path="${0%/*}/backup_settings.conf"
+    [ ! -f "${0%/*}/backup_settings.conf" ] && . "${0%/*}/tools/tools.sh"
+else
+    echo "${0%/*}/tools/tools.sh遺失"
 fi
-
-MODDIR="${0%/*}"
-conf_path="${0%/*}/backup_settings.conf"
-
-# 若配置文件不存在，啟動腳本自動生成默認配置後退出
-if [ ! -f "$conf_path" ]; then
-	. "${0%/*}/tools/tools.sh"
-	exit 0
-fi
-
-. "${0%/*}/tools/tools.sh" | tee "${0%/*}/log_$(date +%Y-%m-%d_%H-%M).txt"
+mkdir -p "${0%/*}/log" 2>/dev/null
+logfile="${0%/*}/log/log_$(date +%Y-%m-%d_%H-%M).txt"
+. "${0%/*}/tools/tools.sh" | tee "$logfile"
+sed -i "$(printf 's/\[[0-9;]*m//g')" "$logfile"
--- a/tools/Device_List
+++ b/tools/Device_List
@@ -158,6 +158,13 @@
 "2512BPNDAI" "Xiaomi 17 Ultra 印度版"
 "25128PNA1C" "Xiaomi 17 Ultra by Leica 國行版 (衛星通訊)"
 "25128PNA1G" "Leica Leitzphone powered by Xiaomi 國際版"
+"2605EPN8EC" "Xiaomi 17 Max"
+"M531DA" "Xiaomi 17T 國行版"
+"2602DPT53G" "Xiaomi 17T 國際版"
+"2602DPT53I" "Xiaomi 17T 印度版"
+"M025EC" "Xiaomi 17T Pro 國行版"
+"2602EPTC0G" "Xiaomi 17T Pro 國際版"
+"2602EPTC0R" "Xiaomi 17T Pro 日本版 (無鎖)"
 "2014616" "小米 Note 雙網通版"
 "2014619" "小米 Note 全網通版"
 "2014618" "小米 Note 移動合約版"
@@ -427,6 +434,7 @@
 "2508CRN2BI" "REDMI 15C 5G 印度版"
 "2508CRN2BR" "REDMI 15C 5G 日本版"
 "25082RNC1C" "REDMI 15R 5G"
+"2602BRNA4I" "REDMI 15A 5G 印度版"
 "2014018" "紅米 Note 聯通 3G 標準版"
 "2013121" "紅米 Note 聯通 3G 增強版"
 "2014017" "紅米 Note 移動 3G 標準版"
@@ -592,7 +600,7 @@
 "24117RN76E" "Redmi Note 14 歐洲版"
 "24117RN76L" "Redmi Note 14 拉美版"
 "24117RN76O" "Redmi Note 14 國際版 (NFC)"
-"24094RAD4C" "Redmi Note 14 5G 國行版"
+"24094RAD4C" "Redmi Note 14 5G 國行版 / REDMI Note 15R Pro 國行版"
 "24094RAD4I" "Redmi Note 14 5G 印度版 / Redmi Note 14 SE 5G 印度版"
 "24094RAD4G" "Redmi Note 14 5G 國際版"
 "2502FRA65G" "Redmi Note 14S 國際版"
@@ -611,6 +619,7 @@
 "25098RA98E" "REDMI Note 15 5G 歐洲版"
 "25098RA98I" "REDMI Note 15 5G 印度版"
 "25098RA98T" "REDMI Note 15 5G 沙特版"
+"26022PCACI" "REDMI Note 15 SE 5G 印度版"
 "25100RA69G" "REDMI Note 15 Pro 國際版"
 "25080RABDC" "REDMI Note 15 Pro 國行版"
 "25080RABDG" "REDMI Note 15 Pro 5G 國際版"
@@ -629,7 +638,8 @@
 "24069RA21C" "Redmi Turbo 3"
 "24129RT7CC" "REDMI Turbo 4"
 "25053RT47C" "REDMI Turbo 4 Pro"
-"2511FRT34C" "REDMI Turbo 5"
+"2511FRT34C" "REDMI Turbo 5 國行版"
+"2606FRT34I" "REDMI Turbo 5 印度版"
 "2602BRT18C" "REDMI Turbo 5 Max"
 "M1903F10A" "Redmi K20 全網通版"
 "M1903F10C" "Redmi K20 運營商全網通版"
@@ -672,6 +682,7 @@
 "2510DRK44C" "REDMI K90"
 "25102RKBEC" "REDMI K90 Pro Max"
 "25102RK69C" "REDMI K90 Pro Max 冠軍版"
+"2604FRK1EC" "REDMI K90 Max"
 "2016020" "紅米 Pro 標準版"
 "2016021" "紅米 Pro 高配版 / 尊享版"
 "M1803E6E" "紅米 S2 全網通版"
@@ -704,8 +715,14 @@
 "25028RN03Y" "REDMI A5 國際版"
 "25028RN03I" "REDMI A5 印度版"
 "25028RN03L" "REDMI A5 拉美版"
+"26020RNB4A" "REDMI A7 國際版"
+"26020RNB4I" "REDMI A7 印度版"
+"26020RNB4L" "REDMI A7 拉美版"
 "25128RN17Y" "REDMI A7 Pro 國際版"
+"25128RN17I" "REDMI A7 Pro 印度版"
 "25128RN17L" "REDMI A7 Pro 拉美版"
+"26020RN1AC" "REDMI R70 5G 國行版 / REDMI R70m 5G 國行版"
+"26020RN1AI" "REDMI A7 Pro 5G 印度版"
 "22081283C" "Redmi Pad 國行版"
 "22081283G" "Redmi Pad 國際版"
 "23073RPBFC" "Redmi Pad SE 國行版"
@@ -736,7 +753,13 @@
 "2509BRP2DC" "REDMI Pad 2 Pro 5G 國行版"
 "2509BRP2DG" "REDMI Pad 2 Pro 5G 國際版"
 "2509BRP2DI" "REDMI Pad 2 Pro 5G 印度版"
+"2603ARP14C" "REDMI Pad 2 SE 國行版"
+"2603ARP14G" "REDMI Pad 2 9.7 國際版"
+"2604ERP4DC" "REDMI Pad 2 SE 4G 國行版"
+"2604ERP4DG" "REDMI Pad 2 9.7 4G 國際版"
+"2604ERP4DI" "REDMI Pad 2 9.7 4G 印度版"
 "25079RPDCC" "REDMI K Pad"
+"26048RP6AC" "REDMI K Pad 2"
 "M1805E10A" "POCO F1"
 "M2004J11G" "POCO F2 Pro 國際版"
 "M2012K11AG" "POCO F3 國際版"
@@ -808,6 +831,8 @@
 "25062PC34E" "POCO M7 歐洲版"
 "24108PCE2I" "POCO M7 5G 印度版"
 "25057PC09I" "POCO M7 Plus 5G 印度版"
+"26067PC09G" "POCO M8s 5G 國際版"
+"26067PC09E" "POCO M8s 5G 歐洲版"
 "2409FPCC4G" "POCO M7 Pro 5G 國際版"
 "25118PC98G" "POCO M8 5G 國際版"
 "25118PC98I" "POCO M8 5G 印度版"
@@ -831,6 +856,10 @@
 "2410FPCC5G" "POCO C75 國際版"
 "2410FPCC5I" "POCO C75 印度版"
 "24116PCC1I" "POCO C75 5G 印度版"
+"25128PC17Y" "POCO C81 Pro 國際版"
+"25128PC17L" "POCO C81 Pro 拉美版"
+"25128PC17I" "POCO C81 印度版"
+"26020PCB4I" "POCO C81x 印度版"
 "25078PC3EG" "POCO C85 國際版"
 "25078PC3EE" "POCO C85 歐洲版"
 "2508CPC2BI" "POCO C85 5G 印度版"
@@ -839,9 +868,12 @@
 "24074PCD2I" "POCO Pad 5G 印度版"
 "25099RP08G" "POCO Pad X1 國際版"
 "2509ARPBDG" "POCO Pad M1 國際版"
+"2603APC14G" "POCO Pad C1 國際版"
 "FYJ01QP" "小米米家翻譯機"
 "21051191C" "CyberDog 仿生四足機器人"
-"2503CVPC6C" "Xiaomi YU7 後排移動控制屏"
+"2405AVPB7C" "小米澎湃智能座艙 (第一代 SU7/SU7 Ultra)"
+"25033VP3FC" "小米澎湃智能座艙 (YU7/新一代 SU7)"
+"2503CVPC6C" "小米汽車後排移動控制屏"
 "MI-ONE" "Mi 1 Lite"
 "2109119BC" "Xiaomi Civi China"
 "2109119BC" "Xiaomi Civi 1S China"
@@ -1502,6 +1534,7 @@
 "SCG34" "Galaxy Z Fold7 Japan (au)"
 "SC-56F" "Galaxy Z Fold7 Japan (NTT Docomo)"
 "SM-F968B" "Galaxy Z TriFold Global"
+"SM-F968U1" "Galaxy Z TriFold US Unlocked"
 "SM-F968N" "Galaxy Z TriFold South Korea"
 "SM-F700F" "Galaxy Z Flip Global"
 "SM-F700U" "Galaxy Z Flip US Carrier"
@@ -2593,8 +2626,13 @@
 "CPH2769" "一加 15R 歐洲版 / 國際版"
 "CPH2771" "一加 15R 北美版"
 "PLZ110" "一加 15T 國行版"
+"PMB110" "一加 Ace 6 至尊版 國行版"
 "PLU110" "一加 Turbo 6 國行版"
+"CPH2793" "一加 Nord 6 印度版"
+"CPH2795" "一加 Nord 6 國際版"
 "PLY110" "一加 Turbo 6V 國行版"
+"CPH2805" "一加 Nord CE 6 印度版"
+"CPH2807" "一加 Nord CE 6 國際版"
 "AC2001" "一加 Nord 印度版"
 "AC2003" "一加 Nord 歐洲版 / 國際版"
 "DN2101" "一加 Nord 2 印度版"
@@ -2620,6 +2658,7 @@
 "CPH2621" "一加 Nord CE 4 Lite 歐洲版 / 國際版"
 "CPH2717" "一加 Nord CE 5 印度版"
 "CPH2719" "一加 Nord CE 5 國際版"
+"CPH2943" "一加 Nord CE 6 Lite 印度版"
 "BE2025" "一加 Nord N10 Metro 版"
 "BE2026" "一加 Nord N10 北美版"
 "BE2029" "一加 Nord N10 歐洲版 / 國際版"
@@ -2649,6 +2688,8 @@
 "OPD2504" "一加平板 Go 2 Wi-Fi"
 "OPD2505" "一加平板 Go 2 5G"
 "OPD2508" "一加平板 2 (2025) 國行版"
+"OPD2513" "一加平板 3 Pro 國行版"
+"OPD2514" "一加平板 4 國際版"
 "W101IN" "一加 Band 印度版"
 "OPBBE221" "一加 Nord Watch"
 "W301CN" "一加手表 國行版 / Cyberpunk 2077 限定版"
@@ -2660,6 +2701,7 @@
 "OPWW251" "一加手表 3 國行版~"
 "OPWWE251" "一加手表 3 國際版"
 "OPWE242" "一加手表 3 43mm 國際版"
+"OPWWE261" "一加手表 4 國際版"
 "E6683" "Xperia Z5 dual"
 "E6883" "Xperia Z5 Premium"
 "F8332" "Xperia XZ"
@@ -2705,7 +2747,7 @@
 "RMX3310" "真我 GT2"
 "RMX3300" "真我 GT2 Pro"
 "RMX3551" "真我 GT2 大師探索版"
-"RMX3820" "真我 GT5 150W"
+"RMX3820" "真我 GT5"
 "RMX3823" "真我 GT5 240W"
 "RMX3888" "真我 GT5 Pro"
 "RMX3800" "真我 GT6"
@@ -2718,15 +2760,15 @@
 "RMX3350" "真我 GT Neo 閃速版"
 "RMX3370" "真我 GT Neo2 / 真我 GT Neo2 龍珠定制版"
 "RMX3357" "真我 GT Neo2T"
-"RMX3560" "真我 GT Neo3 80W"
+"RMX3560" "真我 GT Neo3"
 "RMX3562" "真我 GT Neo3 150W / 真我 GT Neo3 火影限定版"
-"RMX3706" "真我 GT Neo5 150W"
+"RMX3706" "真我 GT Neo5"
 "RMX3708" "真我 GT Neo5 240W"
 "RMX3700" "真我 GT Neo5 SE"
 "RMX3852" "真我 GT Neo6 / 真我 GT Neo6 《完美世界》動畫雲曦限定禮盒"
 "RMX3850" "真我 GT Neo6 SE"
 "RMX5060" "真我 Neo7 / 真我 Neo7 《畫江湖之不良人》限定禮盒"
-"RMX5062" "真我 Neo7 Turbo"
+"RMX5062" "真我 Neo7 Turbo / 真我 Neo7 Turbo AI版"
 "RMX5080" "真我 Neo7 SE"
 "RMX5071" "真我 Neo7x"
 "RMX8899" "真我 Neo8"
@@ -2821,9 +2863,9 @@
 "RMX3491" "realme 9i India / Global"
 "RMX3492" "realme 9i"
 "RMX3493" "realme 9i EU"
-"RMX3612" "realme 9i 5G"
 "RMX3388" "realme 9 5G India"
 "RMX3474" "realme 9 5G EU"
+"RMX3612" "realme 9i 5G"
 "RMX3471" "realme 9 Pro 5G India"
 "RMX3472" "realme 9 Pro 5G Global"
 "RMX3392" "realme 9 Pro+ 5G India"
@@ -2863,6 +2905,7 @@
 "RMX5171" "realme 16 5G"
 "RMX5120" "realme 16 Pro 5G"
 "RMX5131" "realme 16 Pro+ 5G"
+"RMX5268" "realme 16T 5G"
 "RMX1921" "realme XT Global"
 "RMX1922" "realme XT India"
 "RMX1992" "realme X2 India"
@@ -2932,8 +2975,11 @@
 "RMX5566" "realme C85"
 "RMX5253" "realme C85 5G"
 "RMX5555" "realme C85 Pro"
+"RMX5258" "realme C100 5G"
+"RMX5377" "realme C100i"
 "RMX3938" "realme Note 60x"
 "RMX5313" "realme Note 70 / realme Note 70T"
+"RMX5388" "realme Note 80"
 "RMX1833" "realme U1"
 "RMX3870" "realme P1 5G"
 "RMX3844" "realme P1 Pro 5G"
@@ -3087,8 +3133,10 @@
 "V2430A" "vivo S20 Pro"
 "V2464A" "vivo S30"
 "V2465A" "vivo S30 Pro mini"
-"V2528A" "vivo S50"
+"V2528A" "vivo S50 / vivo S50t"
 "V2527A" "vivo S50 Pro mini"
+"V2571A" "vivo S60"
+"V2572A" "vivo S60 元氣版"
 "V1901A" "vivo Y3 全網通版"
 "V1901T" "vivo Y3 移動全網通版"
 "V1930A" "vivo Y3 標準版 全網通版"
@@ -3132,8 +3180,9 @@
 "V2123A" "vivo Y53s (t2 版) 5G"
 "V2045A" "vivo Y54s 5G"
 "V2164A" "vivo Y55s 5G"
-"V2559A" "vivo Y60 5G"
+"V2559A" "vivo Y60 5G / vivo Y6t 5G"
 "V2559BA" "vivo Y60m 5G"
+"V2532BA" "vivo Y6m"
 "V1731CA" "vivo Y71s"
 "V2102A" "vivo Y71t 5G"
 "V2164PA" "vivo Y73t 5G"
@@ -3168,7 +3217,9 @@
 "V2452GA" "vivo Y300 GT"
 "V2506A" "vivo Y500"
 "V2516A" "vivo Y500 Pro"
-"V2531A" "vivo Y500i / vivo Y500s"
+"V2531A" "vivo Y500i / vivo Y500s / vivo Y6"
+"V2561A" "vivo Y600 Pro"
+"V2553A" "vivo Y600 Turbo"
 "V2115A" "vivo T1"
 "V2199GA" "vivo T2"
 "V2188A" "vivo T2x"
@@ -3213,6 +3264,7 @@
 "V2408A" "iQOO 13"
 "V2505A" "iQOO 15"
 "V2546A" "iQOO 15 Ultra"
+"V2564A" "iQOO 15T"
 "V1914A" "iQOO Neo 全網通版"
 "V1914T" "iQOO Neo 移動全網通版"
 "V1936A" "iQOO Neo 855 版 全網通版"
@@ -3334,6 +3386,7 @@
 "V2515" "vivo X300"
 "V2514" "vivo X300 Pro"
 "V2542" "vivo X300 FE"
+"V2562" "vivo X300 Ultra"
 "vivo 1819" "vivo V15"
 "vivo 1920" "vivo V17"
 "vivo 1907" "vivo V17 Neo"
@@ -3374,17 +3427,17 @@
 "V2418" "vivo V40 Lite 5G Indonesia"
 "V2337" "vivo V40 SE 5G"
 "V2451" "vivo V50"
-"V2504" "vivo V50 Pro"
 "V2428" "vivo V50e"
 "V2441" "vivo V50 Lite"
 "V2453" "vivo V50 Lite 5G"
 "V2512" "vivo V60"
-"V2530" "vivo V60 Lite"
+"V2549" "vivo V60 Lite"
 "V2529" "vivo V60 Lite 5G"
 "V2513" "vivo V60e"
 "V2540" "vivo V70"
 "V2548" "vivo V70 Elite"
 "V2558" "vivo V70 FE"
+"V2637" "vivo V70 Lite 5G"
 "vivo 1920_20" "vivo S1 Pro"
 "V2168" "vivo T1"
 "V2157" "vivo T1 5G"
@@ -3404,8 +3457,11 @@
 "V2509" "vivo T4 Lite 5G"
 "V2518" "vivo T4R 5G"
 "V2510" "vivo T4 Pro"
+"V2504" "vivo T4 Ultra"
 "V2568" "vivo T5 Pro"
 "V2545" "vivo T5x 5G"
+"V2603" "vivo T5 Lite 5G"
+"V2557" "vivo T5 Lite 44W 5G"
 "vivo 2015_21" "vivo Y1s"
 "V2044" "vivo Y3s"
 "vivo 1902" "vivo Y5"
@@ -3483,7 +3539,8 @@
 "V2036_21" "vivo Y31"
 "V2521" "vivo Y31 5G"
 "V2534" "vivo Y31 Pro 5G"
-"V2611" "vivo Y31d"
+"V2636" "vivo Y31d"
+"V2543" "vivo Y31d Pro"
 "V2533" "vivo Y31e 5G"
 "V2057" "vivo Y33"
 "V2109-EG" "vivo Y33A"
@@ -3496,7 +3553,7 @@
 "V2447" "vivo Y39 5G"
 "V2035" "vivo Y51"
 "V2031_21" "vivo Y51s"
-"V2544" "vivo Y51 Pro 5G"
+"V2613" "vivo Y51 Pro 5G"
 "V2053" "vivo Y52 5G"
 "V2058" "vivo Y53s"
 "V2154" "vivo Y55"
@@ -3566,12 +3623,19 @@
 "I2505" "iQOO Z10R 5G Global"
 "I2512" "iQOO Z11 5G"
 "I2507" "iQOO Z11x 5G"
+"I2510" "iQOO Z11 Lite 5G"
+"I2515" "iQOO Z11 Lite 44W 5G"
+"J2505" "JOVI X300 FE"
+"J2510" "JOVI X300 Ultra"
 "V2427" "JOVI V50"
 "V2440" "JOVI V50 Lite 5G"
+"J2507" "JOVI V70 5G"
 "V2454" "JOVI Y19s"
+"J2503" "JOVI Y21"
 "J2508" "JOVI Y21 5G"
 "V2445" "JOVI Y29"
 "V2459" "JOVI Y29s 5G"
+"J2506" "JOVI Y31"
 "V2444" "JOVI Y39 5G"
 "PAFM00" "OPPO Find X 標準版 全網通版"
 "PAFT00" "OPPO Find X 標準版 移動版"
@@ -3667,6 +3731,8 @@
 "PLW110" "OPPO Reno15"
 "PLV110" "OPPO Reno15 Pro"
 "PMD110" "OPPO Reno15c"
+"PMM110" "OPPO Reno16"
+"PMK110" "OPPO Reno16 Pro"
 "PCLM10" "OPPO Reno Ace"
 "PDHM00" "OPPO Ace2"
 "PACM00" "OPPO R15 全網通版"
@@ -3725,6 +3791,7 @@
 "PEHT00" "OPPO A93 移動版"
 "PFGM00" "OPPO A93s"
 "PELM00" "OPPO A95"
+"PFUM10" "OPPO A96"
 "PHA120" "OPPO A96"
 "PFTM10" "OPPO A97"
 "PHS110" "OPPO A1 5G (2023)"
@@ -3748,8 +3815,9 @@
 "PLN110" "OPPO A6 Pro"
 "PKW120" "OPPO A6i"
 "PLT120" "OPPO A6s / OPPO A6i+ / OPPO A6k"
+"PMT110" "OPPO A6s Pro"
 "PLT130" "OPPO A6v"
-"PLT140" "OPPO A6x"
+"PLT140" "OPPO A6x / OPPO A6m"
 "PMC110" "OPPO A6c"
 "PBCM30" "OPPO K1"
 "PCGM00" "OPPO K3 全網通版"
@@ -3772,6 +3840,8 @@
 "PLD110" "OPPO K12s"
 "PLM110" "OPPO K13 Turbo"
 "PLE110" "OPPO K13 Turbo Pro"
+"PMH110" "OPPO K15 Pro"
+"PMG110" "OPPO K15 Pro+"
 "OPD2101" "OPPO Pad"
 "OPD2102" "OPPO Pad Air"
 "OPD2201" "OPPO Pad 2"
@@ -3782,6 +3852,9 @@
 "OPD2417" "OPPO Pad SE"
 "OPD2506" "OPPO Pad 5"
 "OPD2501" "OPPO Pad Air5"
+"OPD2511" "OPPO Pad 5 Pro"
+"OPD2515" "OPPO Pad Mini"
+"OPD2601" "OPPO Pad 6"
 "OB19O1" "OPPO Band 運動版"
 "OB19O3" "OPPO Band 運動版 (國際版)"
 "OB19O7" "OPPO Band 活力版"
@@ -3810,6 +3883,7 @@
 "OWW251" "OPPO Watch X2"
 "OWW262" "OPPO Watch S"
 "OWW261" "OPPO Watch X3"
+"OWW263" "OPPO Watch X3 Mini"
 "CPH1875" "OPPO Find X"
 "CPH2023" "OPPO Find X2"
 "CPH2025" "OPPO Find X2 Pro"
@@ -3828,6 +3902,8 @@
 "CPH2797" "OPPO Find X9"
 "OPG07" "OPPO Find X9 (KDDI)"
 "CPH2791" "OPPO Find X9 Pro"
+"CPH2873" "OPPO Find X9s"
+"CPH2841" "OPPO Find X9 Ultra"
 "CPH2439" "OPPO Find N2"
 "CPH2437" "OPPO Find N2 Flip"
 "CPH2499" "OPPO Find N3"
@@ -3918,6 +3994,8 @@
 "CPH2781" "OPPO F31 5G"
 "CPH2763" "OPPO F31 Pro 5G"
 "CPH2757" "OPPO F31 Pro+ 5G"
+"CPH2777" "OPPO F33 5G"
+"CPH2835" "OPPO F33 Pro 5G"
 "CPH1835" "OPPO R15"
 "CPH1833" "OPPO R15 Pro"
 "CPH1879" "OPPO R17"
@@ -3951,8 +4029,10 @@
 "CPH2831" "OPPO A6 5G Global"
 "CPH2785" "OPPO A6 5G India"
 "CPH2799" "OPPO A6 Pro"
+"CPH2827" "OPPO A6 Pro 5G India"
 "CPH2815" "OPPO A6s"
-"CPH2789" "OPPO A6s 5G"
+"CPH2789" "OPPO A6s 5G Global"
+"CPH2889" "OPPO A6s 5G India"
 "CPH2819" "OPPO A6x"
 "CPH2783" "OPPO A6x 5G Global"
 "CPH2823" "OPPO A6x 5G India"
@@ -3960,6 +4040,7 @@
 "CPH2853" "OPPO A6t 5G"
 "CPH2849" "OPPO A6t Pro"
 "CPH2851" "OPPO A6t Pro 5G"
+"CPH2895" "OPPO A6c"
 "CPH1905" "OPPO A7"
 "CPH1903" "OPPO AX7"
 "CPH1938" "OPPO A9"
@@ -4028,6 +4109,8 @@
 "OPD2303" "OPPO Pad Neo LTE"
 "OPD2406" "OPPO Pad 3"
 "OPD2402" "OPPO Pad 3 Pro"
+"OPD2502" "OPPO Pad 5 Wi-Fi"
+"OPD2503" "OPPO Pad 5 5G"
 "OPD2419" "OPPO Pad SE Wi-Fi"
 "OPD2420" "OPPO Pad SE LTE"
 "OBBE215" "OPPO Band 2 Japan"
@@ -4037,3 +4120,6 @@
 "OW19W12" "OPPO Watch 46mm LTE"
 "OWWE231" "OPPO Watch X"
 "OWWE251" "OPPO Watch X2"
+"OWWE242" "OPPO Watch X2 Mini"
+"OWWE261" "OPPO Watch X3"
+"OWWE262" "OPPO Watch S"
--- a/tools/bc
+++ b/tools/bc
--- a/tools/classes.dex
+++ b/tools/classes.dex
--- a/tools/curl
+++ b/tools/curl
--- a/tools/smbclient
+++ b/tools/smbclient
--- a/tools/soc.json
+++ b/tools/soc.json
@@ -66,6 +66,7 @@
  "MSM8930AB": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ 400","MEMORY":"","CHANNELS":""},
  "SXR2230P": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ XR2 Gen 2","MEMORY":"","CHANNELS":""},
  "QCM6490": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ QCM6490","MEMORY":"","CHANNELS":""},
+  "sm-sip1": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ Sip 1","MEMORY":"","CHANNELS":""},
  "MSM8953": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ 625","MEMORY":"LPDDR3 933 MHz","CHANNELS":"single channel"},
  "SM4450": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ 4 Gen 2","MEMORY":"","CHANNELS":""},
  "SM4450A": {"VENDOR":"Qualcomm®","NAME":"Snapdragon™ 4 Gen 2 Accelerated Edition","MEMORY":"","CHANNELS":""},
@@ -346,6 +347,8 @@
  "MT6985": {"VENDOR":"MediaTek","NAME":"Dimensity 9200+","MEMORY":"LPDDR5X","CHANNELS":""},
  "MT6993W/CZA": {"VENDOR":"MediaTek","NAME":"Dimensity 9500","MEMORY":"","CHANNELS":""},
  "MT6993": {"VENDOR":"MediaTek","NAME":"Dimensity 9500","MEMORY":"","CHANNELS":""},
+  "MT6899Z_T/TZA": {"VENDOR":"MediaTek","NAME":"Dimensity 8550 SUPER","MEMORY":"","CHANNELS":""},
+  "MT6881V/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7500","MEMORY":"","CHANNELS":""},
  "MT6991Z/ECZB": {"VENDOR":"MediaTek","NAME":"Dimensity 9500s","MEMORY":"","CHANNELS":""},
  "MT6991Z/SCZB": {"VENDOR":"MediaTek","NAME":"Dimensity 9500s","MEMORY":"","CHANNELS":""},
  "MT6991Z/TCZB": {"VENDOR":"MediaTek","NAME":"Dimensity 9400+","MEMORY":"","CHANNELS":""},
@@ -447,8 +450,11 @@
  "MT6878V_H/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7360-Apex","MEMORY":"","CHANNELS":""},
  "MT6878V/FZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7300X","MEMORY":"","CHANNELS":""},
  "MT6878V_A/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7300-ENERGY","MEMORY":"","CHANNELS":""},
+  "MT6878V_I/TZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7400-SUPER","MEMORY":"","CHANNELS":""},
+  "MT6878V_I/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7360-SUPER","MEMORY":"","CHANNELS":""},
  "MT6878": {"VENDOR":"MediaTek","NAME":"Dimensity 7300 Ultra","MEMORY":"","CHANNELS":""},
  "MT6858V/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7100","MEMORY":"","CHANNELS":""},
+  "MT6858V_A/ZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7100 Ultimate","MEMORY":"","CHANNELS":""},
  "MT6858V/TZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7300e","MEMORY":"","CHANNELS":""},
  "MT6855V/ATZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7025","MEMORY":"","CHANNELS":""},
  "MT6855V_A/ATZA": {"VENDOR":"MediaTek","NAME":"Dimensity 7025 Ultra","MEMORY":"","CHANNELS":""},
@@ -543,7 +549,7 @@
  "MT6789": {"VENDOR":"MediaTek","NAME":"Helio G99","MEMORY":"","CHANNELS":""},
  "mt6789": {"VENDOR":"MediaTek","NAME":"Helio G99","MEMORY":"","CHANNELS":""},
  "mt5867": {"VENDOR":"MediaTek","NAME":"MT5867","MEMORY":"","CHANNELS":""},
-  "MT6769I": {"VENDOR":"MediaTek","NAME":"Helio G92","MEMORY":"","CHANNELS":""},
+  "MT6769I": {"VENDOR":"MediaTek","NAME":"Helio G92 Max","MEMORY":"","CHANNELS":""},
  "MT6769L": {"VENDOR":"MediaTek","NAME":"Helio G81 Extreme","MEMORY":"","CHANNELS":""},
  "MT6785": {"VENDOR":"MediaTek","NAME":"Helio G90 series","MEMORY":"LPDDR4x 2133MHz","CHANNELS":"Dual channel"},
  "MT6769H": {"VENDOR":"MediaTek","NAME":"Helio G88","MEMORY":"LPDDR4X 1800MHz","CHANNELS":"Dual channel"},
@@ -625,7 +631,7 @@
  "MT8768CT": {"VENDOR":"MediaTek","NAME":"MT8768CT","MEMORY":"","CHANNELS":""},
  "MT6762": {"VENDOR":"MediaTek","NAME":"Helio P22","MEMORY":"","CHANNELS":""},
  "mt6762": {"VENDOR":"MediaTek","NAME":"Helio P22","MEMORY":"","CHANNELS":""},
-  "MT8766B": {"VENDOR":"MediaTek","NAME":"MT8766B","MEMORY":"","CHANNELS":""},
+  "MT8766B": {"VENDOR":"MediaTek","NAME":"Helio A22","MEMORY":"","CHANNELS":""},
  "MT8768WT": {"VENDOR":"MediaTek","NAME":"Helio P22T","MEMORY":"","CHANNELS":""},
  "MT8768T": {"VENDOR":"MediaTek","NAME":"Helio P22T","MEMORY":"","CHANNELS":""},
  "MT8735P": {"VENDOR":"MediaTek","NAME":"MT8735P","MEMORY":"LPDDR3","CHANNELS":""},
@@ -869,9 +875,11 @@
  "T770": {"VENDOR":"Unisoc","NAME":"T770","MEMORY":"","CHANNELS":""},
  "T7200": {"VENDOR":"Unisoc","NAME":"T7200","MEMORY":"","CHANNELS":""},
  "ums512": {"VENDOR":"Unisoc","NAME":"T610","MEMORY":"","CHANNELS":""},
-  "ums312": {"VENDOR":"Unisoc","NAME":"","MEMORY":"","CHANNELS":""},
-  "ums9230": {"VENDOR":"Unisoc","NAME":"T7200","MEMORY":"","CHANNELS":""},
+  "ums312": {"VENDOR":"Unisoc","NAME":"T310","MEMORY":"","CHANNELS":""},
+  "UMS312": {"VENDOR":"Unisoc","NAME":"T310","MEMORY":"","CHANNELS":""},
+  "UMS9230T": {"VENDOR":"Unisoc","NAME":"T7225","MEMORY":"","CHANNELS":""},
  "UMS9230E": {"VENDOR":"Unisoc","NAME":"T7200","MEMORY":"","CHANNELS":""},
+  "ums9230": {"VENDOR":"Unisoc","NAME":"T7200","MEMORY":"","CHANNELS":""},
  "UMS9230": {"VENDOR":"Unisoc","NAME":"T7200","MEMORY":"","CHANNELS":""},
  "SC9832E": {"VENDOR":"Unisoc","NAME":"SC9832E","MEMORY":"","CHANNELS":""},
  "sc9832a": {"VENDOR":"Unisoc","NAME":"SC9832A","MEMORY":"","CHANNELS":""},
--- a/tools/tools.sh
+++ b/tools/tools.sh
Author	SHA1	Message	Date
sakuradairong	d286c7cacc	chore: snapshot backup before rainycy push (20260624-032434) Auto-committed by MiMo for migration to git.rainycy.top	2026-06-24 03:26:25 +08:00
YAWAsau	63037d9e5a	Update README.md	2026-06-13 12:43:11 +08:00
Yawasau	05130a9898	feat: 流式備份/恢復、遠端預掃優化、增量邏輯強化新功能 - 流式備份/恢復: remote_stream=1 支援 SMB+WebDAV 邊壓邊傳不佔本機空間 - 遠端預掃: 單次連線取全部列表 + 批量 json 下載 (120 往返→6 連線) - 主循環增量比對零網路開銷 (讀本地快取) - 最終計數核驗 verify_backup_manifest (三態顯示) - conf 重構: smb_url/webdav_url 按協議分組，切換 remote_type 免重輸修復 - 流式 staging 以遠端 json 快取為種子，解決權限/SSAID 無變化仍重備 - 上傳 json 前合併遠端版本，防 version 等欄位被部分覆蓋丟失 - 版本比對讀本地同步副本，修復流式模式每輪誤報版本變化 - 清單偵測版本更新強制重備 apk，防 json 被失敗輪汙染後 apk 缺檔 - apk 版本相符仍核對遠端檔存在性，污染數據自動自愈 - 流式失敗不傳 json，確保下輪整體重備不殘留壞數據 - smbclient cd 失敗停留根目錄導致列表/大小統計污染 → 前綴過濾 - WebDAV href URL 編碼改通用 %XX awk 查表解碼 (中文/空格/+ 全解) - json 預掃改全量批量抓，不再靠列表交集 (修 smbclient 中文名轉碼毀名) - 殺舊進程改單次 ps 快照整樹殺 (修 busybox ps 無 PPID / 誤殺自身) - smbclient stdin 命令還原內嵌換行 (修中文多層路徑建目錄失敗) - 連線失敗轉本地備份時補顯本地分區統計 - ms_to_readable 對永不休眠值特判顯示 - 單 app 備份入口補遠端預掃流程 - .changed_apps 去重、TMPDIR 殘留全清、tab 縮排統一優化 - 遠端預掃: 120 連線→6 連線，主循環零網路開銷 - 殺舊進程: ~15 秒→< 1 秒 (逐 /proc 遞迴→單次 ps 快照 awk) - 批量權限: JVM fork 3N→3	2026-06-13 12:29:18 +08:00
Yawasau	debf83a88c	perf: 備份提速近3倍, dex調用批量化, 修復數個bug 性能優化: - 並行目錄大小預掃(8並發), 主迴圈查表免重複遍歷, 提速約3倍 - 零fork查表: 權限/版本/UID/安裝來源/後台狀態改載入動態變量純記憶體查詢 - _dir_size改寫全域變量返回, 消除子shell fork - 內建glob取代ls檢查tar存在性 - 備份權限預掃批量(getRuntimePermissions 1次+awk分組生成JSON) - 恢復權限批量設置, JVM啟動3N→3 - appops reset集中執行新增功能: - 恢復後權限驗證(讀回比對授予/拒絕, _perm_verify=0可關) - dex調用計數器(_dex_debug=1) - 批量權限進度提示問題修復: - 權限JSON以包名為鍵導致多權限互相覆蓋只存1個(改為權限名為鍵), 舊備份需重備 - 自定義資料夾含點名稱(service.d)恢復時被誤截斷, 改為只去.tar/.tar.zst後綴 - _dir_size處理非應用名稱的bad substitution, 加變量名防呆 - grep -qFx改精確awk比對	2026-06-07 16:27:12 +08:00
Yawasau	e31c31515c	feat: 權限預掃/JSON驗證/遠端比對/互動統一及多項修復功能新增: - ask_yn helper 統一 Lo=0/1/2 互動邏輯 - prepare_permissions_map 備份前預掃 runtime permissions，取代逐 app fork dex - 備份完成後自動驗證本次變動應用的 JSON 結構 - remote_list_backups 加入本地/遠端差異比對，支援直接補上傳/補下載 - show_conf/remote_conf_line 各功能執行前顯示對應 conf - get_backup_dirname/per_app_upload_and_cleanup 邏輯抽成獨立函數邏輯修復: - Backup_Permissions/Backup_ssaid 移出 size 判斷，size 無變化時也偵測變更 - 權限變更列出具體項目 (permName: false→true) - .changed_apps 去重從 grep -qFx 改為 awk /data/data/com.termux/files/usr/bin/push==n，避免特殊字元誤判 - 僅上傳變更應用訊息加 remote_type 守衛，未設遠端時不顯示 - 遠端斷線保存 _remote_type_orig，支援中途開 WiFi 後重連 - 遠端缺檔本地無變化時免重壓直接上傳 - Lo=2 恢復未安裝應用選項順序顛倒 bug - Lo=2 更新腳本誤設 update 變數（應為 choose）bug - Media 備份無內容不留空殼 - 全腳本去除 bc 依賴改用 awk 其他: - 單獨備份模式只預掃該 app 權限 - 頂部加區塊索引，各分區加分隔標題 - 縮排統一為 Tab - 掛載路徑顯示從 mount:[...] 改為 └─ 掛載於:	2026-06-02 00:42:04 +08:00
Yawasau	3dc8bbdb2b	feat: 合併遠端增量備份相關功能 (基於 PR #123 )	2026-05-29 08:40:20 +08:00
Yawasau	8509e3ec2b	feat: 新增遠端備份系統 (WebDAV / SMB) 主要功能: - 遠端上傳:備份完自動上傳到 NAS / 雲端,支援 WebDAV / SMB - 遠端下載:從遠端拉回備份,可直接執行恢復 - 連線測試:三層測試 (TCP / 認證 / 路徑) 驗證設定 - 區網掃描:啟動時自動掃描區網 SMB 主機 - 單獨上傳:每個 app 子目錄生成 upload.sh,可獨立補傳優化: - WebDAV 並行下載 (curl -Z, 4 路同時) - SMB 批次傳輸 (每目錄一次連線) - 完整 UTF-8 中文路徑支援修復: - 強制 curl HTTP/1.1 避開 nginx PUT 404 問題 - WebDAV 預建初始目錄 - trap EXIT 不再誤觸發上傳 - 失敗檔案完整 log,不再中途中斷詳見 CHANGELOG.md	2026-05-16 10:59:58 +08:00
YAWAsau	ff47576425	Merge pull request #119 from sakuradairong/fix/remote-dns-curl fix: 强制 /system/bin/curl + MKCOL逐级目录 + stderr隔离	2026-05-16 10:50:56 +08:00
RainySY	4cf1e61321	fix: FTP测试用 tools/curl(有FTP支持)	2026-05-14 21:50:18 +08:00
RainySY	43b8886642	fix: FTP改用busybox ftpput(系统curl无FTP支持)	2026-05-14 21:46:43 +08:00
RainySY	ed13786ef3	fix: FTP测试改用列目录+被动模式+超时30s	2026-05-14 21:42:36 +08:00
RainySY	6eb10531a4	fix: 测试入口也用 /system/bin/curl (root DNS可靠)	2026-05-14 21:40:36 +08:00
RainySY	c207998028	fix: FTP 加被动模式和超时延长	2026-05-14 21:37:17 +08:00
RainySY	27d8134ae9	fix: FTP 用退出码判断成功/失败，WebDAV用 stderr 隔离	2026-05-14 21:33:17 +08:00
Yawasau	22982ac1ce	feat(remote): 批次上傳、連線預檢、精準範圍、測試入口 - SMB 改批次傳輸,單連線傳完同目錄所有檔 - SCP 改 tar pipeline,失敗自動退回逐檔 - 新增 remote_test 選單入口 - 新增 remote_keep_local 設定項 - 修復中文路徑、smb.conf 警告、無網路卡死等問題	2026-05-14 00:00:07 +08:00
YAWAsau	550e2a760b	Merge pull request #118 from sakuradairong/fix/remote-post-merge fix: SMB改用smbclient, curl重试, noexec适配	2026-05-12 23:00:18 +08:00
RainySY	7113448bb5	fix: SMB改用smbclient, curl重试, noexec适配, 多项修复	2026-05-12 22:58:15 +08:00
YAWAsau	6e1a8a2da3	Merge pull request #117 from sakuradairong/feat/remote-all feat: 遠程備份支援 WebDAV/FTP/SMB/SCP，內置 curl/scp/ssh	2026-05-12 21:14:56 +08:00
RainySY	b2409700c5	feat: 遠程備份 WebDAV/FTP/SMB/SCP + 內置二進制 + 日誌修復	2026-05-12 21:00:10 +08:00
YAWAsau	0bc0b95398	Merge pull request #114 from sakuradairong/fix/remote-improvements fix: 远程备份功能修复 (curl/WebDAV/MKCOL/日志/SMB)	2026-05-12 17:46:26 +08:00
RainySY	6fb53d7f11	fix: 保留 appList.txt 上传	2026-05-12 15:49:28 +08:00
RainySY	c7920acd0c	fix: 远端上传排除 tools/目录及脚本文件,仅上传备份数据	2026-05-12 15:47:12 +08:00
RainySY	384f039f43	fix: SMB改用curl smb://协议上传，合并为统一upload_remote函数	2026-05-12 15:44:34 +08:00
RainySY	80c2b47607	fix: 日志文件移至 log/ 子目录	2026-05-12 15:44:34 +08:00
RainySY	7832fd6d8e	fix: WebDAV URL编码特殊字符并自动创建远程目录(MKCOL)	2026-05-12 15:43:55 +08:00
RainySY	ad52ebd1a1	fix: 移除 curl stderr 静默,改用 test -x 检测,增加诊断日志	2026-05-12 15:43:55 +08:00
RainySY	6f287f42b8	fix: 改用 curl 替代 wget 进行 WebDAV 上传，自动检测 curl 路径	2026-05-12 15:43:55 +08:00
RainySY	9a1c30a583	fix: 在 update_backup_settings_conf 模板中加入远程配置，防止配置重建时丢失网络设置	2026-05-12 15:43:55 +08:00
YAWAsau	37047dcd8b	Merge pull request #113 from sakuradairong/feature/remote-backup feat: 支援透過 WebDAV 與 SMB 遠程備份	2026-05-12 08:23:10 +08:00
Yawasau	7d9c90cc8c	bugfix	2026-05-10 11:40:28 +08:00
RainySY	5201bdac28	docs: add remote backup design spec and implementation plan	2026-05-09 14:36:22 +08:00
RainySY	0e524b407d	feat: add remote backup functions	2026-05-09 14:36:06 +08:00
RainySY	102c3fd2ba	feat: add remote backup config	2026-05-09 14:36:00 +08:00
YAWAsau	da224d6c92	Merge pull request #111 from sakuradairong/optimize-script [优化] 代码清理安全加固：修复竞态条件、空参数漏洞、兼容性修复	2026-05-09 12:43:06 +08:00