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

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

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

@@ -1,26 +1,17 @@
 import Foundation
 
 struct RDEPUBChapterWindowSnapshot {
-    /// 窗口中的章节（有序）
+
     let chapters: [RDEPUBRuntimeChapter]
 
-    /// 展平后的连续页数组（供 RDReaderView 消费）
-    /// 窗口内页码不写回 RDEPUBTextPage 模型；
-    /// flattenedPages 的数组下标就是窗口内连续页码（从 0 开始）。
     let flattenedPages: [RDEPUBTextPage]
 
-    /// 当前章在 chapters 数组中的索引
     let anchorChapterIndex: Int
 
-    /// 当前章在 flattenedPages 中的起始页码（从 0 开始，窗口内编号）
     let anchorPageOffset: Int
 
-    /// 当前窗口首章的 spineIndex，用于调试日志和跨窗口映射
     let windowStartSpineIndex: Int
 
-    // MARK: - 构建
-
-    /// 从章节窗口构建快照
     static func from(
         chapters: [RDEPUBRuntimeChapter],
         anchorSpineIndex: Int
@@ -29,7 +20,6 @@ struct RDEPUBChapterWindowSnapshot {
         let anchorIndex = sortedChapters.firstIndex { $0.spineIndex == anchorSpineIndex } ?? 0
         let pageOffset = sortedChapters.prefix(anchorIndex).reduce(0) { $0 + $1.pages.count }
 
-        // 展平页数组
         var allPages: [RDEPUBTextPage] = []
         for (chIdx, ch) in sortedChapters.enumerated() {
             for var page in ch.pages {
@@ -49,9 +39,6 @@ struct RDEPUBChapterWindowSnapshot {
         )
     }
 
-    // MARK: - 查询
-
-    /// 窗口内页码（即 flattenedPages 下标）-> 所属章节
     func chapterForPage(flattenedPageIndex: Int) -> RDEPUBRuntimeChapter? {
         var offset = 0
         for ch in chapters {
@@ -63,11 +50,9 @@ struct RDEPUBChapterWindowSnapshot {
         return nil
     }
 
-    /// 窗口内页码（即 flattenedPages 下标）-> 所属章节的 spineIndex
     func spineIndexForPage(flattenedPageIndex: Int) -> Int? {
         return chapterForPage(flattenedPageIndex: flattenedPageIndex)?.spineIndex
     }
 
-    /// 总页数（窗口内）
     var pageCount: Int { flattenedPages.count }
 }