移动端优化广告标记器 (增强版) 详细说明

一、脚本简介

移动端优化广告标记器 是一款专为移动设备设计的广告拦截与标记工具，具有以下特点：

核心特性

· 🎯 移动端优先设计：专为触摸屏优化，支持手势操作
· 📌 智能标记：通过点击或长按页面元素快速标记广告
· 🚫 实时拦截：保存规则后立即生效，支持临时拦截预览
· 🎛️ 可视化控制：悬浮菜单、控制面板和设置面板
· 📊 数据统计：记录拦截数量、规则统计等信息
· ⚙️ 高度可配置：支持暗色模式、震动反馈、手势设置等

技术特点

· 使用油猴脚本(Tampermonkey)框架，跨浏览器兼容
· 纯前端实现，不依赖外部服务器
· 本地存储规则和设置，保护用户隐私
· 响应式设计，适配各种屏幕尺寸
· 智能选择器生成，确保规则准确性

二、主要功能模块

1. 标记模式

· 开启方式：通过油猴菜单或悬浮按钮
· 标记方式：
· 点击标记：快速点击元素进行标记
· 长按标记：长按元素（约0.8秒）进行精确标记
· 双击保存：快速双击元素可直接保存规则（可选）
· 视觉反馈：标记元素会有彩色高亮边框

1. 拦截功能

· 永久拦截：保存规则后永久拦截匹配元素
· 临时拦截：预览模式下临时拦截，可撤销
· 暂停/恢复：可随时暂停拦截功能而不删除规则
· 智能匹配：支持CSS选择器，精准匹配页面元素

1. 用户界面

· 悬浮按钮：圆形悬浮按钮，点击打开主菜单
· 主菜单：可拖动、可调整大小的控制面板
· 控制中心：统计信息、规则管理、工具集
· 设置面板：个性化设置和偏好配置

1. 规则管理

· 自动生成：智能生成CSS选择器
· 预览测试：测试选择器匹配效果
· 分类存储：按域名分类存储规则
· 导入导出：支持规则备份和恢复
· 批量操作：清空特定域名或所有规则

三、详细使用方法

1. 安装与启动

2. 安装前提：需要先安装Tampermonkey或类似油猴脚本管理器

3. 安装脚本：将脚本代码复制到油猴脚本编辑器并保存

4. 首次运行：脚本会自动加载，页面右下角会出现悬浮按钮

5. 开启标记：通过油猴菜单选择"🎯 开启标记模式"

6. 基本操作流程

开启标记模式 → 点击/长按广告元素 → 预览拦截效果 → 保存规则

1. 详细步骤

步骤1：开启标记模式

· 方法一：点击油猴图标，选择"🎯 开启标记模式"
· 方法二：直接点击页面右下角的悬浮按钮（🎯）

步骤2：标记广告元素

· 简单标记：点击页面上的广告元素
· 精确标记：长按元素约0.8秒（会有震动反馈）
· 切换元素：点击其他元素会自动切换标记
· 清除标记：点击菜单中的"重置"按钮

步骤3：预览拦截效果

· 标记元素后，点击菜单中的"预览"按钮
· 系统会临时拦截匹配的所有元素（绿色高亮）
· 预览效果持续2秒，可手动清除

步骤4：保存规则

· 确认预览效果满意后，点击"保存"按钮
· 规则会立即生效，永久拦截该类型广告
· 可继续标记其他广告元素

1. 高级功能

规则管理

· 查看规则：在控制中心查看所有已保存规则
· 删除规则：在规则列表中找到并删除特定规则
· 批量清理：清空当前网站或所有网站的规则
· 导入导出：备份规则到JSON文件，或从文件恢复

控制中心功能

· 统计信息：查看拦截总数、今日拦截数等
· 拦截目录：按域名查看和管理拦截规则
· 工具集：
· 重新拦截：重新应用所有规则
· 导出规则：备份所有规则
· 导入规则：从备份恢复
· 重置统计：清零统计数据

设置选项

· 提示设置：控制是否显示提示消息
· 触觉反馈：调节震动强度（轻度/中度/强烈/关闭）
· 手势设置：启用/禁用双击保存和长按标记
· 菜单设置：菜单行为、可拖动性、暗色模式等
· 颜色设置：自定义标记高亮颜色

四、界面说明

1. 主菜单布局

[菜单头部]
  标题：广告标记
  控制按钮：大小切换、关闭

[快速操作区]
  标记 | 预览 | 保存 | 暂停/恢复拦截

[当前元素信息]
  标签 | ID | 类名 | 匹配数
  选择器显示（可点击编辑）

[高级操作]（展开模式下显示）
  预览 | 重置 | 保存 | 清除 | 拦截 | 控制台

[统计信息]（展开模式下显示）
  总拦截 | 今日拦截 | 本站规则 | 总规则

[本站规则列表]（展开模式下显示）
  规则1 [删除]
  规则2 [删除]

[菜单底部]
  状态指示器：标记 | 拦截 | 预览
  拦截计数显示
  大小切换按钮

1. 控制中心布局

[拦截控制]
  暂停/恢复拦截按钮
  状态显示

