私有书库质量检查
书屿 OPDS 书目抽查:核对作者版次、格式链接与真实文件
对已有 OPDS 目录选择几本已知书,分别检查作者译者、版次、封面与获取链接,再比对下载后的正文,不把书目命中当内容正确。
本文目录
OPDS 能列出书,并不代表标题、作者、译者与获取格式全部准确。本篇不再配置连接,而是对已经能用的私人目录做小规模书目质量抽查。用几本已知版本对照资料与实际文件,发现问题时指出是哪一层,不在客户端改个标题就假装服务器目录已经修好。
从已知原件选择小样本
选三到五本自己能确认原件的书,尽量包含作者名较长、有译者信息、同名修订版或同时提供两种格式的例子。建立简短基准:书名、作者、译者、出版或修订标识与文件格式。不要用陌生网络书目替代原件证据,也不为抽查下载整套目录。样本范围写清,结果只说明这些项目,不能外推为全库资料完全准确。先准备可信基准,再进入书屿当前 OPDS 连接,避免边看目录边凭封面猜哪个版本才算正确。
书目字段逐项对照而非只看封面
在已有目录里找到样本,核对标题、作者、描述与当前实际展示的其他字段。译者或版次没有独立字段时,看目录说明与原件版权页,外部清单补充即可,不虚构应用里必有相应编辑项。封面相同不保证内容相同,长名称截断也可能只是列表显示,需要进入详情确认。把缺失、错误与未展示分别记录,三者不是同一情况。先保留服务器返回的原状,不急着本地修名,后续才容易确定问题来自源目录还是自己的显示与整理。
检查获取格式与链接类型
同一条目可能提供 EPUB、PDF 或仅管理用途格式,先按自己需要选择可读路径。详情网页、购买页与实际获取链接不是同一种对象,能点开页面不表示拿到电子书。下载前记录所选格式与样本版次,不靠文件名后缀替代内容检查。若某格式仅能管理而不支持完整阅读,记录能力边界,不把它算成目录损坏。初次用已在本地读通过的格式作为参照,之后再检查其他提供项,避免格式与链接问题同时变化。
下载后对照版权页与目录
按当前入口取得一本样本,回本地书架打开,核对版权页、译者、目录和正文开头。目录里写某译本而文件其实是另一版,属于书目与内容对应问题,不能只看下载成功提示。PDF 或扫描资料缺少可提取文字时,用页面画面核对,不承诺所有版权信息都可自动检索。再抽一处中段与末尾确认文件完整可读。测试以自己的合法原件为基准,不分享整本文件;需要向维护者说明时提供必要的字段差异与去敏截图即可。
同名多格式核对内容是否真对应
若同条目同时提供 EPUB 和 PDF,分别查看选定章节、译者与版次,不因书名相同就认定它们是同一文本。可重排与固定页码不同是正常差异,但新增章节、不同译文或缺附录需要明确说明。不要为了让格式组看起来整齐,把不同修订版合并后删除其中一份。记录主阅读格式与参考格式,以及它们哪些部分能够对应。这个抽查关注目录链接到底指向什么,不要求改变文件格式,也不能靠改后缀修正书目与内容不匹配。
问题回到正确资料层处理
确认错误后,自己管理服务器时按该服务的资料流程修正目录,再等待正常刷新;非自己管理则记录明确问题交给有权维护的人,不擅自写远端资料。书屿本地资料编辑可以服务个人整理,但不能被描述成已经修好 OPDS 源。修正后仍用原样本与原格式链接复查,别同时换账号、改路径和批量导入。分别保留修正前字段、服务器新结果与本地文件核对,能看出是哪一层已经变化,避免只是封面换了却正文仍指向旧版。
保留抽查清单供后续目录变化
记录日期、书源名称、样本、通过字段与待处理项,特别说明哪些格式链接没有验证。下次目录更新可以复用其中一两本正常样本,另外加入新书,而不需要从零检查整个书库。读完下载样本后按自己的存储计划处理,但保留需要的原件与资料记录,删除本地副本不等于撤销服务器目录。书目清单可读输出与应用数据备份也不同,重要记录分别留档。抽查的价值是可重复发现差异,不是追求一张没有任何空白字段的完整表格。
完成标准与常见误判
样本身份、格式链接与实际正文能逐项对应,缺失和错误有明确记录,就完成。封面一样是否证明同版?不能。标题搜到能否说内容正确?还要打开文件核对。格式不能直接读是否 OPDS 坏了?先看公开能力范围。保留抽查限制,不写成全库质量保证;维护者需要的是哪本、哪个字段、哪个链接和什么差异,而不是“整个书源不对”这种难以行动的概括。源资料准确后,个人阅读与引用也更容易稳定。
相关教程与资料
书屿连接 OPDS:浏览目录、搜索并获取电子书、书屿重复导入:处理同一本书的 EPUB 与 PDF 版本。
资料核对:2026 年 10 月 27 日,Apple 公开版本信息显示书屿 1.1.3,最低 iOS / iPadOS 15.6。能力范围参照官方 App Store 说明,具体入口以安装版本为准。本文描述个人阅读或书库检查流程,未声明真机或私人服务器逐项实测;书籍文件与阅读数据分别管理,未把开发中的识别、生成或自动分析当作已发布功能。