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 和状态管理

ReadViewDemo/ReadViewDemoUITests/ReaderUITests/ReaderAnnotationTests.swift

@@ -7,22 +7,20 @@ final class ReaderAnnotationTests: XCTestCase {
         continueAfterFailure = false
     }
 
-    func testSelectionMenuCreatesHighlight() {
-        app.launchAndOpenSampleBook(pageNumber: 2)
+    func testSelectionMenuCreatesHighlight() throws {
+        app.launchAndOpenSampleBook()
         app.waitForReader()
-        app.waitForReaderPage(2)
         app.hideReaderChromeIfNeeded()
 
-        let content = app.otherElements[IDs.readerSelectionText].firstMatch
-        XCTAssertTrue(content.waitForExistence(timeout: 5), "阅读内容区域未出现")
+        let content = try app.requireSelectionText()
 
-        app.waitForReaderState(containing: "toolbar=hidden", timeout: 5)
+        app.waitForDemoReaderState(timeout: 5, description: "toolbar=hidden") { $0.toolbar == "hidden" }
 
         let start = content.coordinate(withNormalizedOffset: CGVector(dx: 0.2, dy: 0.5))
         let end = content.coordinate(withNormalizedOffset: CGVector(dx: 0.8, dy: 0.5))
         start.press(forDuration: 0.8, thenDragTo: end)
 
-        app.waitForReaderState(containing: "selection=1", timeout: 5)
+        app.waitForDemoReaderState(timeout: 5, description: "selection=1") { $0.selection == 1 }
 
         let highlightMenuItem = app.menuItems["高亮"]
         let highlightButton = app.buttons[IDs.readerSelectionHighlight]
@@ -34,25 +32,43 @@ final class ReaderAnnotationTests: XCTestCase {
             XCTFail("选中文本后未出现高亮菜单")
         }
 
-        app.waitForReaderState(containing: "highlights=1", timeout: 8)
+        app.waitForDemoReaderState(timeout: 8, description: "highlights=1") { $0.highlights == 1 }
     }
 
-    func testLongPressSelectionDoesNotShowToolbars() {
-        app.launchAndOpenSampleBook(pageNumber: 2)
+    func testLongPressSelectionDoesNotShowToolbars() throws {
+        app.launchAndOpenSampleBook()
         app.waitForReader()
-        app.waitForReaderPage(2)
         app.hideReaderChromeIfNeeded()
 
-        let content = app.otherElements[IDs.readerSelectionText].firstMatch
-        XCTAssertTrue(content.waitForExistence(timeout: 5), "阅读内容区域未出现")
+        let content = try app.requireSelectionText()
 
-        app.waitForReaderState(containing: "toolbar=hidden", timeout: 5)
+        app.waitForDemoReaderState(timeout: 5, description: "toolbar=hidden") { $0.toolbar == "hidden" }
 
         let start = content.coordinate(withNormalizedOffset: CGVector(dx: 0.2, dy: 0.5))
         let end = content.coordinate(withNormalizedOffset: CGVector(dx: 0.8, dy: 0.5))
         start.press(forDuration: 0.8, thenDragTo: end)
 
-        app.waitForReaderState(containing: "selection=1", timeout: 8)
-        app.waitForReaderState(containing: "toolbar=hidden", timeout: 3)
+        app.waitForDemoReaderState(timeout: 8, description: "selection=1") { $0.selection == 1 }
+        app.waitForDemoReaderState(timeout: 3, description: "toolbar=hidden") { $0.toolbar == "hidden" }
+    }
+
+    func testSelectionMenuAnnotateCreatesHighlight() throws {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+        app.hideReaderChromeIfNeeded()
+
+        let content = try app.requireSelectionText()
+
+        let start = content.coordinate(withNormalizedOffset: CGVector(dx: 0.25, dy: 0.5))
+        let end = content.coordinate(withNormalizedOffset: CGVector(dx: 0.7, dy: 0.5))
+        start.press(forDuration: 0.8, thenDragTo: end)
+
+        app.waitForDemoReaderState(timeout: 5, description: "selection=1") { $0.selection == 1 }
+
+        let annotateMenuItem = app.menuItems["批注"]
+        XCTAssertTrue(annotateMenuItem.waitForExistence(timeout: 3), "选中文本后未出现批注菜单")
+        annotateMenuItem.tap()
+
+        app.waitForDemoReaderState(timeout: 8, description: "highlights=1 after annotate") { $0.highlights == 1 }
     }
 }