feat: 自动安装模组前置

PCL.Core.Test/Minecraft/ResourceProject/ModDependencyResolverTest.cs

@@ -0,0 +1,385 @@
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+using PCL.Core.Minecraft.ResourceProject;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace PCL.Core.Test.Minecraft.ResourceProject;
+
+[TestClass]
+public class ModDependencyResolverTest
+{
+    [TestMethod]
+    public void ResolvesOneMissingRequiredDependency()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = new Dictionary<string, ModDependencyProject>(StringComparer.OrdinalIgnoreCase)
+        {
+            ["Modrinth:B"] = new()
+            {
+                ProjectId = "B",
+                Source = "Modrinth",
+                ProjectName = "Dependency B",
+                Files =
+                [
+                    new ModDependencyFile
+                    {
+                        Id = "b-file",
+                        DisplayName = "Dependency B 1.20.1 Fabric",
+                        Version = "1.0.0",
+                        GameVersions = ["1.20.1"],
+                        Loaders = ["Fabric"],
+                        ReleaseType = 1,
+                        ReleaseDate = new DateTime(2025, 1, 1, 0, 0, 0, DateTimeKind.Utc),
+                    },
+                ],
+            },
+        };
+
+        var request = new ModDependencyRequest
+        {
+            TargetMinecraftVersion = "1.20.1",
+            TargetLoaders = ["Fabric"],
+            RequiredDependencies =
+            [
+                new ModDependencyReference
+                {
+                    ProjectId = "B",
+                    Source = "Modrinth",
+                },
+            ],
+            ProjectResolver = (source, projectId) => projects.GetValueOrDefault($"{source}:{projectId}"),
+        };
+
+        var result = resolver.Resolve(request);
+
+        Assert.AreEqual(1, result.ToInstall.Count);
+        Assert.AreEqual("B", result.ToInstall[0].ProjectId);
+        Assert.AreEqual("Modrinth", result.ToInstall[0].Source);
+        Assert.AreEqual("b-file", result.ToInstall[0].File.Id);
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void ReturnsEmptyForNoDependencies()
+    {
+        var resolver = new ModDependencyResolver();
+        var request = new ModDependencyRequest
+        {
+            TargetMinecraftVersion = "1.20.1",
+            TargetLoaders = ["Fabric"],
+            ProjectResolver = (_, _) => throw new AssertFailedException("Resolver should not be invoked."),
+        };
+
+        var result = resolver.Resolve(request);
+
+        Assert.AreEqual(0, result.ToInstall.Count);
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void ResolvesRecursiveDependencies()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile(
+                    "b-file",
+                    requiredDependencies:
+                    [
+                        CreateDependency("C"),
+                    ])),
+            CreateProject(
+                "C",
+                CreateFile("c-file")));
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B")));
+
+        CollectionAssert.AreEquivalent(new[] { "B", "C" }, result.ToInstall.Select(static item => item.ProjectId).ToList());
+        Assert.AreEqual(2, result.ToInstall.Count);
+        Assert.IsFalse(result.ToInstall.Any(static item => item.ProjectId == "A"));
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void DeduplicatesSharedDependencies()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile(
+                    "b-file",
+                    requiredDependencies:
+                    [
+                        CreateDependency("D"),
+                    ])),
+            CreateProject(
+                "C",
+                CreateFile(
+                    "c-file",
+                    requiredDependencies:
+                    [
+                        CreateDependency("D"),
+                    ])),
+            CreateProject(
+                "D",
+                CreateFile("d-file")));
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B"), CreateDependency("C")));
+
+        Assert.AreEqual(3, result.ToInstall.Count);
+        CollectionAssert.AreEquivalent(new[] { "B", "C", "D" }, result.ToInstall.Select(static item => item.ProjectId).ToList());
+        Assert.AreEqual(1, result.ToInstall.Count(static item => item.ProjectId == "D"));
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void TerminatesCycles()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile(
+                    "b-file",
+                    requiredDependencies:
+                    [
+                        CreateDependency("B"),
+                    ])));
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B")));
+
+        Assert.AreEqual(1, result.ToInstall.Count);
+        Assert.AreEqual("B", result.ToInstall[0].ProjectId);
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void BlocksUnresolvedRequiredDependency()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = new Dictionary<string, ModDependencyProject>(StringComparer.OrdinalIgnoreCase);
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B")));
+
+        Assert.AreEqual(0, result.ToInstall.Count);
+        Assert.AreEqual(1, result.Unresolved.Count);
+        Assert.AreEqual("B", result.Unresolved[0].ProjectId);
+        StringAssert.Contains(result.Unresolved[0].Reason, "not found");
+    }
+
+    [TestMethod]
+    public void SkipsAlreadyInstalledCompatibleDependency()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile("b-file")));
+
+        var result = resolver.Resolve(CreateRequest(
+            projects,
+            [
+                CreateInstalledMod("B"),
+            ],
+            CreateDependency("B")));
+
+        Assert.AreEqual(0, result.ToInstall.Count);
+        Assert.AreEqual(1, result.Satisfied.Count);
+        Assert.AreEqual("B", result.Satisfied[0].ProjectId);
+        StringAssert.Contains(result.Satisfied[0].Reason, "Already installed");
+    }
+
+    [TestMethod]
+    public void TreatsInstalledIncompatibleDependencyAsMissing()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile("b-file")));
+
+        var result = resolver.Resolve(CreateRequest(
+            projects,
+            [
+                CreateInstalledMod("B", gameVersions: ["1.19.2"]),
+            ],
+            CreateDependency("B")));
+
+        Assert.AreEqual(1, result.ToInstall.Count);
+        Assert.AreEqual("B", result.ToInstall[0].ProjectId);
+        Assert.AreEqual("b-file", result.ToInstall[0].File.Id);
+        Assert.AreEqual(0, result.Satisfied.Count);
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    [TestMethod]
+    public void IgnoresOptionalDependencies()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = new Dictionary<string, ModDependencyProject>(StringComparer.OrdinalIgnoreCase);
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B", isRequired: false)));
+
+        Assert.AreEqual(0, result.ToInstall.Count);
+        Assert.AreEqual(0, result.Unresolved.Count);
+        Assert.AreEqual(1, result.Satisfied.Count);
+        Assert.AreEqual("B", result.Satisfied[0].ProjectId);
+        StringAssert.Contains(result.Satisfied[0].Reason, "Optional dependency ignored");
+    }
+
+    [TestMethod]
+    public void SelectsLatestCompatibleReleaseFile()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                CreateFile(
+                    "b-alpha",
+                    displayName: "Dependency B Alpha",
+                    releaseType: 3,
+                    releaseDate: new DateTime(2025, 1, 1, 0, 0, 0, DateTimeKind.Utc)),
+                CreateFile(
+                    "b-beta",
+                    displayName: "Dependency B Beta",
+                    releaseType: 2,
+                    releaseDate: new DateTime(2025, 2, 1, 0, 0, 0, DateTimeKind.Utc)),
+                CreateFile(
+                    "b-release",
+                    displayName: "Dependency B Release",
+                    releaseType: 1,
+                    releaseDate: new DateTime(2025, 3, 1, 0, 0, 0, DateTimeKind.Utc))));
+
+        var result = resolver.Resolve(CreateRequest(projects, CreateDependency("B")));
+
+        Assert.AreEqual(1, result.ToInstall.Count);
+        Assert.AreEqual("b-release", result.ToInstall[0].File.Id);
+        Assert.AreEqual(1, result.ToInstall[0].File.ReleaseType);
+    }
+
+    [TestMethod]
+    public void DoesNotCrossMatchSources()
+    {
+        var resolver = new ModDependencyResolver();
+        var projects = CreateProjectStore(
+            CreateProject(
+                "B",
+                [CreateFile("b-file")],
+                "CurseForge"));
+
+        var result = resolver.Resolve(CreateRequest(
+            projects,
+            [
+                CreateInstalledMod("B", source: "Modrinth"),
+            ],
+            CreateDependency("B", source: "CurseForge")));
+
+        Assert.AreEqual(1, result.ToInstall.Count);
+        Assert.AreEqual("B", result.ToInstall[0].ProjectId);
+        Assert.AreEqual("CurseForge", result.ToInstall[0].Source);
+        Assert.AreEqual(0, result.Satisfied.Count);
+        Assert.AreEqual(0, result.Unresolved.Count);
+    }
+
+    private static ModDependencyRequest CreateRequest(
+        Dictionary<string, ModDependencyProject> projects,
+        params ModDependencyReference[] requiredDependencies)
+    {
+        return CreateRequest(projects, [], requiredDependencies);
+    }
+
+    private static ModDependencyRequest CreateRequest(
+        Dictionary<string, ModDependencyProject> projects,
+        List<InstalledModIdentity> installedMods,
+        params ModDependencyReference[] requiredDependencies)
+    {
+        return new ModDependencyRequest
+        {
+            TargetMinecraftVersion = "1.20.1",
+            TargetLoaders = ["Fabric"],
+            RequiredDependencies = [.. requiredDependencies],
+            InstalledMods = installedMods,
+            ProjectResolver = (source, projectId) => projects.GetValueOrDefault($"{source}:{projectId}"),
+        };
+    }
+
+    private static Dictionary<string, ModDependencyProject> CreateProjectStore(params ModDependencyProject[] projects)
+    {
+        var store = new Dictionary<string, ModDependencyProject>(StringComparer.OrdinalIgnoreCase);
+        foreach (var project in projects)
+        {
+            store[$"{project.Source}:{project.ProjectId}"] = project;
+        }
+
+        return store;
+    }
+
+    private static ModDependencyProject CreateProject(string projectId, params ModDependencyFile[] files)
+    {
+        return CreateProject(projectId, files, "Modrinth");
+    }
+
+    private static ModDependencyProject CreateProject(string projectId, ModDependencyFile[] files, string source)
+    {
+        return new ModDependencyProject
+        {
+            ProjectId = projectId,
+            Source = source,
+            ProjectName = $"Dependency {projectId}",
+            Files = [.. files],
+        };
+    }
+
+    private static ModDependencyFile CreateFile(
+        string id,
+        string? displayName = null,
+        string? version = "1.0.0",
+        List<string>? gameVersions = null,
+        List<string>? loaders = null,
+        int releaseType = 1,
+        DateTime? releaseDate = null,
+        List<ModDependencyReference>? requiredDependencies = null)
+    {
+        return new ModDependencyFile
+        {
+            Id = id,
+            DisplayName = displayName ?? id,
+            Version = version,
+            GameVersions = gameVersions ?? ["1.20.1"],
+            Loaders = loaders ?? ["Fabric"],
+            ReleaseType = releaseType,
+            ReleaseDate = releaseDate ?? new DateTime(2025, 1, 1, 0, 0, 0, DateTimeKind.Utc),
+            RequiredDependencies = requiredDependencies ?? [],
+        };
+    }
+
+    private static ModDependencyReference CreateDependency(string projectId, string source = "Modrinth", bool isRequired = true)
+    {
+        return new ModDependencyReference
+        {
+            ProjectId = projectId,
+            Source = source,
+            IsRequired = isRequired,
+        };
+    }
+
+    private static InstalledModIdentity CreateInstalledMod(
+        string projectId,
+        string source = "Modrinth",
+        string? modId = null,
+        List<string>? gameVersions = null,
+        List<string>? loaders = null)
+    {
+        return new InstalledModIdentity
+        {
+            SourceProjectId = projectId,
+            Source = source,
+            ModId = modId ?? $"mod_{projectId.ToLowerInvariant()}",
+            GameVersions = gameVersions ?? ["1.20.1"],
+            Loaders = loaders ?? ["Fabric"],
+        };
+    }
+}

PCL.Core/App/Config.cs

@@ -87,6 +87,7 @@ public static partial class Config
             [ConfigItem<int>("ToolDownloadTranslate", 0)] public partial int NameFormatV1 { get; set; }
             [ConfigItem<int>("ToolDownloadTranslateV2", 1)] public partial int NameFormatV2 { get; set; }
             [ConfigItem<bool>("ToolDownloadIgnoreQuilt", false)] public partial bool IgnoreQuilt { get; set; }
+            [ConfigItem<bool>("ToolDownloadAutoInstallDependencies", true)] public partial bool AutoInstallDependencies { get; set; }
             [ConfigItem<bool>("ToolDownloadClipboard", false)] public partial bool ReadClipboard { get; set; }
             [ConfigItem<int>("ToolDownloadMod", 1)] public partial int CompSourceSolution { get; set; }
             [ConfigItem<int>("ToolModLocalNameStyle", 0)] public partial int UiCompNameSolution { get; set; }