告别广告弹窗!Yuedu书源净化规则共享与社区库建设指南
你是否还在为阅读小说时频繁出现的广告弹窗、杂乱排版而烦恼?是否经历过精心配置的书源突然失效却找不到替代方案的困境?本文将系统介绍如何通过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),确保所有规则可自由修改与分发。
书源净化规则导入全指南
网络导入(推荐)
- 打开「阅读」APP,依次点击我的 → 书源管理
- 点击右上角**┇ → 网络导入**
- 输入以下任一国内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
本地导入(适合网络不稳定情况)
- 访问项目主页下载shuyuan规则文件
- 保存至手机可访问目录
- 在书源管理中选择本地导入并选择下载的文件
导入操作示例

从左至右依次为:书源管理入口、导入菜单、网络导入界面、本地文件选择
高级净化配置技巧
自定义广告过滤规则
在书源详情页点击编辑 → 净化规则,可添加自定义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」
社区规则贡献流程
规则编写规范
- 基础格式:遵循JSON Schema规范,包含
bookSourceName、bookSourceUrl等必填字段 - 净化规则:使用CSS选择器而非XPath,优先保留
article、div.content等标准标签 - 注释要求:对特殊处理逻辑需在
bookSourceComment中说明,如起点中文的Cookie验证机制
贡献步骤
- Fork项目仓库:https://gitcode.com/gh_mirrors/yu/Yuedu
- 编辑shuyuan文件添加新规则
- 提交PR并说明规则适用网站及净化效果
常见问题解决方案
规则导入后无内容显示
- 检查网络连接,尝试切换不同CDN地址
- 确认书源是否启用:在书源管理中勾选对应规则
- 清除APP缓存:设置 → 应用管理 → 阅读 → 清除缓存
净化不彻底或误删内容
- 进入书源编辑界面,点击预览查看原始HTML结构
- 使用浏览器开发者工具分析干扰元素class属性
- 细化CSS选择器,避免使用过于宽泛的匹配规则
社区共建生态展望
Yuedu社区库目前采用"核心维护者+热心贡献者"的协作模式,未来计划引入:
- 规则投票机制:社区评分决定规则优先级
- 自动化测试:定期验证规则有效性并发送提醒
- 规则模板库:按网站类型提供标准化配置模板
如果你有好的建议,可通过项目Issues功能反馈
结语
通过社区共建的书源净化规则库,我们不仅能获得干净的阅读体验,更能形成知识共享的良性循环。记住,每个微小的规则改进都可能让成千上万的书友受益。立即访问项目仓库获取最新规则,同时将你的净化方案分享给社区,共同打造无广告的阅读净土。
本文规则基于Yuedu v3.29.0版本编写,不同版本界面可能存在差异,请以实际APP为准
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0446
源启盛夏_AtomGit暑期开发者成长计划「源启盛夏」暑期校园开发者成长计划旨在激活校园开源力量,通过积分激励、认证扶持、资源倾斜等形式,引导高校组织和开发者完成「入驻 — 建项目 — 做贡献 — 获认证 — 得资源」的完整闭环。无论你是想带领社团入驻平台的组织者,还是希望用代码贡献证明自己的开发者,都能在这里找到属于你的成长路径。Markdown00
jiuwenswarmJiuwenSwarm 是一款基于openJiuwen开发的智能AI Agent,它能够将大语言模型的强大能力,通过你日常使用的各类通讯应用,直接延伸至你的指尖。Python0761
Hy3Hy3 是由腾讯混元团队研发的快慢思考融合的混合专家模型,总参数量 295B,激活参数 21B,MTP 层参数 3.8B。4 月底发布 Hy3 Preview 后,我们在 50 多个业务中获得了广泛的反馈,修复了各种体验问题,进一步提升了后训练的质量和规模。今天,我们发布 Hy3。它展现出显著强于同尺寸并比肩旗舰(参数规模往往是 Hy3 的 2~5 倍)开源模型的智能水平,显著提升了在各类产品和生产力任务中的实用价值。Python00
AscendNPU-IRAscendNPU-IR是基于MLIR(Multi-Level Intermediate Representation)构建的,面向昇腾亲和算子编译时使用的中间表示,提供昇腾完备表达能力,通过编译优化提升昇腾AI处理器计算效率,支持通过生态框架使能昇腾AI处理器与深度调优C++0310
DragonOSDragonOS is an operating system developed from scratch using Rust, with Linux compatibility. It is designed for **Serverless** scenarios. 使用Rust从0自研内核,具有Linux兼容性的操作系统,面向云计算Serverless场景而设计。Rust00