无疆桌面 · 一键安装部署（下载安装 + 默认桌面 + 授权 + 全面屏手势 + 去三键）
================================

作用：在开启 USB 调试的手机上一条龙部署「无疆桌面」，全程只需双击脚本 + 看提示按键：
      ① 自动核对版本：手机上未装、或版本低于官网最新版时，自动下载最新
         安装包并安装（文件夹里已有 .apk 时直接用它，不再联网）；
         已是最新版则跳过下载与安装，直接做后面的配置；
      ② 安装到手机（已装旧版时覆盖升级，数据保留）；
      ③ 首次启动（手机上出现《用户协议与隐私政策》时点"同意并继续"即可）；
      ④ 设为系统默认桌面；
      ⑤ 一次性授予全部所需权限；
      ⑥ 自动打开桌面内置的「全局全面屏手势」开关（无需进应用手动开）；
      ⑦ 自动识别系统并隐藏底部三键导航（左右边缘内滑=返回，底部上滑=回桌面）。

适用：小米 / 红米（HyperOS / MIUI），以及 LineageOS / 原生安卓等 AOSP 系统。
      需要一根 USB 数据线、一台 Windows 电脑；第 3 步在线下载时需要网络。

★ 小米 / HyperOS 用户必读（实测 HyperOS 2.0，三个开关都要开）★

  设置 → 更多设置 → 开发者选项 →
  ①「USB 调试」——必须开（不开电脑连不上手机）
  ②「USB 调试（安全设置）」——必须开（不开则授不了权限、切换不了导航，
     开启前提：手机已插 SIM 卡、已登录小米账号）
  ③「USB 安装」——必须开（不开 adb 安装应用会被手机拒绝，
     部分系统叫"通过 USB 安装应用"，可能要求登录小米账号）

  脚本会自动检测：缺哪个开关就停在哪一步给引导，开好后按任意键继续。
  （LineageOS / 原生安卓没有这些限制，打开「USB 调试」即可。）

------------------------------------------------
用法（三步）

1. 解压出整个文件夹（不要只拖出 .bat 一个文件，它需要同目录的 adb.exe）。

2. 手机上打开上面列出的 USB 调试相关开关，用数据线把手机连到电脑；
   手机弹出「允许 USB 调试吗？」时勾选「一律允许」再点确定。

3. 双击运行「一键安装部署无疆桌面.bat」，按屏幕提示走完 10 步即可。
   · 第 3 步自动核对版本并显示官网最新版本号；需要下载时自动选线路：
     优先直连国内源站（快，通常一两分钟），不通自动改走官网中转
     （8 线程分块提速）；全程单行进度条实时显示，个别分块卡死会
     自动重启，中断后重新运行会把已下载的部分接着用。
   · 第 4 步安装时若手机弹出"是否允许通过 USB 安装"，在手机上点允许。
   · 第 5 步启动后，手机上若出现《用户协议与隐私政策》，点"同意并继续"
     （手机已是最新版、跳过了安装时，第 5 步会自动略过）。
   · 已装过无疆桌面的手机再运行本脚本：第 3 步自动核对版本，
     已是最新版就跳过下载安装，直接补做权限 / 手势 / 导航配置。

------------------------------------------------
离线 / 下载失败的备用方案

用浏览器打开官网下载页 https://wujiangzhuomian.cn/download.html
手动下载 .apk 安装包，放进本文件夹（和 .bat 同目录），
再运行脚本：检测到文件夹内有安装包时会直接使用，不再联网下载。
（文件夹内有多个 .apk 时脚本会提示只保留一个。）

------------------------------------------------
想恢复三键导航

打开手机系统「设置」，搜索「系统导航」：
· 小米 / HyperOS：一般在 设置 → 更多设置 → 全面屏，
  把「全面屏手势」改回「经典导航键」。
· LineageOS / 原生安卓：一般在 设置 → 系统 → 手势 → 系统导航，
  把「全面屏手势」改回「三按钮导航」。

------------------------------------------------
说明

· 版本核对规则（第 3 步）：读官网 version.json 的 versionName，与手机上
  已装版本（dumpsys 里的 versionName）比较，完全一致才跳过下载安装；
  不是最新版就自动下载覆盖更新。断网且文件夹内也没有安装包时，
  脚本会停在重试提示（联网后按任意键继续，或放入安装包改用本地包）。
