阅读APP书源怎么导入？3 种方式 + 排错清单一次讲清
【免费下载链接】Yuedu📚「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu
第一次打开阅读APP，在搜索框里输入书名，结果页空空如也。这很正常：APP 本身不含任何小说内容，它只按书源规则抓取并解析网页。把 Yuedu 项目的书源导入之后，搜索、看书、追更才真正可用。
准备工作与统一入口
shuyuan 是 Yuedu 项目根目录下的一个 JSON 文件，里面收录了 26 个经过测试的书源。每个书源就是一套解析规则：搜索请求发到哪里、目录从哪里截取、正文怎么清洗。没有这套规则，APP 拿不到网站上的内容。
三种导入方式共用同一个入口：右下角「我的」→ 页面顶部「书源管理」→ 点右上角的菜单图标。
📥 按你的处境选导入方式
手机在手、网络正常 → 二维码导入适合当场就把全部书源配好。
- 书源管理页点右上角菜单，选「二维码导入」
- 在电脑上打开二维码页面
- 用手机的扫码功能对准二维码，导入完成
需要重复或批量导入 → 网络导入适合多台设备都要装，或清缓存后要重新导入。
- 菜单里选「网络导入」
- 在弹窗中粘贴下面任一地址
https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/shuyuan https://cdn.jsdmirror.com/gh/XIU2/Yuedu/shuyuan- 点确定，APP 自动去重，已有的书源不会重复写入
网络受限或要留底 → 本地导入适合信号差，或想把文件留在手机里备查。
- 用电脑把 shuyuan 文件下载到手机存储
- 菜单里选「本地导入」
- 在文件选择器中找到下载的 shuyuan 文件并选中
导入后：看懂你的书源列表
打开书源管理页，全部书源以列表形式排开，每条书源前都有一个勾选框，可以随时启用或停用。
书源大致分三类：
- 正版站：起点中文、番茄小说2，更新与官方同步，最稳定
- 综合站：酷我小说、69书吧、快书网等，资源量大、题材覆盖广
- 特色站：带特定功能取向的书源，shuyuan 里的分组标签就是直接标注
以起点中文为例，这个书源支持的功能点：
- 月票榜、畅销榜、阅读指数榜、粉丝榜等多维度排行
- 男生/女生分区浏览，玄幻、仙侠、都市、科幻等题材筛选
- 完本作品筛选与最近更新追踪
- 搜索若触发 Cookie 验证，按提示手动点一下右上角的勾选按钮即可恢复
🔧 出问题时按症状排查
书源列表为空、导入失败
- 检查网络是否可用，移动数据换 Wi-Fi 试试
- 检查地址首尾有没有多余空格
- 在书源列表下拉刷新
- 仍不行：换另一个 CDN 地址重新导入
章节加载失败、正文空白
- 把「预下载章节数」改为 1，减少同时请求更稳
- 等 10~15 分钟再试，可能是临时限频
- 仍不行：导入另一个 CDN 地址的书源，切过去读
搜索无结果
- 把搜索线程数调低
- 换另一个书源搜索，个别书源的搜索本身不可用
- 稍后再重试
频繁弹验证码、访问受限
打开「阅读 → 其他设置」：
- 预下载章节数设为 1~5 章
- 更新和搜索线程数设为 1~5 线程
这两个数值直接决定你对网站的访问频率，调低能明显降低 IP 被限的风险。
💾 深度调优与备份
切源后显示「无最新章节」书源切换页右上角菜单，勾选「加载详情页」和「加载目录」，再重新加载，最新章节就会出现。
听书依赖 TTS朗读走的是手机 TTS 引擎，不少手机内置引擎不支持中文，需要单独装一个：TTS Server（内置微软 TTS，也支持其他声源接口）或 MultiTTS（支持众多离线语音）都可以。
备份保留多份
- 本地留版本：不同时点的 shuyuan 文件各存一份，随时可本地导入回滚
- 云备份：最新 shuyuan 上传云盘，书源失效或换机时恢复重导
- 多源冗余：同时保留多个书源，一个失效就切到另一个继续读
整理建议按站点类型（正版/免费/综合）、内容类型（玄幻/言情/科幻/都市）、更新频率（日更/周更/完本）给书源分组，比一长条列表好管理得多。
shuyuan 文件速览
shuyuan 是一个 JSON 数组文件，每个对象对应一个书源，主要字段：bookSourceName（名称）、bookSourceUrl（站点 URL）、bookSourceGroup（分组标签）、ruleSearch（搜索规则）、ruleExplore（发现规则）、ruleBookInfo（书籍信息规则）、ruleContent（正文规则）。
界面截图与二维码资源放在 dist/img/ 目录下。
新手最小路径：扫码导入 → 优先启用起点/番茄 → 预下载与线程数调到 1~5 → 看到完本小说及时读完缓存。做到这四步，就可以正常看书了。
【免费下载链接】Yuedu📚「阅读」自用书源分享项目地址: https://gitcode.com/gh_mirrors/yu/Yuedu
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
