跳转到主内容

在 Chrome MV3 的 AdGuard 中调试规则

在用于 Chrome MV3 的 AdGuard 中，过滤日志仅显示所应用的近似规则，我们称之为“假设的规则”。原因是，除非扩展名为“解压”格式，否则浏览器无法提供关于特定声明式规则的详细信息。如需获取准确信息，需要自行在浏览器中安装扩展程序的“解压”版本。

此说明对于有问题的情况也很有用，比如，在用户要更改扩展中静态包含的规则的情况下。在大多数情况下，使用扩展中的「用户规则」就足够了。

先决条件

Git：安装 Git
Node：安装 Node.js
Yarn：安装 Yarn

克隆扩展的方式

克隆存储库：

git clone git@github.com:AdguardTeam/AdguardBrowserExtension.git

转到目录：
```
cd AdguardBrowserExtension
```
切换到 v5.0 分支：
```
git checkout v5.0
```
安装依赖项：
```
yarn install
```

建构扩展的方式

切换到 v5.0 分支：
```
git checkout v5.0
```
在终端中运行以下命令：
```
yarn dev chrome-mv3
```
构建的扩展将放置在以下目录中：
```
./build/dev/chrome-mv3
```

在浏览器中安装解压包

开启「开发者模式」：
单击「加载已解压的扩展程序」：
选择扩展目录并点击「选择」：

完成！

调试规则

在 ./Extension/filters/chromium-mv3 目录中的 .txt 文件中找到并修改需要的规则。
将规则从 TXT 格式转换为声明形式：
```
yarn convert-declarative
```
再次构建扩展：
```
yarn dev chrome-mv3
```
在浏览器中重新加载扩展：

先决条件
克隆扩展的方式
建构扩展的方式
在浏览器中安装解压包
调试规则