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>
2.1 KiB
2.1 KiB
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)