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

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

Sources/RDReaderView/ReaderView/Paging/RDReaderPreloadController.swift

@@ -1,49 +1,52 @@
-//
-//  RDReaderPreloadController.swift
-//  ReadViewSDK
-//
-//  文件职责：页面预加载控制器，负责提前渲染即将显示的页面视图以减少翻页卡顿。
-//
 
 import UIKit
 
-/// 页面预加载控制器
-/// 负责管理页面视图的预加载和缓存，在当前页面基础上提前渲染前后若干页，
-/// 以减少翻页时的等待时间。支持仿真翻页和滚动模式下的不同复用策略。
 final class RDReaderPreloadController {
-    /// 预加载半径，表示在当前页前后各预加载的页数，默认为 1
+
     var radius: Int = 1
 
     private let preloadHostView = UIView()
+
     private var preloadedPageViews: [Int: UIView] = [:]
+
     private var pageCurlCachedViews: [Int: UIView] = [:]
+
     private var cacheSignature: CacheSignature?
 
-    /// 预加载环境参数，封装翻页模式、屏幕方向、页面尺寸等上下文信息
     struct Environment {
+
         let displayType: RDReaderView.DisplayType
+
         let isLandscape: Bool
+
         let pagesPerScreen: Int
+
         let boundsSize: CGSize
+
         let landscapeDualPageEnabled: Bool
+
         let coverPageIndex: Int?
+
         let totalPages: Int
+
         let spreadResolver: RDReaderSpreadResolver
     }
 
     private struct CacheSignature: Equatable {
+
         let displayType: RDReaderView.DisplayType
+
         let isLandscape: Bool
+
         let pagesPerScreen: Int
+
         let boundsSize: CGSize
     }
 
-    /// 设置预加载宿主视图的 frame
     func setHostFrame(_ frame: CGRect) {
         preloadHostView.frame = frame
     }
 
-    /// 将预加载宿主视图添加到父视图中（如果尚未添加），置于最底层且不可见
     func ensureHostView(in parentView: UIView) {
         guard preloadHostView.superview == nil else { return }
         preloadHostView.isHidden = true
@@ -54,12 +57,10 @@ final class RDReaderPreloadController {
         parentView.insertSubview(preloadHostView, at: 0)
     }
 
-    /// 根据当前环境初始化缓存签名，用于后续检测环境是否发生变化
     func initializeSignature(_ environment: Environment) {
         cacheSignature = currentCacheSignature(environment)
     }
 
-    /// 清除所有已缓存的页面视图并更新缓存签名
     func invalidate(environment: Environment) {
         pageCurlCachedViews.values.forEach { $0.removeFromSuperview() }
         preloadedPageViews.values.forEach { $0.removeFromSuperview() }
@@ -68,7 +69,6 @@ final class RDReaderPreloadController {
         cacheSignature = currentCacheSignature(environment)
     }
 
-    /// 获取指定页码的页面视图用于显示，优先复用已缓存的视图
     func pageViewForDisplay(
         pageNum: Int,
         environment: Environment,
@@ -80,14 +80,12 @@ final class RDReaderPreloadController {
         return view
     }
 
-    /// 取出指定页码的预加载视图并从缓存中移除，供外部复用
     func takePreloadedView(for pageNum: Int) -> UIView? {
         let preloaded = preloadedPageViews.removeValue(forKey: pageNum)
         preloaded?.removeFromSuperview()
         return preloaded
     }
 
-    /// 预加载当前页周围指定半径内的页面，清除不再需要的缓存视图
     func prime(
         around pageNum: Int,
         preferredForward: Bool? = nil,