宙斯浏览器脚本自动执行设置_特定域名运行JS脚本

宙斯浏览器支持为特定域名自动执行自定义JavaScript脚本，需通过用户脚本管理配置@match匹配域名、@exclude排除路径、@require加载依赖、本地导入及调试日志排查问题。

如果您希望在宙斯浏览器中为特定域名自动执行自定义 JavaScript 脚本，则需通过内置的用户脚本管理机制进行配置。以下是实现该功能的具体步骤：

一、启用用户脚本支持并创建新脚本

宙斯浏览器默认支持 Tampermonkey 风格的用户脚本语法，需先确保脚本功能已激活，并新建一个符合域名匹配规则的脚本文件。

1、点击浏览器右上角菜单按钮，选择“扩展程序”或“用户脚本管理”。

2、在脚本管理界面中，点击“新建脚本”按钮，进入编辑页面。

3、在脚本编辑区顶部的元数据区块中，添加 @match 或 @include 指令以声明目标域名。

4、在 @match 行中填入 https://example.com/* 格式，替换 example.com 为实际需要注入脚本的域名。

5、在元数据下方编写所需执行的 JavaScript 代码，例如 document.body.style.backgroundColor = 'yellow';。

6、点击“保存”按钮使脚本生效，刷新对应域名页面即可触发执行。

二、使用 @exclude 排除不适用子路径

当目标域名下存在多个子路径，而仅需在特定路径运行脚本时，可通过 @exclude 指令排除干扰路径，避免脚本误触发。

1、在已有脚本的元数据区域中，于 @match 行下方新增一行 @exclude。

2、填写需排除的路径模式，例如 https://example.com/admin/*。

3、支持通配符 * 和正则语法（若浏览器版本支持），如 https://example.com/*/api/*。

4、保存更改后，重新加载目标页面验证排除逻辑是否生效。

三、通过 @require 加载外部依赖库

若脚本依赖 jQuery、Lodash 等第三方库，可利用 @require 指令在执行前自动加载指定 URL 的 JS 文件，确保运行环境完整。

1、在脚本元数据中 @match 行上方添加 @require 指令。

2、填写远程库地址，例如 https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js。

3、确认该 URL 可被宙斯浏览器直接访问且返回合法 JS 内容。

4、在主脚本代码中调用 $ 或 jQuery 函数前，确保 DOM 已就绪，建议包裹在 window.addEventListener('DOMContentLoaded', ...) 中。

四、启用本地文件系统脚本注入

对于无法通过网络托管的私有脚本，宙斯浏览器允许从设备本地存储加载 JS 文件，适用于内网或离线环境下的域名脚本部署。

1、将编写完成的 .js 文件保存至手机内部存储的 ZeusScripts 目录下（如 /sdcard/ZeusScripts/）。

2、在用户脚本管理界面中选择“从本地导入”，定位并选取该文件。

3、导入后自动解析元数据，检查 @match 值是否匹配目标域名，未匹配则手动修改。

4、启用该脚本开关，并确认权限提示中已授权“读取本地文件”选项。

五、调试脚本执行状态与错误日志

脚本未按预期运行时，需借助浏览器内置调试工具定位问题根源，包括匹配失败、语法错误或权限限制等常见原因。

1、打开目标域名页面后，长按地址栏呼出快捷菜单，选择“查看用户脚本日志”。

2、在日志面板中查找红色标记的报错信息，重点关注 Failed to match URL 或 SyntaxError。

3、若显示 Script disabled due to unsafe eval()，说明脚本含动态执行语句，需移除 eval、Function 构造器等禁用操作。

4、启用“开发模式”后，可在控制台输入 zeus.userScripts.list() 查看当前所有注册脚本及其匹配状态。