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

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

Sources/RDReaderView/EPUBUI/ReaderController/RDEPUBReaderViewportMonitor.swift

@@ -1,13 +1,15 @@
 import UIKit
 
-/// 视口监测器，监听视图布局和屏幕旋转等视口变化事件，
-/// 检测变化是否显著，必要时触发重新分页或内容重建。
 final class RDEPUBReaderViewportMonitor {
+
     private unowned let context: RDEPUBReaderContext
 
     private var lastAppliedViewportSignature: RDEPUBViewportSignature?
+
     private var pendingViewportChangeReason: RDEPUBViewportChangeReason?
+
     private var pendingPresentationRestoreLocation: RDEPUBLocation?
+
     private var isWaitingForViewportTransitionCompletion = false
 
     init(context: RDEPUBReaderContext) {
@@ -18,7 +20,6 @@ final class RDEPUBReaderViewportMonitor {
         context.controller
     }
 
-    /// 视图布局完成后检查视口是否发生变化，首次布局时触发初始加载
     func viewDidLayoutSubviews() {
         guard let controller else { return }
         guard let viewportSignature = currentViewportSignature() else { return }
@@ -41,8 +42,6 @@ final class RDEPUBReaderViewportMonitor {
         handleViewportChangeIfNeeded(reason: .viewLayout, viewportSignature: viewportSignature)
     }
 
-    /// 屏幕旋转前捕获当前阅读位置，旋转完成后检测视口变化并处理
-    /// - Parameter coordinator: 转场协调器
     func viewWillTransition(with coordinator: UIViewControllerTransitionCoordinator) {
         guard let controller else { return }
         guard controller.didStartInitialLoad else { return }
@@ -57,7 +56,6 @@ final class RDEPUBReaderViewportMonitor {
         }
     }
 
-    /// 重置所有视口状态，用于重新加载书籍
     func resetForReload() {
         lastAppliedViewportSignature = currentViewportSignature()
         pendingViewportChangeReason = nil
@@ -65,19 +63,16 @@ final class RDEPUBReaderViewportMonitor {
         isWaitingForViewportTransitionCompletion = false
     }
 
-    /// 消费并返回待恢复的阅读位置（一次性读取后清空）
     func consumePendingPresentationRestoreLocation() -> RDEPUBLocation? {
         defer { pendingPresentationRestoreLocation = nil }
         return pendingPresentationRestoreLocation
     }
 
-    /// 主动捕获当前阅读位置到待恢复队列，供后续视口变化后恢复使用
     func capturePendingPresentationRestoreLocation() {
         guard let controller else { return }
         pendingPresentationRestoreLocation = controller.currentVisibleLocation() ?? controller.persistenceLocation()
     }
 
-    /// 分页完成后处理挂起的视口变化（如有），避免分页过程中重复触发
     func processPendingChangeAfterPagination() {
         guard let pendingReason = pendingViewportChangeReason else { return }
         pendingViewportChangeReason = nil
@@ -86,7 +81,6 @@ final class RDEPUBReaderViewportMonitor {
         }
     }
 
-    /// 获取当前视口签名，包含容器尺寸和安全区域信息
     func currentViewportSignature() -> RDEPUBViewportSignature? {
         guard let controller else { return nil }
         let containerSize = controller.readerView.bounds.size == .zero ? controller.view.bounds.size : controller.readerView.bounds.size
@@ -102,7 +96,6 @@ final class RDEPUBReaderViewportMonitor {
         )
     }
 
-    /// 检测视口签名是否发生显著变化，若变化则触发重新分页或重建外部 TextBook
     func handleViewportChangeIfNeeded(
         reason: RDEPUBViewportChangeReason,
         viewportSignature: RDEPUBViewportSignature? = nil