feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化

- 实现EPUB阅读器搜索功能及选中注释功能 - 优化CFI模块，修复代码审查发现的11个问题 - 实现大书远距目录跳转与后台补全优化方案 - 优化设置面板与章节运行时联动 - 重构及大量改进优化
2026-06-22 20:26:34 +08:00
parent f50495ad91
commit c65c190b71
178 changed files with 11380 additions and 6728 deletions
@@ -0,0 +1,85 @@
+import Foundation
+
+public enum RDEPUBNoteKind: String, Codable, Equatable {
+
+    case footnote
+
+    case endnote
+
+    case rearnote
+
+    case unknown
+}
+
+public struct RDEPUBNoteReference: Codable, Equatable {
+
+    public var sourceHref: String
+
+    public var sourceCFI: String?
+
+    public var targetHref: String
+
+    public var targetFragment: String?
+
+    public var targetCFI: String?
+
+    public var label: String?
+
+    public var kind: RDEPUBNoteKind
+
+    public init(
+        sourceHref: String,
+        sourceCFI: String? = nil,
+        targetHref: String,
+        targetFragment: String? = nil,
+        targetCFI: String? = nil,
+        label: String? = nil,
+        kind: RDEPUBNoteKind = .unknown
+    ) {
+        self.sourceHref = sourceHref
+        self.sourceCFI = sourceCFI
+        self.targetHref = targetHref
+        self.targetFragment = targetFragment
+        self.targetCFI = targetCFI
+        self.label = label?.nilIfEmpty
+        self.kind = kind
+    }
+}
+
+public struct RDEPUBResolvedNote: Equatable {
+
+    public var reference: RDEPUBNoteReference
+
+    public var sourceLocation: RDEPUBLocation?
+
+    public var targetLocation: RDEPUBLocation
+
+    public var title: String?
+
+    public var html: String
+
+    public var plainText: String
+
+    public init(
+        reference: RDEPUBNoteReference,
+        sourceLocation: RDEPUBLocation? = nil,
+        targetLocation: RDEPUBLocation,
+        title: String? = nil,
+        html: String,
+        plainText: String
+    ) {
+        self.reference = reference
+        self.sourceLocation = sourceLocation
+        self.targetLocation = targetLocation
+        self.title = title?.nilIfEmpty
+        self.html = html
+        self.plainText = plainText
+    }
+}
+
+private extension String {
+    var nilIfEmpty: String? {
+        let trimmed = trimmingCharacters(in: .whitespacesAndNewlines)
+        return trimmed.isEmpty ? nil : trimmed
+    }
+}