docs: 补充注释、修正过时文档、清理重复内容

源码注释：
- 为 ~60 个 Swift 文件补充缺失的 doc comment（file header、类型、属性、方法）
- 修正 4 处错误注释：翻页模式数量、搜索行为描述、手势识别器描述、悬空文档块

文档维护：
- 删除重复文档：WXRead/读书EPUB阅读器实现架构.md（与微信读书版完全一致）
- 合并重叠文档：阅读器规划.md → 阅读器功能开发计划.md（单一真值）
- 修正过时内容：所有文档中"四种翻页模式"→"三种"，移除 horizontalCoverScroll
- 更新架构图：补齐 EPUBUI/ReaderController、Paging/、Typesetter/ 等子目录
- 更新 index.md 索引：新增开发计划和架构对比文档引用

Sources/RDReaderView/EPUBUI/ReaderController/RDEPUBReaderAnnotationCoordinator.swift

@@ -1,5 +1,12 @@
 import UIKit
 
+/// EPUB 阅读器标注协调器：负责高亮、批注和书签的增删改查操作。
+///
+/// 职责：
+/// - 管理高亮（highlight）与批注（annotation）的创建、更新和删除
+/// - 管理书签（bookmark）的添加、切换和删除
+/// - 处理文本选中后的菜单操作（复制、高亮、批注）
+/// - 弹出高亮管理器和书签管理器界面
 final class RDEPUBReaderAnnotationCoordinator {
     private unowned let context: RDEPUBReaderContext
 
@@ -11,16 +18,19 @@ final class RDEPUBReaderAnnotationCoordinator {
         context.controller
     }
 
+    /// 根据 ID 查找书签。
     func bookmark(withID id: String) -> RDEPUBBookmark? {
         guard let controller else { return nil }
         return controller.activeBookmarks.first { $0.id == id }
     }
 
+    /// 根据 ID 查找高亮。
     func highlight(withID id: String) -> RDEPUBHighlight? {
         guard let controller else { return nil }
         return controller.activeHighlights.first { $0.id == id }
     }
 
+    /// 更新当前文本选区状态，并同步刷新底部工具栏的高亮按钮可用性。
     func updateCurrentSelection(_ selection: RDEPUBSelection?) {
         guard let controller else { return }
         controller.currentSelection = selection?.isEmpty == false ? selection : nil
@@ -34,6 +44,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         controller.delegate?.epubReader(controller, didChangeSelection: controller.currentSelection)
     }
 
+    /// 基于当前选区添加高亮标记，自动去重并持久化。
     @discardableResult
     func addHighlight(
         from selection: RDEPUBSelection? = nil,
@@ -43,6 +54,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         addAnnotation(from: selection, style: .highlight, color: color, note: note)
     }
 
+    /// 基于选区创建标注（高亮/划线/批注），支持指定样式、颜色和备注。
     @discardableResult
     func addAnnotation(
         from selection: RDEPUBSelection? = nil,
@@ -85,6 +97,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return newHighlight
     }
 
+    /// 插入或更新高亮（upsert），按 ID 匹配已有记录。
     @discardableResult
     func upsertHighlight(_ highlight: RDEPUBHighlight) -> RDEPUBHighlight? {
         guard let controller else { return nil }
@@ -101,6 +114,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return scopedHighlight
     }
 
+    /// 根据 ID 删除高亮并持久化。
     @discardableResult
     func removeHighlight(id: String) -> RDEPUBHighlight? {
         guard let controller else { return nil }
@@ -112,6 +126,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return removed
     }
 
+    /// 更新指定高亮的批注备注内容。
     @discardableResult
     func updateHighlightNote(id: String, note: String?) -> RDEPUBHighlight? {
         guard let controller else { return nil }
@@ -123,6 +138,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return controller.activeHighlights[index]
     }
 
+    /// 跳转到指定高亮所在位置。
     @discardableResult
     func go(toHighlightID id: String, animated: Bool = true) -> Bool {
         guard let controller else { return false }
@@ -132,6 +148,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return controller.restoreReadingLocation(highlight.location, animated: animated)
     }
 
+    /// 清除所有高亮标记。
     func removeAllHighlights() {
         guard let controller else { return }
         guard !controller.activeHighlights.isEmpty else { return }
@@ -139,6 +156,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         persistHighlightsAndRefreshContent()
     }
 
+    /// 将选区位置相对于指定 spine 索引进行规范化。
     func scopedSelection(
         _ selection: RDEPUBSelection,
         relativeToSpineIndex spineIndex: Int?
@@ -166,6 +184,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         )
     }
 
+    /// 弹出高亮管理器，支持查看、编辑备注和删除高亮。
     func presentHighlightsManager() {
         guard let controller else { return }
         guard controller.configuration.allowsHighlights else { return }
@@ -196,6 +215,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         controller.present(navigationController, animated: true)
     }
 
+    /// 弹出标注创建面板（高亮/划线/批注选择）。
     func presentAnnotationCreation() {
         guard let controller else { return }
         guard controller.configuration.allowsHighlights,
@@ -205,6 +225,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         presentAnnotationActionSheet(for: currentSelection)
     }
 
+    /// 处理文本选中后的菜单操作：复制、高亮、批注。
     func handleSelectionMenuAction(_ action: RDEPUBAnnotationMenuAction, selection: RDEPUBSelection?) {
         guard let selection else { return }
         switch action {
@@ -218,6 +239,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         }
     }
 
+    /// 在当前位置添加书签，自动去重。
     @discardableResult
     func addBookmark(note: String? = nil) -> RDEPUBBookmark? {
         guard let controller else { return nil }
@@ -239,6 +261,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return newBookmark
     }
 
+    /// 切换当前位置的书签状态：已存在则移除，不存在则添加。
     @discardableResult
     func toggleBookmark(note: String? = nil) -> RDEPUBBookmark? {
         guard let controller else { return nil }
@@ -254,6 +277,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return addBookmark(note: note)
     }
 
+    /// 根据 ID 删除书签并持久化。
     @discardableResult
     func removeBookmark(id: String) -> RDEPUBBookmark? {
         guard let controller else { return nil }
@@ -265,6 +289,7 @@ final class RDEPUBReaderAnnotationCoordinator {
         return removed
     }
 
+    /// 跳转到指定书签所在位置。
     @discardableResult
     func go(toBookmarkID id: String, animated: Bool = true) -> Bool {
         guard let controller else { return false }
@@ -274,12 +299,14 @@ final class RDEPUBReaderAnnotationCoordinator {
         return controller.restoreReadingLocation(bookmark.location, animated: animated)
     }
 
+    /// 同步顶部书签按钮和底部书签列表按钮的 UI 状态。
     func updateBookmarkChrome() {
         guard let controller else { return }
         controller.topToolView.setBookmarkSelected(currentBookmark() != nil)
         controller.bottomToolView.setBookmarksEnabled(!controller.activeBookmarks.isEmpty)
     }
 
+    /// 弹出书签管理器，支持查看、跳转和删除书签。
     func presentBookmarksManager() {
         guard let controller else { return }
         guard !controller.activeBookmarks.isEmpty else { return }