阅读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），仅供参考