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

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

Sources/RDReaderView/EPUBUI/ReaderController/RDEPUBReaderLocationCoordinator.swift

@@ -1,23 +1,14 @@
 import Foundation
 
-/// EPUB 阅读器位置协调器：负责阅读位置的恢复、查询和持久化。
-///
-/// 职责：
-/// - 根据保存的位置恢复阅读进度
-/// - 获取当前可见页面的阅读位置
-/// - 从持久化存储加载已保存位置
-/// - 持久化当前位置并通知委托
 final class RDEPUBReaderLocationCoordinator {
     private unowned let context: RDEPUBReaderContext
 
-    /// 上次翻页时的 spineIndex，用于检测跨章翻页
     private var lastPageChangeSpineIndex: Int?
 
     init(context: RDEPUBReaderContext) {
         self.context = context
     }
 
-    /// 恢复到指定阅读位置，返回是否成功跳转。
     @discardableResult
     func restoreReadingLocation(
         _ location: RDEPUBLocation,
@@ -57,13 +48,11 @@ final class RDEPUBReaderLocationCoordinator {
         }
         readerView.transitionToPage(pageNum: max(targetPageNumber - 1, 0), animated: animated)
 
-        // 记录翻页到 JumpSession
         recordPageChangeIfNeeded()
 
         return true
     }
 
-    /// 获取当前可见页面对应的阅读位置。
     func currentVisibleLocation() -> RDEPUBLocation? {
         guard let controller = context.controller,
               let readerView = context.readerView else {
@@ -74,8 +63,7 @@ final class RDEPUBReaderLocationCoordinator {
             if let location = controller.resolvedTextLocation(forPageNumber: pageNumber) {
                 return location
             }
-            // resolvedTextLocation 可能因章节数据未加载而返回 nil，
-            // 通过 readingSession 的 activePages 构建回退位置
+
             if let readingSession = context.readingSession,
                readingSession.activePages.indices.contains(readerView.currentPage) {
                 return readingSession.fallbackLocation(
@@ -87,7 +75,6 @@ final class RDEPUBReaderLocationCoordinator {
         return context.readingSession?.currentReadingLocation(bookIdentifier: context.currentBookIdentifier)
     }
 
-    /// 从持久化存储加载上次保存的阅读位置。
     func persistenceLocation() -> RDEPUBLocation? {
         guard let controller = context.controller,
               let currentBookIdentifier = context.currentBookIdentifier else {
@@ -96,7 +83,6 @@ final class RDEPUBReaderLocationCoordinator {
         return controller.persistence?.loadLocation(for: currentBookIdentifier)
     }
 
-    /// 持久化阅读位置，并通知委托更新目录项和书签状态。
     func persist(location: RDEPUBLocation) {
         guard let controller = context.controller,
               let currentBookIdentifier = context.currentBookIdentifier else { return }
@@ -106,7 +92,6 @@ final class RDEPUBReaderLocationCoordinator {
         controller.updateReaderChrome()
     }
 
-    /// 记录翻页到 JumpSession
     func recordPageChangeIfNeeded() {
         guard let runtime = context.runtime,
               let bookPageMap = context.bookPageMap,
@@ -127,7 +112,6 @@ final class RDEPUBReaderLocationCoordinator {
 
         lastPageChangeSpineIndex = currentSpineIndex
 
-        // 检查是否应该结束 JumpSession
         let isIdle = context.secondsSinceLastUserNavigation() > 2.0
         if let endReason = runtime.jumpSessionManager.checkSessionEnd(
             currentSpineIndex: currentSpineIndex,
@@ -137,7 +121,6 @@ final class RDEPUBReaderLocationCoordinator {
         }
     }
 
-    /// 重置翻页状态（用于重新加载等场景）
     func resetPageChangeState() {
         lastPageChangeSpineIndex = nil
     }