· 覆盖安装用 adb install -r，保留手机上原有的布局与数据；
  只有遇到"不同签名的旧版"（很早以前安装的版本）时才需要卸载重装，
  脚本会先征求同意（卸载会清空旧版数据），并自动尝试解除设备管理器。
· 下载走双线路：默认直连国内源站（脚本内置地址，实测约 3.5MB/s，
  比走官网中转快 20 倍左右），源站不可用时自动改走官网中转线路并
  8 线程分块提速；若以后更换源站主机，改脚本开头 ORIGIN_BASE 一行即可
  （或在官网 version.json 里加 originUrl 字段，脚本会优先读取）。
· 安装包按版本号缓存在系统临时目录（如 %TEMP%\zhuomian_2.1.4.apk）；
  分块下载的临时分片在 %TEMP%\zhuomian_dl\，下载中断后重新运行，
  已完成的分块直接复用，不会重复下载。
· 第 6~10 步（设默认桌面 / 授权 / 开内置手势 / 去三键 / 验证）与
  《一键开启全面屏手势》工具完全一致：
  - 设默认桌面：cmd package set-home-activity（失败时自动改走系统
    "角色"接口兜底；个别系统限制下可手动到 设置 → 应用 → 默认应用 选择）；
  - 授权清单：修改安全系统设置 + 更改系统设置 / 运行时权限（联系人、
    照片与存储、电话、定位、蓝牙）/ 麦克风录音（语音输入：对着宠物
    说话、AI 语音对话）/ 悬浮窗 / 读取通知 /
    免打扰策略 / 无障碍服务 / 使用情况访问 / 设备管理器；
    小米系统授权前先做"预检"，检测到被 HyperOS/MIUI 限制时停下给引导；
  - 开内置手势：写入开启标记 settings put secure zhuomian_enable_gesture_nav 1
    并拉起无疆桌面，桌面读到标记后自动打开应用内开关并消费掉标记；
    之后应用内开关仍是唯一开关——手动关掉不会被脚本顶回去；
  - 去三键：小米写 navigation_mode=2 + force_fsg_navbar=1（写完回读校验），
    AOSP 系切换导航 overlay（threebutton / gestural 等，名字按手机上
    实际存在的自动选择）。
· 内置手势没自动开启？第 10 步验证若显示「开启标记未被桌面消费」：
  小米先检查「USB 调试（安全设置）」是否已开；然后重新运行本脚本再试；
  或打开无疆桌面 → 设置 → 手势与导航 →「全局全面屏手势」手动打开。
  首次安装还没同意《用户协议》的，先打开应用同意协议后再跑一次脚本。
· 「家人传声」的消息提醒（通知）：脚本第 7 步已自动打开应用通知权限——
  人在别的应用时来消息会有提醒。小米 / HyperOS 机型想看到顶部弹出的
  「横幅」，还需在手机上手动开一次「悬浮通知」（系统不允许电脑代开）：
  设置 → 通知 → 无疆桌面 → 通知类别「宠物传声」→ 打开「悬浮通知」；
  桌面内第一次配对成功时也会自动弹引导直达这一页。
  LineageOS / 原生安卓无需手动，开箱即有横幅。
· 小米的「自启动」是厂商私有开关，adb 授不了：若全面屏手势在重启后
  没有自动恢复，请在 安全中心 → 应用管理 → 无疆桌面 → 自启动 手动打开。
· 以后想更新版本：重新运行本脚本即可，不是最新版会自动下载更新
  （数据保留）；或直接在 无疆桌面 → 设置 → 关于 里检查更新。
· 本工具仅面向 Windows 电脑；Mac / Linux 用户可自行安装 platform-tools 后
  执行相应命令（设默认桌面 cmd package set-home-activity <包名>；安装
  adb install -r <apk>；开内置手势 settings put secure
  zhuomian_enable_gesture_nav 1；小米换导航 settings put secure
  navigation_mode 2 与 settings put secure force_fsg_navbar 1；AOSP 系
  cmd overlay enable/disable --user 0 <overlay名>）。
