米侠浏览器脚本运行报错需五步排查：先确认报错来源是本地脚本（含mixia://、file:///sdcard/或scripts/路径）还是网页自身（https://域名）；再依syntaxerror、referenceerror等错误类型分层定位语法、引用或内存问题；接着验证脚本为小写.js、utf-8无bom、未压缩；然后检查注入开关开启、路径为/sdcard/mixiabrowser/scripts/且手动刷新列表；最后用console.log验证@run-at时机是否生效。
米侠浏览器脚本运行报错时，页面功能缺失、按钮不响应或控制台持续红字提示，说明脚本已加载但执行阶段失败，必须区分是语法错误、运行时异常还是资源冲突导致的中断，不能只看报错文字就盲目改代码。
确认报错来源是本地脚本还是网页自身
点击地址栏右侧“刷新”按钮旁的“开发者工具”图标（或按F12），切换到Console面板；若红字报错开头含mixia://、file:///sdcard/或路径中含scripts/字样，说明错误来自你安装的本地用户脚本；若报错指向https://域名下的JS文件，则问题在网页自身，无需修改你的脚本。
这一步跳过会直接误判方向——网页自身的语法错误无法通过改本地脚本修复，强行编辑反而破坏功能。
定位具体错误类型并分层排查
根据报错关键词快速归类：
SyntaxError：说明脚本存在非法字符、括号不匹配、分号遗漏或X5内核不支持的ES6+语法，需用纯文本编辑器检查BOM头/全角符号，以分段注释法缩小范围，并切换系统内核获取精准报错。
ReferenceError / TypeError：常见于变量未声明、DOM节点未找到、API不可用（如AbortController、ResizeObserver在X5内核中返回undefined），需检查@run-at时机是否过早、是否缺少polyfill垫片、是否误用现代语法。
RangeError / InternalError / Out of Memory：多由长循环未拆分、事件监听器未释放、setInterval未清除或DOM节点持续累积导致，需清理冗余资源并分批执行任务。
验证脚本文件是否符合硬性准入条件
第一步：检查文件扩展名是否为纯小写.js——若是 .JS、.Js 或带空格（如“my script.js”），米侠浏览器会静默忽略，不报错也不显示。
第二步：用文件管理器长按该.js文件→「编辑」→全选粘贴到记事本类纯文本工具中查看：若开头出现乱码或隐藏BOM头（如 EF BB BF 字节），必须另存为UTF-8无BOM格式，否则解析失败。
【务必保存为UTF-8无BOM格式】——用Notepad++选“编码→转为UTF-8无BOM”，VS Code右下角点击编码类型后选择“Save with Encoding→UTF-8”。
下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。
第三步：确认脚本未被压缩包包裹——米侠不支持直接读取.zip/.rar内嵌的.js，必须解压到目录层级中，且若有 manifest.json，需与.js同级。
检查脚本注入总开关与路径有效性
点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。
【必须先做这一步】重启浏览器后，再进入该页面确认开关右侧显示“已启用”，否则后续所有操作全部无效。
安卓设备上，米侠浏览器仅扫描/sdcard/MiXiaBrowser/scripts/目录下的.js文件。其他任何位置（如Download、Documents、根目录）均不会被自动发现。
用文件管理器新建文件夹，路径必须严格为 /sdcard/MiXiaBrowser/scripts/（注意大小写和斜杠方向），然后把你的.js文件复制进去。
刷新脚本列表并验证执行时机
第一步：进入【脚本注入】设置页→点击右上角【刷新脚本列表】
第二步：等待几秒，观察旧脚本是否重新出现在列表中
第三步：若出现，逐个点击右侧开关启用；若未出现，说明文件已被系统清理或路径被重定向，需重新复制脚本文件进 /sdcard/MiXiaBrowser/scripts/ 目录
第四步：进入脚本编辑界面，检查头部 @match 行是否覆盖当前网页地址；若当前页面为 file:// 协议，必须添加 @match file://* 或在 chrome://extensions 中勾选“允许访问文件网址”
第五步：将 @run-at 修改为 document-end 或 document-start，保存后用 console.log 验证是否触发执行
