企业官网建设流程全解析

阅读书源从零到一：3 步完成导入、调优与排障的实用指南

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

刚装完「阅读」APP，书架空空，搜什么都没反应——因为它本质上是个空壳浏览器，得自己导入阅读书源才找得到书。这个项目就是一套覆盖起点、69书吧、23qb 等 22 个书源的精选书源合集，写给新手和进阶用户看：前段带你 10 分钟把书源装进 APP，后段讲参数调优和常见坑，动手不会卡。

📖 阅读为什么需要书源：书源是一份「提取模板」

书源文件本质上是一组解析规则，告诉 APP 去搜索页哪个位置找书名、详情页哪个字段是作者、正文页哪一块是正文，你可以把它理解成每个小说网站的一份「提取模板」：APP 拿到模板，就能把网站变成自己书架的数据源。

打开项目里的 shuyuan 就能看到书源长什么样。以排最前面的起点书源为例，核心就四块字段（示意）：

{ "bookSourceUrl": "https://www.qidian.com", "searchUrl": "https://www.qidian.com/so/{{key}}.html", "ruleSearch": { "bookList": "class.res-book-item", "name": "class.book-info-title.0@tag.a.0@text" }, "ruleContent": { "content": "class.read-content@html" } }

读法是这样的：searchUrl用关键词{{key}}拼出搜索页地址，ruleSearch用 CSS 选择器定位搜索结果里的书名，ruleContent从read-content区块里取正文。整个文件里有 22 个这样的书源，覆盖官方平台、聚合站、镜像站三类，每个书源处于什么状态（比如搜索暂不可用、需要人机验证）都写在bookSourceComment字段和 README.md 里。想在本机翻规则，也可以把仓库 clone 下来：

git clone https://gitcode.com/gh_mirrors/yu/Yuedu

原理清楚了，下一步把这批书源装进 APP。

📥 阅读书源导入：三条路，挑顺手的走

入口都一样：打开 APP，点右下角「我的」，进「书源管理」，再点右上角「⋮」菜单。菜单里三个选项对应三种方式，导入时 APP 会自动去重，同一套书源反复导也不会堆成两堆。

扫二维码，最稳

菜单选「二维码导入」，手机对着电脑上书源分享页的二维码扫一下，导入完成。这条路不依赖手机的网络解析能力，第一次用建议优先选它。

图：仓库内置的一键导入二维码

贴地址，最快

选「网络导入」，把能用的网络导入地址粘进输入框（README.md 里给了一串 CDN 分流地址，CDN 就是同一份文件的多个加速节点，挑一个你网络环境下能通的），点「确定」完成导入。

存文件到手机，最可控

去书源分享页点「下载文件」拿到shuyuan.json，存到手机任意位置（图片目录、下载目录都行），再在 APP「本地导入」里选中它。这种方式不走任何第三方中转，网络受限或想自己留存一份书源文件时最合适。

图：书源管理到导入完成的完整流程

书源进来了，但急着搜书的话，还有两件事会绊你一跤：网站限流，以及需要验证的书源。

🎛️ 先慢下来：两个参数避开限流

书源来自第三方网站，对方一般会盯着访问频率。APP 满速发请求，轻则弹人机验证，重则临时封 IP。解法就是降速，「我的 - 其它设置」里有两个数字：

• 预下载：APP 会提前加载当前章节前后 X 章，从默认值降到1~5
• 更新和搜索线程数：设1~5；离线缓存全书时如果从某一章开始全部失败，多半是并发太大触发了限制

这个仓库里还有几个书源自带「限速条款」：手记小说源要求两次搜索间隔至少120 秒；一些书源在bookSourceComment里也写了注意事项，用之前点「书源管理」里的书源看一眼说明，能少踩不少坑。

参数调好，再看实际使用中最容易碰壁的三种情况。

🔧 卡壳了：三个最常见的坑

切换书源显示「无最新章节」

有些书源网站的搜索页压根不显示最新章节，这不是 bug。在书源切换界面点右上角「⋮」，勾选**「加载详情页」和「加载目录」**，切换时 APP 会额外请求详情页和目录，最新章节就能出来。

人机验证一直循环

仓库里有几个书源（69书吧、河图小说等）全站启用了人机验证，弹一次、过了就没事。但如果验证页无限循环，通常是手机 WebView 内核版本和书源声明的版本号对不上——WebView 是安卓内置的网页渲染内核，不同手机系统版本不同。办法：把书源请求头规则里Chrome/115.0.4664.104的115改成你手机的 WebView 大版本号（比如 96.0.x.x 就改成96）；如果系统 WebView 本身太老，先升级到 11x 以上。

起点搜不到 / 突然弹验证页

起点书源带 Cookie 校验（Cookie 是网站写进手机的一张小凭证，证明你通过了一次验证）：APP 检测到校验没过时会自动用内置浏览器打开起点网页，你手动点一下右上角「[√]」，Cookie 就写进去了，之后一段时间搜索都正常。个别书源注释里还留了登录账号，过期后到「书源管理」的「登录」入口自己重新登一下即可。

这三个坑处理完，就只剩一个长期问题。

📦 书源会失效：缓存和备份才是保险

这套书源全部来自第三方网站，README 自己也写了「无法保证可用性，可能随时失效」——书源失效是常态不是意外，更不是这个仓库的锅。稳妥的做法：完本小说全本缓存并导出 TXT，内容留在自己手机里，哪个书源死了都不受影响。

顺手把shuyuan.json备份一份（文件管理器里复制到网盘或别的存储位置），换手机时重新导入一次就能恢复原状。

下一步建议：先挑一个你最常用的书源，把「搜索 → 加入书架 → 阅读」跑一遍，确认链路没问题；再把预下载和线程数按上一节调到 1~5；然后在「发现」页多挑几个顺手的书源；找到好用的书源后，可以把shuyuan.json导出留存，也欢迎提交给作者扩充合集。

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