# vivo X300 Ultra（V2547DA，卫星通信版）

目录里有两份脚本，按系统版本选：`recipe.py` 录的是 OriginOS 6（`BUILD` = `PD2547D_A_16`，真机
`PD2547D_A_16.0.21.21.W10`，2026-10-28），`recipe_android17.py` 录的是 Android 17（`BUILD` = `PD2547D_A_17.1.10.2`，
入口来自 Issue #220 的报告者实测）。`run.py` 只在设备版本对上 `PD2547D_A_17.1.10.2` 时选 Android 17 那份；
其余 17.x 小版本对不上，仍走 OriginOS 6 脚本并进安全模式。同门 V2547A（OriginOS 7）是另一份脚本 `recipes/vivo/V2547A/`。

```bash
python3 tool/run.py -s <序列号> backup
python3 tool/run.py -s <序列号> recipe
python3 tool/run.py -s <序列号> finish
```

可只跑某一段，例如 `recipe 浏览器`。开关是逐段点名的：先确认页面与目标开关都在，拨完回读，再比较
同页其他开关的状态。脚本不挂起组件、不处理快应用和通知渠道、不关闭开发者模式。

## 验证范围

| 变体 | 机器与版本 | 验过什么 |
|---|---|---|
| `recipe.py`（OriginOS 6） | `PD2547D_A_16.0.21.21.W10` | 2026-10-28 本机整段跑通，七段全过，124 秒 |
| `recipe.py`（OriginOS 6） | 同上 | 入口相关的改动有三处，都没在这台复测：2026-11-03 商店段改用 `p.tab()`、齿轮改用引擎 `icon_hit`（#530）；2026-11-07 齿轮补落地校验（#575）；同日浏览器段重写「菜单 → 设置」的落点校验（#753） |
| `recipe_android17.py`（Android 17） | `PD2547D_A_17.1.10.2.W10`，商店 `V10.5.20.0` | 2026-11-07 本机整段复测，七段全过，91 → 62 秒；系统广告、全局搜索、阅图锁屏改为直达，打不开再走菜单 |

2026-11-07 那一轮的开关都已关过，验的是「到得了页面、读得对状态」，不是从开启状态关起。

## 分段用时

2026-11-07 电脑经无线 adb 跑 Android 17 变体，改前 / 改后（秒）：

| 段落 | 改前 | 改后 |
|---|---|---|
| 系统广告 | 22 | 3 |
| 全局搜索 | 39 | 31 |
| 阅图锁屏 | 24 | 11 |

手机上整轮 91 → 62 秒。浏览器设置页在这个版本没有导出，仍走「右上菜单 → 设置」，是这一轮最慢的一段
（电脑上 55 秒）。

## 未验证项

- OriginOS 6 变体没有用时对比，系统广告、全局搜索、阅图锁屏三段在 `recipe.py` 里仍是菜单 / 滚动路径。
  Android 17 上验过的三个 Activity 在 OriginOS 6 上能不能直达，要单独 `am start` 确认，不能照抄（#689）。
- 「直达打不开时走老路」的自动化覆盖只到单测（`tests/test_entries.py`）。11-07 那一轮没有
  记录哪一段回退过，从上面三段的用时降幅看直达是生效的，回退分支在真机上没被触发。商店是例外——
  这一版 `AppstoreSettingsActivity` 没导出，实际走的就是「我的 → 齿轮」回退，而这条回退没有单测。
- 齿轮的落地校验（#575）在真机上还没复测。它改的是「点完要认出设置页才算命中」——改前点不动的图标
  静默算命中，后面的步骤就会在旧页上找入口。
- 浏览器段按 #753 重写过后同样没在这台复测；它改的是把菜单浮层当弹窗关掉的老毛病。
- 商店「个性化推荐」页的两个开关读屏里没有标题（content-desc 只有「开启，开关」），只有 Android 17
  变体按位置逐个点（`off_unnamed()`），依赖这两行在页面上的数量与顺序（#220）；灰的行不点。
  `recipe.py`（OriginOS 6）仍按标题关这两个开关。

## 脚本结构

两个变体都是七段、同名同序：系统广告、全局搜索、阅图锁屏、应用商店、浏览器、i 管家、天气。骨架相同，
差别在到达方式；另外商店「个性化推荐」页那两个无标题开关只有 Android 17 变体按位置关。

| 段 | `recipe.py`（OriginOS 6） | `recipe_android17.py`（Android 17） | 关闭的目标 |
|---|---|---|---|
| 系统广告 | 设置首页 → 安全 / 安全与隐私 → 更多安全设置 → 广告与隐私 | 直达 `com.android.settings/.Settings$AdAndPrivacyActivityForOsTwo`，打不开走左边的菜单 | 个性化广告、个性化推荐、智能推荐服务 |
| 全局搜索 | 设置首页 → 系统管理与升级 → 全局搜索 | 直达 `com.vivo.globalsearch/.view.SearchSettingsActivity`，打不开走菜单 | 首页展示内容的搜索框推荐词、推荐卡片；热搜榜单的热门搜索；个性化内容的广告个性化 |
| 阅图锁屏 | 设置首页 → 桌面、锁屏与壁纸 → 锁屏设置 → 阅图锁屏 | 直达 `com.vivo.magazine/.ui.MagazineSettings`，打不开走菜单 | 阅图锁屏、锁屏横滑进入阅图 |
| 应用商店 | 拉起商店 → 底部「我的」（`p.tab`）→ 齿轮 → 关于 | 直达 `com.bbk.appstore/.ui.menu.AppstoreSettingsActivity`，打不开走左边的「我的 → 齿轮」 | 关于 →「个性化推荐」页的两个开关（Android 17 变体读不出标题，按位置点）；服务管理里的签到有礼、顶部轮播图、顶部栏目、开屏、摇一摇、悬浮窗、限时推广 |
| 浏览器 | 拉起 → 右上菜单 → 设置 | 同左，这一版也没导出设置页 | 首页设置的上滑展示资讯；网页浏览设置；更多设置的两项跳转新闻资讯与下载页推荐；隐私权限的三项个性化 |
| i 管家 | 直达 `com.iqoo.secure/.MainSettings` → 关于 → 个性化设置 | 同左 | 应用个性化推荐、清理个性化推荐 |
| 天气 | 直达 `com.vivo.weather/.WeatherSettings` → 天气服务 | 同左 | 只关「天气服务」（天气相关热点资讯通知） |

Android 17 的全局搜索页上通常没有「推荐热搜榜单」这个入口（#220），`recipe_android17.py` 只在它出现
时才处理。

改动的边界：全局搜索保留历史记录与应用建议；商店服务管理保留「我的服务」「空间清理」；浏览器会选
「极简首页」（会改首页形态），其余设置只关点名的行；天气保留气象预警、异常天气、地震预警。

入口表与同族差异见 [docs/清单/vivo-OriginOS.md](../../docs/清单/vivo-OriginOS.md)。