修复阅读器资源、朗读与持久化稳定性

阅读器在多会话朗读、加密 EPUB 资源、并发打开同一本书和多 UserDefaults 容器等场景下，存在旧异步结果覆盖新状态、锁屏控制串会话、大型明文资源被误拒绝、解压半成品被复用及标注跨容器混用的风险；同时高亮、书签、搜索和设置面板的空状态与自动化可访问性入口不完整。\n\n本次为朗读会话引入代次和当前 utterance 校验，远程控制改为仅响应当前会话并按自身 token 清理；加密资源 provider 先判定是否实际返回解密数据，明文大资源继续流式读取；解压缓存串行化以避免并发复用未完成目录。书签与高亮迁移至受保护文件，按 UserDefaults 容器隔离命名空间，保留标准容器旧文件兼容并确保新副本成功落盘后才删除历史数据。\n\n同步调整缓存淘汰、FoundationModels 弱链接、搜索/标注/设置面板交互与 UI 测试，并更新 Pod 生成配置及 API、风险文档。已执行 git diff --check 和 ReadViewDemo Debug Simulator 构建，结果为 BUILD SUCCEEDED。

ReadViewDemo/ReadViewDemoUITests/ReaderUITests/SettingsEffectTests.swift

@@ -16,9 +16,8 @@ final class SettingsEffectTests: XCTestCase {
         XCTAssertTrue(app.buttons[IDs.readerSettings].waitForExistence(timeout: 3), "设置按钮不存在")
         app.buttons[IDs.readerSettings].tap()
 
-        XCTAssertTrue(app.scrollViews[IDs.settingsScroll].waitForExistence(timeout: 5), "设置面板未出现")
-        XCTAssertTrue(app.buttons[IDs.settingsFontIncrease].waitForExistence(timeout: 3), "字号增大按钮不存在")
-        app.buttons[IDs.settingsFontIncrease].tap()
+        XCTAssertTrue(app.waitForSettingsPanel(), "设置面板未出现")
+        XCTAssertTrue(app.increaseSettingsFontSize(), "字号滑块不存在")
 
         XCTAssertTrue(app.buttons[IDs.settingsDone].waitForExistence(timeout: 3), "完成按钮不存在")
         app.buttons[IDs.settingsDone].tap()
@@ -32,8 +31,7 @@ final class SettingsEffectTests: XCTestCase {
 
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
-        XCTAssertTrue(app.scrollViews[IDs.settingsScroll].waitForExistence(timeout: 5), "设置面板未出现")
-        app.scrollViews[IDs.settingsScroll].swipeUp()
+        XCTAssertTrue(app.waitForSettingsPanel(), "设置面板未出现")
 
         let darkThemeButton = app.buttons[IDs.settingsTheme(5)]
         if darkThemeButton.waitForExistence(timeout: 3) { darkThemeButton.tap() }
@@ -50,12 +48,9 @@ final class SettingsEffectTests: XCTestCase {
 
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
-        XCTAssertTrue(app.scrollViews[IDs.settingsScroll].waitForExistence(timeout: 5))
+        XCTAssertTrue(app.waitForSettingsPanel())
 
-        let lineHeightControl = app.segmentedControls[IDs.settingsLineHeight]
-        if lineHeightControl.waitForExistence(timeout: 3) && lineHeightControl.buttons.count > 1 {
-            lineHeightControl.buttons.element(boundBy: 1).tap()
-        }
+        app.selectSettingsPillOption(pillIdentifier: IDs.settingsLineHeight, optionTitle: "标准")
 
         app.buttons[IDs.settingsDone].tap()
         app.waitForDemoReaderState(timeout: 8, description: "reader=opened") { $0.isOpened }
@@ -68,12 +63,9 @@ final class SettingsEffectTests: XCTestCase {
 
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
-        XCTAssertTrue(app.scrollViews[IDs.settingsScroll].waitForExistence(timeout: 5))
+        XCTAssertTrue(app.waitForSettingsPanel())
 
-        let displayTypeControl = app.segmentedControls[IDs.settingsDisplayType]
-        if displayTypeControl.waitForExistence(timeout: 3) && displayTypeControl.buttons.count > 0 {
-            displayTypeControl.buttons.element(boundBy: 0).tap()
-        }
+        app.selectSettingsPillOption(pillIdentifier: IDs.settingsDisplayType, optionTitle: "仿真")
 
         app.buttons[IDs.settingsDone].tap()
         app.waitForDemoReaderState(timeout: 8, description: "display changed") { $0.display != nil }
@@ -98,19 +90,21 @@ final class SettingsEffectTests: XCTestCase {
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
 
-        XCTAssertTrue(app.buttons[IDs.settingsFontIncrease].waitForExistence(timeout: 5))
+        XCTAssertTrue(app.sliders[IDs.settingsFontSize].waitForExistence(timeout: 5))
         let fontValueLabel = app.staticTexts[IDs.settingsFontValue]
         XCTAssertTrue(fontValueLabel.waitForExistence(timeout: 3))
         let originalFontValue = fontValueLabel.label
 
-        app.buttons[IDs.settingsFontIncrease].tap()
+        XCTAssertTrue(app.increaseSettingsFontSize(), "字号滑块应存在")
         let newFontValue = fontValueLabel.label
-        XCTAssertNotEqual(newFontValue, originalFontValue, "点击增大后字号 label 应变化")
+        XCTAssertNotEqual(newFontValue, originalFontValue, "增大字号后 label 应变化")
 
         app.buttons[IDs.settingsDone].tap()
         app.buttons[IDs.readerBack].tap()
 
-        app.launchAndOpenSampleBook()
+        // 必须保留状态：默认的 resetsReaderState 会清掉刚存下的设置，
+        // 那样这个用例永远测不到持久化
+        app.launchAndOpenSampleBook(resetsReaderState: false)
         app.waitForReader(timeout: 12)
 
         app.showReaderChromeIfNeeded()
@@ -158,11 +152,12 @@ final class SettingsEffectTests: XCTestCase {
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
 
-        let fontChoiceControl = app.segmentedControls[IDs.settingsFontChoice]
+        let fontChoiceControl = app.buttons[IDs.settingsFontChoice]
         XCTAssertTrue(fontChoiceControl.waitForExistence(timeout: 5))
-        if fontChoiceControl.buttons.count > 1 {
-            fontChoiceControl.buttons.element(boundBy: 1).tap()
-        }
+        XCTAssertTrue(
+            app.selectSettingsPillOption(pillIdentifier: IDs.settingsFontChoice, optionTitle: "宋体"),
+            "字体应可切换到宋体"
+        )
         XCTAssertEqual(fontChoiceControl.value as? String, "宋体", "切换字体后当前字体值应更新")
         app.buttons[IDs.settingsDone].tap()
 
@@ -174,7 +169,7 @@ final class SettingsEffectTests: XCTestCase {
         app.showReaderChromeIfNeeded()
         app.buttons[IDs.readerSettings].tap()
 
-        let reopenedFontChoiceControl = app.segmentedControls[IDs.settingsFontChoice]
+        let reopenedFontChoiceControl = app.buttons[IDs.settingsFontChoice]
         XCTAssertTrue(reopenedFontChoiceControl.waitForExistence(timeout: 5))
         XCTAssertEqual(reopenedFontChoiceControl.value as? String, "宋体", "字体选择应在重启后保持")
         app.buttons[IDs.settingsDone].tap()