本脚本完全由 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 的强大能力来维护和定制这个脚本，即使您不是专业的程序员。
