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

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

Sources/RDReaderView/EPUBUI/ReaderController/ChapterRuntime/RDEPUBChapterOffsetMap.swift

@@ -1,16 +1,35 @@
 import Foundation
 
 struct RDEPUBChapterOffsetMap {
+
     let fragmentOffsets: [String: Int]
+
     let pageStartOffsets: [Int]
+
     let pageEndOffsets: [Int]
 
-    /// fragmentID -> 章内字符偏移
+    let cfiMap: RDEPUBCFIMap?
+
+    let chapterText: String?
+
     func chapterOffset(forFragmentID fragmentID: String) -> Int? {
         return fragmentOffsets[fragmentID]
     }
 
-    /// 章内字符偏移 -> 章内页码（从 0 开始）
+    func chapterOffset(forCFI rawCFI: String?) -> Int? {
+        guard let cfi = RDEPUBCFICompatibility.parseLossy(rawCFI) else { return nil }
+        let resolved = RDEPUBCFIResolver.resolve(cfi)
+        let lastOffset = max((pageEndOffsets.max() ?? 0), 0)
+        return RDEPUBCFIRecoveryEngine.recover(
+            cfi: cfi,
+            cfiMap: cfiMap,
+            chapterText: chapterText,
+            fragmentOffsets: fragmentOffsets,
+            fallbackOffset: resolved.chapterOffset,
+            lastOffset: lastOffset
+        )?.chapterOffset
+    }
+
     func pageIndex(forChapterOffset offset: Int) -> Int? {
         for i in 0..<pageStartOffsets.count {
             if offset >= pageStartOffsets[i] && offset <= pageEndOffsets[i] {
@@ -19,4 +38,4 @@ struct RDEPUBChapterOffsetMap {
         }
         return nil
     }
-}
+}