← 返回开发日志

阅栖 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 绕过能力。应用会说明本地保存的数据范围,包括书籍元数据、沙箱路径、阅读进度、阅读设置和导入诊断;默认不上传正文和阅读历史。删除书架书籍也只删除应用内副本,不删除用户原始文件。 这些工作看起来不如新功能显眼,但它们决定了一个本地阅读器能不能长期稳定使用。