Install Toggle Dropdown

• Install with minification
• Userscript Beginners HOWTO

max / 净搜 CleanSearch

一种基于vibe coding的去广告插件
人话：AI写的去广告插件，主要适配bing、百度
# 净搜 CleanSearch

> 搜索引擎去广告净化脚本（Tampermonkey / Violentmonkey / Greasemonkey 油猴脚本）
> 只做一件事：**去广告、去竞价排名**。不做重定向、不做美化、不掺推广。

净搜专注屏蔽**搜索引擎的竞价排名广告与推广内容**，覆盖百度 / 谷歌 / 必应 / 360 搜索，以及知乎、B站、豆瓣、微博、CSDN、百度系子站（贴吧 / 文库 / 百科 / 知道）等中文站点的常见广告位。内置零依赖设置面板，无任何第三方推广与暗桩。

> ⚠️ **AI 生成声明**：本项目代码与文档由 AI 协作生成（human-in-the-loop，作者 VeT_SHIUAN 全程测试与验收）。如发现问题欢迎提 Issue / 反馈。

---

## ✨ 为什么值得用

| | 净搜 CleanSearch | 同类对比 |
|---|---|---|
| **人无我有** | 一个脚本覆盖 5 个搜索引擎 + 中文站点全家桶；必应广告追踪链识别；CSS 伪元素角标检测 | AC-baidu 等主要深耕百度 |
| **人有我优** | 四级广告判定（结构属性 → 专用类名 → 角标文本 → 自定义规则），多重防误杀约束；CSS + DOM 双保险 | 比"整块按类名删除"更精细 |
| **人优我特** | 纯净开源（MIT）、零外部依赖、零推广跳转、命中计数可视、旧数据自动迁移 | 部分同类脚本内置作者推广/赞助链接 |

## 📦 安装

1. 浏览器安装 [Tampermonkey](https://www.tampermonkey.net/)（Edge/Chrome/Firefox 均支持）
2. 点击安装：
（或 GreasyFork 页面一键安装）
3. 打开百度 / 必应搜一个商业词（如"英语培训"），广告条应消失

## 🎛 使用与设置

- 点击油猴图标 → **净搜 · 设置**：总开关、10 个站点开关、功能开关、屏蔽关键词 / 屏蔽网址 / 白名单、配置导入导出
- 控制台接口：`window.__CleanSearch = { version, openPanel, runAll }`
- 旧版"【屏蔽广告】"脚本（GreasyFork 460743）的屏蔽词表会自动迁移一次

## 🗂 支持范围

| 分类 | 站点 |
|---|---|
| 搜索引擎 | 百度搜索（PC/移动）、谷歌、必应、360 搜索 |
| 百度系 | 贴吧、文库、百科、知道、图片、视频、经验、好看 |
| 社区/内容 | 知乎、B站、豆瓣、微博、CSDN |

## 🔍 广告判定原理（透明公开）

广告识别按优先级执行，命中即移除最近的结果级容器：

1. **结构化属性**：`data-tuiguang`、`data-module="ad"`、`data-placeid`、`cmatchid`
2. **广告专用类名**：`ec-tuiguang`、`ecom-result`、`cos-pc-ad-container` 等
3. **角标文本**：识别"广告 / 推广 / 商业推广 / Sponsored"等角标——兼容纯文本、**图标+文字混排**、**CSS 伪元素渲染**三种形态
4. **自定义规则**：用户屏蔽的关键词（标题/摘要）与网址片段

判定全程在结果容器内进行，正常结果的类名（如百度 `c-container`、必应 `b_algo`）只作定位不作删除；右栏"相关搜索"等正常栏目默认保留（可开关）。

## 🔒 隐私

- 脚本**不向任何第三方发送数据**，无统计、无上报
- 唯一的网络请求：百度搜索结果的跳转链接解析（`baidu.com/link?url=...` → 真实地址，用于网址屏蔽判定），仅在你启用了"网址屏蔽"且结果为百度跳转链时发生，请求直达百度，结果仅存于本页面会话内存
- 所有配置存储在浏览器油猴本地存储（`GM_setValue`），不经过任何服务器

## ⚠️ 已知限制

- 搜索引擎（尤其百度）会不定期改版 DOM，若某天出现漏删，请打开设置检查开关，或到 Issue 反馈搜索词与页面截图
- 360 搜索、豆瓣、微博的广告容器未经大规模实测，规则以保守为主

## 📜 更新日志

- **0.1.2**：整合 AC-baidu 现行去广告规则（角标兼容 `广告`、顶部推广流、右栏清理、CSS 兜底隐藏、谷歌 `aria-label`、必应 `ad_fls`）
- **0.1.1**：角标判定兼容"图标+文字"混排与 CSS 伪元素；必应广告追踪链接识别
- **0.1.0**：首个版本。原生 JS 全量重写（前身为已下架脚本 GreasyFork 460743，其含恶意推广已整体剔除）；内置设置面板、旧数据迁移、MutationObserver 增量净化

## 📄 License

[MIT](./LICENSE)

---

*由 AI 生成 · 作者 VeT_SHIUAN · 2026*