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/EPUBTextRendering/BuildPipeline/RDEPUBChapterTailNormalizer.swift

@@ -20,7 +20,9 @@ struct RDEPUBChapterTailNormalizer {
                     previous.diagnostics.append(note)
                     compacted.append(previous)
                 } else {
+                    #if DEBUG
                     print("[EPUB][Pagination] href=\(href) dropped leading/intermediate whitespace frame \(NSStringFromRange(frame.contentRange))")
+                    #endif
                 }
                 continue
             }
@@ -36,7 +38,9 @@ struct RDEPUBChapterTailNormalizer {
                 previousFrame.diagnostics.append(note)
                 normalized.append(previousFrame)
             } else {
+                #if DEBUG
                 print("[EPUB][Pagination] href=\(href) dropped trailing frame \(NSStringFromRange(lastFrame.contentRange))")
+                #endif
             }
         }
 

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookBuilder.swift

@@ -137,7 +137,9 @@ public final class RDEPUBTextBookBuilder {
         // 保存分页缓存（只缓存页范围和分页原因，不缓存富文本）
         cacheCoordinator.save(chapters: chapters, key: cacheKey)
 
+        #if DEBUG
         print(sampler.summary())
+        #endif
         lastBuildPerformanceSamples = sampler.samples
 
         return book
@@ -207,11 +209,15 @@ public final class RDEPUBTextBookBuilder {
 
         let plainText = rendered.attributedString.string.trimmingCharacters(in: .whitespacesAndNewlines)
         if item.href.lowercased().contains("cover") {
+            #if DEBUG
             print("[EPUB][Cover] rendered href=\(item.href) textLength=\(plainText.count) attrLength=\(rendered.attributedString.length) attachments=\(attachmentCount(in: rendered.attributedString))")
+            #endif
         }
         if shouldSkipChapter(item: item, content: rendered.attributedString, text: plainText) {
             if item.href.lowercased().contains("cover") {
+                #if DEBUG
                 print("[EPUB][Cover] skipped href=\(item.href)")
+                #endif
             }
             return nil
         }
@@ -301,7 +307,9 @@ public final class RDEPUBTextBookBuilder {
             : normalizedFrames
 
         if item.href.lowercased().contains("cover") {
+            #if DEBUG
             print("[EPUB][Cover] paginated href=\(item.href) pages=\(effectiveFrames.count) firstRange=\(effectiveFrames.first.map { NSStringFromRange($0.contentRange) } ?? "none")")
+            #endif
         }
 
         let chapterAttributedContent = content.copy() as! NSAttributedString

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextBookCache.swift

@@ -170,7 +170,9 @@ public final class RDEPUBTextBookCache {
         queue.sync {
             let fileURL = cacheDirectory.appendingPathComponent(key)
             guard FileManager.default.fileExists(atPath: fileURL.path) else {
+                #if DEBUG
                 print("[Cache] load MISS key=\(key)")
+                #endif
                 return nil
             }
             do {
@@ -179,17 +181,23 @@ public final class RDEPUBTextBookCache {
                     ofClass: PaginationCacheArchive.self,
                     from: data
                 ) else {
+                    #if DEBUG
                     print("[Cache] load MISS key=\(key) (unarchive returned nil)")
+                    #endif
                     return nil
                 }
                 var result: [String: RDEPUBTextChapterPaginationCache] = [:]
                 for chapter in archive.chapters {
                     result[chapter.href] = chapter.toCache()
                 }
+                #if DEBUG
                 print("[Cache] load HIT key=\(key) chapters=\(result.count)")
+                #endif
                 return result
             } catch {
+                #if DEBUG
                 print("[Cache] load MISS key=\(key) error=\(error)")
+                #endif
                 return nil
             }
         }
@@ -204,9 +212,13 @@ public final class RDEPUBTextBookCache {
                 let bookArchive = PaginationCacheArchive(chapters: archives)
                 let data = try NSKeyedArchiver.archivedData(withRootObject: bookArchive, requiringSecureCoding: true)
                 try data.write(to: fileURL, options: .atomic)
+                #if DEBUG
                 print("[Cache] save key=\(key) chapters=\(chapters.count)")
+                #endif
             } catch {
+                #if DEBUG
                 print("[Cache] save FAILED key=\(key) error=\(error)")
+                #endif
             }
         }
     }
@@ -223,7 +235,9 @@ public final class RDEPUBTextBookCache {
             for file in contents {
                 try? fileManager.removeItem(at: file)
             }
+            #if DEBUG
             print("[Cache] invalidateAll")
+            #endif
         }
     }
 }

Sources/RDReaderView/EPUBTextRendering/BuildPipeline/RDEPUBTextPerformanceSampler.swift

@@ -51,7 +51,9 @@ public final class RDEPUBTextPerformanceSampler {
     /// 记录单个章节的性能采样，并输出日志
     public func record(_ sample: RDEPUBTextPerformanceSample) {
         samples.append(sample)
+        #if DEBUG
         print("[PERF] \(sample.chapterHref): render=\(formatMS(sample.renderDuration)) paginate=\(formatMS(sample.paginateDuration)) pages=\(sample.pageCount) cache=\(sample.cacheHit ? "HIT" : "MISS")")
+        #endif
     }
 
     /// 生成性能汇总报告，包含总渲染/分页耗时和缓存命中率