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 和状态管理
2026-06-13 22:48:56 +08:00
parent 27e9b85ddb
commit 6f75b083f7
83 changed files with 4824 additions and 1879 deletions
@@ -0,0 +1,74 @@
+import XCTest
+
+/// 书签 chrome 状态测试
+/// 覆盖：书签列表按钮在零书签时禁用、添加后启用、书签跨重启存活
+final class BookmarkChromeStateTests: XCTestCase {
+
+    private let app = XCUIApplication()
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+    }
+
+    /// 零书签时，底部书签列表按钮应禁用
+    func testBookmarksListButtonDisabledWhenNoBookmarks() throws {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        app.showReaderChromeIfNeeded()
+
+        let bookmarksButton = app.buttons[IDs.readerBookmarks]
+        guard bookmarksButton.waitForExistence(timeout: 3) else {
+            throw XCTSkip("书签列表按钮不存在")
+        }
+        // 零书签时按钮应存在但不可用
+        XCTAssertFalse(bookmarksButton.isEnabled, "零书签时书签列表按钮应禁用")
+    }
+
+    /// 添加书签后，底部书签列表按钮应启用
+    func testBookmarksListButtonEnabledAfterAdding() throws {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        app.showReaderChromeIfNeeded()
+
+        // 添加书签
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        guard bookmarkButton.waitForExistence(timeout: 3) else {
+            throw XCTSkip("书签按钮不存在")
+        }
+        bookmarkButton.tap()
+
+        // 验证书签列表按钮启用
+        let bookmarksButton = app.buttons[IDs.readerBookmarks]
+        guard bookmarksButton.waitForExistence(timeout: 3) else {
+            throw XCTSkip("书签列表按钮不存在")
+        }
+        XCTAssertTrue(bookmarksButton.isEnabled, "添加书签后书签列表按钮应启用")
+    }
+
+    /// 书签跨重启存活
+    func testBookmarkSurvivesRestart() {
+        app.launchAndOpenSampleBook()
+        app.waitForReader()
+
+        // 添加书签
+        app.showReaderChromeIfNeeded()
+        let bookmarkButton = app.buttons[IDs.readerBookmark]
+        bookmarkButton.waitForExistence(timeout: 3)
+        bookmarkButton.tap()
+
+        // 等待书签状态确认
+        app.waitForDemoReaderState(timeout: 5, description: "bookmarks=1") { $0.bookmarks == 1 }
+
+        // 关闭阅读器
+        app.buttons[IDs.readerBack].tap()
+
+        // 重新打开（不重置状态）
+        app.launchAndOpenSampleBook(resetsReaderState: false)
+        app.waitForReader()
+
+        // 验证书签仍然存在
+        app.waitForDemoReaderState(timeout: 5, description: "bookmarks=1 after restart") { $0.bookmarks == 1 }
+    }
+}