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

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

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

Sources/RDReaderView/ReaderView/RDReaderView+ToolView.swift

@@ -1,9 +1,16 @@
+//
+//  RDReaderView+ToolView.swift
+//  ReadViewSDK
+//
+//  文件职责：工具栏管理扩展，处理工具栏的显示/隐藏动画、安装和布局约束。
+//
+
 import UIKit
 
 /// 工具栏管理扩展：处理工具栏的显示/隐藏动画、安装、布局
 extension RDReaderView {
 
-    /// 点击屏幕中央区域，切换工具栏的显示/隐藏
+    /// 点击屏幕中央区域，切换工具栏的显示/隐藏，带动画效果
     func tapCenter() {
         refreshToolViewsFromProviderIfNeeded()
         isShowToolView = !isShowToolView
@@ -50,7 +57,7 @@ extension RDReaderView {
         }
     }
 
-    /// 判断点击命中的视图是否在指定工具栏内
+    /// 判断点击命中的视图是否在指定工具栏内，用于决定是否拦截点击事件
     func isHitView(_ hitView: UIView?, inside toolView: UIView, point: CGPoint) -> Bool {
         if toolView.frame.contains(point) {
             return true
@@ -60,11 +67,15 @@ extension RDReaderView {
         return hitView === toolView || hitView.isDescendant(of: toolView)
     }
 
+    /// 工具栏位置枚举
     enum ToolViewPosition {
+        /// 顶部工具栏（如标题栏、导航栏）
         case top
+        /// 底部工具栏（如进度条、操作按钮）
         case bottom
     }
 
+    /// 将工具栏安装到指定位置并设置布局约束，已安装则跳过
     func installToolViewIfNeeded(_ toolView: UIView, position: ToolViewPosition) {
         guard toolView.superview !== self else { return }
 
@@ -97,6 +108,7 @@ extension RDReaderView {
         }
     }
 
+    /// 更新顶部和底部工具栏的高度约束，通常在 safeAreaInsets 变化时调用
     func updateToolViewHeightConstraintsIfNeeded() {
         topToolViewHeightConstraint?.constant = resolvedToolViewHeight(for: .top)
         bottomToolViewHeightConstraint?.constant = resolvedToolViewHeight(for: .bottom)