feat: EPUB 阅读器搜索、选中注释、书签 chrome 状态及大量重构优化

- 新增 RDEPUBReaderSearchCoordinator 与 RDEPUBSelectionState 管理搜索和选中状态
- 新增 BookmarkChromeStateTests、NavigationBackwardTests、SelectionAnnotateTests 等 UI 测试
- 新增多个边界测试 epub 样本（损坏结构、空归档、缺失文件、流式外链验证）
- 重构阅读器 chrome 状态管理，统一 tool bar 与 search bar 交互
- 优化大书分页缓存策略（RDEPUBChapterSummaryDiskCache、RDEPUBPageCountCache）
- 移除废弃的 RDEPUBLocationConverter 和 RDEPUBPageBreakPolicy
- 更新 epub-bridge.js 与 JS bridge 通信协议
- 全面更新现有 UI 测试以适配新的 helper 和状态管理

Sources/RDReaderView/EPUBUI/Settings/RDEPUBReaderConfiguration.swift

@@ -114,6 +114,17 @@ public struct RDEPUBReaderConfiguration: Equatable {
     /// 若 writeTotalMs 占比显著（I/O 等待），可试探 cpuCount * 1.25~1.5 以填充 I/O 等待间隙。
     public var metadataParsingConcurrency: Int
 
+    // 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: 初始化
 
     /// 创建阅读器配置，所有参数均提供合理的默认值
@@ -136,6 +147,10 @@ public struct RDEPUBReaderConfiguration: Equatable {
     ///   - 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,
@@ -156,7 +171,11 @@ public struct RDEPUBReaderConfiguration: Equatable {
         fixedLayoutSpreadMode: RDEPUBFixedLayoutSpreadMode = .automatic,
         textRenderingEngine: RDEPUBTextRenderingEngine = .dtCoreText,
         onDemandChapterWindowSize: Int = 3,
-        metadataParsingConcurrency: Int = ProcessInfo.processInfo.activeProcessorCount
+        metadataParsingConcurrency: Int = ProcessInfo.processInfo.activeProcessorCount,
+        allowedExternalURLSchemes: Set<String> = ["https"],
+        requiresExternalLinkConfirmation: Bool = true,
+        allowsInspectableWebViews: Bool = false,
+        enablesVerboseWebViewLogging: Bool = false
     ) {
         self.fontSize = fontSize
         self.lineHeightMultiple = lineHeightMultiple
@@ -178,6 +197,10 @@ public struct RDEPUBReaderConfiguration: Equatable {
         self.textRenderingEngine = textRenderingEngine
         self.onDemandChapterWindowSize = Self.normalizedChapterWindowSize(onDemandChapterWindowSize)
         self.metadataParsingConcurrency = max(1, metadataParsingConcurrency)
+        self.allowedExternalURLSchemes = allowedExternalURLSchemes
+        self.requiresExternalLinkConfirmation = requiresExternalLinkConfirmation
+        self.allowsInspectableWebViews = allowsInspectableWebViews
+        self.enablesVerboseWebViewLogging = enablesVerboseWebViewLogging
     }
 
     /// 默认配置实例，使用所有参数的默认值

Sources/RDReaderView/EPUBUI/Settings/RDEPUBReaderSettingsViewController.swift

@@ -239,6 +239,7 @@ final class RDEPUBReaderSettingsViewController: UIViewController {
 
         let selectedPreset = ThemePreset.allCases.first(where: { $0.theme == currentConfiguration.theme }) ?? .light
         updateThemeSelection(selectedPreset)
+        updateControlAccessibilityValues()
     }
 
     private func applyTheme(_ theme: RDEPUBReaderTheme) {
@@ -279,9 +280,17 @@ final class RDEPUBReaderSettingsViewController: UIViewController {
             let isSelected = button.tag == preset.rawValue
             button.layer.borderWidth = isSelected ? 2 : 1
             button.layer.borderColor = isSelected ? currentConfiguration.theme.toolControlTextColor.cgColor : currentConfiguration.theme.toolControlBorderUnselectColor.cgColor
+            button.accessibilityValue = isSelected ? "selected" : "unselected"
         }
     }
 
+    private func updateControlAccessibilityValues() {
+        fontChoiceControl.accessibilityValue = fontChoiceControl.titleForSegment(at: fontChoiceControl.selectedSegmentIndex)
+        lineHeightControl.accessibilityValue = lineHeightControl.titleForSegment(at: lineHeightControl.selectedSegmentIndex)
+        columnCountControl.accessibilityValue = columnCountControl.titleForSegment(at: columnCountControl.selectedSegmentIndex)
+        displayTypeControl.accessibilityValue = displayTypeControl.titleForSegment(at: displayTypeControl.selectedSegmentIndex)
+    }
+
     @objc private func doneAction() {
         dismiss(animated: true)
     }
@@ -312,6 +321,7 @@ final class RDEPUBReaderSettingsViewController: UIViewController {
         let choice = choices[index]
         guard choice != currentConfiguration.fontChoice else { return }
         currentConfiguration.fontChoice = choice
+        updateControlAccessibilityValues()
         onFontChoiceChange?(choice)
     }
 
@@ -319,12 +329,14 @@ final class RDEPUBReaderSettingsViewController: UIViewController {
         let index = max(0, min(control.selectedSegmentIndex, lineHeightValues.count - 1))
         let value = lineHeightValues[index]
         currentConfiguration.lineHeightMultiple = value
+        updateControlAccessibilityValues()
         onLineHeightChange?(value)
     }
 
     @objc private func columnCountChanged(_ control: UISegmentedControl) {
         let numberOfColumns = control.selectedSegmentIndex == 1 ? 2 : 1
         currentConfiguration.numberOfColumns = numberOfColumns
+        updateControlAccessibilityValues()
         onColumnCountChange?(numberOfColumns)
     }
 
@@ -339,6 +351,7 @@ final class RDEPUBReaderSettingsViewController: UIViewController {
             displayType = .pageCurl
         }
         currentConfiguration.displayType = displayType
+        updateControlAccessibilityValues()
         onDisplayTypeChange?(displayType)
     }