本脚本完全由 AI (Gemini 2.5 Pro) 生成。
作者放弃此脚本的一切版权,不对此脚本产生的任何问题负责,也没有义务对此脚本进行维护。
为了共同抵制垃圾信息,允许任何人转载和修改此脚本。
X.com 九族拉黑 (Chain Blocker)
一个强大的 X.com (原 Twitter) 管理工具,旨在帮助您高效、批量地清理时间线上的垃圾信息和骚扰用户。
核心功能
- 💥 九族拉黑 (Chain Blocker)
- 当您对某个推文作者执行“九族拉黑”时,脚本会自动将作者、所有转推者 (Retweeters) 以及所有回复者 (Repliers) 加入后台处理队列,逐一进行拉黑。
- 🤖 智能自动拉黑 (Auto-Block)
- 自动扫描您的时间线、搜索结果等页面。
- 当检测到用户的昵称同时满足以下三个条件时,会自动执行“九族拉黑”或“单独拉黑”:
- 长度超长 (默认大于25个字符)。
- 包含中文字符。
- 包含至少2个斜杠字符 (
/
)。
- 此功能主要用于精准打击昵称中包含大量垃圾广告(如“查档/开盒/定位...”)的用户。
- ⚙️ 可视化配置面板
- 提供一个统一的设置面板,用于管理脚本的所有功能。
- 包含 设置、拉黑记录 和 白名单 三个标签页。
- 白名单与记录管理
- 所有被拉黑的用户都会被记录在“拉黑记录”中,方便追溯。
- 您可以轻松地将用户从拉黑记录中移至“白名单”,脚本将自动为您解除拉黑,并且未来不会再拉黑白名单中的用户。
- 支持在拉黑记录和白名单中进行实时搜索。
使用说明
手动九族拉黑
- 在任意一条推文上,点击右上角的“更多”(
...
)按钮。
- 在弹出的菜单中,找到带有 红色生物危害图标 (☣️) 的 “九族拉黑 (包括回复)” 选项,点击即可。
- 脚本会立即开始在后台收集转推者和回复者,并将他们加入处理队列。您可以在屏幕右上角看到队列状态通知。
配置与记录面板
- 点击浏览器右上角的 Tampermonkey (油猴) 图标。
- 在弹出的菜单中,点击 “配置与记录” 即可打开设置面板。
- 设置 (Settings) 标签页:
- 自动拉黑开关: 开启或关闭智能自动拉黑功能。
- 拉黑记录最大条数: 设置记录上限,防止记录无限增长。
- 自动拉黑生效页面: 配置需要自动扫描的 URL 规则,支持
*
通配符。
- 拉黑记录 (Block Log) & 白名单 (Whitelist) 标签页:
- 搜索框: 可以通过用户名、
@handle
或 User ID 实时筛选列表。
- 移至白名单: 在“拉黑记录”中,点击用户的
@handle
或其 User ID,该用户将被解除拉黑并移入白名单。
- 移除记录: 在“拉黑记录”中,点击时间戳可以仅将该用户从记录中移除(不会解除拉黑)。在“白名单”中,点击“移除”按钮可将其移出白名单。

