Yuedu书源净化调试：4类显示问题逐个修好

【免费下载链接】Yuedu📚「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu

Yuedu书源仓库是「阅读」APP的书源分享项目。书源本质是一套解析规则，书源净化调试的难点集中在导入书源后最常见的四类显示问题：广告残留、乱码、章节重复、图片混入。本文按症状逐个给药方。

一、书源净化规则到底在改什么

书源净化就是两件事：选对内容区，删掉文字里的杂质。

shuyuan 文件里每个书源都有ruleSearch、ruleBookInfo、ruleToc、ruleContent四组规则，对应搜索页、详情页、目录页、正文页，显示问题大多出在ruleContent上。规则的结构是「选择器＋清洗正则」：选择器负责从页面里圈出哪块是正文，正则负责把不想要的行删掉。

比如仓库里起点中文书源：

"ruleContent": { "content": "class.read-content@html" }

class.read-content@html的意思是「取 class 为 read-content 的元素的 HTML」，这就是「选内容区」那一步。「删杂质」有两个常用写法：选择器后面可以跟##正则，命中的就地删除（八一中文书源用它删掉「请退出转码」行）；也可以在ruleContent里配replaceRegex，对最终取到的文本做整体替换。

前提是书源已经导入：扫二维码即可导入 shuyuan 地址，入口在「我的-书源管理」。

二、按症状开药方，一症一改

🧹 广告残留：过滤规则怎么写

正文混着「(本章完)」、水印或广告行，改法是写进replaceRegex删掉。

原因不是选择器选错了位置，而是网站把垃圾文本塞进了内容区，书源没做清洗。

把垃圾文本的特征写成正则即可，仓库里阅友小说书源是现成例子：

"ruleContent": { "content": ".con@html", "replaceRegex": "##[\\(（]本章未完.*[）\\)]|[\\(（]本章完[）\\)]" }

replaceRegex 里##是固定前缀，后面的正则就是要删掉的内容；这条规则删掉「(本章未完…」和「(本章完)」两类行。

改完连翻 3～5 章，每章都只剩正文，就算修好。

📄 书源乱码怎么修

正文出现乱码或夹杂无意义符号，改法是先重定位 content 选择器。

多数不是编码问题，而是选择器选错了节点，比如选到了脚本块；少量情况是网站换了页面模板。

用 PC 浏览器打开真实页面核对，找到正文实际所在的节点，把content重新指向它；如果是方框乱码且网站本身用 GBK 编码，规则层面能做的不多，换一个编码正常的同源书源更快。

通读一整章：没有连续乱码、标点正常即可，也可以把首尾两段和网站页面对照一遍。

📑 书源目录章节重复怎么处理

目录里同一章重复出现多次，改法是把ruleToc里的chapterList选择器收窄。

原因是chapterList匹配到了比预期更宽的元素，同一个列表被取了好几次。

把它收窄到只包含章节链接的最小列表；也可以加切片只取最后一段——仓库里 69书吧 书源用的是id.catalog.0@tag.ul.0@tag.a[-1:0]，只取最后一个 ul。

重新打开目录：章节数和网站显示一致、没有重复章节名、最新章节在末尾。

🖼️ 书源正文图片混入怎么挡

正文里插着 logo、广告等图片，改法是让 content 只取文字、不取整块 DOM。

原因是content用了@html，整块内容连 img 标签一起被取回来。

把@html改成@text或@textNodes，仓库里就爱文学书源就是这么做的：

"ruleContent": { "content": "#ccontent@textNodes" }

需要保留部分图片时，可参考仓库里手机小说书源设置的imageStyle字段。

翻几章图片较多的章节，正文里没有图片块就算修好。

三、两类疑难情况：动态加载与反爬拦截

正文为空但网站页面有内容，通常不是规则写错，而是正文由 JS 动态加载；对策是 content 里包一段<js>块，先用java.ajax请求到真实的内容接口，再把结果交给选择器，仓库里番茄小说2、来看文学书源都是这个做法。

请求被 403 拦截或弹验证，说明触发了网站限流；一套对策是确认书源的enabledCookieJar已开启，在header里配 User-Agent / Referer，同时把 APP「其它设置」里的预下载和更新线程数调到 1～5，README 建议就是这个区间。

四、改规则前先系上安全带

改书源前一定给自己留后路。先把当前书源文件导出备份，文件名带日期（如 shuyuan_0601.json），改坏了直接导入旧文件回滚；不想本地存文件的话，也可以用 APP「我的-备份与恢复」做一次本地备份，书源丢了再走二维码导入重新拉回 shuyuan 地址即可。

✅ 五、书源调试自查清单

修不好时按顺序逐项核对：

1. 书源已出现在「我的-书源管理」里并勾选启用
2. 搜索能找到书，书名、作者、封面齐全
3. 目录章节数与网站一致，无重复
4. 正文内容区选对，第一章完整
5. 连翻 3～5 章，无广告、乱码、图片
6. 正文为空时，用 PC 浏览器核对网站是否换了模板
7. 网站有限流时，预下载和线程数调到 1～5

一句话总结：先定位问题出在哪一组规则，再决定是收窄选择器还是加清洗正则。修出好用的净化规则，欢迎到项目 README.md 的反馈渠道分享出来，给其他用户参考。

【免费下载链接】Yuedu📚「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu