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

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

Sources/RDReaderView/EPUBCore/RDEPUBAssetRepository.swift

@@ -1,9 +1,18 @@
+// RDEPUBAssetRepository.swift
+// EPUBCore 静态资源仓库
+// 负责从资源包中加载 EPUB 渲染所需的 JS 桥接脚本和固定版式 HTML 模板，
+// 支持模板变量替换（{{token}} 占位符）。
+
 import Foundation
 
+/// EPUB 内置资源枚举，定义桥接脚本和固定版式模板的文件名及扩展名
 enum RDEPUBAsset: String {
+    /// JS 桥接脚本（epub-bridge.js），注入到 WebView 中实现原生-JS 通信
     case bridgeScript = "epub-bridge"
+    /// 固定版式 HTML 模板（epub-fixed-layout.html），用于渲染 pre-paginated 类型的 EPUB
     case fixedLayoutTemplate = "epub-fixed-layout"
 
+    /// 对应的文件扩展名
     var fileExtension: String {
         switch self {
         case .bridgeScript:
@@ -14,7 +23,13 @@ enum RDEPUBAsset: String {
     }
 }
 
+/// 静态资源加载器，负责从资源包中读取模板文件并执行变量替换
 enum RDEPUBAssetRepository {
+    /// 加载指定资源文件的内容，并将 {{key}} 占位符替换为对应的值
+    /// - Parameters:
+    ///   - asset: 要加载的资源类型
+    ///   - replacements: 模板变量字典，key 为占位符名称，value 为替换值
+    /// - Returns: 替换后的文件内容字符串
     static func string(for asset: RDEPUBAsset, replacements: [String: String] = [:]) -> String {
         guard let url = resourceBundle.url(forResource: asset.rawValue, withExtension: asset.fileExtension),
               var content = try? String(contentsOf: url, encoding: .utf8) else {
@@ -28,6 +43,7 @@ enum RDEPUBAssetRepository {
         return content
     }
 
+    /// 获取资源所在的 Bundle（优先使用已解析的子 bundle，兜底到宿主 bundle）
     private static var resourceBundle: Bundle {
         if let bundle = resolvedBundle {
             return bundle
@@ -35,6 +51,7 @@ enum RDEPUBAssetRepository {
         return Bundle(for: RDEPUBAssetBundleToken.self)
     }
 
+    /// 延迟解析 RDReaderViewAssets.bundle 的位置，在宿主 bundle 和所有 framework 中查找
     private static var resolvedBundle: Bundle? = {
         let hostBundles = [Bundle(for: RDEPUBAssetBundleToken.self), Bundle.main] + Bundle.allFrameworks + Bundle.allBundles
         for hostBundle in hostBundles {
@@ -47,4 +64,5 @@ enum RDEPUBAssetRepository {
     }()
 }
 
+/// 用于定位当前模块 Bundle 的标记类
 private final class RDEPUBAssetBundleToken {}