阅读APP书源实用指南Yuedu书源导入、调参与备份一篇搞定【免费下载链接】Yuedu「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu本文以 Yuedu 开源项目为例讲清阅读APP书源的配置全流程书源是什么、怎么导入、如何搭配主力与备份源、哪些参数要调低、听书和备份怎么设最后附一张故障速查表。看完约 10 分钟阅读APP就能正常用起来。 先搞懂书源是什么书源配置的地基书源没配好APP 就是个空壳。这一节用两段话讲清书源的作用和文件位置。「阅读」APP 本身不内置任何小说它的工作原理是解析小说网站的搜索页、详情页、目录页、正文页把信息提取出来显示给你。书源就是一套解析规则告诉 APP去哪个页面找书、书名写在哪一栏、正文从哪个标签开始、下一页按钮点哪里。书源文件就是把这些规则打包成的 JSON 文件JSON 是一种用文本存储数据的通用格式导入 APP 后即可生效。用一个类比理解书源像一张写得极其详细的取货单。「阅读」是个不认路的外卖骑手书源告诉它去哪条街网站域名、上几层楼哪个页面路径、敲哪个门牌号哪个字段才能拿到包裹小说内容。没有这张单子骑手再快也只能在楼下干等。Yuedu 项目的根目录就放着这个文件 shuyuan里面共 22 个书源配置涵盖起点中文这类正版站点、速读网这类免费站点以及酷我小说这类 API 源API 指网站直接提供结构化数据接口APP 无需解析网页。项目说明可看 README.md。 书源导入三步走三种方式对比着选这一节帮你挑最省事的导入方式一次成功不折腾。导入方式适用人群优点缺点适用环境二维码导入第一次用的用户扫一次码全部导入步骤最少内容固定随项目更新而变动有摄像头即可网络导入需要经常刷新书源的用户随时一键更新最稳定需网络能访问对应地址网络畅通本地导入离线或弱网用户完全离线一次下载多次复用要手动下载并保存文件无网络 / 弱网网络导入用到的地址来自 CDN内容分发网络可理解为同一文件存放在多台镜像服务器一个不通就换另一个https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/shuyuan https://cdn.jsdmirror.com/gh/XIU2/Yuedu/shuyuan推荐路径网络导入共五步打开「阅读」APP点击右下角「我的」点击「书源管理」点击右上角「⋮」菜单选择「网络导入」输入上面任一可用地址点击「确定」等待导入完成 提示导入时 APP 会自动去重同一书源重复导入不会产生两份放心反复操作。 搭一套自己的书源组合主力、备份、备用三层不用背 22 个书源的特点按「主力源 备份源 备用源」三层搭配就行。主力源是日常追更依赖的源标准是更新稳、加载快、排版干净。代表是起点中文正版分类支持分类浏览和月票榜、畅销榜等榜单导航内容最全面。注意它首次搜索时会触发一次 Cookie 验证Cookie 是网站留在浏览器里的小标识用来证明你来过APP 会弹出起点页面让你点一下「[√]」通过后一段时间内不再弹。备份源在主力源内容不全或加载慢时顶上同类型书换个源就能搜到。代表是番茄小说2免费源量大更新快和酷我小说API 源数据接口直接返回加载速度快。备用源平时可以不管前两层都失效时再启用比如速读网、铅笔小说等常规免费站以及需要偶尔点人机验证的站点。列表不用全开在「书源管理」里只保留 5~8 个常用源搜索一本书后看哪些源能命中常年搜不到书的源直接关掉列表干净了搜索也快。⚙️ 调好两个参数少被网站限制「加载慢、弹验证、缓存一半失败」的大头都出在下面这两个设置上都在「阅读 - 其他设置」里。预下载指提前把前后几章内容加载好建议设为1~5。更新和搜索线程数指同时发出多少个请求建议设为1~5。原理很简单小说网站普遍有访问频率限制请求太猛就像有人反复猛敲门网站会直接封 IP 或弹人机验证来拦你。如果离线缓存一本书时前面成功、后面整片失败基本就是触发限制了把线程降到 1等 10~15 分钟再试。两个常见情况的处理也归在这网络导入地址打不开CDN 镜像会挂换一个地址重试即可不影响已导入的书源。切换书源后显示「无最新章节」部分站点的搜索页本身不带最新章节信息。在书源切换页点右上角「⋮」勾选「加载详情页」和「加载目录」重新加载即可显示。 听书与备份设置一次书源失效不慌听书依赖 TTS文字转语音引擎即把文字读成语音的组件多数手机自带引擎不支持中文装一个第三方 TTS 即可。方案特点适合谁TTS Server内置微软 TTS支持其他声源接口追求自然音质MultiTTS支持众多离线语音常离线听书微软 TTS语音自然多语言微软生态用户Google 文字转语音免费集成度高日常随便听讯飞语记需在「通用设置 - 语音合成」开启「合成系统接口」安卓用户装好后在系统设置里把它选为默认 TTS 引擎再在阅读APP里点「听书」即可。书源备份恢复建议做三件事完本小说趁早全本缓存并导出为 TXT。书源来自第三方网站书源失效是常态本地 TXT 永远不会失效。把 shuyuan 文件存一份到手机本地失效后走「本地导入」恢复。电脑上也可以git clone https://gitcode.com/gh_mirrors/yu/Yuedu后把根目录的shuyuan拷到手机。把书源二维码存进手机相册随时扫码一键重导 排障速查表出问题先对这张表这一节把高频故障收成一张表照症状对号入座多数情况不用搜攻略。症状可能原因处理方法导入后书源列表是空的网络导入地址不通换另一个 CDN 地址重新导入导入后书源列表是空的文件没下完整重新下载 shuyuan 文件改走本地导入搜索没结果或弹验证触发网站人机验证点弹框中的验证按钮等 10~15 分钟再试切换书源显示「无最新章节」该站搜索页无此信息勾选「加载详情页」和「加载目录」后重加载章节整批加载 / 缓存失败触发频率限制预下载和线程数都降到 1过一会儿重试听书没有中文语音手机自带 TTS 不支持中文安装 TTS Server 等引擎并在系统设置选中 行动清单照做就完事完成首次书源导入优先网络导入确认「书源管理」里至少启用一个书源按「主力 备份 备用」挑 5~8 个源关掉用不上的预下载设为 1~5更新和搜索线程数设为 1~5完本小说全本缓存 导出 TXT手机里存一份 shuyuan 文件或二维码图片书源失效别慌重新导入一次即可疑难情况对照上面的速查表【免费下载链接】Yuedu「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考