首页
/ 告别广告弹窗!Yuedu书源净化规则共享与社区库建设指南

告别广告弹窗!Yuedu书源净化规则共享与社区库建设指南

2026-02-05 04:44:09作者:彭桢灵Jeremy

你是否还在为阅读小说时频繁出现的广告弹窗、杂乱排版而烦恼?是否经历过精心配置的书源突然失效却找不到替代方案的困境?本文将系统介绍如何通过Yuedu社区共建的书源净化规则库,打造无干扰的阅读环境,同时教会你参与规则贡献,让优质阅读体验惠及更多书友。读完本文,你将掌握书源规则导入、净化配置、社区贡献的全流程方法,彻底摆脱广告骚扰与书源失效困扰。

什么是书源净化规则

书源净化规则是「阅读」APP(Yuedu)实现网页内容过滤的核心机制,通过自定义CSS选择器和JavaScript脚本,移除小说页面中的广告、悬浮窗、无关导航等干扰元素,仅保留正文内容。与原始网页相比,净化后的阅读界面能将信噪比提升60%以上,大幅降低视觉疲劳。

Yuedu项目的README.md中明确指出,书源规则本质是"解析小说网站的搜索页、详情页、目录页、正文页,提取相关信息"的配置文件。社区共享的净化规则库则是将这些解析规则标准化、模块化,形成可复用的资源集合。

社区库核心价值与使用现状

现有书源规则结构解析

Yuedu社区库采用JSON格式存储书源规则,每个规则包含网站基本信息、解析路径和净化配置三大部分。以"起点中文"书源为例:

{
  "bookSourceComment": "需通过内置浏览器访问验证Cookie",
  "bookSourceGroup": "正版",
  "bookSourceName": "起点中文",
  "bookSourceUrl": "https://www.qidian.com",
  "enabledCookieJar": true,
  "enabledExplore": true,
  "header": "User-Agent: Mozilla/5.0 (Android 13; Mobile; rv:108.0) Gecko/108.0 Firefox/108.0",
  "search": {
    "charset": "UTF-8",
    "list": ".all-book-list > li",
    "name": ".book-mid-info h4 a",
    "next": ".lbf-pagination-next",
    "url": ".book-mid-info h4 a"
  }
}

其中search节点定义了搜索结果的解析规则,list字段指定内容列表的CSS选择器,name字段定位书名元素。通过这类结构化配置,APP能够精准提取有效内容。

社区共建数据表现

根据README.md统计,目前社区库已累计收录120+个主流小说网站的净化规则,覆盖90%以上的网络文学平台。规则平均更新周期为7天,热门网站如起点中文、纵横中文网的规则响应时间不超过24小时。项目采用GPL-3.0开源协议(LICENSE),确保所有规则可自由修改与分发。

书源净化规则导入全指南

网络导入(推荐)

  1. 打开「阅读」APP,依次点击我的 → 书源管理
  2. 点击右上角**┇ → 网络导入**
  3. 输入以下任一国内CDN地址并确认:
    • https://raw.ixnic.net/XIU2/Yuedu/master/shuyuan
    • https://raw.kkgithub.com/XIU2/Yuedu/master/shuyuan
    • https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/master/shuyuan

本地导入(适合网络不稳定情况)

  1. 访问项目主页下载shuyuan规则文件
  2. 保存至手机可访问目录
  3. 在书源管理中选择本地导入并选择下载的文件

导入操作示例

书源导入步骤

从左至右依次为:书源管理入口、导入菜单、网络导入界面、本地文件选择

高级净化配置技巧

自定义广告过滤规则

在书源详情页点击编辑 → 净化规则,可添加自定义CSS过滤规则。常见过滤场景及配置:

干扰类型 CSS选择器 示例规则
顶部悬浮广告 div[class*="ad-top"] display: none !important;
底部弹窗 div.modal-ad visibility: hidden;
侧边栏推荐 aside.sidebar width: 0 !important;

性能优化设置

为避免频繁访问导致IP封禁,需在README.md推荐的其他设置中调整:

  • 预下载章节数:1~5章
  • 更新和搜索线程数:1~3线程
  • 启用Cookie持久化:开启「启用CookieJar」

社区规则贡献流程

规则编写规范

  1. 基础格式:遵循JSON Schema规范,包含bookSourceNamebookSourceUrl等必填字段
  2. 净化规则:使用CSS选择器而非XPath,优先保留articlediv.content等标准标签
  3. 注释要求:对特殊处理逻辑需在bookSourceComment中说明,如起点中文的Cookie验证机制

贡献步骤

  1. Fork项目仓库:https://gitcode.com/gh_mirrors/yu/Yuedu
  2. 编辑shuyuan文件添加新规则
  3. 提交PR并说明规则适用网站及净化效果

常见问题解决方案

规则导入后无内容显示

  1. 检查网络连接,尝试切换不同CDN地址
  2. 确认书源是否启用:在书源管理中勾选对应规则
  3. 清除APP缓存:设置 → 应用管理 → 阅读 → 清除缓存

净化不彻底或误删内容

  1. 进入书源编辑界面,点击预览查看原始HTML结构
  2. 使用浏览器开发者工具分析干扰元素class属性
  3. 细化CSS选择器,避免使用过于宽泛的匹配规则

社区共建生态展望

Yuedu社区库目前采用"核心维护者+热心贡献者"的协作模式,未来计划引入:

  • 规则投票机制:社区评分决定规则优先级
  • 自动化测试:定期验证规则有效性并发送提醒
  • 规则模板库:按网站类型提供标准化配置模板

如果你有好的建议,可通过项目Issues功能反馈

结语

通过社区共建的书源净化规则库,我们不仅能获得干净的阅读体验,更能形成知识共享的良性循环。记住,每个微小的规则改进都可能让成千上万的书友受益。立即访问项目仓库获取最新规则,同时将你的净化方案分享给社区,共同打造无广告的阅读净土。

本文规则基于Yuedu v3.29.0版本编写,不同版本界面可能存在差异,请以实际APP为准

登录后查看全文
热门项目推荐
相关项目推荐