feat: 交互协调器拆分、附件提示、暗色图片适配、选区放大镜及文档清理

- 拆分 ContentDelegates/TextContentView 为独立协调器（InteractionCoordinator、LocationResolution、ExternalLinks、AttachmentTooltip）
- 新增 RDEPUBAttachmentTooltipView/OverlayView 附件气泡提示
- 新增 RDEPUBDarkImageAdjuster 暗色模式图片亮度适配
- 新增 RDEPUBSelectionLoupeView 选区放大镜
- 新增 MetadataParseWorker/CancellationController 元数据解析取消机制
- 重构 PresentationRuntime/PaginationCoordinator 精简职责
- 优化 ChapterLoader/WarmupOrchestrator 异步章节加载
- CFI 模块微调与 NoteModels 更新
- 清理冗余文档，更新架构/UML/业务逻辑文档

Co-Authored-By: Claude <noreply@anthropic.com>

Sources/RDReaderView/ReaderView/RDReaderView+PageCurl.swift

@@ -96,6 +96,11 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
     }
 
     public func pageViewController(_ pageViewController: UIPageViewController, didFinishAnimating finished: Bool, previousViewControllers: [UIViewController], transitionCompleted completed: Bool) {
+        let resolvedPage = (pageViewController.viewControllers?.first as? RDReaderPageChildViewController)?.pageNum ?? -1
+        RDEPUBBackgroundTrace.log(
+            "PageCurl",
+            "didFinishAnimating finished=\(finished) completed=\(completed) resolvedPage=\(resolvedPage + 1) currentPageBeforeFinish=\(currentPage + 1)"
+        )
         if completed, let firstVC = pageViewController.viewControllers?.first as? RDReaderPageChildViewController {
             let pn = firstVC.pageNum
             if pn != RDReaderView.blankPageNum && pn != RDReaderView.blankEndPageNum {
@@ -114,8 +119,17 @@ extension RDReaderView: UIPageViewControllerDataSource, UIPageViewControllerDele
         if let target = pendingViewControllers.first as? RDReaderPageChildViewController,
            target.pageNum != RDReaderView.blankPageNum,
            target.pageNum != RDReaderView.blankEndPageNum {
+            RDEPUBBackgroundTrace.log(
+                "PageCurl",
+                "willTransitionTo targetPage=\(target.pageNum + 1) currentPage=\(currentPage + 1)"
+            )
             predictedPageDirection = target.pageNum >= currentPage
             primePageCache(around: target.pageNum, preferredForward: predictedPageDirection)
+        } else {
+            RDEPUBBackgroundTrace.log(
+                "PageCurl",
+                "willTransitionTo blank target currentPage=\(currentPage + 1)"
+            )
         }
     }
 }