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

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

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

Sources/RDReaderView/EPUBUI/TextPage/RDEPUBTextAnnotationOverlay.swift

@@ -1,7 +1,13 @@
 import UIKit
 
-/// 前景覆盖层，负责绘制高亮、搜索命中和当前选区。
+/// 原生文本渲染路径的批注覆盖层，负责绘制用户高亮、搜索命中高亮和当前选区装饰。
 final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
+    /// 将用户高亮批注以富文本属性形式应用到页面内容上
+    /// - Parameters:
+    ///   - highlights: 高亮批注数组
+    ///   - content: 待修改的富文本
+    ///   - page: 目标文本页
+    ///   - contentBaseOffset: 内容在全局偏移中的起始位置
     func applyHighlights(
         _ highlights: [RDEPUBHighlight],
         to content: NSMutableAttributedString,
@@ -38,6 +44,12 @@ final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
         }
     }
 
+    /// 将搜索命中高亮以富文本背景色形式应用到页面内容上
+    /// - Parameters:
+    ///   - content: 待修改的富文本
+    ///   - page: 目标文本页
+    ///   - searchState: 当前搜索状态
+    ///   - contentBaseOffset: 内容在全局偏移中的起始位置
     func applySearchHighlights(
         to content: NSMutableAttributedString,
         page: RDEPUBTextPage,
@@ -65,6 +77,13 @@ final class RDEPUBTextAnnotationOverlay: RDEPUBSelectionOverlayView {
         }
     }
 
+    /// 构建页面的背景和前景装饰数组（搜索高亮为背景，下划线批注为前景）
+    /// - Parameters:
+    ///   - page: 目标文本页
+    ///   - highlights: 高亮批注数组
+    ///   - searchState: 当前搜索状态
+    ///   - interactionController: 用于计算选区矩形的交互控制器
+    /// - Returns: 分离的背景和前景装饰数组
     func buildDecorations(
         page: RDEPUBTextPage,
         highlights: [RDEPUBHighlight],