# browser_plugins

**Repository Path**: miaoguoxin/browser_plugins

## Basic Information

- **Project Name**: browser_plugins
- **Description**: 一些浏览器插件，复制工具、去除复制限制、广告拦截、去除csdn遮罩
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Unhide Reader 工具集合使用说明

本扩展是一个“阅读增强工具集合”，包含：
- CSDN 正文解遮罩/解折叠（只处理已下发到页面 DOM 的内容，不绕过权限）
- 解除网页“不可复制/不可选中”限制（轻量/强力模式）
- 复制工具：复制净化、复制为 Markdown
- 广告拦截：网络层规则集（DNR）+ 页面层广告净化（可恢复）

> 边界：本扩展不会绕过登录/付费/会员/DRM/服务端权限校验；只做前端交互/展示层增强与广告净化。

## 安装与更新
### Chrome / Edge 安装（开发者模式加载）
1. 打开扩展管理页：
   - Chrome：`chrome://extensions/`
   - Edge：`edge://extensions/`
2. 打开右上角“开发者模式”
3. 点击“加载已解压的扩展程序”
4. 选择目录：`browser-extension-unhide`

### 更新代码后如何生效
- 进入扩展管理页，对该扩展点击“重新加载/刷新”
- 若弹出新增权限提示（例如广告拦截相关），确认即可

## 弹窗工具集合（核心入口）
打开任意网页后，点击浏览器工具栏里的扩展图标，弹窗内按模块使用。

### 1) 复制工具
适用：想把选中的内容更干净地复制，或复制为 Markdown。

使用步骤：
1. 在网页里先选中一段内容（拖拽选中）
2. 打开扩展弹窗
3. 点击：
   - **复制净化**：对选区纯文本做清理（去零宽字符、收敛多余空行、尝试去掉常见“版权声明/来源/原文链接”等尾巴）
   - **复制为 Markdown**：把选区转成 Markdown（基础支持标题、段落、列表、链接、图片、引用、代码块、表格）

常见提示：
- `no_selection`：说明你没有在页面里选中任何内容

### 2) 解除不可复制（本页）
适用：页面通过 CSS/事件监听禁用选中、右键、复制等。

功能：
- **本页解除**：对当前标签页按需注入“解除限制”脚本
- **本页恢复**：回滚本页的修改（移除注入样式、恢复部分事件处理）
- **模式**：
  - 轻量：优先只解除 CSS/属性层限制，更稳
  - 强力：额外拦截部分事件，成功率更高，但可能影响页面快捷键/拖拽等交互
- **本域名偏好**：保存该域名下的默认开关与模式（用于下次快速使用）

推荐流程：
1. 先用“轻量模式”本页解除
2. 若仍无法选中/复制，再切“强力模式”
3. 恢复时点击“本页恢复”

### 3) 广告拦截
广告拦截分两层：
- **页面层净化（本页）**：隐藏/清理页面中已出现的广告位 DOM，支持恢复
- **网络层拦截（规则集）**：阻止部分广告/统计域名请求（目前以 csdn.net 为主）

弹窗内能力（页面层）：
- **本页净化**：对当前页执行广告净化（轻量/强力）
- **本页恢复**：回滚本页净化（恢复被隐藏/移除的节点与样式）
- **本域名偏好**：保存该域名的默认开关与模式

模式说明：
- 轻量：主要基于选择器隐藏常见广告容器、遮罩等，更稳
- 强力：更激进的 heuristics（例如识别覆盖层、iframe 广告特征、部分可疑内联脚本），可能误伤，建议按需使用

网络层规则集开关：
- 在“设置页”可以开关 **CSDN 网络广告规则集**

### 4) CSDN 遮罩/折叠（展开全文）
适用：CSDN 页面正文被遮罩/折叠，且正文内容已下发到 DOM。

功能：
- **立即处理**：尝试点击“阅读全文/展开全文/继续阅读”等按钮，移除遮罩并解除折叠限制
- **恢复原状**：回滚本页修改
- **本域名启用**：控制 csdn.net 是否自动生效/可用

提示：
- 如果状态显示“正文可能未下发”，表示服务端可能没有返回完整内容；扩展不会绕过权限。

## 设置页（Options）
弹窗底部点击“设置”进入。

当前包含：
- CSDN（csdn.net）启用开关
- 调试模式（在处理结果里展示更多信息）
- CSDN 网络广告规则集开关（DNR）
- 重置设置（恢复默认）

## 常见问题
### 1) 为什么按钮是灰色不可点？
- 当前页面不是 `http/https`（例如浏览器内部页 `chrome://`、新标签页、扩展页）无法注入脚本

### 2) 为什么“复制净化/复制为 Markdown”没生效？
- 需要先在页面里选中内容
- 某些页面会强拦截剪贴板/复制流程：先用“解除不可复制（本页解除）”再复制

### 3) 广告拦截为什么有时效果一般？
- 广告投放与域名很多且变化快。本扩展当前以“轻量、可控、合规”为目标：先覆盖 csdn.net 与通用少量规则
- 你可以把遇到的页面 URL 和广告元素截图发我，我可以把选择器/规则补进去

## 安全与合规说明
- 不采集你的浏览数据
- 不绕过服务端权限、不尝试恢复未下发内容
- 广告拦截与页面净化可能造成站点布局变化；遇到异常可用“本页恢复”回滚