# 社交评论关键字过滤浏览器插件

**Repository Path**: wjy000/SocialCommentKeywordFilteringBrowserPlugIn

## Basic Information

- **Project Name**: 社交评论关键字过滤浏览器插件
- **Description**: Chrome 浏览器插件。自定义关键字，自动隐藏 **YouTube** 和 **X / Twitter** 评论中命中关键字的评论，被隐藏的评论可以手动展开查看。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社交评论关键字过滤浏览器插件

Chrome 浏览器插件。自定义关键字，自动隐藏 **YouTube** 和 **X / Twitter** 评论中命中关键字的评论，被隐藏的评论可以手动展开查看。

## 功能特性

- **自定义关键字**：在插件弹窗中添加 / 删除关键字，评论文本包含任意关键字即被过滤（大小写不敏感）。
- **两平台支持**：
  - YouTube：过滤整个评论线程（含回复）。
  - X / Twitter：在帖子详情页过滤回复列表（自动跳过主推文）。
- **连续分组，批量操作**：命中的评论被隐藏；连续隐藏的评论自动合并为一组，只显示一个灰色小字按钮并标注数量（如"显示被过滤的评论 (3)"），点击整组灰色展开，展开后可点"隐藏这 N 条"整组收起，不干扰正常阅读。
- **实时生效**：修改关键字或开关后无需刷新页面，立即生效。
- **一键停用**：弹窗中的开关可临时停用全部过滤。

## 安装方法

1. 打开 Chrome，地址栏输入 `chrome://extensions/` 回车。
2. 打开右上角 **开发者模式**。
3. 点击 **加载已解压的扩展程序**，选择本项目目录（`comment-filter/`）。
4. 安装成功后在工具栏点击图标即可配置关键字。

## 使用说明

1. 点击工具栏插件图标，打开弹窗。
2. 输入关键字（如 `广告`、`spam`），回车或点"添加"。可添加多个。
3. 刷新或直接访问 YouTube / X 的评论区，命中关键字的评论会被自动隐藏。
4. 连续被隐藏的评论位置只有一个灰色小字按钮"显示被过滤的评论 (N)"，点击整组查看，展开后可点"隐藏这 N 条"整组收起。

## 文件结构

```
.
├── manifest.json     # Manifest V3 清单
├── content.js        # 内容脚本：评论过滤核心逻辑
├── content.css       # 页面内注入的占位条 / 按钮样式
├── popup.html        # 弹窗界面
├── popup.css         # 弹窗样式
├── popup.js          # 弹窗逻辑（关键字管理）
├── build_icons.py    # 图标生成脚本（python3 build_icons.py）
├── icons/            # 插件图标（16/48/128）
└── README.md
```

## 实现说明

- 评论过滤通过 `content.js` 中的 `MutationObserver` 监听评论懒加载，命中关键字即隐藏。
- 配置存储在 `chrome.storage.sync`，多设备同步。
- X / Twitter 端仅在帖子详情页（URL 含 `/status/`）生效，避免误伤时间线推文。

## 已知限制

- 仅作用于运行期间新加载 / 已加载的评论，页面结构变更（如 YouTube 改版）可能需要调整选择器。
- 展开状态不持久化，刷新页面后需重新展开。