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

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

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

@@ -1,8 +1,11 @@
 import Foundation
 
 final class RDEPUBChapterSummaryDiskCache {
+
     private let cacheDirectory: URL
+
     private let fileManager = FileManager.default
+
     private let queue = DispatchQueue(label: "com.rdreader.summarydiskcache", qos: .utility)
 
     init(cacheDirectory: URL) {
@@ -10,28 +13,22 @@ final class RDEPUBChapterSummaryDiskCache {
         try? fileManager.createDirectory(at: cacheDirectory, withIntermediateDirectories: true)
     }
 
-    // MARK: - 写入（异步）
-
     func write(summary: RDEPUBChapterSummary, for key: RDEPUBChapterCacheKey) {
         queue.async {
             self.writeImmediately(summary: summary, for: key)
         }
     }
 
-    /// 同步写入：用于后台整书元数据构建完成前，确保摘要文件已经真实落盘。
     func writeSynchronously(summary: RDEPUBChapterSummary, for key: RDEPUBChapterCacheKey) {
         queue.sync {
             self.writeImmediately(summary: summary, for: key)
         }
     }
 
-    /// 等待此前已排队的异步写入全部落盘。
     func flushPendingWrites() {
         queue.sync { }
     }
 
-    // MARK: - 读取（同步，因为 loadChapter 已在串行队列上）
-
     func read(for key: RDEPUBChapterCacheKey) -> RDEPUBChapterSummary? {
         let fileURL = self.fileURL(for: key)
         let data: Data
@@ -40,7 +37,7 @@ final class RDEPUBChapterSummaryDiskCache {
         } catch {
             let nsError = error as NSError
             if nsError.domain == NSCocoaErrorDomain && nsError.code == NSFileReadNoSuchFileError {
-                // 文件不存在属于正常缓存未命中，不报错
+
             } else {
                 #if DEBUG
                 print("[RDEPUBChapterSummaryDiskCache] ⚠️ read IO error for \(fileURL.lastPathComponent): \(error.localizedDescription)")
@@ -58,11 +55,6 @@ final class RDEPUBChapterSummaryDiskCache {
         }
     }
 
-    // MARK: - 批量读取：二次打开时直接从磁盘构建 BookPageMap
-
-    /// 批量读取指定缓存键列表的摘要，返回 spineIndex → summary 映射。
-    /// 同步方法，应在后台线程调用。
-    /// 由调用方负责构建完整的缓存键列表（含正确的 contentHash）。
     func readAll(keys: [(key: RDEPUBChapterCacheKey, spineIndex: Int, href: String, title: String)]) -> (
         summaries: [Int: RDEPUBChapterSummary],
         mapBuilder: RDEPUBBookPageMap.Builder
@@ -85,7 +77,6 @@ final class RDEPUBChapterSummaryDiskCache {
         return (summaries, mapBuilder)
     }
 
-    /// 检查指定缓存键列表是否全部有对应的磁盘摘要。
     func isCacheComplete(keys: [RDEPUBChapterCacheKey]) -> Bool {
         for key in keys {
             if read(for: key) == nil {
@@ -95,24 +86,20 @@ final class RDEPUBChapterSummaryDiskCache {
         return true
     }
 
-    /// 清空所有缓存文件
     func removeAll() {
         removeFiles(matching: { _ in true })
     }
 
-    /// 清空指定书籍的所有缓存文件
     func removeAll(forBookID bookID: String) {
         let bookPrefix = Self.cacheNamespacePrefix(for: bookID)
         removeFiles { $0.hasPrefix(bookPrefix + "__") }
     }
 
-    /// 清空指定渲染签名下的所有缓存文件
     func removeAll(forRenderSignature renderSignature: String) {
         let renderPrefix = "__" + Self.cacheNamespacePrefix(for: renderSignature) + "__"
         removeFiles { $0.contains(renderPrefix) }
     }
 
-    /// 缓存统计信息
     var cacheStatistics: (fileCount: Int, totalBytes: Int64) {
         guard let files = try? fileManager.contentsOfDirectory(at: cacheDirectory, includingPropertiesForKeys: [.fileSizeKey]) else {
             return (0, 0)
@@ -128,9 +115,6 @@ final class RDEPUBChapterSummaryDiskCache {
         return (count, totalBytes)
     }
 
-    // MARK: - key -> 文件路径
-
-    /// 使用确定性字符串拼接生成文件名，不依赖 Hashable.hashValue
     private func fileURL(for key: RDEPUBChapterCacheKey) -> URL {
         let bookPrefix = Self.cacheNamespacePrefix(for: key.bookID)
         let renderPrefix = Self.cacheNamespacePrefix(for: key.renderSignature)
@@ -171,29 +155,48 @@ final class RDEPUBChapterSummaryDiskCache {
 }
 
 struct RDEPUBChapterSummary: Codable {
+
     let pageRanges: [RangeData]
+
     let pageCount: Int
+
     let fragmentOffsets: [String: Int]
+
+    let cfiMap: RDEPUBCFIMap?
+
     let renderSignature: String
+
     let schemaVersion: Int
+
     let chapterContentHash: String
+
     let pageMetadataList: [PageMetadataSummary]
 
-    static let currentSchemaVersion = 6
+    static let currentSchemaVersion = 9
 
     struct RangeData: Codable {
+
         let location: Int
+
         let length: Int
+
         var nsRange: NSRange { NSRange(location: location, length: length) }
     }
 
     struct PageMetadataSummary: Codable {
+
         let breakReason: String
+
         let attachmentRanges: [RangeData]
+
         let attachmentKinds: [String]
+
         let blockKinds: [String]
+
         let semanticHints: [String]
+
         let attachmentPlacements: [String]
+
         let trailingFragmentID: String?
 
         func toPageMetadata() -> RDEPUBTextPageMetadata {