PXRead
自建面向来源混杂、版本重复的 TXT 与 EPUB 的本地书库和阅读系统,核心是持久的作品、版本和修订模型。
- 要解决的问题
- 文件命名不统一、重复多、元数据不确定,而且同一作品常有多个版本。单纯管理文件无法保证阅读进度和标注在版本替换后仍指向正确内容。
- 工程工作
- Work/Edition 双层模型把作品和具体可读版本分开;正文修订不可变,推进 HEAD 时使用 compare-and-set。
- 导入流程记录来源依据、候选元数据和置信度,再选择追加、分叉、跳过或待审;正文文件按内容哈希托管。
- 阅读统一走 EPUB,标注使用可重挂的位置契约,并覆盖重挂和明确失配的测试。
- 证据与边界
- 已有可运行的本地应用,包括后端、网页与移动客户端、数据库迁移和测试。源码保持私有,公开部分只讲架构与已实现行为。