一个用于 X（Twitter）的 Tampermonkey / Violentmonkey 用户脚本：按可配置的启发式规则自动隐藏疑似垃圾/引流内容，提供一键拉黑按钮和可随时增删的屏蔽词管理面板。
免责声明：本项目为非官方个人工具，与 X Corp. 无任何关联，未获其授权或认可；仅供个人学习与使用，请自行遵守 X 服务条款及所在地法律法规，因使用本脚本导致的账号或其它风险由使用者自行承担。过滤规则为启发式规则，内置关键词为个人偏好配置，不代表对任何人物、机构、品牌或内容的评价。本项目按 MIT 许可提供，不附带任何担保。
- 自动检测：结合显示名关键词、推文内容关键词、随机字母数字 handle、纯 emoji 内容等信号，按启发式规则判定是否隐藏。
- 自动隐藏：命中后隐藏对应推文，显示「已按屏蔽规则隐藏」占位符，点击可临时展开查看。
- 一键拉黑：每条推文菜单旁注入拉黑按钮，用户主页也提供拉黑按钮。
- 屏蔽词管理面板：页面右下角悬浮按钮，展示全部生效屏蔽词（自定义 + 内置），支持随时添加/删除并立即生效，内置词删除后可一键恢复默认。
- 类似词匹配：自定义词支持变体拦截（大小写、空格/零宽字符、间隔字符），如「福/利」也能命中「福利」。
- 可选自动拉黑：开启
autoBlock后，命中规则的账号自动执行拉黑。
- 安装 Tampermonkey（或 Violentmonkey）。
- 将 x_bot_filter.user.js 的内容复制到「新建用户脚本」中，或直接打开该文件的原始链接让脚本管理器提示安装。
- 保存后刷新 X（x.com / twitter.com）页面。
脚本要求：
- 匹配站点：
x.com、twitter.com - 权限：
@grant none（无跨域请求，无额外权限） - 运行时机：
document-idle
点击页面右下角「屏蔽词」按钮打开面板：
- 自定义词：输入框添加（回车或点「添加」），每个词带 × 可删除。
- 内置硬词 / 内置软词 / 英文整词 / 显示名词：脚本内置词表，可折叠查看，逐词删除。
- 恢复全部默认屏蔽词：一键还原所有被删除的内置词。
所有增删操作都会立即重新过滤当前页面：删除某个词后，原本因此被隐藏的推文会恢复显示。
自定义词默认开启「类似词匹配」，可拦截常见变体写法：
- 大小写变体：
SAO/sao - 空格/零宽字符变体：
福 利 - 间隔字符变体：
福/利命中「福利」（相邻两字间隔最多customKeywordMaxGap个字符，默认 1，「福气与利」不会误命中）
脚本顶部 CONFIG 可调整：
| 配置项 | 说明 |
|---|---|
autoBlock |
true 自动拉黑 + 隐藏；false 仅隐藏（默认） |
autoHide |
是否自动隐藏命中规则的推文 |
showFilteredPlaceholder |
是否显示「已按屏蔽规则隐藏」占位符 |
suspiciousDisplayNameKeywords |
显示名关键词，命中即判定为机器人 |
blockKeywords |
推文内容硬屏蔽词，命中即过滤；英文不区分大小写 |
wordKeywords |
英文整词屏蔽词，按单词边界匹配（sao / ys / ex 等） |
softKeywords |
推文内容软屏蔽词，避免误伤，需满足组合规则 |
softMinHits |
一条推文命中 ≥ N 个软词即过滤（默认 2） |
softWithSignal |
命中 1 个软词 + 随机 handle / 纯 emoji 强信号时过滤 |
customKeywordMaxGap |
自定义词类似词匹配允许的字符间隔（默认 1） |
randomHandlePattern |
随机字母数字 handle 的正则 |
requireBothConditions |
true 严格模式：关键词/handle 命中且内容为纯 emoji 才过滤 |
软词档用于避免单字/常见词误杀：单独出现不过滤，组合或带强信号才过滤。想「见词就杀」可把词从
softKeywords移到blockKeywords。
- 用户默认清单：蹲个弟弟、涨粉、少妇、看片、日本美女、AI裸照、crypto、giveaway、普通人也可以、这仅仅是开始、每天赚钱、快速获利、万达广场、福不黑、太涩、探花、玩的开、玩得开、锐评
- 常见套路补充：私我、评论扣、躺赚、刷单、带单、稳赚、包赚、内幕消息、内部消息、支付宝口令、订阅链接
sao、ys、ex
币、狗、资、永久、弟弟、主人、附近、小姐、福利、线下、同城、暴论、春节、春晚、搭子、小狗、墨迹、勿扰、进群、副业、薅羊毛、百分百、机场、翻倍、代购、加我、滴滴、身体、骚、福、进入、体制、反差
同城、上门、面付、约炮、约啪、自拍、私聊、福利、视频、裸聊、直播、外围、小姐、学生妹、兼职、援交、勾搭、约单、在线、聊天赚钱、快手、玩得开、少妇、搭子、附近、互粉、蓝V、涨粉、咸鱼、闲鱼、陪聊、陪玩、空降、蹲个弟弟
- 脚本完全在本地运行，不发送任何网络请求，无统计、无埋点。
- 自定义屏蔽词与设置仅保存在浏览器
localStorage（x.com 与 twitter.com 域名互相独立），不上传。 - 脚本使用
@grant none，不需要任何额外站点权限。
如果你认为清单中的某个屏蔽词涉及法律问题（名誉权、隐私、商标等）或不合理，欢迎通过内容申诉模板提交。作者审核后会删除或调整相关词条，处理说明见 REPORTING.md。
- 脚本依赖 X 页面的 DOM 结构（
data-testid等选择器），X 改版后可能失效，需要相应更新。 - 过滤判定为启发式规则，可能存在误杀或漏网，建议通过屏蔽词面板按需调整。
.
├── x_bot_filter.user.js # 用户脚本本体
├── README.md # 本说明
├── CHANGELOG.md # 版本变更记录
└── LICENSE # MIT 许可证