uBlockOrigin/uBOL-home项目中的URL过滤规则问题解析

在uBlockOrigin/uBOL-home项目中，近期发现了一个关于URL过滤规则的重要技术问题。这个问题涉及到浏览器扩展在MV3架构下处理URL过滤时的特殊行为，值得所有内容过滤开发者深入了解。

问题的核心在于MV3扩展中DeclarativeNetRequest(DNR)API对"initiator"(发起者)概念的特殊处理方式。在传统网页环境中，当一个页面通过链接跳转到另一个页面时，我们通常认为目标页面的"domain"就是其自身的域名。然而在DNRAPI的实现中，"initiator"实际上指的是跳转来源页面的域名。

这一差异导致了某些特定场景下的过滤异常。例如，当用户从GitHub页面点击一个指向steamcommunity.com的链接时，DNRAPI会将"initiator"识别为github.com，而非steamcommunity.com。如果过滤规则使用了domain参数来限制目标站点，就可能出现意外的拦截行为。

技术团队经过深入分析后，提出了明确的解决方案：对于针对document类型请求的过滤规则，应当使用to参数替代domain参数。to参数直接匹配目标URL的域名，不受initiator概念的影响，能够确保过滤行为符合预期。

这一发现不仅解决了steamcommunity.com被误拦截的问题，更揭示了一个重要的开发原则：在MV3架构下开发内容过滤功能时，开发者需要特别注意不同类型的请求匹配策略。对于document请求，优先使用to参数；而对于子资源请求，则仍可使用domain参数。

该问题的解决体现了开源社区协作的力量，也展示了技术团队对产品细节的深入把控。这一经验对于所有基于MV3架构开发浏览器扩展的团队都具有参考价值，特别是在处理跨域跳转和内容过滤的场景下。