# vivo V2417A 适配记录 实测日期：2026-10-30。型号取自 `ro.product.model`，没有根据型号编码推断零售名称。 | 项目 | 本次真机版本 | |---|---| | 系统 | OriginOS 6 / Android 16 | | 构建 | `PD2417D_A_16.2.14.1.W10` | | 应用商店 | `10.5.20.0` | | 浏览器 | `31.1.3.1`；2026-11-02 复跑时升到 `31.3.0.0`，入口变了，见「浏览器 31.3.0.0」 | | 全局搜索 | `8.80.65.3` | | 阅图锁屏 | `11.17.0.2` | | 手机管家 | `9.3.19.0` | | 天气 | `9.3.3.02` | | 负一屏 | `7.84.5.0` | ## 范围与路径 脚本分八段，所有关闭操作均点名目标开关；修改前确认目标完整，修改后回读，并比较同页其他开关的状态。这里的“核对”包括原本已经关闭的项目，不等于本轮实际改动数量。 | 段落 | 本机入口与处理项 | 保留项 | |---|---|---| | 系统广告 | 设置 → 安全 → 更多安全设置 → 广告与隐私；三项个性化广告/推荐服务 | 其他安全与隐私设置 | | 全局搜索 | 设置 → 系统管理与升级 → 全局搜索；推荐词、推荐卡片、热门搜索、广告个性化 | 总开关、历史记录、语音搜索、应用建议、搜索结果个性化的原值 | | 阅图锁屏 | 设置 → 桌面、锁屏与壁纸 → 锁屏设置 → 阅图锁屏；总开关和横滑入口 | 不选择或更换壁纸 | | 应用商店 | 我的 → 设置 → 关于；两项个性化推荐，以及服务管理中的七项推广 | 我的页-我的服务、空间清理、下载和更新设置 | | 浏览器 | 先试“菜单 → 设置”，没有“菜单”时改走“我的”页右上角的设置图标；极简首页、上滑资讯、网页下载推荐、WiFi 跳新闻、下载页两项推广、三项个性化 | 快捷网址、窗口恢复、收藏更新提醒、“首页展示AI”等其他设置 | | i管家 | 手机管家设置 → 关于 → 个性化设置；应用个性化推荐 | 安全检测、清理等功能 | | 天气 | 天气设置 → 天气服务（说明是“接收天气相关热点资讯通知”） | 气象预警、异常天气、地震预警 | | 负一屏 | 第一页桌面右滑 → 设置；更多设置 → 个性化推荐，以及内容精选、热点资讯 | 便捷生活的推荐服务、小V建议、常驻服务卡片 | ### 本机差异 - 系统广告与隐私、全局搜索、阅图锁屏页面均已确认可以通过 Activity 启动，脚本使用这些入口，避开系统设置首页悬浮搜索框遮挡列表首行的问题。带 `$` 的设置 Activity 先做 shell 引用。广告与隐私页使用 `settle=0` 跳过首页消弹窗，避免将开关说明中的“关闭后”误认成关闭按钮。 - 商店设置页未导出，从商店界面进入。冷启动可能先出现“月度精品”，只点“进入首页”，不点安装。 - 商店个性化开关的标题包含“，开启/关闭”，关闭后标题会改变；本机的“确认关闭”按钮未被通用确认逻辑识别。脚本逐行处理明确的关闭确认，再按稳定标题回读。 - 服务管理页的广告悬浮项叫“悬浮球”，不是部分其他 vivo 机型的“悬浮窗”。 - 浏览器设置页未导出，`am start` 直达抛 `SecurityException: not exported from uid`，只能从界面走。入口随版本变：`31.1.3.1` 是底部“菜单 → 设置”；`31.3.0.0` 起底部标签栏改成首页/视频/AI/影视小说/我的，没有“菜单”，“设置”挂在“我的”页右上角。该图标只有 `content-desc`、没有 `text`，`texts()` 取两者之一，所以按“设置”点名能找到，不能用 `tap_icon()`——它只挑文字与描述都为空的节点。新权限申请只拒绝；需要同意协议才能进入时，本段未完成，不代用户同意。 - 负一屏设置页未导出，从桌面滑入；HOME 也可能直接恢复到上次停留的负一屏，此时核对 `HiBoard` 和“添加组件”后直接进入设置。子页之间核对实际 Activity，设置面板按单屏处理；不拨动热点资讯页的形态单选钮。 ## 验证记录 以下结果来自贡献者的 V2417A 真机（社区实测），维护方未在本机复跑。 手动逐页实测覆盖全部八段。系统三项广告开关、搜索的推荐卡片/热门搜索/广告个性化、负一屏热点资讯原本已关，按读屏状态确认，未为测试而开启。 八段均已逐段运行通过。最终版本整段运行 `python3 tool/run.py -s S recipe` 返回成功，输出为： ```text 回读确认 32 项关闭；未完成 0 段 机型脚本跑完：关了 0 个，179 秒 ``` 32 项来自上述八段中点名的开关数（3 + 4 + 2 + 9 + 8 + 1 + 1 + 4），不含“极简首页”选择和单独执行的通知/快应用操作。179 秒取自引擎末行计时；本轮是在已去广告状态上做幂等复跑，确认保持关闭，实际新增拨动为 0。没有为复跑重新开启广告。 离线回归：`python -m unittest discover -s tests`；新增测试保护商店确认框与动态标题、重复运行、真实引擎的相似标题保护、缺目标时停止、服务开关不变、失败与断连上报、HOME 恢复负一屏、设置页不误消弹窗。 本轮共 397 项测试：396 项通过，1 项跳过，其中新增 10 项；`ruff check --select F,E9 tool tests gui` 通过。脚本验证只覆盖页面与开关状态，不代表对下单、支付、软件下载或天气告警触发进行了业务测试。 ### 浏览器 31.3.0.0 2026-11-02 贡献者在同一台真机上复跑，浏览器升到 `31.3.0.0`，整段因“没找到「菜单」”未完成，本段改动就是为了这条入口差异。新首页的“首页设置”改成默认/极简/自定义三选一单选钮，“首页上滑展示资讯”只在选中极简首页之后才出现在页面上，脚本仍然先选极简首页再逐项点名；多出的“首页展示AI”不在去广告范围，没有拨动。八项处理项在新版本上全部关成，回读确认同页其他开关未变。 新增 4 项测试保护这条路径：旧版本仍走“菜单”、新版本回落“我的 → 设置”、两个入口都没有时判本段未完成、只有 `content-desc` 的设置图标可被点名而 `tap_icon()` 会漏掉它。这 4 项全部通过，`ruff check --select F,E9 tool tests gui` 通过；只把回落那两行删掉，4 项中有 3 项变红。全量 `python -m unittest discover -s tests` 在改动前后的失败集合一致（贡献者本机缺依赖项导致的既有失败），本次改动没有引入新失败；PR 上 CI 的 Linux 与 Windows 两套回归均通过。 ## 运行与单独确认的操作 ```bash python3 tool/run.py devices python3 tool/run.py -s S check python3 tool/run.py -s S backup python3 tool/run.py -s S recipe # 也可只跑一段：recipe 应用商店 python3 tool/run.py -s S finish ``` `S` 替换成自己手机的序列号。运行时保持手机解锁且空闲；手动切换应用会中断页面验证，遇到未完成段时核对原因后重跑。结束后关闭开发者模式和 USB 调试。 本机脚本不包含营销通知清单、快应用开关或包挂起。营销通知应走 `chan-scan`，由机主筛掉服务类渠道，再用 `chan-off`；本轮另用通用流程关闭了五个明确营销渠道，未将用户的第三方 App 列表写入脚本。快应用系统服务开关也已另行验证可关闭、回读及备份原值，必须征得机主同意后单独运行 `quickapp off`，恢复用 `quickapp on`。 App 内开关按上表入口手动恢复；浏览器首页的本机原值为“默认首页”。不提交 `backups/`、账号页面、通知内容或设备序列号。