# Zhihu Cleaner

**Repository Path**: constfiv/zhihu-cleaner

## Basic Information

- **Project Name**: Zhihu Cleaner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zhihu Cleaner

<p align="center">
  <img src="./logo.png" alt="Zhihu Cleaner Logo" width="180" />
</p>

一个用于知乎首页信息流清理的 Chrome 插件。

`Zhihu Cleaner` 的目标是提升知乎首页的信息密度，减少空泛讨论、引战内容、政治相关内容和广告卡片，让首页更接近“具体问题导向”的浏览体验。

## 功能简介

- 只作用于 `https://www.zhihu.com/` 首页信息流
- 支持隐藏：
  - 空泛话题
  - 引战问题
  - 政治相关内容
  - 首页广告卡片
- 支持三档屏蔽强度：
  - 低强度
  - 中强度
  - 高强度
- 支持用户自定义词条
- 默认词库和评分参数保存在代码文件中，便于继续调优

## 截图展示

### 插件弹窗

![插件弹窗](./screenshot/3.png)

### 部分过滤词示例

![词库配置页](./screenshot/2.png)

### 过滤效果示例

![首页过滤效果](./screenshot/1.png)

## 下载项目

你可以通过以下两种方式获取项目：

### 方式一：下载 ZIP

1. 打开本项目的 GitHub 仓库主页
2. 点击右上角绿色 `Code` 按钮
3. 点击 `Download ZIP`
4. 下载完成后解压到本地目录

### 方式二：使用 Git 克隆

如果你本机安装了 Git，可以执行：

```bash
git clone <仓库地址>
```

把 `<仓库地址>` 替换成你自己的仓库 URL。

## 在 Chrome 中安装

1. 打开 Chrome 浏览器
2. 在地址栏输入 `chrome://extensions/`
3. 打开右上角的“开发者模式”
4. 点击“加载已解压的扩展程序”
5. 选择本项目根目录
6. 加载完成后，浏览器工具栏中会出现 `Zhihu Cleaner`

如果你之前已经加载过旧版本：

1. 打开 `chrome://extensions/`
2. 找到原有扩展
3. 点击“刷新”
4. 回到知乎首页并刷新页面

## 如何使用

### 1. 在弹窗中选择过滤类型

点击浏览器工具栏中的 `Zhihu Cleaner` 图标，可以直接勾选：

- 空泛话题
- 引战问题
- 政治相关

### 2. 在弹窗中调整屏蔽强度

- 低强度：更保守，只有分数较低的内容会被隐藏
- 中强度：默认推荐值
- 高强度：更激进，更容易触发隐藏

### 3. 编辑自定义词条

点击弹窗中的“编辑词库配置”后：

1. 点击“添加一行”
2. 选择类别
3. 输入关键词
4. 选择权重
5. 点击“保存”

这个页面只展示你自己的自定义词条。

默认词库不会显示在页面里。

## 评分逻辑

当前版本采用统一评分制：

1. 每个标题的初始分数为 `100`
2. 以 `30` 字为中间值
3. 标题字数大于 30，每多 1 个字加 1 分
4. 标题字数小于 30，每少 1 个字减 1 分
5. 如果标题不是以 `?` 或 `？` 结尾，会额外减 `10` 分
6. 命中已启用类别的消极词条后，按权重扣分
7. 命中积极词条后，按权重加分
8. 最终分数与当前强度阈值比较，低于阈值则隐藏

### 权重分值

- `high`：50 分
- `medium`：30 分
- `low`：10 分

### 强度阈值

- `低强度`：50
- `中强度`：70
- `高强度`：90

## 项目结构

```text
.
├─ content.js
├─ filter-data.js
├─ manifest.json
├─ popup.html
├─ popup.css
├─ popup.js
├─ options.html
├─ options.css
├─ options.js
├─ logo.png
├─ icons/
└─ screenshot/
```

## 自定义与二次开发

如果你想修改默认词库或评分参数，可以直接查看：

- `filter-data.js`
- `content.js`

## 说明

- 当前主要针对知乎首页信息流结构进行处理
- 如果知乎页面结构发生变化，过滤逻辑可能需要调整
- 当前面向 Chrome 浏览器

## License

本项目建议使用 MIT License。