垃圾推号大扫除
最近中文推圈垃圾内容漫山遍野，体验急剧下降。而马老师在忙着造大火箭，毫无作为。不胜其扰之余，vibe 了这个脚本。目前感觉不错，漏网率和误伤率都非常低（这个关键在于规则定义，尤其是正则）。
当然，这是一个道高一尺魔高一丈的纠缠往复过程。趁着最近几天有时间，积极维护一下。
普通潜水用户开垃圾回复隐藏（折叠）就够了，电脑和网速快的基本是加载即隐藏；而“拉黑”因为平台限制是个相当慢的动作。强迫症或者想维护自己帖子回复区的整洁，可考虑挂着跑拉黑队列，必要时再开“边刷边拉黑”。跑两天通常会明显改善，但垃圾号实在太多，拉之不绝。建议打开订阅动态更新规则。
需要先安装 Tampermonkey、Greasemonkey、Violent monkey 这类插件才能安装本脚本；只在电脑端 Chrome 平台测试通过。移动端浏览器未测试可用性。不支持 X 的 App端。
网友 taoist laoshan 对移动端浏览器进行了适配，若有需要请移步这里下载。
脚本主要处理推文回复区里最常见、最影响阅读体验的两类垃圾账号：
- 内容垃圾号：回复正文或昵称里直接出现诈骗、网盘、同城、奇怪符号、重复 emoji 等明显垃圾特征（默认关键字不过滤黄推只过滤垃圾推，若有此需要的X用户很容易自己定制关键字实现）。
- 导流号：回复本身可能很正常，但账号主页里写着“大号”、外链、跳转站、联系方式等引流信息。
简单说，这两种账号的搜索速度不一样：
- 内容垃圾号：搜索快，通常看回复正文和昵称就能判断。
- 导流号：搜索慢，往往要查账号主页。
也有两种处理方式：
- 隐藏：把回复折叠掉，马上见效。
- X 平台官方拉黑：把账号加入 X 的拉黑列表，更彻底，但更慢，也更受平台限制。
两种账号都可以隐藏，也都可以用 X 平台官方拉黑。区别只是搜索快慢和处理成本不一样。
两个主要功能
1. 隐藏：眼不见心不烦
隐藏是最快见效的功能。
脚本会把已经识别出的垃圾回复折叠掉，让你继续看正常讨论，不用一条一条手动处理。
- 内容垃圾号隐藏：通常可以马上生效，因为它主要看当前回复正文和昵称。
- 导流号隐藏：会稍微有延迟，因为它需要查询账号主页，看主页里是否有“大号”、外链等导流信息。
- 下方预折叠：普通滚动时，脚本会尽量提前处理快要看到的回复，让折叠过程更不打扰阅读。
隐藏不会修改你的 X 账号状态，也不会真正拉黑对方。它更适合日常刷回复区时快速清屏。
2. 拉黑：一劳永逸
拉黑会调用 X 的拉黑接口，把命中的账号加入你的拉黑列表。
它比隐藏更彻底：刷新页面后，被拉黑账号通常就不会再出现。
但拉黑不是无限快的操作。X 对批量请求、主页查询和拉黑操作都有平台限制。脚本会故意放慢速度、排队执行，尽量降低触发限流的概率。
简单说：
- 想立刻清爽：用隐藏。
- 想以后少见：用拉黑。
- 垃圾号很多时：先隐藏，再慢慢批量拉黑。
安装
- 先安装一个 userscript 管理器，例如 Tampermonkey、Violentmonkey 或 Greasemonkey。
- 安装
x_fraud_scanner.user.js。
- 打开 X 的推文详情页，也就是类似
x.com/xxx/status/123... 的页面。
- 页面右侧会出现一组小按钮。
如果已经安装过旧版本，更新脚本后刷新 X 页面即可。
右侧按钮怎么用
按钮默认显示在推文详情页右侧，可以拖动位置，也可以收起成一个 XFS 小按钮。
红标：内容垃圾号
- 红色标记：回复或昵称命中了内容垃圾规则。
- 红标隐藏按钮：隐藏已经命中的内容垃圾回复；再次点击可以显示回来。
- 内容扫描按钮：扫描当前已经加载出来的回复，并自动拉黑命中的内容垃圾号。
- 整页扫描按钮 / 一网打尽：自动加载并扫描整页回复，边扫边隐藏命中的垃圾回复，最后统一加入拉黑队列。适合热门推文下面垃圾回复很多的情况。
内容垃圾号主要依赖当前页面文本，所以速度通常最快。
橙标：导流号
- 橙色标记：脚本认为这个账号是导流号。
- 橙标隐藏按钮：隐藏已经识别出的导流号回复；再次点击可以显示回来。
- 导流扫描按钮：扫描当前已经加载出来的回复用户，查询他们的主页，发现导流号后自动拉黑。
- 自动检测导流号：开启后，滚动加载过的回复会被低频后台检查，命中后会自动变成橙标。
- 拉黑新号：默认关闭。开启后，导流查询会顺手检查账号注册时间，把少于所选天数或晚于所选日期注册的账号也标成橙色，并纳入导流扫描的拉黑候选。
导流号扫描需要查账号主页，所以会比内容垃圾号慢。点击后如果看到“正在搜索导流号”的提示，说明按钮已经生效，只是查询还在排队或等待平台响应。
批量拉黑队列
扫描命中账号后，会出现一个批量拉黑队列。
你可以看到：
- 命中的账号列表
- 命中的原因
- 拉黑进度
- 拉黑完成后的刷新按钮
队列里的用户名和 @handle 可以点击打开账号主页，方便确认误判，或者在误拉黑后去 X 主页手动恢复。
队列可以收起。收起后左侧会保留一个小提示，点击“打开队列”可以打开。
回复右上角附近的小圆圈也会同步队列状态：红色/省略号表示已经在队列中。还没开始执行的排队项可以再点一次从队列移出。
实验功能：边刷边拉黑
工具面板里有一个实验功能叫边刷边拉黑。
它的逻辑不是“先扫一遍再决定”，而是你一边刷回复，一边把当前规则已经明确命中的账号自动加入拉黑排队。这样适合在某类垃圾号模式已经非常稳定、你也已经把关键词和正则长期调到低误伤之后使用。
它有几个特点：
- 自动入队，不是立刻拉黑：命中账号会先进入批量拉黑队列，后续仍按队列节奏慢慢执行。
- 依赖当前规则质量：如果你的关键词或正则还没调稳，这个功能会把误判放大，所以一定要先充分测试。
- 更适合挂后台慢慢跑：建议另外开一个 X 页面挂着，让它持续入队和排队执行，不要指望短时间内高速清空。
- 需要手动关闭：开启后会持续保持开启，直到你在设置里手动关闭。因为它会自动把命中账号加入队列，不建议长期忘着开。
在用户主页时间线里，边刷边拉黑会处理被这个用户 repost 出来的帖子作者；不会反复把正在浏览的主页主人加入队列。
关键词和规则
面板里的“关键词”区域可以调整规则：
- 内容关键词：用于匹配回复正文。
- 用户名关键词：用于匹配显示名。
- 正则：用于匹配更复杂的固定模式。默认同时匹配昵称和回复正文；可以用
content: 前缀限制为只匹配回复正文，用 name: 前缀限制为只匹配昵称。
- 关键词工具：可以导出、合并导入、覆盖导入自定义规则。
- 隐藏命中统计：展开正则区域后，角落里的“统计”入口可以查看每条用户名关键词、内容关键词和正则累计帮助隐藏了多少次回复。统计保存在本地，重复打开同一帖子会重复计数。
- 会员保护不自动拉黑：在齿轮设置里，默认开启。页面上显示会员标识的账号不会加入自动拉黑候选；手动拉黑按钮仍可用。这个开关可以降低误杀率，但现在垃圾号也可能购买会员。
- 隐藏命中会员：在齿轮设置里，默认关闭。开启后，会员回复如果命中内容关键词或正则，也会被红标隐藏；但仍不会仅因为命中内容规则进入自动拉黑队列。
- 远程规则订阅：在齿轮设置里，默认关闭，但强烈建议打开。开启后，脚本会每小时从 GitHub 拉取一次远程关键词 JSON，并同步内容关键词、用户名关键词和正则；拉取失败时继续使用本地缓存。垃圾号话术和写法变化很快，作者自己也是重度推友，会经常更新有效规则，尽量降低误伤和漏网；打开订阅后，你通常不需要手动追着改规则。
- 拉黑新号：在齿轮设置里，默认关闭。可以按天数选择 7、14、30、60、90 天，也可以按具体日期选择；日期框默认是一个月之前的今天。开启后，新号会进入橙标和导流扫描拉黑候选。
- 时间设置：在“边刷边拉黑”的时间设置里，可以调整基础间隔、每 20 个暂停一次的时长、每 60 个暂停一次的时长。默认是 5 秒、30 秒、2 分钟；长冷却允许手动降到最低 1 分钟。设置会保存在本地。如果经常被平台要求重新登录，就把这些时间继续往上加。
内置规则会随脚本更新。远程规则是持续维护的可更新预设，更适合应对近期垃圾号的新话术和新写法。你自己添加或删除的关键词会保存在浏览器里；如果你删掉过某条远程规则，后续远程更新不会强行把同一条加回来。
远程规则现在分为四类：内容关键词、用户名关键词、正则规则、只隐藏正则。最后一类命中后只会隐藏回复，不会仅因这条规则进入自动拉黑候选，适合误伤率偏高但页面噪音很大的模式。
如果误伤太多，可以先从用户名关键词和正则规则开始删减；如果漏报太多，可以添加你常见的垃圾话术。
远程规则文件在 rules/keywords.json，结构如下：
{
"schemaVersion": 1,
"rulesVersion": "2026-05-14.1",
"updatedAt": "2026-05-14T00:00:00Z",
"contentKeywords": [],
"nameKeywords": [],
"regexKeywords": [],
"hideOnlyRegexKeywords": []
}
使用建议
- 普通回复页：开着红标隐藏和橙标隐藏，滚动浏览即可。
- 垃圾号很多的热门推文：先隐藏，保持页面可读，再用整页扫描/一网打尽慢慢处理。
- 规则已经比较稳定、误伤率很低时：可以考虑开“边刷边拉黑”，让命中当前规则的账号一边浏览一边自动进队列。
- 明显有导流号但没有橙标：点击导流扫描按钮手动查一次。
- 单个漏网账号：直接点该回复右上角附近的小拉黑按钮；如果它只是排队中，还没执行，再点一次可以移出队列。
- 需要批量拉黑时：不要同时开很多 X 标签页一起扫，容易触发平台限流。
为什么有些操作不能立刻完成？
这个脚本有两种速度完全不同的工作：
隐藏主要是本地页面操作。
脚本已经在页面里看到的内容，可以马上折叠掉，所以内容垃圾号隐藏通常非常快。
拉黑和导流识别需要请求 X。
导流号要查询账号主页，拉黑要调用 X 的拉黑接口。这些都受平台规则限制：
- X 会限制短时间内的主页查询频率。
- X 会限制短时间内的拉黑操作频率。
- 注册时间不在回复列表里，也需要查询账号主页才能拿到。
- 查询或拉黑太快，可能触发
429 限流、请求失败、要求重新登录，甚至临时限制操作。
- X 页面本身没有加载出来的回复，脚本也无法扫描到。
所以脚本会主动放慢速度，并在多个标签页之间协调请求节奏。这样做不是为了慢，而是为了尽量稳定。
可以把它理解成：
- 隐藏负责马上改善阅读体验。
- 拉黑负责慢慢把垃圾账号清掉。
- 导流号识别因为要查主页，天然会比内容关键词慢。
- 拉黑新号只能作为高误伤选项，不适合默认开启。它支持按天数或按具体日期筛选，日期默认是一个月之前的今天。它的实际收益有限，因为注册时间查询很慢，热门回复区里你可能已经看完了，后台还没查完。
已知限制
这个脚本不是万能过滤器，下面这些情况需要理解：
- 只能处理已经加载出来的内容：X 没加载到页面里的回复，脚本看不到。整页扫描会帮你自动加载一部分，但极长回复串仍可能扫不完。
- 导流号识别会有延迟：导流号需要查询账号主页，受 X 接口速度和限流影响，可能需要等待，也可能暂时查不到。
- 导流号不是实时百分百标记：自动检测是低频后台检查，主要为了避免页面卡顿和触发限制。想立刻检查当前视图，可以手动点导流扫描。
- 会员保护依赖页面标识：只有当前页面上显示会员标识的账号会被当作会员处理。如果 X 没有渲染出标识，脚本就无法用这个规则保护它。开启“隐藏命中会员”后，会员账号命中内容规则也会被隐藏，但仍不会自动加入拉黑队列。
- 拉黑新号误伤风险高：新号不一定是垃圾号。这个选项默认关闭，只建议在垃圾号特别密集、你接受“宁杀错不放过”时手动开启。
- 可能误伤：昵称、emoji、奇怪符号、关键词和正则都可能误判正常用户。拉黑前可以在面板里取消勾选。
- 可能漏报：垃圾号会变换话术、符号、链接和主页写法。遇到漏报，可以补关键词或正则。
- 远程规则不是实时同步：它最多每小时拉取一次，也可能因为 GitHub 网络、脚本管理器权限或 JSON 写错而失败。失败时脚本会沿用上一次成功缓存。
- 远程正则需要谨慎：远程规则订阅会同时同步正则。正则比普通关键词更容易误伤，也更容易写出影响性能的规则，所以这个订阅开关默认关闭。
- 拉黑后页面不会总是立刻消失：X 不一定会立即重新渲染页面。拉黑完成后刷新页面，已拉黑账号通常就会消失。
- 批量拉黑不能无限加速：脚本已经加入间隔和排队，但仍不能完全避免平台限制。
两种垃圾号的区别
内容垃圾号
这类账号通常在回复里直接暴露特征，例如：
- 色情或诈骗关键词
- 同城、附近、真人、搭子等话术
- 网盘链接或推广链接
- 连续 emoji、奇怪装饰符号
- 昵称里带明显垃圾关键词
它们通常会被标成红色。
导流号
这类账号的回复可能很干净，甚至只发一句普通话。但点进主页后会看到：
- “联系大号”
- “点击大号”
- 外部网站
- 跳转链接
- 主页简介、位置或显示名里暗示引流
它们通常会被标成橙色。
导流号比内容垃圾号更难识别，所以需要查询主页，也更容易受到 X 限流影响。
安全说明
脚本只在你自己的浏览器里运行，用你的 X 登录状态执行拉黑操作。它不会替你关注、发帖、点赞或转发。
请把它当作个人清理工具使用，不要用来做大规模自动化操作。使用前也请自行确认符合 X 的服务条款。
