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,63 @@
+import Foundation
+
+public enum RDEPUBNoteDetector {
+
+    private static let noteTokens = [
+        "noteref",      
+        "footnote",     
+        "endnote",      
+        "rearnote",     
+        "fnref",        
+        "fn-",          
+        "fn_",          
+        "note",         
+        "annotation"    
+    ]
+
+    public static func makeReferenceIfLikelyNote(
+        sourceHref: String,
+        sourceCFI: String?,
+        targetHref: String,
+        targetFragment: String?,
+        targetCFI: String?,
+        targetElementHTML: String?
+    ) -> RDEPUBNoteReference? {
+
+        let haystack = [
+            targetHref,
+            targetFragment ?? "",
+            targetElementHTML ?? ""
+        ].joined(separator: " ").lowercased()
+
+        guard noteTokens.contains(where: { haystack.contains($0) }) ||
+              hasEPUBType("footnote", in: targetElementHTML) ||
+              hasEPUBType("endnote", in: targetElementHTML) ||
+              hasEPUBType("rearnote", in: targetElementHTML) else {
+            return nil
+        }
+
+        return RDEPUBNoteReference(
+            sourceHref: sourceHref,
+            sourceCFI: sourceCFI,
+            targetHref: targetHref,
+            targetFragment: targetFragment,
+            targetCFI: targetCFI,
+            label: targetFragment,
+            kind: kind(from: haystack)
+        )
+    }
+
+    public static func kind(from text: String) -> RDEPUBNoteKind {
+        let lowered = text.lowercased()
+        if lowered.contains("endnote") { return .endnote }
+        if lowered.contains("rearnote") { return .rearnote }
+        if lowered.contains("footnote") || lowered.contains("fn") { return .footnote }
+        return .unknown
+    }
+
+    private static func hasEPUBType(_ type: String, in html: String?) -> Bool {
+        guard let html else { return false }
+        let pattern = #"epub:type\s*=\s*['"][^'"]*\b"# + NSRegularExpression.escapedPattern(for: type) + #"\b[^'"]*['"]"#
+        return html.range(of: pattern, options: [.regularExpression, .caseInsensitive]) != nil
+    }
+}