通用论坛屏蔽插件 - 支持一键拉黑，跨域共享关键字，同步配置等

通用论坛屏蔽插件 | Universal Forum Block

Github: https://github.com/Heavrnl/UniversalForumBlock

Universal Forum Block 是一个功能强大的通用论坛内容屏蔽插件。主要功能有：

🎯 支持关键词、正则表达式进行精确过滤

🚫 支持一键屏蔽用户，不再需要手动复制粘贴

🔗 支持全局共享关键字和用户名，实现全网屏蔽

☁️ 支持多个云端配置定时同步

🔄 支持导入/导出配置

🌍 支持多种语言

🌐 支持自定义站点配置

使用示例

界面

使用方法

安装脚本管理器（如 Tampermonkey）

点击前往Greasyfork 安装脚本

访问支持的论坛网站

在网站左下角找到我们的面板开始使用

特殊说明：在已配置的论坛中，当鼠标移动到用户名上时会出现屏蔽按钮，点击即可一键屏蔽该用户。屏蔽按钮的显示方式可在设置面板中切换为"总是显示"或"悬停显示"。

支持的网站

中文论坛：hostloc，v2ex，nodeseek，linux.do，nodeloc，nga，恩山，3dmgame，知乎，豆瓣，一亩三分地，巴哈姆特,百度贴吧

英文论坛：Lowendtalk, reddit

如果需要支持其他网站，请在issue中提出或参考下方自定义新网站

除了版本更新外，插件不会自动更新内置的网站配置，可以使用仓库中预设配置导入到全局配置中获取实时更新

中文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/chinese/config.json

英文论坛:

https://raw.githubusercontent.com/Heavrnl/UniversalForumBlock/refs/heads/main/website/english/config.json

界面说明:

全局配置界面

配置项

说明

全局关键字

所有已配置的域名共享各自的关键字池

全局用户名

所有已配置的域名共享各自的用户名单

主页/内容页共享关键词

该域名主页和内容页共享关键词池

主页/内容页共享用户名

该域名主页和内容页共享用户名单

配置连接

单向同步一个或多个配置文件的下载，可定时同步，配置模板请看下方配置模板说明

关键词/用户名配置界面

配置项

说明

关键词列表

支持正则表达式，输入需要屏蔽的关键词

用户名列表

支持正则表达式，输入需要屏蔽的用户名

URL匹配模式界面

配置项

说明

主页URL匹配模式

该域名主页URL的正则表达式匹配规则

分页URL匹配模式

开发遗留项，可不配置，仅配置主页URL匹配模式即可

内容页URL匹配模式

该域名内容页URL的正则表达式匹配规则

XPath配置界面

配置项

说明

XPath选择器

用于定位HTML中的元素位置，分为以下几类：

- 主页/分页标题

用于匹配主页/分页中的标题文本

- 主页/分页用户

用于匹配主页/分页中的用户名

- 内容页关键词

用于匹配内容页中的关键词文本

- 内容页用户

用于匹配内容页中的用户名

....

进阶用法

配置模板说明

注：以下模板仅供说明使用，如有需要请使用：配置模板

