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

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

Sources/RDReaderView/EPUBUI/RDEPUBReaderTheme.swift

@@ -1,13 +1,37 @@
 import UIKit
 
+// MARK: - 阅读器主题
+
+/// EPUB 阅读器主题配置结构体
+/// 定义阅读器内容区域和工具栏的颜色方案
+/// 内置浅色、深色、黄色、绿色、粉色、蓝色六套预设主题
 public struct RDEPUBReaderTheme: Equatable {
+    // MARK: 内容区颜色
+
+    /// 内容区域的背景色
     public var contentBackgroundColor: UIColor
+    /// 内容区域的正文文字颜色
     public var contentTextColor: UIColor
+
+    // MARK: 工具栏颜色
+
+    /// 工具栏背景色
     public var toolBackgroundColor: UIColor
+    /// 工具栏控件文字/图标颜色
     public var toolControlTextColor: UIColor
+    /// 工具栏控件未选中状态的边框颜色
     public var toolControlBorderUnselectColor: UIColor
+    /// 工具栏中分隔线的颜色
     public var toolLineColor: UIColor
 
+    /// 初始化主题配置
+    /// - Parameters:
+    ///   - contentBackgroundColor: 内容区背景色
+    ///   - contentTextColor: 内容区文字颜色
+    ///   - toolBackgroundColor: 工具栏背景色
+    ///   - toolControlTextColor: 工具栏控件颜色
+    ///   - toolControlBorderUnselectColor: 控件未选中边框色
+    ///   - toolLineColor: 分隔线颜色
     public init(
         contentBackgroundColor: UIColor,
         contentTextColor: UIColor,
@@ -24,6 +48,9 @@ public struct RDEPUBReaderTheme: Equatable {
         self.toolLineColor = toolLineColor
     }
 
+    // MARK: 内置预设主题
+
+    /// 浅色主题：白底黑字，适合日间阅读
     public static let light = RDEPUBReaderTheme(
         contentBackgroundColor: .white,
         contentTextColor: .black,
@@ -33,6 +60,7 @@ public struct RDEPUBReaderTheme: Equatable {
         toolLineColor: UIColor.lightGray.withAlphaComponent(0.5)
     )
 
+    /// 深色主题：黑底白字，适合夜间阅读
     public static let dark = RDEPUBReaderTheme(
         contentBackgroundColor: .black,
         contentTextColor: .white,
@@ -42,6 +70,7 @@ public struct RDEPUBReaderTheme: Equatable {
         toolLineColor: UIColor.lightGray.withAlphaComponent(0.5)
     )
 
+    /// 黄色护眼主题：暖色调背景，减少蓝光刺激
     public static let yellow = RDEPUBReaderTheme(
         contentBackgroundColor: UIColor(red: 0.89, green: 0.87, blue: 0.79, alpha: 1),
         contentTextColor: .black,
@@ -51,6 +80,7 @@ public struct RDEPUBReaderTheme: Equatable {
         toolLineColor: UIColor.lightGray.withAlphaComponent(0.5)
     )
 
+    /// 绿色护眼主题：模拟纸质书的柔和绿色背景
     public static let green = RDEPUBReaderTheme(
         contentBackgroundColor: UIColor(red: 0.87, green: 0.91, blue: 0.82, alpha: 1),
         contentTextColor: .black,
@@ -60,6 +90,7 @@ public struct RDEPUBReaderTheme: Equatable {
         toolLineColor: UIColor.lightGray.withAlphaComponent(0.5)
     )
 
+    /// 粉色主题：柔和粉色背景
     public static let pink = RDEPUBReaderTheme(
         contentBackgroundColor: UIColor(red: 1, green: 0.89, blue: 0.91, alpha: 1),
         contentTextColor: .black,
@@ -69,6 +100,7 @@ public struct RDEPUBReaderTheme: Equatable {
         toolLineColor: UIColor.lightGray.withAlphaComponent(0.5)
     )
 
+    /// 蓝色主题：冷色调蓝色背景
     public static let blue = RDEPUBReaderTheme(
         contentBackgroundColor: UIColor(red: 0.8, green: 0.84, blue: 0.89, alpha: 1),
         contentTextColor: .black,
@@ -79,11 +111,15 @@ public struct RDEPUBReaderTheme: Equatable {
     )
 }
 
+// MARK: - CSS 颜色转换
+
 extension RDEPUBReaderTheme {
+    /// 将内容区背景色转换为 CSS 颜色字符串，注入 EPUB 的 HTML 中
     var themeBackgroundColorCSS: String {
         contentBackgroundColor.ss_cssString
     }
 
+    /// 将内容区文字颜色转换为 CSS 颜色字符串，注入 EPUB 的 HTML 中
     var themeTextColorCSS: String {
         contentTextColor.ss_cssString
     }