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

- 实现EPUB阅读器搜索功能及选中注释功能
- 优化CFI模块，修复代码审查发现的11个问题
- 实现大书远距目录跳转与后台补全优化方案
- 优化设置面板与章节运行时联动
- 重构及大量改进优化

Sources/RDReaderView/EPUBCore/Models/RDEPUBPaginationModels.swift

@@ -1,46 +1,43 @@
 import Foundation
 
 public enum RDEPUBTextPageBreakReason: String, Codable, Equatable {
-    /// 章节自然结束
+
     case chapterEnd
-    /// 达到帧容量限制
+
     case frameLimit
-    /// 块级元素边界（如段落、标题）
+
     case blockBoundary
-    /// 附件（图片等）边界
+
     case attachmentBoundary
-    /// 语义边界（如列表、引用块）
+
     case semanticBoundary
 }
 
-/// 文本附件类型
 public enum RDEPUBTextAttachmentKind: String, Codable, Equatable {
-    /// 图片附件
+
     case image
-    /// 通用附件
+
     case generic
 }
 
-/// 文本页元数据，记录分页时的上下文信息
-/// 用于调试分页问题和优化分页质量
 public struct RDEPUBTextPageMetadata: Codable, Equatable {
-    /// 分页截断原因
+
     public var breakReason: RDEPUBTextPageBreakReason
-    /// 本页覆盖的块级元素范围
+
     public var blockRange: NSRange?
-    /// 本页包含的附件范围列表
+
     public var attachmentRanges: [NSRange]
-    /// 附件类型列表
+
     public var attachmentKinds: [RDEPUBTextAttachmentKind]
-    /// 块级元素类型列表
+
     public var blockKinds: [RDEPUBTextBlockKind]
-    /// 语义提示信息
+
     public var semanticHints: [RDEPUBTextSemanticHint]
-    /// 附件布局位置信息
+
     public var attachmentPlacements: [RDEPUBTextAttachmentPlacement]
-    /// 本页末尾的 fragment ID（用于恢复位置）
+
     public var trailingFragmentID: String?
-    /// 诊断信息列表（调试用）
+
     public var diagnostics: [String]
 
     public init(
@@ -66,13 +63,12 @@ public struct RDEPUBTextPageMetadata: Codable, Equatable {
     }
 }
 
-/// 高亮模型，表示用户在阅读中标记的文本片段
 public struct EPUBChapterInfo: Codable, Equatable {
-    /// 对应的 spine 索引
+
     public var spineIndex: Int
-    /// 章节标题
+
     public var title: String
-    /// 该章节的总页数
+
     public var pageCount: Int
 
     public init(spineIndex: Int, title: String, pageCount: Int) {
@@ -82,20 +78,18 @@ public struct EPUBChapterInfo: Codable, Equatable {
     }
 }
 
-/// 页面模型，描述单页的完整信息
-/// 由 RDEPUBReadingSession 根据分页结果构建，是翻页容器层的数据单元
 public struct EPUBPage: Codable, Equatable {
-    /// 对应的 spine 索引
+
     public var spineIndex: Int
-    /// 章节索引（从 0 开始的章节序号）
+
     public var chapterIndex: Int
-    /// 页在章节中的索引（从 0 开始）
+
     public var pageIndexInChapter: Int
-    /// 该章节的总页数
+
     public var totalPagesInChapter: Int
-    /// 章节标题
+
     public var chapterTitle: String
-    /// 固定版式 Spread 数据（仅 fixed layout 书籍有值）
+
     public var fixedSpread: EPUBFixedSpread?
 
     public init(
@@ -115,15 +109,14 @@ public struct EPUBPage: Codable, Equatable {
     }
 }
 
-/// 固定版式 Spread 中的单个资源
 public struct EPUBFixedSpreadResource: Codable, Equatable {
-    /// 对应的 spine 索引
+
     public var spineIndex: Int
-    /// 资源路径
+
     public var href: String
-    /// 资源标题
+
     public var title: String
-    /// 在 spread 中的位置偏好
+
     public var pageSpread: RDEPUBPageSpread?
 
     public init(spineIndex: Int, href: String, title: String, pageSpread: RDEPUBPageSpread? = nil) {
@@ -134,38 +127,24 @@ public struct EPUBFixedSpreadResource: Codable, Equatable {
     }
 }
 
-/// 固定版式 Spread（双页展开）模型
-/// 将 1-2 个 spine 资源组合为一个显示单元
 public struct EPUBFixedSpread: Codable, Equatable {
-    /// 该 spread 包含的资源列表（通常 1-2 个）
+
     public var resources: [EPUBFixedSpreadResource]
 
     public init(resources: [EPUBFixedSpreadResource]) {
         self.resources = resources
     }
 
-    /// 主资源（列表中的第一个），用于标识和定位
     public var primaryResource: EPUBFixedSpreadResource {
         resources.first ?? EPUBFixedSpreadResource(spineIndex: 0, href: "", title: "")
     }
 
-    /// 判断指定 href 的资源是否属于此 spread
-    /// - Parameters:
-    ///   - normalizedHref: 标准化后的 href
-    ///   - normalizer: href 标准化函数
-    /// - Returns: 是否包含该资源
     public func contains(normalizedHref: String, normalizer: (String) -> String?) -> Bool {
         resources.contains { resource in
             normalizer(resource.href) == normalizedHref
         }
     }
 
-    /// 根据 spine 列表和 spread 设置生成 Spread 数组
-    /// 根据 pageSpread 属性（left/right/center）决定资源配对
-    /// - Parameters:
-    ///   - spine: spine 项列表
-    ///   - spreadEnabled: 是否启用 spread 模式
-    /// - Returns: spread 数组
     public static func makeSpreads(spine: [RDEPUBSpineItem], spreadEnabled: Bool) -> [EPUBFixedSpread] {
         let resources = spine.enumerated().map { index, item in
             EPUBFixedSpreadResource(
@@ -204,13 +183,10 @@ public struct EPUBFixedSpread: Codable, Equatable {
         return spreads
     }
 
-    /// 便捷方法：从 parser 构建 spread
     public static func makeSpreads(parser: RDEPUBParser, spreadEnabled: Bool) -> [EPUBFixedSpread] {
         makeSpreads(spine: parser.spine, spreadEnabled: spreadEnabled)
     }
 
-    /// 判断两个资源是否应该配对为一个 spread
-    /// center 类型不参与配对，left+right 或 right+left 配对
     private static func shouldPair(current: EPUBFixedSpreadResource, next: EPUBFixedSpreadResource) -> Bool {
         if current.pageSpread == .center || next.pageSpread == .center {
             return false
@@ -226,4 +202,3 @@ public struct EPUBFixedSpread: Codable, Equatable {
         }
     }
 }
-