Readest订阅快速上手：OPDS书源自动更新

【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest

追更一部连载，或盯着一个免费书库的新书上架，你希望它一发布就躺在书柜里，而不是自己隔三差五去网站下载导入。Readest 的订阅功能干的就是这件事：把一个 OPDS 目录接成书源后，应用会在后台按固定节奏检查新书，发现更新就自动下载入库，并同步到你登录的其他设备。读完这篇，你可以拿到：

• 三步把第一个 OPDS 书源接入并打开自动下载的操作路径
• 自动更新的检查节奏、失败重试机制，以及书源列表如何跨设备同步
• 三类"更新没进来"的常见现象与排查方向

订阅功能是什么：一个自动收货的书架

可以把订阅理解成"自动收货的快递柜"：书源（OPDS 目录）持续投递新书，Readest 负责收件、入库、再转发给其他设备。它替你省掉四件事：

📬 不用反复逛源站看有没有新书——启动应用时检查一次，运行期间每 5 分钟再检查一轮

🎧 不用手动挑文件格式——只领取免费直链，并按 EPUB 优先的顺序选你读得动的格式

📱 不用换设备重新导入——新书下载完成后会自动同步到云端，新设备登录即可拉取

🗂 不用怕下载失败的书丢失——失败条目会被记录，应用按逐渐拉长的间隔自动重试

除了自定义地址，页面里预置了 Project Gutenberg、Standard Ebooks 等免费目录，可以一键添加。这套"检查—下载—记录"的循环由 OPDS 订阅服务 实现。

三步接入第一个 OPDS 书源

第一步，找到订阅入口。点主界面右上角头像进入设置，在「集成（Integrations）」页找到「OPDS Catalogs」一行点进去，就是书源管理页。已接入的书源以卡片形式排列，每张卡片上能看到最后检查时间。

第二步，接入第一个书源。点击新增，填写书源名称和目录地址（OPDS feed URL）。公开书源填入即可校验；需要登录的私有书源在同一弹窗里填上用户名和密码。手上没有书源时，直接从预置的 Gutenberg 等热门列表里挑一个添加。若你习惯的是 JSON Feed 格式的书源，代码库的 RSS 模块（rss service）同样能解析 JSON Feed 1.1 格式的 feed。

第三步，定好自动更新节奏。翻开书源卡片上的「自动下载」开关，此后新书会自动导入书库。开关打开后 5 秒内再关可以取消本次触发，避免误触；确认生效后，应用会在启动时和运行期间每 5 分钟检查一次，新书几分钟内就会出现在书库里。

进阶配置：失败恢复、重试与跨设备同步

🔧处理失败的下载。自动下载只认免费直链，需要购买、借阅或跳转落地页的条目会被跳过；网络抖动导致的失败则记入每个书源的失败列表，最多重试 3 次，间隔按指数递增。书源卡片上的「失败下载」入口会打开明细，逐条看到标题和链接，方便判断是源站问题还是本地网络问题。

跨设备同步书源与新书。书源列表本身是设置同步的一部分（见目录同步适配器），换设备登录后不用重新录入地址；新下载的书也会进入上传队列同步到云端。也就是说，"订阅在哪台设备上收到"并不重要，最终各设备书库一致。

控制更新量。多个书源同时开着自动下载时，库会被各种新书填满。建议只给最关心的书源开开关，其余保持关闭——关闭的书源仍可手动打开目录页浏览，只是不自动入库。

排障速查：更新没进来时查什么

现象：开了自动下载，但新书迟迟不出现。排查方向：看卡片上的最后检查时间——从未更新说明开关实际没生效或书源处于禁用状态；有更新但无书，多半是源站的"最新"列表没被识别，或条目需要付费。处理办法：手动打开该书源页面确认内容能正常显示；核对 URL 结尾（有些目录对斜杠和重定向敏感）；付费、借阅类条目跳过是预期行为，不是故障。

现象：失败计数一直挂着。排查方向：失败条目按条目记录，自动重试最多 3 次，计数不变通常意味着该下载链接本身超时或失效，本地重开也没用。处理办法：点「失败下载」查看具体条目，等下一轮自动检查或重启应用触发一次新检查；重试与退避记录保存在订阅状态文件中（见subscriptionState.ts）。

现象：新设备上书源是空的。排查方向：书源列表和新书都依赖云同步，新设备未登录或同步未完成时，列表自然是空的。处理办法：用同一账号登录并等待同步结束即可恢复全部书源。

配置完成之后，订阅功能基本在后台安静运行：新书入库、进度与笔记照常同步，你只需要偶尔瞟一眼书源卡片上的最后检查时间，确认它还在工作。书源多的时候，把自动下载留给最重要的几个，其余的目录留着手动浏览就好。

提示：每个书源的检查记录（最后检查时间、已见条目）都保存在本地，书源列表则随账号同步。换设备时登录同一账号即可完整恢复订阅，不用重新逐个录入地址。

【免费下载链接】readestReadest is a modern, feature-rich ebook reader designed for avid readers offering seamless cross-platform access, powerful tools, and an intuitive interface to elevate your reading experience.项目地址: https://gitcode.com/gh_mirrors/re/readest