[规则管理]
  当前网站规则列表
  清空本站规则 | 清空所有规则

[数据统计]
  总拦截数 | 今日拦截 | 总规则数 | 本站规则

[拦截目录]
  按域名分组的规则列表
  可展开/折叠查看详情

[实用工具]
  重新拦截 | 导出规则 | 导入规则
  标记模式 | 重置统计

1. 设置面板布局

[提示设置]
  ✓ 显示提示消息
  ✓ 显示标记模式提示

[触觉反馈]
  震动强度：关闭 | 轻度 | 中度 | 强烈

[手势设置]
  ✓ 启用双击保存
  ✓ 启用长按手势

[菜单设置]
  ✓ 自动展开菜单
  ✓ 菜单可拖动
  ✓ 菜单可调整大小
  ✓ 记住菜单设置
  ✓ 暗色模式

[颜色设置]
  高亮颜色选择器

五、技术细节

1. 选择器生成算法

脚本使用智能算法生成CSS选择器：

1. 优先使用ID选择器（如果ID唯一）

2. 结合类名、属性、标签名

3. 使用:nth-of-type()处理同类型元素

4. 生成最短有效选择器

5. 自动验证选择器有效性

6. 拦截机制

· 永久拦截：添加element-blocked和permanent-blocked类，设置display: none
· 临时拦截：添加temporary-blocked类，降低透明度和饱和度
· 拦截状态管理：根据设置动态应用/移除拦截

1. 数据存储

· 规则存储：GM_setValue('adBlockRules', JSON.stringify(rules))
· 设置存储：GM_setValue('adMarkerSettings', JSON.stringify(settings))
· 统计存储：GM_setValue('adMarkerStatistics', JSON.stringify(stats))

1. 移动端优化

· 触摸事件处理：区分点击、长按、双击等手势
· 防止误触：菜单区域阻止事件冒泡
· 性能优化：防抖处理、异步更新、批量操作
· 视觉反馈：震动、动画、颜色变化等多重反馈

六、使用技巧与最佳实践

1. 标记技巧

· 精确标记：对于复杂页面，使用长按标记更准确
· 层级选择：标记父元素可拦截整个广告区域
· 动态内容：对于AJAX加载的内容，标记容器元素

1. 规则优化

· 测试规则：保存前务必使用预览功能测试
· 通用规则：尽量选择稳定的属性（如data-id、固定class）
· 避免过度拦截：选择器不要太宽泛，以免误伤正常内容

1. 性能建议

· 规则数量：单个网站建议不超过20条规则
· 复杂选择器：避免使用过于复杂的选择器
· 定期清理：删除无效或过期的规则

七、常见问题解答

Q1: 脚本安装后没有反应？

· 检查Tampermonkey是否已启用脚本
· 刷新页面重新加载
· 检查控制台是否有错误信息

Q2: 标记元素后没有效果？

· 确认已开启标记模式（顶部有提示条）
· 检查元素是否被正确高亮
· 尝试使用长按标记

Q3: 保存的规则不生效？

· 使用预览功能测试选择器是否有效
· 检查规则是否已保存（在控制中心查看）
· 确保拦截功能已启用（状态指示器为绿色）

Q4: 如何恢复误删的规则？

· 如果有备份，使用导入功能恢复
· 如果没有备份，需要重新标记

Q5: 脚本影响页面性能？

· 规则数量过多可能影响性能
· 建议定期清理无效规则
· 复杂的动态页面可能需调整拦截时机

八、安全与隐私

数据安全

· 所有数据存储在本地浏览器中
· 不会收集或上传任何用户数据
· 规则导出为纯文本JSON，不含敏感信息

隐私保护

· 不记录浏览历史
· 不跟踪用户行为
· 所有操作均在客户端完成

九、更新与维护

版本信息

· 当前版本：14.1
· 最后更新：详见脚本头部注释

更新日志

1. 增强移动端适配：优化触摸事件处理
2. 改进选择器生成：提高选择器准确性
3. 新增预览功能：临时拦截预览
4. 增强UI体验：可拖动菜单、暗色模式
5. 完善规则管理：导入导出、批量操作

问题反馈

如遇到问题或有改进建议，请：

1. 检查控制台错误信息
2. 确认Tampermonkey版本
3. 尝试禁用其他冲突脚本

十、注意事项

使用限制

· 仅支持支持油猴脚本的移动浏览器
· 某些网站的反广告措施可能影响脚本效果
· 动态加载的内容可能需要重新标记

兼容性

· 支持大部分现代移动浏览器
· 需要Tampermonkey 4.0以上版本
· 依赖部分ES6+特性

法律责任

· 本脚本仅供学习和技术研究使用
· 用户需遵守网站使用条款
· 请勿用于商业或非法用途

---

总结：移动端优化广告标记器是一个功能强大、易于使用的广告拦截工具，特别针对移动设备优化。通过直观的触摸操作和智能的规则管理，用户可以轻松屏蔽网页广告，提升浏览体验。脚本设计注重用户体验和隐私保护，是移动端网页浏览的实用工具。