如何为 uBOLite 将过滤列表转换为声明式 ruleset【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlockuBlock Origin 仓库中包含一个 MV3 分支产品 uBOLite它不再在运行时动态解析过滤规则而是把文本形式的过滤列表预先转换成浏览器的 declarative ruleset。要完成这条转换链你在 Linux 环境下按仓库的构建流程跑一次构建即可——tools/make-mv3.sh会调用 Node.js 脚本 make-rulesets.js逐个拉取并转换 rulesets.json 中声明的过滤列表最终产出rulesets/目录下的 DNR 规则文件和打过补丁的manifest.json。本文基于 platform/mv3/README.md 和构建脚本正文说明这条路径的前提、执行方式和如何核对产物。前提条件构建说明明确要求 Linux 环境且对 Node.js 版本有下限要求platform/mv3/README.md 写明该 Nodejs 脚本要求 Node 版本为17.5.0 或以上platform/mv3/package.json 中的engines.node同样声明node: 17.5.0。构建会从远程服务器下载过滤列表需要网络访问。仓库包含子模块README 给出的准备步骤是git submodule init git submodule update哪些过滤列表参与转换转换的输入清单是 platform/mv3/rulesets.json每个条目描述一个列表集字段包括id、name、group、enabled、urls列表下载地址、homeURL以及可选的lang、tags、trusted、parent和excludedPlatforms。例如默认启用的条目有ublock-filters指向 uAssets 仓库的quick-fixes.min.txt、unbreak.min.txt、filters.min.txt、privacy.min.txt、ubol-filters.txt五个文件、easylist、easyprivacy、pgl、ublock-badware、urlhaus-full。脚本主循环中的过滤逻辑值得注意for ( const ruleset of rulesets ) { if ( ruleset.excludedPlatforms?.includes(platform) ) { continue; } await rulesetFromURLs(ruleset); }即条目excludedPlatforms中包含当前构建平台时会被整体跳过。rulesets.json中pgl、ublock-badware、urlhaus-full、adguard-spyware-url、pol-3均声明了excludedPlatforms: [ safari ]所以make mv3-safari不会为这些列表生成 ruleset。执行转换在仓库根目录执行[platform]取chromium、edge、firefox或safarimake mv3-chromium其他平台对应make mv3-edge、make mv3-firefox、make mv3-safari。Makefile 中这些目标依赖ubol-codemirror先构建 codemirror-ubol 打包产物和dist/build/mv3-data然后实际执行的是tools/make-mv3.sh platform。make mv3-*属于增量重建目标脚本开头会rm -rf掉已有的dist/build/uBOLite.$PLATFORM目录再重建所以重复执行会删除并覆盖上一次的扩展产物。它内部做三件事见 tools/make-mv3.sh把 uBlock 主分支与 MV3 目录的文件复制到dist/build/uBOLite.$PLATFORM组装扩展骨架搭建一个临时构建目录运行node --no-warnings make-rulesets.js output$UBOL_DIR platform$PLATFORM按平台收尾edge会把rulesets/main/*移到包根目录注释说明 “For Edge, declared rulesets must be at package root”并运行platform/mv3/edge/patch-extension.jssafari运行platform/mv3/safari/patch-extension.js做合规修补。在转换脚本内部每个列表集的文本本地缓存缺失时从urls远程拉取成功后写入缓存目录${output}/../mv3-data即dist/build/mv3-data经dnrRulesetFromRawLists解析为 DNR 规则再按类型拆分落盘同时生成一个 16 位十六进制secret存于mv3-data/secret.txt首次生成后复用用于给内置过滤片段插入!#trusted on secret签名。核对产物构建完成后按 README 的说明逐项检查扩展包位置dist/build/uBOLite.chromium或.edge/.firefox/.safari。ruleset 文件全部位于dist/build/uBOLite.[platform]/rulesets下脚本写出的文件包括main/id.json——每个列表集一个静态规则集其中每条规则带递增的id例如main/ublock-filters.jsonregex/id.json——仅当该列表集存在正则规则时才生成strictblock/id.json、urlskip/id.json、scripting/下的 cosmetic/scriptlet 产物——均为条件生成非空才写出ruleset-details.json每个列表集的过滤/规则统计、scriptlet-details.json、generic-details.json。manifest 已打补丁脚本会写回manifest.json新增declarative_net_request.rule_resources每个列表集一项path形如/rulesets/main/id.json携带id与enabled并追加重定向资源所需的web_accessible_resources条目同时把version更新为本次构建的时间戳版本号。构建日志dist/build/uBOLite.[platform]/log.txt记录构建过程中发生了什么README 明确将其作为排查构建过程的依据每个列表集的处理中会记录输入过滤条数、接受/拒绝条数和输出规则条数。可选分支与限制强制刷新过滤列表dist/build/mv3-data缓存了从远程拉取的数据重复构建不会重复下载。需要最新列表时执行make cleanassets其 Makefile 定义为rm -rf dist/build/mv3-data dist/build/uAssets即删除全部本地缓存的过滤列表下次构建会重新拉取。本地调试构建不带版本号参数的构建即上面make mv3-*走的路径会向manifest.json增加declarativeNetRequestFeedback权限脚本注释标明用于 DNR 规则调试Firefox 平台还会把扩展 ID 改为uBOLite.devraymondhill.net以区别于正式版。发布构建直接向脚本传full或形如x.y.z的版本号如tools/make-mv3.sh full会打包出uBOLite_TAGNAME.platform.zipFirefox 为.xpi并放到dist/build/同时会删除rulesets/debug目录。缩小更新差异tools/make-mv3.sh支持beforedir参数构建后调用 salvage-ruleids.mjs对比 before/after 两包中main、modify-headers、redirect、regex、removeparam各子目录的规则文件保留未变化规则的id以缩小 diff 尺寸。平台差异excludedPlatforms决定某些列表只在部分平台生成 ruleset见前文Edge 的声明式 ruleset 必须位于包根目录Safari 需要额外的合规修补步骤两者由构建脚本自动处理。如果构建失败先读dist/build/uBOLite.[platform]/log.txt定位是哪个列表集在哪一步出错拉取失败会记录为Fetching failed: url一类信息可用make cleanassets清缓存后重试。【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlock创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何为 uBOLite 将过滤列表转换为声明式 ruleset【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlockuBlock Origin 仓库中包含一个 MV3 分支产品 uBOLite它不再在运行时动态解析过滤规则而是把文本形式的过滤列表预先转换成浏览器的 declarative ruleset。要完成这条转换链你在 Linux 环境下按仓库的构建流程跑一次构建即可——tools/make-mv3.sh会调用 Node.js 脚本 make-rulesets.js逐个拉取并转换 rulesets.json 中声明的过滤列表最终产出rulesets/目录下的 DNR 规则文件和打过补丁的manifest.json。本文基于 platform/mv3/README.md 和构建脚本正文说明这条路径的前提、执行方式和如何核对产物。前提条件构建说明明确要求 Linux 环境且对 Node.js 版本有下限要求platform/mv3/README.md 写明该 Nodejs 脚本要求 Node 版本为17.5.0 或以上platform/mv3/package.json 中的engines.node同样声明node: 17.5.0。构建会从远程服务器下载过滤列表需要网络访问。仓库包含子模块README 给出的准备步骤是git submodule init git submodule update哪些过滤列表参与转换转换的输入清单是 platform/mv3/rulesets.json每个条目描述一个列表集字段包括id、name、group、enabled、urls列表下载地址、homeURL以及可选的lang、tags、trusted、parent和excludedPlatforms。例如默认启用的条目有ublock-filters指向 uAssets 仓库的quick-fixes.min.txt、unbreak.min.txt、filters.min.txt、privacy.min.txt、ubol-filters.txt五个文件、easylist、easyprivacy、pgl、ublock-badware、urlhaus-full。脚本主循环中的过滤逻辑值得注意for ( const ruleset of rulesets ) { if ( ruleset.excludedPlatforms?.includes(platform) ) { continue; } await rulesetFromURLs(ruleset); }即条目excludedPlatforms中包含当前构建平台时会被整体跳过。rulesets.json中pgl、ublock-badware、urlhaus-full、adguard-spyware-url、pol-3均声明了excludedPlatforms: [ safari ]所以make mv3-safari不会为这些列表生成 ruleset。执行转换在仓库根目录执行[platform]取chromium、edge、firefox或safarimake mv3-chromium其他平台对应make mv3-edge、make mv3-firefox、make mv3-safari。Makefile 中这些目标依赖ubol-codemirror先构建 codemirror-ubol 打包产物和dist/build/mv3-data然后实际执行的是tools/make-mv3.sh platform。make mv3-*属于增量重建目标脚本开头会rm -rf掉已有的dist/build/uBOLite.$PLATFORM目录再重建所以重复执行会删除并覆盖上一次的扩展产物。它内部做三件事见 tools/make-mv3.sh把 uBlock 主分支与 MV3 目录的文件复制到dist/build/uBOLite.$PLATFORM组装扩展骨架搭建一个临时构建目录运行node --no-warnings make-rulesets.js output$UBOL_DIR platform$PLATFORM按平台收尾edge会把rulesets/main/*移到包根目录注释说明 “For Edge, declared rulesets must be at package root”并运行platform/mv3/edge/patch-extension.jssafari运行platform/mv3/safari/patch-extension.js做合规修补。在转换脚本内部每个列表集的文本本地缓存缺失时从urls远程拉取成功后写入缓存目录${output}/../mv3-data即dist/build/mv3-data经dnrRulesetFromRawLists解析为 DNR 规则再按类型拆分落盘同时生成一个 16 位十六进制secret存于mv3-data/secret.txt首次生成后复用用于给内置过滤片段插入!#trusted on secret签名。核对产物构建完成后按 README 的说明逐项检查扩展包位置dist/build/uBOLite.chromium或.edge/.firefox/.safari。ruleset 文件全部位于dist/build/uBOLite.[platform]/rulesets下脚本写出的文件包括main/id.json——每个列表集一个静态规则集其中每条规则带递增的id例如main/ublock-filters.jsonregex/id.json——仅当该列表集存在正则规则时才生成strictblock/id.json、urlskip/id.json、scripting/下的 cosmetic/scriptlet 产物——均为条件生成非空才写出ruleset-details.json每个列表集的过滤/规则统计、scriptlet-details.json、generic-details.json。manifest 已打补丁脚本会写回manifest.json新增declarative_net_request.rule_resources每个列表集一项path形如/rulesets/main/id.json携带id与enabled并追加重定向资源所需的web_accessible_resources条目同时把version更新为本次构建的时间戳版本号。构建日志dist/build/uBOLite.[platform]/log.txt记录构建过程中发生了什么README 明确将其作为排查构建过程的依据每个列表集的处理中会记录输入过滤条数、接受/拒绝条数和输出规则条数。可选分支与限制强制刷新过滤列表dist/build/mv3-data缓存了从远程拉取的数据重复构建不会重复下载。需要最新列表时执行make cleanassets其 Makefile 定义为rm -rf dist/build/mv3-data dist/build/uAssets即删除全部本地缓存的过滤列表下次构建会重新拉取。本地调试构建不带版本号参数的构建即上面make mv3-*走的路径会向manifest.json增加declarativeNetRequestFeedback权限脚本注释标明用于 DNR 规则调试Firefox 平台还会把扩展 ID 改为uBOLite.devraymondhill.net以区别于正式版。发布构建直接向脚本传full或形如x.y.z的版本号如tools/make-mv3.sh full会打包出uBOLite_TAGNAME.platform.zipFirefox 为.xpi并放到dist/build/同时会删除rulesets/debug目录。缩小更新差异tools/make-mv3.sh支持beforedir参数构建后调用 salvage-ruleids.mjs对比 before/after 两包中main、modify-headers、redirect、regex、removeparam各子目录的规则文件保留未变化规则的id以缩小 diff 尺寸。平台差异excludedPlatforms决定某些列表只在部分平台生成 ruleset见前文Edge 的声明式 ruleset 必须位于包根目录Safari 需要额外的合规修补步骤两者由构建脚本自动处理。如果构建失败先读dist/build/uBOLite.[platform]/log.txt定位是哪个列表集在哪一步出错拉取失败会记录为Fetching failed: url一类信息可用make cleanassets清缓存后重试。【免费下载链接】uBlockuBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.项目地址: https://gitcode.com/GitHub_Trending/ub/uBlock创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
