企业官网建设流程全解析

阅读APP书源导入三步走：Yuedu 的 26 个高质量书源，导完还会排障

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

刚装好的阅读APP，没有书源就是一具空壳——搜不出书、打不开章节，界面上什么内容都没有。本文以「阅读」自用书源开源项目 Yuedu 为例，带你三步完成书源导入（覆盖起点中文、番茄小说、酷我小说等站点），再讲清楚书源不显示、章节加载失败时该怎么定位。

动手前，先看懂核心文件 shuyuan

先搞清楚书源是什么。阅读APP本身不带任何内容，它只是个解析器：照着规则去抓站点的搜索页、详情页、目录页、正文页，把信息抠出来摆到屏幕上。书源就是那份「抓取说明书」——去哪站、章节在第几层、正文从哪开始切，全靠它指路。说明书丢了，解析器只会原地空转。

Yuedu 把 26 份说明书打包在一个文件里，就放在项目根目录：

shuyuan # 26 个书源的 JSON 配置（核心文件） dist/img/ # 操作界面截图、二维码图片

shuyuan 是标准 JSON 格式，一个对象对应一个书源。每个书源包含 7 个关键字段：

bookSourceName / bookSourceUrl / bookSourceGroup ruleSearch / ruleExplore / ruleBookInfo / ruleContent

bookSourceName、bookSourceUrl、bookSourceGroup 说的是书源的身份：它叫谁、指向哪个站、归到哪个组；四个 rule 开头的字段则定义搜索、探索、书籍信息、正文各自怎么解析。导入这一个文件，26 个书源一次到位。

二维码导入：全程几秒，全部书源一次拿全

1. 打开阅读APP，点右下角「我的」。
2. 点页面底部的「书源管理」。
3. 点右上角「┇」菜单，选「二维码导入」。
4. 扫下面这张图，扫码结束导入即完成：

第一张二维码识别不了时，换下面这张再扫：

导入会自动去重，重复导入等于更新，建议每周跑一次保持规则最新。

网络导入和本地导入：同一个菜单里的两条备胎

摄像头不好使、或者人不在网络环境里，同一个「┇」菜单里还有两条路。

网络导入：选「网络导入」，粘贴下面任一地址，点「确定」：

https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/shuyuan https://cdn.jsdmirror.com/gh/XIU2/Yuedu/shuyuan

本地导入（离线兜底）：从项目页面下载shuyuan文件存到手机，菜单里选「本地导入」，选中该文件确认即可。

整条导入链路从「我的」页面到文件选择，四步走完，如下图所示：

26 个书源先开哪个？按口味挑三档

导入完别乱点。26 个书源分三档，按你的阅读口味认领：

正版平台

• 起点中文：内容全面、更新及时，男生/女生榜单、玄幻仙侠都市科幻分类、月票榜畅销榜阅读指数榜一应俱全。
• 番茄小说2：海量免费资源，适合追连载。

综合聚合

• 酷我小说：资源丰富，分类细。
• 熊猫看书：加载快，界面友好。
• 笔阅读器：轻量阅读体验。

特色书源

支持按类别浏览、排行榜查看、最新章节追踪，还能筛选完本作品、追踪最近更新。

刚上手就固定用起点、番茄这类稳定书源，先保证能读起来。

书源不显示、被限流了？按这个顺序查

排查思路固定为「遇到什么 → 先查哪 → 怎么解」，四种常见情况：

搜索无结果或超时

• 先查：「更新和搜索线程数」是不是太高，触发了站点频率限制？
• 怎么解：把「更新和搜索线程数」降到 1~5，换其他书源搜索。

弹出验证 / IP 被限

• 先查：短时间内是不是访问太频繁？
• 怎么解：预下载降到 1~5 章、线程数降到 1~5，等 10~15 分钟再试。

章节加载失败

• 先查：被限流还是网络抖动？
• 怎么解：预下载章节数降为 1，等待 10~15 分钟，或换另一个 CDN 的书源。

书源导入后不显示

• 先查：网络通不通、地址有没有贴错？
• 怎么解：检查网络，换一条 CDN 地址，核对地址无多余空格，在书源管理页下拉刷新。

调优、备份、长期维护：导入之后还有三件事

体验调优

• 切换书源后显示「无最新章节」：在书源切换页面点右上角菜单，勾选「加载详情页」「加载目录」，再重新加载。
• 到「阅读 - 其他设置」，预下载章节数、更新和搜索线程数都建议设为 1~5，体验和被限流的风险之间取个平衡。
• 定期清理缓存；大规模更新书源尽量在 Wi-Fi 下进行；缓存可放到外置存储。

备份比修源更靠谱

• 定期备份 shuyuan 文件：本地导入留存多个版本，或直接放云存储。
• 同时导入多个书源，一个失效立刻切到另一个。
• 看完的书尽早全本缓存并导出为 TXT，书源失效也不影响回看。

长期维护三个习惯

• 书源多了找不着：按网站类型、内容类型、更新频率分组整理。
• 想用听书：装一个支持中文的 TTS 引擎，如 TTS Server、MultiTTS。
• 想自动化：设定时任务定期更新书源，盯一下响应时间，失效就换。

本项目书源数量有限、维护节奏不固定，持续跟进项目更新，书源失效时第一时间换源。现在就去书源管理页面，把导入跑一遍。

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