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

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

Sources/RDReaderView/EPUBCore/RDEPUBJavaScriptBridge.swift

@@ -1,35 +1,27 @@
-// RDEPUBJavaScriptBridge.swift
-// 原生与 WebView 之间的 JavaScript 桥接层
-// 定义所有 JS 消息类型（progression/selection/link/error 等），
-// 生成注入到 WebView 的用户脚本，以及分页渲染、搜索高亮等执行脚本。
 
 import Foundation
 
-/// JS 桥接消息类型枚举，每种消息对应 WebView 向原生发送的一种事件
 enum RDEPUBJavaScriptBridgeMessage: String, CaseIterable {
-    /// 阅读进度变化事件
+
     case progressionChanged = "ssReaderProgressionChanged"
-    /// 文本选择变化事件
+
     case selectionChanged = "ssReaderSelectionChanged"
-    /// 内部链接点击事件（ss-reader:// 协议）
+
     case internalLink = "ssReaderInternalLink"
-    /// 外部链接点击事件（http/https/mailto/tel）
+
     case externalLink = "ssReaderExternalLink"
-    /// JavaScript 运行时错误事件
+
     case javaScriptError = "ssReaderJSError"
-    /// 固定版式渲染就绪事件
+
     case fixedLayoutReady = "ssReaderFixedLayoutReady"
 }
 
-/// JavaScript 桥接工具集，负责生成注入脚本和执行脚本
 enum RDEPUBJavaScriptBridge {
-    /// 所有需要注册的 JS 消息名称列表，用于 WKUserContentController 注册
+
     static var messageNames: [String] {
         RDEPUBJavaScriptBridgeMessage.allCases.map(\.rawValue)
     }
 
-    /// 获取注入到 WebView 的桥接用户脚本（在 document end 注入）
-    /// 将消息类型占位符替换为实际值，使 JS 端能通过 window.webkit.messageHandlers 发送消息
     static var userScript: String {
         [
             RDEPUBAssetRepository.string(for: .rangyCoreScript),
@@ -50,10 +42,6 @@ enum RDEPUBJavaScriptBridge {
         ].joined(separator: "\n\n")
     }
 
-    /// 生成重排模式下的分页渲染脚本
-    /// 注入 CSS 分页样式、设置页码参数、高亮和目标位置，最后触发进度汇报
-    /// - Parameter request: 重排渲染请求，包含展示样式、高亮、目标位置等信息
-    /// - Returns: 可直接通过 evaluateJavaScript 执行的脚本字符串
     static func applyPresentationScript(for request: RDEPUBReflowableRenderRequest) -> String {
         let style = escapedJavaScriptTemplateLiteral(RDEPUBStyleSheetBuilder.renderCSS(for: request.presentation))
         let pageStride = max(1, request.presentation.viewportSize.width)
@@ -87,10 +75,6 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
-    /// 生成固定版式模式下的主题应用脚本
-    /// 仅应用共享主题（背景色），不涉及分页逻辑（固定版式由 HTML 自身布局决定）
-    /// - Parameter request: 固定版式渲染请求，包含背景色等信息
-    /// - Returns: 可直接通过 evaluateJavaScript 执行的脚本字符串
     static func applyFixedPresentationScript(for request: RDEPUBFixedRenderRequest) -> String {
         """
         (function() {
@@ -105,11 +89,6 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
-    /// 生成搜索高亮脚本
-    /// 在当前文档和所有 iframe 中查找关键词并用 span 标记高亮，
-    /// 活跃匹配项使用特殊样式并自动滚动到视图中央
-    /// - Parameter presentation: 搜索展示信息（关键词、各资源的匹配数量等）
-    /// - Returns: 搜索高亮脚本字符串
     static func applySearchScript(for presentation: RDEPUBSearchPresentation?) -> String {
         let payload = jsonString(from: searchPayload(presentation), fallback: "null")
         return """
@@ -121,9 +100,6 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
-    /// 生成获取当前装饰数据的脚本
-    /// 从 WebView 中读取高亮和搜索高亮的 DOM 装饰信息，用于同步原生标注状态
-    /// - Returns: 可直接通过 evaluateJavaScript 执行的脚本字符串，返回包含 highlights 和 search 的对象
     static func resolveDecorationsScript() -> String {
         """
         (function() {
@@ -133,14 +109,12 @@ enum RDEPUBJavaScriptBridge {
         """
     }
 
-    /// 转义字符串中的反斜杠和反引号，避免 JS 模板字面量语法错误
     private static func escapedJavaScriptTemplateLiteral(_ string: String) -> String {
         string
             .replacingOccurrences(of: "\\", with: "\\\\")
             .replacingOccurrences(of: "`", with: "\\`")
     }
 
-    /// 将高亮数组转换为 JS 可用的字典数组
     private static func highlightsPayload(_ highlights: [RDEPUBHighlight]) -> [[String: String]] {
         highlights.compactMap { highlight in
             guard let rangeInfo = highlight.rangeInfo, !rangeInfo.isEmpty else { return nil }
@@ -153,7 +127,6 @@ enum RDEPUBJavaScriptBridge {
         }
     }
 
-    /// 将目标位置转换为 JS 可用的字典（含 progression、fragment）
     private static func targetLocationPayload(_ location: RDEPUBLocation?) -> [String: Any]? {
         guard let location else { return nil }
         return [
@@ -163,7 +136,6 @@ enum RDEPUBJavaScriptBridge {
         ]
     }
 
-    /// 将搜索展示信息转换为 JS 可用的字典
     private static func searchPayload(_ presentation: RDEPUBSearchPresentation?) -> [String: Any]? {
         guard let presentation else { return nil }
         return [
@@ -178,7 +150,6 @@ enum RDEPUBJavaScriptBridge {
         ]
     }
 
-    /// 将任意对象序列化为 JSON 字符串，失败时返回 fallback
     private static func jsonString(from object: Any?, fallback: String) -> String {
         guard let object else { return fallback }
         guard JSONSerialization.isValidJSONObject(object),
@@ -189,8 +160,6 @@ enum RDEPUBJavaScriptBridge {
         return string
     }
 
-    /// 将 Swift 字符串转换为 JavaScript 字符串字面量
-    /// nil 值转为 "null"，非空值序列化为 JSON 字符串后去除外层方括号
     private static func javaScriptStringLiteral(_ value: String?) -> String {
         guard let value else { return "null" }
         return jsonString(from: [value], fallback: "[null]")