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/EPUBCore/RDEPUBWebViewDebug.swift

@@ -21,6 +21,30 @@ enum RDEPUBWebViewDebug {
 #endif
     }()
 
+    /// 详细日志模式是否启用（默认关闭，可通过 UserDefaults "RDEPUBWebViewVerboseEnabled" 开启）
+    /// 开启后 logMessage 将输出完整消息体，关闭时仅输出消息名、字段名和文本长度
+    static var isVerboseEnabled: Bool = {
+        if let configured = UserDefaults.standard.object(forKey: "RDEPUBWebViewVerboseEnabled") as? Bool {
+            return configured
+        }
+        return false
+    }()
+
+    /// 是否允许开启 inspectable。
+    /// 默认关闭，仅在阅读器配置显式允许或 UserDefaults 覆盖时开启。
+    static var isInspectableEnabled: Bool = {
+        if let configured = UserDefaults.standard.object(forKey: "RDEPUBInspectableWebViewsEnabled") as? Bool {
+            return configured
+        }
+        return false
+    }()
+
+    /// 将阅读器配置同步到调试策略，保证默认安全策略由配置显式控制。
+    static func applyDebugPolicy(inspectableEnabled: Bool, verboseLoggingEnabled: Bool) {
+        isInspectableEnabled = inspectableEnabled
+        isVerboseEnabled = verboseLoggingEnabled
+    }
+
     /// 获取 WebView 的十六进制标识符（用于日志区分多个 WebView 实例）
     static func webViewID(_ webView: WKWebView?) -> String {
         guard let webView else { return "nil-webview" }
@@ -51,10 +75,26 @@ enum RDEPUBWebViewDebug {
         log(scope, message: "webView=\(webViewID(webView)) js=\(action) \(details)")
     }
 
-    /// 输出 JS 消息接收日志（含消息名称和消息体）
+    /// 输出 JS 消息接收日志（默认仅输出字段名和文本长度，verbose 模式输出完整消息体）
     static func logMessage(_ scope: String, webView: WKWebView?, name: String, body: Any) {
         guard isEnabled else { return }
-        log(scope, message: "webView=\(webViewID(webView)) message=\(name) body=\(String(describing: body))")
+        if isVerboseEnabled {
+            log(scope, message: "webView=\(webViewID(webView)) message=\(name) body=\(String(describing: body))")
+            return
+        }
+        if let dict = body as? [String: Any] {
+            let keys = dict.keys.sorted().joined(separator: ",")
+            var meta = "keys=[\(keys)]"
+            if let text = dict["text"] as? String {
+                meta += " textLen=\(text.count)"
+            }
+            if let urlString = dict["url"] as? String ?? dict["href"] as? String {
+                meta += " url=\(summarizedURL(URL(string: urlString)))"
+            }
+            log(scope, message: "webView=\(webViewID(webView)) message=\(name) \(meta)")
+        } else {
+            log(scope, message: "webView=\(webViewID(webView)) message=\(name) type=\(Swift.type(of: body))")
+        }
     }
 
     /// 输出 URL Scheme 任务日志（含请求 URL、文件 URL、事件类型、错误信息）
@@ -81,4 +121,4 @@ enum RDEPUBWebViewDebug {
         }
         return url.lastPathComponent.isEmpty ? path : url.lastPathComponent
     }
-}
+}