feat: 获取并显示实例安装的资源 (#202)

Author: AnemoFlower

PCL.Mac.Core/Extensions/Archive+EntryExtract.swift

@@ -0,0 +1,20 @@
+//
+//  Archive+Entry.swift
+//  PCL.Mac
+//
+//  Created by AnemoFlower on 2026/6/7.
+//
+
+import Foundation
+import ZIPFoundation
+
+public extension Archive {
+    /// 解压归档中的某个 `Entry`。
+    func extract(_ entry: Entry) throws -> Data {
+        var entryData: Data = .init()
+        _ = try extract(entry, consumer: { data in
+            entryData.append(data)
+        })
+        return entryData
+    }
+}

PCL.Mac.Core/Extensions/String+Template.swift

@@ -0,0 +1,16 @@
+//
+//  String+Template.swift
+//  PCL.Mac
+//
+//  Created by AnemoFlower on 2026/6/8.
+//
+
+public extension String {
+    func replacingPlaceholders(with values: [String: String], dollarPrefix: Bool = true) -> String {
+        var s: String = self
+        for key in values.keys {
+            s = s.replacingOccurrences(of: (dollarPrefix ? "$" : "") + "{\(key)}", with: values[key]!)
+        }
+        return s
+    }
+}

PCL.Mac.Core/Extensions/URL+Utils.swift

@@ -0,0 +1,18 @@
+//
+//  URL+Utils.swift
+//  PCL.Mac
+//
+//  Created by AnemoFlower on 2026/6/16.
+//
+
+import Foundation
+
+public extension URL {
+    func deletingAllPathExtensions() -> URL {
+        var url = self
+        while url.pathExtension != "" {
+            url = url.deletingPathExtension()
+        }
+        return url
+    }
+}

PCL.Mac.Core/Minecraft/Launch/MinecraftLauncher.swift

@@ -63,7 +63,7 @@ public class MinecraftLauncher {
         }
         arguments.append(manifest.mainClass)
         arguments.append(contentsOf: manifest.gameArguments.flatMap { $0.rules.allSatisfy { $0.test(with: options) } ? $0.value : [] })
-        arguments = arguments.map { Utils.replace($0, withValues: values) }
+        arguments = arguments.map { $0.replacingPlaceholders(with: values) }
         process.arguments = arguments
 
         let pipe: Pipe = .init()

PCL.Mac.Core/Models/CurseForge/CurseForgeMod.swift

@@ -8,10 +8,13 @@
 import Foundation
 
 public struct CurseForgeMod: Codable {
+    public let id: Int32
     public let name: String
+    public let summary: String
+    public let logo: CurseForgeModAsset
     public let classId: Int?
 
-    public var projectType: ProjectType? {
+    public var projectType: ResourceType? {
         switch classId {
         case 12: .resourcepack
         case 6: .mod
@@ -22,6 +25,17 @@ public struct CurseForgeMod: Codable {
     }
 }
 
+public struct CurseForgeModAsset: Codable {
+    public let id: Int32
+    public let title: String
+    public let url: URL
+    public let thumbnailURL: URL
+    
+    private enum CodingKeys: String, CodingKey {
+        case id, title, url, thumbnailURL = "thumbnailUrl"
+    }
+}
+
 public struct CurseForgeModFile: Codable {
     public struct FileHash: Codable {
         public let value: String

PCL.Mac.Core/Models/ModLoader.swift

@@ -7,7 +7,7 @@
 
 import Foundation
 
-public enum ModLoader: String, CustomStringConvertible {
+public enum ModLoader: String, Codable, CustomStringConvertible {
     case fabric, forge, neoforge
 
     public var index: Int {

PCL.Mac.Core/Models/Modpack/ModpackIndex.swift

@@ -98,12 +98,7 @@ public extension ModpackIndex {
 
         public var path: String? {
             guard let cachedMod, let cachedModFile, let type = cachedMod.projectType else { return nil }
-            guard let directory: String = switch type {
-            case .mod: "mods"
-            case .modpack: nil
-            case .resourcepack: "resourcepacks"
-            case .shader: "shaderpacks"
-            } else { return nil }
+            guard let directory = type.saveDirectory else { return nil }
             return "\(directory)/\(cachedModFile.fileName)"
         }
 

PCL.Mac.Core/Models/Modrinth/ModrinthProject.swift

@@ -24,7 +24,7 @@ public struct ModrinthProject: Decodable, Identifiable, Hashable, Equatable {
 
     public let id: String
     public let slug: String
-    public let type: ProjectType
+    public let type: ResourceType
     public let title: String
     public let description: String
     public let iconURL: URL?
@@ -40,7 +40,7 @@ public struct ModrinthProject: Decodable, Identifiable, Hashable, Equatable {
         let container = try decoder.container(keyedBy: CodingKeys.self)
         self.id = try container.decodeIfPresent(String.self, forKey: .id) ?? container.decode(String.self, forKey: .projectId)
         self.slug = try container.decode(String.self, forKey: .slug)
-        self.type = try container.decode(ProjectType.self, forKey: .type)
+        self.type = try container.decode(ResourceType.self, forKey: .type)
         self.title = try container.decode(String.self, forKey: .title)
         self.description = try container.decode(String.self, forKey: .description)
         self.iconURL = try container.decodeIfPresent(String.self, forKey: .iconURL).flatMap(URL.init(string:))

PCL.Mac.Core/Models/Resource.swift

@@ -7,6 +7,62 @@
 
 import Foundation
 
-public enum ProjectType: String, Codable {
+public enum ResourceType: String, Codable {
     case mod, modpack, resourcepack, shader
+    
+    public var saveDirectory: String? {
+        switch self {
+        case .mod: "mods"
+        case .modpack: nil
+        case .resourcepack: "resourcepacks"
+        case .shader: "shaderpacks"
+        }
+    }
+}
+
+public struct Resource: Codable, Hashable, Equatable {
+    public enum Source: Codable, Hashable, Equatable {
+        case modrinth(projectId: String)
+        case curseforge(id: Int32)
+    }
+    
+    public enum Icon: Codable, Hashable, Equatable {
+        case archiveEntry(path: String, globalHash: String)
+        case network(url: URL)
+    }
+    
+    public let id: UUID = .init()
+    public let type: ResourceType
+    public let name: String
+    public let version: String?
+    public let description: String?
+    public let icon: Icon?
+    public let loaders: [ModLoader]
+    public let tags: [String]
+    public let sources: [Source]
+    
+    public init(
+        type: ResourceType,
+        name: String,
+        version: String?,
+        description: String?,
+        icon: Icon?,
+        loaders: [ModLoader],
+        tags: [String],
+        sources: [Source]
+    ) {
+        self.type = type
+        self.name = name
+        self.version = version
+        self.description = description
+        self.icon = icon
+        self.loaders = loaders
+        self.tags = tags
+        self.sources = sources
+    }
+    
+    private enum CodingKeys: CodingKey {
+        // 不持久化存储 id
+        case type, name, version, description, icon, loaders, tags, sources
+    }
 }

PCL.Mac.Core/Services/Cache/ResourceCache.swift

@@ -0,0 +1,69 @@
+//
+//  ResourceCache.swift
+//  PCL.Mac
+//
+//  Created by AnemoFlower on 2026/6/7.
+//
+
+import Foundation
+
+public class ResourceCache {
+    public static var shared: ResourceCache!
+    
+    private let cacheFileURL: URL
+    private let iconCacheDirectory: URL
+    private var cacheMap: [String: Resource]
+    
+    public init(cacheDirectory: URL) {
+        self.cacheFileURL = cacheDirectory.appending(path: "resource_cache.json")
+        self.iconCacheDirectory = cacheDirectory.appending(path: "resource_icon")
+        
+        if FileManager.default.fileExists(atPath: cacheFileURL.path) {
+            do {
+                let data = try Data(contentsOf: cacheFileURL)
+                self.cacheMap = try JSONDecoder.shared.decode([String: Resource].self, from: data)
+            } catch {
+                err("缓存文件加载失败：\(error.localizedDescription)")
+                try? FileManager.default.removeItem(at: cacheFileURL)
+                self.cacheMap = [:]
+            }
+        } else {
+            self.cacheMap = [:]
+        }
+    }
+    
+    public func resource(forHash hash: String) -> Resource? { cacheMap[hash] }
+    
+    public func store(_ resource: Resource, forHash hash: String) { cacheMap[hash] = resource }
+    
+    public func icon(forHash globalHash: String) throws -> Data? {
+        let url = url(of: globalHash)
+        if FileManager.default.fileExists(atPath: url.path) {
+            return try Data(contentsOf: url)
+        }
+        return nil
+    }
+    
+    public func store(_ iconData: Data, relativePath: String, fileHash: String) throws -> String {
+        let globalHash = globalHash(of: relativePath, with: fileHash)
+        let url = url(of: globalHash)
+        try FileManager.default.createDirectory(at: url.deletingLastPathComponent(), withIntermediateDirectories: true)
+        try iconData.write(to: url)
+        return globalHash
+    }
+    
+    public func save() throws {
+        try FileManager.default.createDirectory(at: cacheFileURL.deletingLastPathComponent(), withIntermediateDirectories: true)
+        let data = try JSONEncoder.shared.encode(cacheMap)
+        try data.write(to: cacheFileURL)
+    }
+    
+    
+    private func url(of globalHash: String) -> URL {
+        return iconCacheDirectory.appending(path: "\(globalHash.prefix(2))/\(globalHash)")
+    }
+    
+    private func globalHash(of path: String, with fileHash: String) -> String {
+        return (fileHash + path).sha1
+    }
+}