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

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

Sources/RDReaderView/EPUBUI/Settings/RDEPUBReaderConfiguration.swift

@@ -1,26 +1,18 @@
 import UIKit
 
-// MARK: - 文本渲染引擎
-
-/// EPUB 文本渲染引擎枚举
-/// 定义了当前支持的文本渲染方式，未来可扩展为多引擎选择
 public enum RDEPUBTextRenderingEngine: Equatable {
-    /// 基于 DTCoreText 的渲染引擎，将 HTML/CSS 转换为 NSAttributedString
+
     case dtCoreText
 }
 
-// MARK: - 阅读字体
-
-/// 阅读器内置字体选项。
-/// 第一版优先使用系统授权字体，后续可扩展为 bundle 内置字体注册。
 public enum RDEPUBReaderFontChoice: String, Codable, CaseIterable, Equatable {
-    /// 系统默认无衬线字体
+
     case system
-    /// 系统衬线字体
+
     case serif
-    /// 系统圆体字体
+
     case rounded
-    /// 系统等宽字体
+
     case monospaced
 
     public var displayName: String {
@@ -54,108 +46,58 @@ public enum RDEPUBReaderFontChoice: String, Codable, CaseIterable, Equatable {
     }
 }
 
-// MARK: - 阅读器配置
-
-/// EPUB 阅读器的完整配置结构体
-/// 作为 EPUBUI 层的入口配置，控制阅读器的外观、行为和功能开关
-/// 调用方在创建 RDEPUBReaderController 前可自定义此配置
 public struct RDEPUBReaderConfiguration: Equatable {
-    // MARK: 阅读排版参数
 
-    /// 正文字号（单位：pt），默认 15
     public var fontSize: CGFloat
-    /// 行距倍数，默认 1.6（即行距为字号的 1.6 倍）
+
     public var lineHeightMultiple: CGFloat
-    /// 正文字体，默认系统字体
+
     public var fontChoice: RDEPUBReaderFontChoice
-    /// 栏数，默认单栏
+
     public var numberOfColumns: Int
-    /// 栏间距，默认 20pt
+
     public var columnGap: CGFloat
-    /// 翻页显示模式：.pageCurl（仿真翻页）或 .scroll（滚动阅读）
+
     public var displayType: RDReaderView.DisplayType
-    /// 横屏时是否启用双页显示，默认开启
+
     public var landscapeDualPageEnabled: Bool
 
-    // MARK: UI 功能开关
-
-    /// 是否显示目录入口，默认开启
     public var showsTableOfContents: Bool
-    /// 是否允许文本高亮功能，默认开启
+
     public var allowsHighlights: Bool
-    /// 是否显示设置面板入口，默认开启
+
     public var showsSettingsPanel: Bool
 
-    // MARK: 内容内边距
-
-    /// 流式排版（reflowable）内容的内边距，上下 40pt、左右 16pt
     public var reflowableContentInsets: UIEdgeInsets
-    /// 固定布局（fixed layout）内容的内边距，默认为零
+
     public var fixedContentInset: UIEdgeInsets
 
-    // MARK: 主题与布局
-
-    /// 当前阅读主题（浅色/深色/护眼等），默认 .light
     public var theme: RDEPUBReaderTheme
-    /// 暗色主题下是否柔化正文图片，降低夜间阅读刺眼感
+
     public var darkImageAdjustmentEnabled: Bool
-    /// 暗色主题图片柔化混合比例，0 表示不处理，推荐 0.12 ~ 0.2
+
     public var darkImageBlendRatio: CGFloat
-    /// 固定布局的适配模式：按页适配或按宽度适配
+
     public var fixedLayoutFit: RDEPUBFixedLayoutFit
-    /// 固定布局的跨页模式：自动/单页/双页
+
     public var fixedLayoutSpreadMode: RDEPUBFixedLayoutSpreadMode
-    /// 文本渲染引擎，默认使用 DTCoreText
+
     public var textRenderingEngine: RDEPUBTextRenderingEngine
-    /// 章节按需加载窗口大小（总章节数，包含当前章），默认 3，范围 3...15，偶数自动向上取奇
+
     public var onDemandChapterWindowSize: Int
-    /// 后台元数据解析并发数，默认为 CPU 核心数。
-    /// 若 profiling 显示 renderTotalMs ≈ wallClockMs（渲染受限），维持核心数即可；
-    /// 若 writeTotalMs 占比显著（I/O 等待），可试探 cpuCount * 1.25~1.5 以填充 I/O 等待间隙。
+
     public var metadataParsingConcurrency: Int
 
-    // MARK: JumpSession 策略
-
-    /// JumpSession 策略配置
     public var jumpSessionPolicy: RDEPUBJumpSessionPolicy
 
-    // MARK: 安全策略
-
-    /// 允许直接打开的外部 URL scheme 集合，默认仅允许 https
     public var allowedExternalURLSchemes: Set<String>
-    /// 打开外部链接前是否需要用户确认，默认 true
+
     public var requiresExternalLinkConfirmation: Bool
-    /// 是否允许正文和离屏分页 WebView 开启 inspectable，默认 false
+
     public var allowsInspectableWebViews: Bool
-    /// 是否允许输出完整 WebView 消息体日志，默认 false
+
     public var enablesVerboseWebViewLogging: Bool
 
-    // MARK: 初始化
-
-    /// 创建阅读器配置，所有参数均提供合理的默认值
-    /// - Parameters:
-    ///   - fontSize: 正文字号，默认 15pt
-    ///   - lineHeightMultiple: 行距倍数，默认 1.6
-    ///   - fontChoice: 正文字体，默认系统字体
-    ///   - displayType: 翻页模式，默认 .pageCurl
-    ///   - landscapeDualPageEnabled: 横屏双页，默认 true
-    ///   - showsTableOfContents: 显示目录入口，默认 true
-    ///   - allowsHighlights: 允许高亮，默认 true
-    ///   - showsSettingsPanel: 显示设置面板，默认 true
-    ///   - reflowableContentInsets: 流式排版内边距
-    ///   - fixedContentInset: 固定布局内边距
-    ///   - theme: 阅读主题，默认 .light
-    ///   - darkImageAdjustmentEnabled: 暗色主题下是否柔化正文图片
-    ///   - darkImageBlendRatio: 暗色主题图片柔化混合比例
-    ///   - fixedLayoutFit: 固定布局适配模式
-    ///   - fixedLayoutSpreadMode: 固定布局跨页模式
-    ///   - textRenderingEngine: 文本渲染引擎
-    ///   - onDemandChapterWindowSize: 章节按需加载窗口大小（总章节数 3...15，偶数自动向上取奇）
-    ///   - metadataParsingConcurrency: 后台元数据解析并发数，默认 CPU 核心数
-    ///   - allowedExternalURLSchemes: 允许直接打开的外部 URL scheme 集合，默认仅 https
-    ///   - requiresExternalLinkConfirmation: 打开外部链接前是否需要确认，默认 true
-    ///   - allowsInspectableWebViews: 是否允许开启 inspectable，默认 false
-    ///   - enablesVerboseWebViewLogging: 是否允许输出完整 WebView 消息体日志，默认 false
     public init(
         fontSize: CGFloat = 15,
         lineHeightMultiple: CGFloat = 1.6,
@@ -210,11 +152,11 @@ public struct RDEPUBReaderConfiguration: Equatable {
         self.enablesVerboseWebViewLogging = enablesVerboseWebViewLogging
     }
 
-    /// 默认配置实例，使用所有参数的默认值
     public static let `default` = RDEPUBReaderConfiguration()
 }
 
 extension RDEPUBReaderConfiguration {
+
     static func normalizedChapterWindowSize(_ size: Int) -> Int {
         let clamped = max(3, min(15, size))
         return clamped % 2 == 0 ? clamped + 1 : clamped
@@ -225,11 +167,8 @@ extension RDEPUBReaderConfiguration {
     }
 }
 
-// MARK: - 配置转换
-
 extension RDEPUBReaderConfiguration {
-    /// 将用户可见的配置转换为底层排版引擎所需的 RDEPUBPreferences
-    /// - Returns: 排版偏好设置实例，供 Core 层的渲染管道使用
+
     func makePreferences() -> RDEPUBPreferences {
         RDEPUBPreferences(
             fontSize: fontSize,