企业官网建设流程全解析

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 目录开启自动下载，应用就会定期巡检 feed，把新出版的书直接放进你的书库。你能得到的，是一个自己"长新书"的书架。

🔄 原理速览

每个目录在本地有一份独立的订阅状态文件，记录上次检查时间、已见过的条目列表和失败记录。应用在启动时、每 5 分钟以及你手动触发时，会遍历所有开启自动下载的目录：先抓取 feed，按条目 ID 过滤出未下载过的新书，再以固定并发下载并导入书库。整个机制类似订报纸——你不用逐期去问报亭，投递员定期把新一期放到门口。

新内容探测由 feedChecker 负责，它会优先跟随目录的"按最新排序" feed，对目录型 feed 则按广度优先方式下探子目录，并受页数与深度上限约束；下载与入库流水线在 autoDownload 中，负责去重、并发控制与失败记录；每份订阅状态由 subscriptionState 持久化到本地 JSON 文件。

🚀 快速上手：三步开启 OPDS 目录自动更新

1. 找到目录管理入口：设置面板打开「集成」，进入 OPDS 目录列表，管理界面在 CatalogManager。
2. 添加一个目录：填入名称和 OPDS feed 地址，需要账号的目录可同时保存用户名与密码，保存后列表中出现新卡片。
3. 打开自动下载开关：在目录卡片的 Auto-download 开关上拨一下，当前订阅立即生效，并马上触发一次检查。
4. 查看同步状态：卡片下方显示上次检查时间和失败条目数；手动触发成功后会有 toast 提示本次新下载的数量，新书直接出现在书库里。

调度逻辑在 useOPDSSubscriptions 中：书库加载完成后自动跑一次，之后每 5 分钟静默巡检一轮，没有开启订阅的目录不会发起任何请求。

⚙️ 进阶配置：五个常用订阅参数

• 认证凭据（username / password）：抓取 feed 和下载文件时附加 HTTP 认证头 → 适用于 Calibre-Web 等私有目录。
• 自定义请求头（customHeaders）：为请求附加一组额外的 HTTP 头 → 适用于要求特殊字段的自建服务器。
• 允许自签名证书（allowSelfSignedCert）：对该目录放宽 TLS 证书校验 → 适用于自签证书的内网目录，按目录独立开关。
• 停用目录（disabled）：暂停一个目录的巡检但不删除它 → 适用于想暂时停订但保留配置的场景。
• 云端自动上传：登录 Readest Cloud 且同步类别「Books」开启时，下载完成的书会排队上传，其他设备即可读到；逻辑在 cloudUpload 中。

⚠️ 避坑指南：四个高频问题排查

新书一直不自动下载

现象：目录已添加，但新发布的内容始终没进书库。原因：要么 Auto-download 开关没开，要么该条目在 feed 里只有购买、借阅或试读链接——这类链接需要人工操作，无人值守下载会主动跳过。解决：确认开关状态；付费书请打开目录页面手动下载。

失败条目反复重试

现象：某本书挂在失败列表里，隔一会儿就再试一次，仍然失败。原因：每个失败条目按指数退避安排重试（基准 60 秒、逐次翻倍），累计 3 次后标记为永久跳过，避免无意义地占带宽。解决：打开目录卡片的失败下载对话框，可以逐条重试或跳过，重试会重置该条目的失败计数并立即触发检查。

大目录首次同步中断后进度消失

现象：第一次订阅一个大型目录耗时很久，应用中途被系统杀掉后，重新打开像是从头再来。原因：Android 等移动平台会回收后台进程，长时间同步是重点关照对象。解决：无需处理——下载进度每 10 个条目落盘一次，已完成的批次会被记入"已知条目"，下次运行从中断处继续而不是清零重来。

同一地址在多台设备上重复出现

现象：手机和电脑分别添加了同一个 OPDS 地址，担心同步后变成两份。原因：目录的 contentId 由 URL 推导而来，设备间同步时相同 URL 会收敛为一条记录。解决：不用额外处理；若手动建出重复条目，直接在目录列表中删掉多余的一张即可。

OPDS 订阅把"追更新"变成"收快递"：去 OPDS 目录管理界面，把几个常看的目录打开自动下载，书库之后的更新就不用你操心了。

提示：订阅目录保存在设置里并随 Readest Cloud 跨设备同步，换设备后登录账号即可看到原有目录，不必重新粘贴 URL。

【免费下载链接】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