私有书库目录与结果核验

书屿 OPDS 长目录:区分前后样本、继续加载与书籍获取

用同一自有目录的前后两本书核实际列表、搜索和取书结果,按服务实际分页信息排查。

用同一自有目录的前后两本书核实际列表、搜索和取书结果,按服务实际分页信息排查。

先准备同一目录的前后样本

选择自己有权访问的私人 OPDS 书库,在服务端已有管理或浏览入口中记下目录身份、账号权限、排序和筛选条件。选一本当前列表前段的自有书 A,以及一本按同一目录顺序位于较后位置的自有书 B,分别记录书名、作者和格式;不要只凭同名判断身份。保留原文件及本地笔记,截图时隐藏账号、地址中的敏感参数与书籍正文。没有现成书库或权限时只记录准备事项,不公开部署服务器来凑一次测试。

确认总量和筛选来源

先核服务端所显示的数目究竟是全部库、当前分类还是当前搜索结果,并记下查询时间。若列表随新增、删除或排序改变而变化,两轮结果不一定处于同一快照;尽量在短时间内停止自行修改书库。若服务端没有可靠总数,就记录可确认的 A、B 与目录范围,不用把猜测数量当验收标准。账号可能只被授权查看部分内容;先在服务端用与书屿相同的身份确认范围,管理员账户看到的数量不能直接替代普通账户。

在书屿定位同一入口

在书屿通过已有的 OPDS 连接进入同一书库、分类与可见筛选,先找到 A 并打开书目详情,核标题、作者和格式。再按当前界面实际支持的滚动、继续加载或其他可见方式寻找 B;如果没有明显继续入口,就记下当前可见列表和最后条目,不假定存在固定按钮或支持某种交互。首次页面只出现部分结果时,先确认它确实是同一分类和相同排序,不凭首页数量立即认定 B 已丢失。

只在适用时看目录分页信息

如果服务实际提供的是 OPDS 1.2,且用户有权限并已有工具查看返回的目录文档,可以只读查看当前 feed 的条目及 rel=next 链接,并记录检查时间。该规范允许大型获取目录分页,next 指向后续目录文档,不是下一页书籍正文或一个可直接阅读的文件;有无该链接和后续内容要按真实响应记录。后续链接也可能是相对地址或携带服务器生成的游标;应结合实际文档位置和服务说明理解,不把页码自行加一当成一定有效的地址。对照期间不要把带授权信息的链接发给别人,也不需要反复请求整个私人目录。没有文档、没有 next 或无法确认协议版本时标未知,不把该规范的可选结构当作当前服务必然存在,也不声称书屿必定使用特定的分页算法。

分开搜索、列表和书籍获取

如果 B 在长列表暂未找到,且当前目录实际提供搜索,使用明确的 B 标题或作者搜索,再核结果与版本;搜索结果有自己的范围,不能证明原长列表已经完整加载。打开 B 的详情后,再按实际可用入口获取所需 EPUB 或 PDF,并确认正文开头与末尾,而不把封面或预览链接写成已下载正文。B 可以通过搜索找到但列表暂时未见,也可以服务器自身就找不到;把这两种结果分别记录,不猜是否由客户端过滤造成。

出现重复或空白时先固定条件

列表出现重复标题,先核作者、版次和实际条目身份:同名译本或再版可能是两本书,两个列表位置也可能指向同一条记录。后续加载为空时,记录网络、账号、筛选和最后一个可见条目;只改变一个条件再试,不连续删除连接、重建书库或修改原文件。若服务器数据在检查中变化,要注明结果不属于同一静态快照。重复与空白的成因不能仅凭书名或一次截图断言。

保护地址和已有阅读数据

对照服务端文档时,不要把带令牌的完整链接、账号密码或私人目录直接贴进公开反馈;保留足以描述层次的脱敏结构。目录浏览与私有同步是不同功能,修复列表不需要清除 WebDAV 同步数据。已下载的本地书和笔记继续独立保留;网络不通时不要把服务器不可达误写成本地文件消失。未确知某个操作的作用范围时先停止,按现有文档或服务提供方的说明核对。

重开并交付有范围的结论

重新进入同一分类,复查 A 与 B 的实际可见、搜索和取书结果,并记下时间和账户范围。交付对照表:服务端 A/B、书屿列表 A/B、可用搜索结果、正文实际打开状态、任何 next 文档证据与未测项。没有执行服务器查看、分页或书籍下载的项目保持未完成;一次小样能够定位差异,却不能证明整个大书库所有条目完整或所有 OPDS 服务器均兼容。

相关教程与资料

连接 OPDS 私人书库、OPDS 书目与文件抽查。

2026年11月20日,Apple公开查询列书屿1.1.4、最低iOS / iPadOS 15.6;App Store介绍 OPDS 私人书库浏览、搜索和下载。分页方法参考 OPDS 1.2 规范。本文未声称完成真机或私人服务器测试。