根本原因是页面html结构变更导致queryselector选择器失配，或新前端框架重写dom挂载方式；需先用document.queryselector验证选择器是否返回null，再通过elements面板抓取新结构、搜索文本定位节点，转为语义化css选择器，并用mutationobserver监听挂载、穿透shadow dom。
米侠浏览器网页改版后脚本失效，表现为按钮消失、功能无响应、控制台无报错但逻辑未触发，根本原因是页面HTML结构变更导致querySelector选择器全部失配，或新版本JS框架（如Vue 3.4+、React 19）彻底重写了DOM挂载方式，旧脚本依赖的静态节点路径已不存在。
确认失效根源是结构变更而非注入失败
打开目标网页→点击地址栏右侧“开发者工具”图标→切换到Console标签页→输入document.querySelector("你的选择器")（例如document.querySelector("#main-content .btn-download")）→回车。若返回null，说明选择器已失效；若返回元素，则问题不在DOM匹配，需转向API调用或事件监听排查。
这一步必须先做，跳过会直接浪费时间调试@run-at或路径问题——结构没变却去改时机，纯属徒劳。
定位并修复选择器断点
方法一：用开发者工具实时抓取新结构
在开发者工具Elements面板中，右键目标按钮或区域→“检查”→观察新生成的class名、data属性或嵌套路径；注意是否有动态生成的id（如id="app-123456"）、是否包裹在<shadow-root></shadow-root>内、是否被v-if或ng-if条件渲染隐藏。
方法二：搜索关键文本反向定位节点
按Ctrl+F（Android端长按地址栏输入框调出搜索）→输入按钮上可见文字（如“立即下载”）→在Elements面板中高亮对应<button></button>或<a></a>标签→逐级向上查看父容器class或data属性，替换原脚本中硬编码的层级路径。
【严禁直接复制Chrome DevTools里看到的完整XPath】——米侠X5内核不支持document.evaluate()，且XPath在动态渲染页极易断裂；必须转为健壮的CSS选择器，优先用[data-testid]、[aria-label]等语义化属性。
适配现代前端框架的挂载延迟
第一步：确认框架类型
在Console中执行typeof window.Vue或typeof window.React，若返回"function"，说明页面使用对应框架；再执行window.Vue?.version或React.version获取具体版本号。
第二步：注入时机升级
旧脚本若仅用@run-at document-end，对Vue 3的onMounted或React 18的useEffect挂载的节点仍会失败。必须补上MutationObserver监听目标区域出现：
const observer = new MutationObserver(() => {<br> if (document.querySelector(".new-download-section")) {<br> // 插入你的功能代码<br> observer.disconnect();<br> }<br>});<br>observer.observe(document.body, { childList: true, subtree: true });
第三步：绕过Shadow DOM隔离
若目标元素藏在<shadow-root mode="open"></shadow-root>内，普通querySelector无法穿透。需先获取host元素（如document.querySelector("my-custom-element")），再调用shadowRoot.querySelector(".inner-btn")。
验证修复效果
保存修改后的脚本→返回米侠浏览器→点击地址栏右侧刷新按钮强制重载页面→立即打开Console观察是否有新报错；若无报错且功能按钮正常出现，说明修复完成。
