阅读APP书源导入实战指南从0到长期维护的书源配置完整避坑笔记【免费下载链接】Yuedu「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu阅读APP是一款开源小说阅读工具APP本身不提供任何小说内容能不能搜到书、看到目录、读到正文完全取决于书源导入与书源配置这一步。这篇实战指南按装上APP → 第一次导入 → 导入后必改设置 → 长期维护 → 出问题时怎么救的顺序把书源是什么、三种导入方式怎么选、防限流参数怎么调、书源失效后如何排查一次讲清楚。什么是书源决定阅读APP能不能用的解析规则可以把书源理解成一份阅读说明书它告诉阅读APP面对某个小说网站时搜索页该从哪里抓取书名和作者、详情页该提取哪些信息、目录页怎么把章节一条条切出来、正文页怎么去广告、留正文。没有这份说明书阅读APP打开网站就像一台没有驱动器的机器——页面加载了但你什么都看不到。本仓库的 shuyuan 文件就是这份说明书的合集JSON 数组格式目前收录 22 个书源覆盖起点中文、番茄、酷我等站点。每条书源记录里真正影响体验的核心字段如下字段作用bookSourceName/bookSourceUrl书源名称与它解析的网站地址bookSourceGroup分组标签相当于该书的状态备注ruleSearch搜索页解析规则ruleBookInfo详情页书籍信息解析规则ruleToc/ruleContent目录与正文解析规则enabled是否默认启用阅读APP书源导入三种方式网络、二维码、本地怎么选三种方式入口都在同一个位置我的 → 书源管理再点右上角的┇菜单。下图按从左到右的顺序演示了完整路径第一次操作照着点即可网络导入粘贴一个地址搞定网络顺畅时首选书源管理页┇菜单选网络导入粘贴下面任意一个能通的地址点确定https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/shuyuan https://cdn.jsdmirror.com/gh/XIU2/Yuedu/shuyuan https://bitbucket.org/xiu2/yuedu/raw/master/shuyuan三个地址内容相同只是走不同的 CDN哪个打不开就换下一个用浏览器直接打开显示乱码是正常的不影响 APP 导入。二维码导入手机对着仓库里的二维码扫不想敲地址的话在┇菜单选二维码导入扫描下面这张仓库内置的二维码即可本地导入离线可用也是备份恢复的通道先到书源分享页下载shuyuan.json文件存进手机再回到书源管理选本地导入在文件选择器里挑中shuyuan.json。这种方式不依赖当下网络是否通畅后面做书源恢复时用的也是它。提示导入时 APP 会自动去重同一本书源重复导入不会产生多余条目。所以再导一次本身就是刷新书源的动作这一点后面维护时会用到。导入后先调这两个数字防止小说网站封你的IP别急着开书——绝大多数书源对应的网站都有访问频率限制访问太频繁就会封 IP 或弹验证码。装完先做这一步进入设置 → 其他设置把两项参数压低预下载章节数1~5。阅读APP会提前把前后若干章加载进本地数值越高对网站请求越密更新和搜索线程数1~5。它决定同时用几个线程去搜索、更新也影响离线缓存的并发速度。判断是否已经触发限制的信号很典型离线缓存一本书时前面章节成功、后面章节成片失败——基本就是撞墙了。此时把线程数降到 1歇 10~15 分钟再试。22个书源怎么选先搞清正版站、API站、免费站的差别打开 shuyuan 扫一眼书源大致分三类各自脾气不同类型代表书源特点正版站起点中文内容全、更新及时探索页有月票榜、畅销榜等完整分类搜索带 Cookie 验证首次需按提示在弹出的网页点一下[√]API 站番茄小说2、酷我小说走平台接口加载快部分如番茄小说2需要先在书籍信息页登录界面里获取密钥才能读到正文免费站速读网、快书网、铅笔小说、得奇小说网等数量最多资源散不少标注了人机验证或搜索暂不可用挑书源时看bookSourceGroup字段就够了它相当于作者写的状态备注分组里写着人机验证搜索暂不可用的说明该站反爬严格或规则暂时失效默认不启用日常以起点中文这类正版站为主力免费站留两三个当备胎不要押在单一书源上。切换书源后显示无最新章节勾上这两个选项一些小说站的搜索页本身就不返回最新章节这个字段这类书源切过去后书籍信息页会显示无最新章节——这不是坏了是信息源里没有。处理办法在书籍信息页的书源切换区域点右上角┇把加载详情页和加载目录两个选项勾上再切换APP 就会主动去请求详情页和目录页最新章节随之补齐。进阶书源配置自定义解析规则与广告过滤用熟了之后可以在书源管理里新建书源或编辑现有书源做三件进阶的事改解析规则网站改版导致正文或目录抓不到时按新页面结构调整ruleContent、ruleToc等规则加过滤规则在正文规则里追加内容过滤器把章节间的广告文案剔除应付反爬给请求带上自定义 header 或启用 Cookie 存储enabledCookieJar模拟正常浏览行为。README.md 里也提到了起点书源的 Cookie 验证逻辑这类需要人工配合一次的书源第一次按提示操作通过后后续一段时间内搜索就能恢复。书源维护节奏多久重导一次、怎么整理、怎么备份更新书源规则会随网站改版失效建议每周左右用网络导入再跑一次——APP 自动去重旧规则会被新版覆盖不需要手动删干净。整理书源多了之后按分组标签理一遍正版 / API / 免费各归各也可以再按题材玄幻、都市、科幻或更新频率日更、完本在脑子里建个索引找书更快。备份书源管理支持把自己的书源配置导出成文件配合本地导入就构成备份 → 恢复闭环换手机、重装 APP 时直接导回来即可。最重要的一条看完本小说时趁早全本缓存并导出为 TXT。书源来自第三方网站随时可能失效本地文件才是真正属于你的收藏。突然不好使了先排查这三种情况导入后书源列表里没东西先确认网络是否正常、地址里有没有多敲空格换一个 CDN 地址重试再下拉刷新书源列表仍不行就走本地导入兜底。章节加载失败把预下载章节数临时降到 1、线程数降到 1等十几分钟让网站消气再试同一本书如果别的书源能加载说明是这个站的问题直接切源不必死磕。搜索无结果或报错看该书源分组标签——写着搜索暂不可用人机验证的基本是网站端反爬升级属于书源状态问题而非你配置问题换书源搜索即可或者等维护者更新规则。另外两条轻量建议大规模更新书源、离线缓存整本书时尽量连 Wi-Fi 完成能省流量也能避免频繁切网带来的失败APP 缓存积多了定期清理一次读取速度会明显回来。避坑清单开始书源配置前对照一遍预下载与线程数先压到1~5这是防封 IP 的核心参数分组带人机验证 / 搜索暂不可用的书源默认别启用同一本书保留 1~2 个备用书源主源失效时能无缝切换完本小说尽早全本缓存 导出 TXT书源死了也不影响阅读定期每周左右网络导入一次刷新规则并给自己导出一份书源文件做备份。一句话记住书源就是解析规则导入只是第一步——压低防限流参数、定期重导、缓存完本小说这三件事做到位阅读体验就能长期稳定。【免费下载链接】Yuedu「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考