{

// 全局配置

"globalConfig": {

"GLOBAL_KEYWORDS": false, // 是否启用全局关键词共享

"GLOBAL_USERNAMES": false, // 是否启用全局用户名共享

"SHOW_BLOCK_BUTTON": "hover", // 屏蔽按钮显示方式:"hover"悬停显示,"always"总是显示

"TIME_INTERVAL": 30, // 配置同步时间间隔(分钟)

"LANGUAGE": "zh-CN", // 界面语言

"GLOBAL_CONFIG_URL": [], // 全局配置URL列表

"CONFIG_SECTION_COLLAPSED": { // 各配置区块的折叠状态

"global_SECTION_COLLAPSED": true,

"keywords_SECTION_COLLAPSED": true,

"usernames_SECTION_COLLAPSED": true,

"url_SECTION_COLLAPSED": true,

"xpath_SECTION_COLLAPSED": true

},

"EDITOR_STATES": { // 各配置区块子区块的折叠状态

"keywords": false, // 关键词编辑器

"keywords_regex": false, // 关键词正则编辑器

"usernames": false, // 用户名编辑器

"usernames_regex": false, // 用户名正则编辑器

"mainpage_url_patterns": false, // 主页URL模式编辑器

"subpage_url_patterns": false, // 分页URL模式编辑器

"contentpage_url_patterns": false, // 内容页URL模式编辑器

"main_and_sub_page_title_xpath": false, // 主页和分页标题XPath编辑器

"main_and_sub_page_user_xpath": false, // 主页和分页用户XPath编辑器

"contentpage_title_xpath": false, // 内容页标题XPath编辑器

"contentpage_user_xpath": false // 内容页用户XPath编辑器

}

},

// 用户配置列表

"userConfig": [

{

"domain": "", // 域名（必填）

"enabled": true, // 是否启用

"mainPageUrlPatterns": [], // 主页URL匹配模式

"subPageUrlPatterns": [], // 分页URL匹配模式

"contentPageUrlPatterns": [], // 内容页URL匹配模式

"shareKeywordsAcrossPages": false, // 是否在主页和分页页面间共享关键词

"shareUsernamesAcrossPages": true, // 是否在主页和分页页面间共享用户名

"mainAndSubPageKeywords": { // 主页和分页关键词配置

"xpath": [], // XPath规则列表

"keywords": [], // 关键词列表

"regexPatterns": [] // 正则表达式列表

},

"mainAndSubPageUserKeywords": { // 主页和分页用户关键词配置

"xpath": [],

"keywords": [],

"regexPatterns": []

},

"contentPageKeywords": { // 内容页关键词配置

"xpath": [],

"keywords": [],

"regexPatterns": []

},

"contentPageUserKeywords": { // 内容页用户关键词配置

"xpath": [],

"keywords": [],

"regexPatterns": []

}

}

]

}

若配置userConfig了，那么domain是必填项。除了domain，其他全部配置项都是可选

以上配置文件即可用于界面中的导入按钮直接导入，也可以在全局配置的配置连接中导入

若想维护自己的屏蔽词列表，可以这样写

{

"userConfig": [

{

"domain": "example.com",

"mainAndSubPageKeywords": {

"keywords": ["关键词1", "关键词2", "关键词3"],

}

}

]

}

自定义新网站

1. URL匹配模式配置

首先需要分析网站的URL结构,并配置相应的URL匹配模式:

主页URL匹配: 如论坛根目录是主页,可填写 ^/$

内容页URL匹配: 如帖子页面URL格式为 /thread-123456-1.html,可填写 ^/thread.*

配置正确后,界面顶部会显示当前页面类型。

2. XPath选择器配置

XPath选择器用于定位页面元素,分为以下几类:

主页/分页标题

主页/分页用户名

内容页关键词

内容页用户名

在页面中右键目标元素,点击"检查"找到对应HTML结构，然后找到他的容器标签

例如有以下HTML代码：

....

....

标题

我们应该找到 容器标签 ，这里是li，那么他的标题XPath选择器就是 //li//div[@class="title"]/text()

若他的用户名在属性里，那么他的用户名XPath选择器就是 //li//a[@class="user"]/@username

特殊情况 1 : 假设我们的目标文本在属性里，而且有干扰字符，例如：

....

....

标题

对于这种情况我们的插件自定义了一种新的方法：/split(参数1,参数2,参数3)

参数1：分割符，例如空格，逗号，分号等

参数2：目标文本的索引，例如1，2，3等，支持负数，-1表示最后一个

参数3：目标文本所在属性，例如username

那么他的XPath选择器就是 //li//a[@class="user"]/split(" ",0,username)

特殊情况 2 : 假设容器标签下用多个同名的标签，例如：

....

....

标题