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

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

Sources/RDReaderView/ReaderView/RDReaderView+PageCurl.swift

@@ -1,18 +1,8 @@
-//
-//  RDReaderView+PageCurl.swift
-//  ReadViewSDK
-//
-//  文件职责：UIPageViewController 数据源和代理实现，处理仿真翻页模式下的页面数据供给和翻页事件。
-//
 
 import UIKit
 
-/// UIPageViewController 数据源和代理实现
-/// 处理仿真翻页模式下的页面数据供给和翻页事件
 extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDelegate {
 
-    /// 创建指定页码的子控制器
-    /// 空白页返回空视图，正常页从缓存或数据源获取内容
     private func makeSinglePageChildVC(for pageNum: Int) -> RDReaderPageChildViewController {
         if pageNum == RDReaderView.blankPageNum || pageNum == RDReaderView.blankEndPageNum {
             return RDReaderPageChildViewController(contentView: UIView(), pageNum: pageNum)
@@ -21,12 +11,9 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         return RDReaderPageChildViewController(contentView: contentView, pageNum: pageNum)
     }
 
-    /// 计算某页的"下一页"页码
-    /// 考虑封面页独占和末尾空白页配对的情况
     private func nextPageNum(after pageNum: Int, isDualPage: Bool) -> Int? {
         let totalPages = numberOfPages()
 
-        // 末尾空白页之后没有更多页
         if pageNum == RDReaderView.blankEndPageNum {
             return nil
         }
@@ -46,7 +33,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
             return next
         }
 
-        // pageNum 是最后一页，检查在双页模式下是否需要空白页配对
         if isDualPage {
             if let coverIndex = coverPageIndex {
                 let adjustedIndex = pageNum - (coverIndex + 1)
@@ -62,8 +48,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         return nil
     }
 
-    /// 计算某页的"上一页"页码
-    /// 考虑封面页独占和末尾空白页配对的情况
     private func prevPageNum(before pageNum: Int, isDualPage: Bool) -> Int? {
         if pageNum == RDReaderView.blankEndPageNum {
             let totalPages = numberOfPages()
@@ -81,8 +65,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         return prev >= 0 ? prev : nil
     }
 
-    /// UIPageViewController 数据源：返回当前页之前（左/上）的页面控制器
-    /// RTL 模式下 before/after 语义互换：before（向右翻）= 下一页
     public func pageViewController(_ pageViewController: UIPageViewController, viewControllerBefore viewController: UIViewController) -> UIViewController? {
         guard let vc = viewController as? RDReaderPageChildViewController else { return nil }
         let isDualPage = landscapeDualPageEnabled && isLandscape
@@ -98,8 +80,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         return targetVC
     }
 
-    /// UIPageViewController 数据源：返回当前页之后（右/下）的页面控制器
-    /// RTL 模式下 before/after 语义互换
     public func pageViewController(_ pageViewController: UIPageViewController, viewControllerAfter viewController: UIViewController) -> UIViewController? {
         guard let vc = viewController as? RDReaderPageChildViewController else { return nil }
         let isDualPage = landscapeDualPageEnabled && isLandscape
@@ -115,8 +95,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         return targetVC
     }
 
-    /// UIPageViewController 代理：翻页动画完成回调
-    /// 更新当前页码，触发预加载，并检测 PageViewController 异常状态
     public func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
         if completed, let firstVC = pageViewController.viewControllers?.first as? RDReaderPageChildViewController {
             let pn = firstVC.pageNum
@@ -130,8 +108,6 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         finishPageCurlTransition()
     }
 
-    /// UIPageViewController 代理：即将开始转场动画
-    /// 记录预测的翻页方向，用于优化预加载策略
     public func pageViewController(_ pageViewController: UIPageViewController, willTransitionTo pendingViewControllers: [UIViewController]) {
         pagingController.isTransitioning = true
         willTransitionToViewController = pendingViewControllers.first