refactor: 添加中文注释 + 优化模块结构

- 给全部 78 个 Swift 源文件添加详细的中文注释（文件级、类级、方法级）
- 删除 LegacyRDReaderController/ 死代码目录（16 文件 4592 行）
- 根目录翻页容器文件移入 ReaderView/ 目录
- Resources/ 移入 EPUBCore/Resources/（与使用者归属一致）
- RDEPUBTextIndexTable.swift 移入 EPUBTextRendering/（消除反向依赖）
- RDURLReaderController.swift 移入 EPUBUI/（入口控制器归入 UI 层）
- 更新 podspec 资源路径

Sources/RDReaderView/EPUBTextRendering/RDEPUBTextPaginationSupport.swift

@@ -1,7 +1,18 @@
 import CoreText
 import UIKit
 
+// MARK: - NSAttributedString 分页扩展
+
+/// 为 NSAttributedString 提供便捷的分页方法，是渲染链路中 CoreText 分页的入口点。
 extension NSAttributedString {
+    /// 将富文本按指定页面尺寸分页，返回布局帧列表（每帧对应一页）。
+    ///
+    /// 这是 `RDEPUBTextBookBuilder` 和 `RDPlainTextBookBuilder` 调用的核心分页方法。
+    /// - Parameters:
+    ///   - size: 页面尺寸
+    ///   - fragmentOffsets: fragment ID → 字符偏移量映射（用于阅读位置恢复）
+    ///   - config: 布局配置（孤行控制、avoidPageBreakInside 等）
+    /// - Returns: 分页后的布局帧列表
     func rd_paginatedFrames(
         size: CGSize,
         fragmentOffsets: [String: Int] = [:],
@@ -11,12 +22,17 @@ extension NSAttributedString {
             .layoutFrames(fragmentOffsets: fragmentOffsets)
     }
 
+    /// 简化版分页：只返回每页的 NSRange 列表（不含语义元数据）
     func ss_pageRanges(size: CGSize) -> [NSRange] {
         rd_paginatedFrames(size: size).map(\.contentRange)
     }
 }
 
+// MARK: - UIColor CSS 转换扩展
+
+/// 为 UIColor 提供 CSS 颜色字符串转换，用于动态生成暗色模式 CSS。
 extension UIColor {
+    /// 将 UIColor 转换为 CSS rgba() 字符串格式
     var ss_cssString: String {
         var red: CGFloat = 0
         var green: CGFloat = 0