企业官网建设流程全解析

阅读APP书源导入与日常维护：3种导入方式、2个关键参数、一套失效排查流程

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

Yuedu 是一款开源阅读工具，本身不提供小说内容，靠书源规则去解析第三方网站。本文以它内置的 26 个已验证书源为例，分有网、只带手机、离线三种场景讲清书源导入的完整操作，以及导入后调参与书源失效的处理方式。适合刚上手这个工具、又希望书源长期稳定可用的读者。

第一步：按网络情况选导入方式

三种导入方式的落点相同——书源管理页右上角的菜单，按你手边的条件选一种即可。

有电脑、能扫二维码

适合手机和电脑都在身边、屏幕上有二维码可扫的情况。

1. 打开阅读APP，进入“我的”→“书源管理”，在右上角菜单里选择“二维码导入”。
2. 用手机扫描下图中的二维码，二维码内容就是 shuyuan 文件的地址。
3. 扫码后点击确定，26 个书源会一次性进入列表。

只有一台手机

适合手机有信号、旁边没有电脑的情况。

1. 打开书源管理，在右上角菜单选择“网络导入”。
2. 依次输入下面三个地址之一，某个地址超时就删除后换下一个：https://jsd.onmicrosoft.cn/gh/XIU2/Yuedu/shuyuanhttps://cdn.jsdmirror.com/gh/XIU2/Yuedu/shuyuanhttps://bitbucket.org/xiu2/yuedu/raw/master/shuyuan
3. 点击“确定”，成功后书源列表会由空变为 26 条。

完全离线

适合没有信号的场合，前提是文件已经提前存进手机。

1. 先把仓库中的 shuyuan 文件（JSON 格式）下载到手机里。
2. 在书源管理里从右上角菜单选择“本地导入”。
3. 在文件选择器中点选该 shuyuan 文件，导入随即完成。

第二步：两个参数把“书源停更”概率降下来

网站端对访问频率有限制，下面两个数值调低后，被封的概率会明显下降。两项都在APP内的“其它设置”里。

• 预下载章节数：设为1~5。章节按批次拉取，批次越小，一次操作产生的请求越少，越不容易碰到频率上限。
• 更新和搜索线程数：设为1~5。并发线程在服务端看来像突发流量，把线程数压低，请求曲线就平缓了。

第三步：书源失效后的排查顺序

顺序是：先查本地加载选项，再降频，最后才换源。

1. 出现“无最新章节”时：打开书源切换菜单，勾选“加载详情页”与“加载目录”两项，再重新加载页面。
2. 章节加载报错时：把预下载章节数、线程数都调回1~5区间，过一会儿再重试。
3. 搜索或目录整体不工作时：按失效处理。删除旧书源，重新导入 shuyuan 文件（有网时可换一个 CDN 地址），APP 会自动去重，最后留下的只有有效书源。

一分钟看懂 shuyuan 文件

Yuedu 自身不含内容，书源就是 JSON 里的一条条配置：记录站点地址，以及从每个页面里如何定位并摘出搜索结果、目录、正文。仓库根目录的 shuyuan 文件就是这 26 条配置的合集。

主要字段：

• bookSourceName：书源名称
• bookSourceUrl：站点基础地址
• bookSourceGroup：书源分组
• ruleSearch：搜索规则
• ruleExplore：发现（探索）规则
• ruleBookInfo：书籍信息规则
• ruleContent：正文内容解析规则

站点改版后失效的通常就是这些规则字段。届时按“删除旧书源 → 重新导入”的流程整体替换即可，APP 会自动去重，重复导入不会产生多余条目。

常见问题

问：导入完成，但书源列表一条都没有，怎么回事？先确认网络是否正常；走网络导入时，换一个 CDN 地址重试；再检查输入的地址首尾有没有多余空格；最后在书源管理页下拉刷新一次。

问：怎么判断书源已经失效？搜索没有结果、目录不加载，都是信号。先按第三步第 1 条把“加载详情页 / 加载目录”两项打开试试；还不行，就整体替换：删除旧书源，重新导入。

问：再导入一遍书源，会产生重复条目吗？不会。APP 导入时自动去重，只保留有效书源，任何时候都可以再导一次。

问：常看的站哪天不能访问了，书会不会白追？把完本小说做全本缓存并导出 TXT，设备上就有一份本地副本，站不在了也能读。

书源规则均指向第三方小说网站，仅用于公益分享，内容归属各站点及其版权方；请遵守站点条款与相关法规，并控制访问频率。对打算反复回看的完本小说，建议提前做全本缓存并导出 TXT，书源失效时阅读不受影响。

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