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

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

Sources/RDReaderView/EPUBTextRendering/RDEPUBTextPerformanceSampler.swift

@@ -1,13 +1,20 @@
 import Foundation
 
-// MARK: - Performance Sample
+// MARK: - 性能采样数据模型
 
+/// 单个章节的性能采样数据，记录渲染和分页的耗时。
 public struct RDEPUBTextPerformanceSample: Equatable {
+    /// 章节文件路径
     public var chapterHref: String
+    /// HTML 渲染耗时（秒）
     public var renderDuration: TimeInterval
+    /// CoreText 分页耗时（秒）
     public var paginateDuration: TimeInterval
+    /// 分页后的页数
     public var pageCount: Int
+    /// 富文本字符长度
     public var attributedStringLength: Int
+    /// 是否命中分页缓存
     public var cacheHit: Bool
 
     public init(
@@ -27,19 +34,27 @@ public struct RDEPUBTextPerformanceSample: Equatable {
     }
 }
 
-// MARK: - Performance Sampler
+// MARK: - 性能采样器
 
+/// 书籍构建过程的性能采样器，用于监控每章的渲染和分页耗时。
+///
+/// 由 `RDEPUBTextBookBuilder` 在构建过程中使用，每章记录一个采样点，
+/// 构建完成后输出汇总报告。
 public final class RDEPUBTextPerformanceSampler {
+    /// 所有章节的采样数据列表
     public private(set) var samples: [RDEPUBTextPerformanceSample] = []
+    /// 整本书构建的总耗时（秒）
     public var totalBuildDuration: TimeInterval = 0
 
     public init() {}
 
+    /// 记录单个章节的性能采样，并输出日志
     public func record(_ sample: RDEPUBTextPerformanceSample) {
         samples.append(sample)
         print("[PERF] \(sample.chapterHref): render=\(formatMS(sample.renderDuration)) paginate=\(formatMS(sample.paginateDuration)) pages=\(sample.pageCount) cache=\(sample.cacheHit ? "HIT" : "MISS")")
     }
 
+    /// 生成性能汇总报告，包含总渲染/分页耗时和缓存命中率
     public func summary() -> String {
         let totalRender = samples.reduce(0) { $0 + $1.renderDuration }
         let totalPaginate = samples.reduce(0) { $0 + $1.paginateDuration }
@@ -47,11 +62,13 @@ public final class RDEPUBTextPerformanceSampler {
         return "[PERF] chapters=\(samples.count) render=\(formatMS(totalRender)) paginate=\(formatMS(totalPaginate)) total=\(formatMS(totalBuildDuration)) cacheHits=\(hitCount)/\(samples.count)"
     }
 
+    /// 重置所有采样数据
     public func reset() {
         samples.removeAll()
         totalBuildDuration = 0
     }
 
+    /// 将秒转换为毫秒格式字符串
     private func formatMS(_ duration: TimeInterval) -> String {
         String(format: "%.0fms", duration * 1000)
     }