# KeywordsGoAway

**Repository Path**: codekpy/keywords-go-away

## Basic Information

- **Project Name**: KeywordsGoAway
- **Description**: 基于篡改猴的屏蔽脚本
- **Primary Language**: JavaScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-05
- **Last Updated**: 2025-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KeywordsGoAway

#### 介绍
基于篡改猴(Tampermonkey)的百度热搜关键词过滤脚本，可以帮助用户过滤掉不想看到的热搜内容，打造更纯净的浏览体验。

#### 功能特点
- 精准隐藏包含指定关键词的热搜条目
- 支持多层容器匹配策略，确保完全隐藏相关内容
- 关键词本地存储，浏览器重启后仍能保留设置
- 实时监控页面变化，自动过滤动态加载的内容
- 支持自定义添加关键词和重置功能

#### 软件架构
1. 使用 Tampermonkey 提供的 API 进行用户脚本开发
2. 采用 MutationObserver 监听页面变化，实现实时过滤
3. 通过 CSS 样式隐藏匹配的内容
4. 利用 GM_setValue/GM_getValue 实现本地数据持久化

#### 安装教程
1. 首先在浏览器中安装 Tampermonkey 扩展
   - Chrome: [Tampermonkey 扩展](https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo)
   - Firefox: [Tampermonkey 扩展](https://addons.mozilla.org/zh-CN/firefox/addon/tampermonkey/)
2. 点击 Tampermonkey 图标，选择"添加新脚本"
3. 复制本项目 `index.js` 文件的全部内容，粘贴到编辑器中
4. 保存并安装脚本
5. 访问百度搜索页面，脚本将自动运行

#### 使用说明
1. 添加隐藏关键词
   - 点击 Tampermonkey 图标，选择"🎭 添加隐藏关键词"
   - 在弹出的输入框中输入要隐藏的关键词（如：演员、歌手）
   - 点击确定，关键词将被添加并立即生效
2. 重置关键词
   - 点击 Tampermonkey 图标，选择"🗑️ 重置关键词"
   - 所有已添加的关键词将被清除，页面将重新加载
3. 重新扫描页面
   - 点击 Tampermonkey 图标，选择"🔄 重新扫描页面"
   - 脚本将重新扫描当前页面并应用过滤规则

#### 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 版本历史
- v2.4: 优化多层容器匹配策略，提升过滤精准度
- v2.0: 增加 MutationObserver 实现实时过滤
- v1.0: 基础版本发布，支持关键词过滤功能