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

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

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

Sources/RDReaderView/EPUBTextRendering/Pagination/RDEPUBTextPaginationInterfaces.swift

@@ -1,15 +1,30 @@
+// RDEPUBTextPaginationInterfaces.swift
+// EPUB 分页接口定义，包括断页决策、章节数页和页面帧构建协议。
+
 import Foundation
 import UIKit
 
 // MARK: - 分页接口定义
 
+/// 单次断页决策，记录断页位置、原因及诊断信息。
 struct RDEPUBPageBreakDecision {
+    /// 本页在富文本中的字符范围
     var range: NSRange
+    /// 断页原因
     var reason: RDEPUBTextPageBreakReason
+    /// 分页过程中的诊断日志
     var diagnostics: [String]
 }
 
+/// 章节页数计算接口，将富文本按页面尺寸拆分为断页决策序列。
 protocol RDEPUBChapterPageCounting {
+    /// 计算章节中每页的断页位置。
+    /// - Parameters:
+    ///   - attributedString: 章节富文本
+    ///   - pageSize: 页面尺寸
+    ///   - config: 排版配置
+    ///   - fragmentOffsets: fragment 锚点偏移映射
+    /// - Returns: 断页决策数组，每个元素对应一页
     func pageRanges(
         for attributedString: NSAttributedString,
         pageSize: CGSize,
@@ -18,7 +33,15 @@ protocol RDEPUBChapterPageCounting {
     ) -> [RDEPUBPageBreakDecision]
 }
 
+/// 页面帧构建接口，将富文本转换为可渲染的页面帧数组。
 protocol RDEPUBPageFrameBuilding {
+    /// 将富文本构建为页面帧数组。
+    /// - Parameters:
+    ///   - attributedString: 待分页的富文本
+    ///   - pageSize: 页面尺寸
+    ///   - config: 排版配置
+    ///   - fragmentOffsets: fragment 锚点偏移映射
+    /// - Returns: 页面帧数组
     func makeFrames(
         attributedString: NSAttributedString,
         pageSize: CGSize,