feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化

- 实现EPUB阅读器搜索功能及选中注释功能 - 优化CFI模块，修复代码审查发现的11个问题 - 实现大书远距目录跳转与后台补全优化方案 - 优化设置面板与章节运行时联动 - 重构及大量改进优化
2026-06-22 20:26:34 +08:00
parent f50495ad91
commit c65c190b71
178 changed files with 11380 additions and 6728 deletions
@@ -1,33 +1,20 @@
-//
-//  RDEPUBNavigatorState.swift
-//  RDReaderView
-//
-//  EPUBCore 层导航状态机定义文件。
-//  定义了阅读器导航器的状态枚举，状态流转遵循：
-//  initializing → loading → idle ↔ jumping/moving/repaginating
-//  由 RDEPUBReadingSession 管理状态跃迁，控制分页快照的应用时机。
-//

 import Foundation

-/// 导航状态枚举，描述阅读器的当前操作状态
-/// 状态机流转：initializing → loading → idle ↔ jumping/moving/repaginating
 public enum RDEPUBNavigatorState: String, Codable {
-    /// 初始化状态，刚打开书籍，等待初始恢复位置
+
    case initializing
-    /// 加载状态，正在生成首轮分页模型
+
    case loading
-    /// 空闲状态，显示稳定，可接受用户操作和快照应用
+
    case idle
-    /// 跳转状态，正在执行目录/内部链接跳转
+
    case jumping
-    /// 翻页状态，用户正在翻页操作中
+
    case moving
-    /// 重排状态，正在重新分页（字号/横竖屏变化触发）
+
    case repaginating

-    /// 是否处于可应用分页快照的稳定状态
-    /// 只有 idle 状态才允许消费 staged snapshot
    public var isStableForSnapshotApplication: Bool {
        self == .idle
    }