🛠️ 【重要】当脚本失效时:如何自行修复
X.com 经常更改其内部 API,这可能导致脚本的“获取转推/回复列表”功能失效。本脚本已将这些易变的 API 端点(Endpoint)集中管理,方便用户在失效后自行修复。
如果您发现点击“九族拉黑”后,队列中没有新增用户,可以尝试按以下步骤操作:
打开开发者工具
- 在 X.com 页面上,按
F12
键打开浏览器的开发者工具,然后切换到 “网络(Network)” 标签页。
过滤网络请求
- 在“网络”标签页顶部的过滤框中,输入
graphql
,这样可以只显示 X.com 的 API 请求。
触发功能
- 在网页上执行一个会触发目标功能的操作。例如:
- 要查找回复列表的 API,请点击进入任意一条推文的详情页。
- 要查找转推列表的 API,请点击任意推文下方的“转帖”计数,在弹出的窗口中查看转推用户列表。
找到新的 API 请求
- 在开发者工具的网络请求列表中,您会看到一个新的请求出现。它的名字通常包含
TweetDetail
(用于回复) 或 Retweeters
(用于转推)。
提取新的哈希值 (Hash)
更新脚本
- 编辑此脚本,在代码顶部找到
API_ENDPOINTS
常量。
将对应功能(如 TweetDetail
或 Retweeters
)的 hash
值替换成您刚刚找到的新哈希值。
// 示例:将 TweetDetail 的哈希值更新
const API_ENDPOINTS = {
// ...其他端点...
TweetDetail: { hash: '-0WTL1e9Pij-JWAF5ztCCA', features: {...} } // 把这里的 hash 换成新的
};
保存脚本,刷新页面即可。
注意: features
对象也可能改变,但修复难度较高。通常情况下,只需更新 hash
即可解决问题。
附注:关于 HTML 结构注释
脚本代码底部有一段关于 HTML 结构的注释。这是为有一定开发经验的用户准备的,它简化了 X.com 推文和用户列表的层级结构,并标注了脚本依赖的关键选择器 (data-testid
)。如果未来 X.com 对页面布局进行大改版,导致脚本无法找到元素,您可以参考此注释来更新脚本中的 querySelector
部分。
🤖 【进阶】利用 AI 辅助修改脚本
脚本底部有一段特殊的注释,它被称为 FORMAT-PROTOCOL
。这不是代码,而是 给 AI 使用的指令集 (Prompt)。它的作用是让 AI (如 Gemini 2.5 Pro 等) 能够像一个专业的程序员一样,在严格的约束下修改这个脚本,从而最大限度地保留脚本的稳定性和可维护性。
为什么需要这个协议?
直接让 AI 修改复杂的油猴脚本通常会导致以下问题:
- 破坏逻辑: AI 可能会为了“优化”而重构代码,导致核心功能出错。
- 改变变量名: 使后续的调试和修改变得困难。
- 省略代码: AI 经常返回部分修改过的代码片段,而不是完整的、可直接使用的脚本。
- 过度美化/压缩: 改变代码风格,使其难以阅读。
FORMAT-PROTOCOL
通过设定明确的规则来解决这些问题。
如何使用?
当您想让 AI 帮你修改或增加功能时,请遵循以下步骤:
复制完整代码: 将整个油猴脚本的全部代码(从 // ==UserScript==
开头,到 </FORMAT-PROTOCOL>*/
结尾)完整地复制下来。
提出明确需求: 在代码的前面或后面,用自然语言清晰地描述您的修改需求。例如:
- “请帮我修正 XXX 的问题,这是它的 HTML 结构...”
- “请帮我增加一个功能,在配置面板里添加一个 XXX 的开关...”
- “九族拉黑按钮没有变红,请修复它的样式。”
发送给 AI: 将“您的需求” + “完整的脚本代码(包含协议)”一起作为一次完整的输入,发送给 AI。
正确使用示例:
【你的需求,例如:请帮我把九族拉黑按钮的图标换成火焰图标】
--- START OF FILE X.com Chain Blocker.user.js ---
// ==UserScript==
// @name X.com Chain Blocker
... (这里是完整的脚本代码)
...
</FORMAT-PROTOCOL>
*/
当 AI 看到这个协议后,它会明白自己需要:
- 返回完整的代码块,而不是代码片段。
- 保持原有的逻辑结构和变量名,只在必要的地方进行修改。
- 不添加无用的注释或省略号。
- 只对 CSS 字符串进行压缩,不压缩 JS 逻辑。
通过这种方式,您可以更安全、更高效地利用 AI 的强大能力来维护和定制这个脚本,即使您不是专业的程序员。