万达广场屏蔽

fuckwanda 是一个面向 X / Twitter 的浏览器扩展，用来自动隐藏“万达广场”及同类低质引流、刷屏、约聊、资源盘链接回复。

项目目标是尽量无感地清理评论区：命中后直接消失，不保留占位卡片；用户仍可以手动屏蔽、临时查看和恢复误封。

主要功能

• 自动扫描 X / Twitter 的时间线、帖子详情页和评论区。
• 命中基础规则或用户自定义提示词后，直接隐藏对应内容。
• 在每条回复右上角加入轻量屏蔽按钮，尽量贴近 X 原生按钮风格。
• 支持手动屏蔽单条回复，并在本地保存记录。
• 支持 Ctrl+Z / Cmd+Z 撤回最近一次手动屏蔽。
• 支持临时查看已屏蔽内容，便于检查误封。
• 支持本地同质文案聚类：相似内容多次手动屏蔽后，会沉淀成本地规则。
• 支持本地账号黑名单：同一账号多次被屏蔽后，后续内容自动隐藏。
• 支持导入、导出、迁移本地库，便于备份和规则分析。
• 支持关闭本地库，仅测试基础规则和自定义提示词命中率。
• 普通用户默认只看到自定义提示词；高级模式才显示底层基础规则。
• 支持手机屏蔽词同步：生成保守词库，并可在 X 屏蔽词页面辅助导入。

安装方式

推荐：解压加载

1. 下载 Release 里的 fuckwanda-v0.6.1.zip。
2. 解压到本地目录。
3. 打开 Chrome / Edge 的扩展管理页。
4. 开启“开发者模式”。
5. 选择“加载已解压的扩展程序”。
6. 选择解压后的扩展目录。

关于 .crx

Release 中也提供 fuckwanda-v0.6.1.crx。这是 Chrome 打包出的 CRX3 插件包。

但 Chrome / Edge 可能会拦截 GitHub 下载的非商店 .crx，表现为下载后自动删除或禁止安装。这不是 Manifest V2 问题；当前扩展使用 Manifest V3。

非商店分发时，最稳定的安装方式仍然是下载 zip、解压、开发者模式加载目录。

使用方法

1. 安装扩展后打开 x.com 或 twitter.com。
2. 扩展会自动扫描页面内容并隐藏命中的回复。
3. 点击浏览器工具栏里的扩展图标，可以快速开关插件和编辑自定义提示词。
4. 打开详细设置页，可以导入/导出本地库、迁移旧本地库、生成候选规则、开启高级模式。
5. 如需测试基础规则成功率，可在设置页关闭“启用本地库”。
6. 如需影响手机端 X App，可在设置页复制“手机屏蔽词”，或打开 X 屏蔽词页面使用插件注入的导入面板。

手机用户

手机端不能直接运行这个浏览器插件，但可以使用 X 自带的账号级屏蔽词能力作为兜底。

• 有电脑用户：在扩展设置页打开“手机屏蔽词同步”，复制词库或跳转到 X 屏蔽词页面导入。
• 没有电脑用户：打开 mobile-blocklist.txt，或直接打开 纯文本词库，复制里面的词组，导入到 X App 的屏蔽词功能。
• 词库格式：一行一个词组，无注释、无编号、无逗号，适合整体复制后一次性粘贴导入。
• 注意：手机屏蔽词只是一组高置信短词，不能覆盖插件里的组合规则、本地库、账号黑名单和误封恢复能力。

数据与隐私

• 当前版本的手动屏蔽记录、账号黑名单和同质文案规则都保存在本地浏览器中。
• 当前版本不上传用户数据，也没有共享库同步。
• 导出本地库时，会生成 JSON 文件供用户自行保存或分析。

后续规划

后续功能整理在 docs/ROADMAP.md。

重点方向包括：

• 共享屏蔽库：多人屏蔽同一文案或账号后进入共享规则。
• 周期提炼：定期从高频样本中提炼新的基础规则。
• 功德箱 / 黑榜：展示高频垃圾账号，并引导用户协作举报。
• 反滥用机制：防止恶意用户污染共享库。
• 误封检查页：集中查看、恢复和分析被隐藏内容。
• 更强同质聚类：减少换链接、换表情、换少量字后的漏网。
• 媒体类识别：区分纯图片、纯表情、卡片、二维码和视频链接。
• 发布工程：自动打包、版本记录和浏览器实测矩阵。

开发说明

本项目是 Manifest V3 扩展，无构建工具，主要由原生 HTML、CSS、JavaScript 组成。

常用检查命令：

node --check src/shared.js
node --check src/content.js
node --check src/local-db.js
node --check src/local-db-client.js
node --check src/background.js
node --check src/options.js
node --check src/popup.js
node -e "JSON.parse(require('node:fs').readFileSync('manifest.json','utf8')); console.log('manifest ok')"