高级设置
一大组浏览器行为开关。这张卡片汇集了高级 WebViewConfig 选项。
位置:编辑通用配置编辑器中的 高级设置 卡片。
User-Agent 与渲染
- User-Agent —— 这张卡片的第一块。系统默认、桌面风味或自定义字符串(
userAgentMode、customUserAgent)。导出会写入这个选择。HTTPUser-Agent和Sec-CH-UA*保持成对,包括架构和机型。选择自定义会清掉残留的内核风味并关闭内核伪装,这样输入的字符串就是身份。桌面风味同时打开桌面模式。 - 桌面模式 —— 请求桌面版站点(
desktopMode)。开关在同一块里。 - 缩放 —— 启用双指缩放(
zoomEnabled)。 - 页面缩放 —— 构建期的按应用整页缩放百分比,可选 Chrome 式档位(50%–150%)或自由输入(
pageZoomPercent,默认 100)。每次运行(含冷启动)都用文档根上的 CSSzoom应用这个比例——文字、布局、图片和画布一起缩放(不同于只缩放字形的textZoom)。脚本不再改写 viewport meta,页面自己把 meta 写回去时不会反复刷新。不需要运行时工具栏。旧数据中的0视作 100。 - 视口模式 —— 默认或自定义视口宽度(
viewportMode、customViewportWidth)。
导航与刷新
- 下拉刷新 —— 拉动刷新(
swipeRefreshEnabled)。 - 边缘过度滚动 —— 默认开启(
overscrollEffectEnabled)。关闭后,系统 WebView 不再出现 Android 12 及以上的边缘拉伸,GeckoView 自己的边缘效果也会关掉。下拉刷新仍然可用。页面自己用脚本做的回弹不受影响。 - 自动刷新 —— 定期重载,带间隔和倒计时(
autoRefreshEnabled、autoRefreshIntervalSec)。 - 新窗口行为 —— 弹窗/新窗口如何打开(
newWindowBehavior:同窗口、外部、弹窗……)。脚本打开的窗口,以及 OAuth 主机,会保持为真正的子窗口,弹窗登录可以把结果交给window.opener。拦截仍然拦截。 - 弹窗拦截 —— 拦截弹窗(
popupBlockerEnabled)。
下载
- 下载 —— 启用下载并选择位置(
downloadEnabled、downloadLocationMode:系统下载目录 / 应用私有 / 自定义 SAF 目录 / 每次选择位置)。每次选择位置会为每一次下载弹出系统保存对话框,包括 blob、data 和媒体文件。取消对话框则不写入。默认仍是系统下载目录。
网络与隐私
- 代理 —— 静态 HTTP/HTTPS/SOCKS5 或 PAC,带认证和绕过规则(
proxyMode、proxyHost、pacUrl……)。 - TLS 指纹 —— 模拟浏览器 JA3 配置(
tlsFingerprintEnabled、tlsFingerprintTemplate如CHROME_131)。 - CORS 绕过 —— 为跨源 SPA 绕过 CORS(
enableCorsBypass)。 - 混合内容 —— 允许/兼容模式(
allowMixedContent、mixedContentMode)。 - 私有网络桥 —— 桥接私有网络请求(
enablePrivateNetworkBridge、privateNetworkScope)。 - Hosts 映射 —— host → IP 覆盖(
hostsMappingEnabled、hostsMappings)。 - Cookie —— 第三方 Cookie 和持久化(
acceptThirdPartyCookies、thirdPartyCookieMode)。 - 地理位置 —— 启用,带精度和策略(
geolocationEnabled、geolocationAccuracy、geolocationPolicy)。
内核与状态栏
- 内核伪装 —— 呈现不同的浏览器内核风味(
enableKernelDisguise、kernelFlavor、kernelDisguiseLevel)。 - Cloudflare 兼容 —— Cloudflare 挑战的兼容模式(
enableCloudflareCompat、cloudflareCompatMode)。默认 WebView 路径上,User-Agent 和Sec-CH-UA描述同一个 Chrome 身份。验证码框架跳过其他 document-start 脚本。验证码站点走 WebView 自己的连接,不经过本地 DNS 代理或 TLS 桥。 - 故障转移 —— 镜像 URL,带触发条件和超时(
failoverEnabled、failoverUrls、failoverTimeoutSeconds)。
状态栏颜色/外观配置(颜色模式 THEME/PAGE_TOP/TRANSPARENT/CUSTOM、自定义颜色、深色图标、背景颜色/图片,明暗分别配置)位于全屏模式卡片内的可展开区。