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

语言：zh-CN
原文：[书屿 OPDS 长目录：区分前后样本、继续加载与书籍获取](<https://allluckly.cn/guides/nasbook-opds-later-catalog-page-list-search-acquisition/>)
中文：[中文 HTML](<https://allluckly.cn/guides/nasbook-opds-later-catalog-page-list-search-acquisition/>)
English: [English HTML](<https://allluckly.cn/en/guides/nasbook-opds-later-catalog-page-list-search-acquisition/>)
发布于: 2026-11-20T00:00:00+08:00
内容更新于: 2026-11-20T00:00:00+08:00
署名：Bison

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

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

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

选择自己有权访问的私人 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 私人书库](<https://allluckly.cn/guides/nasbook-opds-library/>)、[OPDS 书目与文件抽查](<https://allluckly.cn/guides/nasbook-opds-catalog-quality-audit/>)。

2026年11月20日，[Apple公开查询](<https://itunes.apple.com/lookup?id=6766198898&country=cn&entity=software>)列书屿1.1.4、最低iOS / iPadOS 15.6；[App Store](<https://apps.apple.com/cn/app/id6766198898>)介绍 OPDS 私人书库浏览、搜索和下载。分页方法参考 [OPDS 1.2 规范](<https://specs.opds.io/opds-1.2.html>)。本文未声称完成真机或私人服务器测试。

