阅栖 EPUB 内测前回归:样本矩阵、离线阅读与合规边界
5/26/2026
阅栖 EPUB 当前已经形成导入、书架、目录、阅读页和进度保存的基本闭环,但在正式发布前,还需要把回归和合规工作补齐。
为什么要做样本矩阵
EPUB 文件的实际情况非常复杂:有的只有纯文本,有的带封面和目录,有的缺少 nav 但有 NCX,有的图片路径异常,有的章节很大,有的样式非常复杂。阅读器如果只用少数样本验证,很容易在真实用户文件上出现白屏、目录失败或进度丢失。
计划覆盖的样本类型
1. 纯文本小说 EPUB。
2. 带封面和目录的 EPUB。
3. 无封面 EPUB。
4. 无 nav 但有 NCX 的 EPUB。
5. nav / NCX 缺失或异常的 EPUB。
6. 带插图 EPUB。
7. 大章节 EPUB。
8. 章节数量很多的 EPUB。
9. 样式复杂 EPUB。
10. 路径大小写异常或资源缺失的 EPUB。
外部打开兼容
除了应用内导入,后续还要继续验证文件管理器、下载页、聊天软件和分享页。不同来源可能提供 file://、content://、application/epub+zip、application/octet-stream 或未知 MIME,应用需要尽量识别真正的 .epub 文件,并在失败时给出明确提示。
性能和稳定性
回归重点会放在普通 EPUB 导入耗时、大章节首次打开、连续翻页、目录跳转、样式调整后的重排,以及关闭网络后的离线阅读。目标不是支持所有边界文件,而是不让异常样本导致应用整体崩溃。
合规边界
阅栖 EPUB 不内置未授权图书、书源、爬虫或 DRM 绕过能力。应用会说明本地保存的数据范围,包括书籍元数据、沙箱路径、阅读进度、阅读设置和导入诊断;默认不上传正文和阅读历史。删除书架书籍也只删除应用内副本,不删除用户原始文件。
这些工作看起来不如新功能显眼,但它们决定了一个本地阅读器能不能长期稳定使用。
