ReadViewSDK/Doc/index.md
shenlei c64460988a feat: 实现大书远距目录跳转与后台补全优化方案
Phase 1: 稳定性优先
- 新增 RDEPUBJumpSession 保护机制,防止远距跳转后翻页串章
- 升级页图接管条件,增加 JumpSession 保护区检查
- 窗口扩展改为基于当前权威窗口方向

Phase 2: 补全优先级重排
- 新增 RDEPUBBackgroundPriorityPolicy 策略配置
- 实现 hot/warm/cold zone 优先级排序
- 添加失败重试机制(指数退避,最多3次)

Phase 3: 分段覆盖与最终收敛
- 新增 RDEPUBBackgroundCoverageStore 分段存储
- 新增 RDEPUBPageMapReconciliationCoordinator 页图接管仲裁
- 实现 LRU 淘汰和内存警告处理

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-15 16:28:11 +08:00

2.1 KiB
Raw Blame History

ReadViewSDK 文档索引

最后更新2026-06-15


核心文档

文档 说明
ARCHITECTURE.md 系统架构总览:分层架构、核心数据流、缓存架构、目录结构、设计模式
UML_CLASS_DIAGRAMS.md UML 类图Mermaid 格式):模块关系、核心类图、并发模型、缓存键设计
BUSINESS_LOGIC.md 业务逻辑详解EPUB 解析、文本渲染管线、后台解析优化、翻页容器、标注系统、搜索、设置

工程规范与风险

文档 说明
CONCERNS.md 代码库风险与关注点12 项安全/性能/可维护性风险
TESTING.md 测试基础设施UI 测试文件清单、运行方式、覆盖率
CONVENTIONS.md 编码规范:命名约定、代码风格、导入规范、错误处理
ARCHITECTURE-CONTEXT.md WXRead vs ReadViewSDK 架构差距分析4 个领域、14 项决策

专题文档

文档 说明
当前阅读器问题修复开发清单.md 基于当前代码实现整理的逐任务开发计划10 个任务、修改位置、实施步骤、风险点与验收标准
大书远距目录跳转与后台补全优化方案.md 面向大书按需分页模式的完整优化方案:远距目录跳转、后台补全优先级、页图接管协议与分阶段实施路径
大书后台解析优化实施清单_30秒目标.md 《凡人修仙传》后台解析性能优化方案,目标从 70s 压缩到 30-50s

项目信息

  • 模块总数: 4 个EPUBCore、EPUBTextRendering、RDReaderView、EPUBUI
  • Swift 文件数: 139 个SDK Sources
  • 测试用例数: 23 个测试类,约 99 个测试方法UI 测试)
  • 最低 iOS 版本: 15.6
  • 构建方式: CocoaPods本地 pod