fix(modload): 修复宿主程序集加载导致mod识别失败的问题

Author: StArray

StArray.ModManager.CImGui/imgui/backends/imgui_impl_opengl3.cpp

@@ -859,8 +859,12 @@ bool    ImGui_ImplOpenGL3_CreateDeviceObjects()
         "    Out_Color = Frag_Color * texture(Texture, Frag_UV.st);\n"
         "}\n";
 
+    // [LOCAL PATCH] 上游此处为 "precision mediump float;"。
+    // 大图集（4096+，本项目 5 个字体合并全 BMP 就是这种情况）下 mediump(10bit 尾数) 的 UV
+    // 量化误差可达 1~2 texel，采样会越过字形留白命中相邻格子的墨迹，表现为某些字底下多出一条细线
+    // （Windows 走 D3D11 fp32 着色器，所以看不到）。ES3 片元着色器强制支持 highp，可直接改。
     const GLchar* fragment_shader_glsl_300_es =
-        "precision mediump float;\n"
+        "precision highp float;\n"
         "uniform sampler2D Texture;\n"
         "in vec2 Frag_UV;\n"
         "in vec4 Frag_Color;\n"

StArray.ModManager.Tests/ModLoadContextTests.cs

@@ -27,9 +27,12 @@ public void TearDown()
 
     /// <summary>生成一个程序集并落盘：含一个公共类 Marker（可被实例化验证）。</summary>
     private string WriteAssembly(string fileName, string typeName = "Marker")
+        => WriteAssemblyTo(_tempDir, fileName, typeName);
+
+    private static string WriteAssemblyTo(string dir, string fileName, string typeName = "Marker")
     {
-        Directory.CreateDirectory(_tempDir);
-        var path = Path.Combine(_tempDir, fileName);
+        Directory.CreateDirectory(dir);
+        var path = Path.Combine(dir, fileName);
 
         var ab = new PersistedAssemblyBuilder(
             new AssemblyName(Path.GetFileNameWithoutExtension(fileName)), typeof(object).Assembly);
@@ -159,8 +162,49 @@ public void ResolvesDependencyFromSameDirectory()
         finally { alc.Unload(); }
     }
 
-    // ── 文件锁行为（路径加载的已知权衡） ──
+    /// <summary>
+    /// 管理器目录里也存在宿主程序集的副本时，依赖解析必须复用宿主已加载的实例。
+    /// 回归用例：SMM 自身就在 manager/ 目录里，若 mod ALC 从该目录再加载一份，
+    /// mod 看到的 IModPlugin 是另一个 Type，插件识别全失败（表现为“发现 0 个 Mod”）。
+    /// </summary>
+    [Test]
+    public void HostLoadedAssembly_WinsOverManagerDirCopy()
+    {
+        var sharedName = "HostShared_" + Guid.NewGuid().ToString("N");
+        var hostDir = Path.Combine(_tempDir, "host");
+        var managerDir = Path.Combine(_tempDir, "manager");
+        var modDir = Path.Combine(_tempDir, "mod");
+
+        // 两份同名程序集：一份已在宿主上下文，一份躺在管理器目录
+        var hostPath = WriteAssemblyTo(hostDir, sharedName + ".dll", "SharedMarker");
+        WriteAssemblyTo(managerDir, sharedName + ".dll", "SharedMarker");
+
+        var hostAsm = AssemblyLoadContext.Default.LoadFromAssemblyPath(hostPath);
+        var hostMarker = hostAsm.GetType("SharedMarker")!;
+
+        // mod 的依赖 dll 引用 SharedMarker → 触发 mod ALC 的依赖解析
+        var ab = new PersistedAssemblyBuilder(new AssemblyName("DepOfShared"), typeof(object).Assembly);
+        var mb = ab.DefineDynamicModule("MainModule");
+        var tb = mb.DefineType("DepMarker", TypeAttributes.Public | TypeAttributes.Sealed | TypeAttributes.Class);
+        tb.DefineField("Ref", hostMarker, FieldAttributes.Public | FieldAttributes.Static);
+        tb.CreateTypeInfo();
+        var depPath = Path.Combine(modDir, "DepOfShared.dll");
+        Directory.CreateDirectory(modDir);
+        ab.Save(depPath);
 
+        var alc = new ModLoadContext("T:HostFirst", modDir, managerDir);
+        try
+        {
+            var resolved = alc.LoadFromFilePath(depPath)
+                .GetType("DepMarker")!.GetField("Ref")!.FieldType;
+
+            Assert.That(resolved, Is.SameAs(hostMarker),
+                "宿主已加载的程序集必须复用同一实例，不能从管理器目录加载副本");
+        }
+        finally { alc.Unload(); }
+    }
+
+    // ── 文件锁行为（路径加载的已知权衡） ──
     [Test]
     public void PathLoad_HoldsFileUntilUnloadCollected()
     {

StArray.ModManager/Runtime/ModLoadContext.cs

@@ -23,6 +23,10 @@ public sealed class ModLoadContext : AssemblyLoadContext
     private readonly string _baseDir;
     private readonly string? _managerDir;
 
+    /// <summary>宿主上下文（SMM 本体所在的 ALC）——其中的程序集在 mod 侧必须保持同一身份。</summary>
+    private static readonly AssemblyLoadContext HostContext =
+        AssemblyLoadContext.GetLoadContext(typeof(ModLoadContext).Assembly) ?? AssemblyLoadContext.Default;
+
     /// <summary>mod 依赖解析失败时触发（诊断用）。</summary>
     public event Action<ModLoadContext, AssemblyName>? OnResolveFailure;
 
@@ -35,7 +39,14 @@ public ModLoadContext(string name, string baseDir, string? managerDir = null)
 
     protected override Assembly? Load(AssemblyName assemblyName)
     {
-        // 只处理本 mod 目录内的程序集；系统/框架程序集返回 null 交给默认上下文，
+        // 1) 宿主已加载的同名程序集必须复用同一实例。
+        //    管理器目录里同样有 StArray.ModManager.dll，若直接从这里加载一份副本，
+        //    mod 看到的 IModPlugin / ModEntryPointAttribute 就变成另一份类型，
+        //    IsPluginType 恒为 false → 一个 Mod 都发现不了（Android/Windows 皆然）。
+        if (TryFindHostAssembly(assemblyName.Name, out var hostAssembly))
+            return hostAssembly;
+
+        // 2) 只处理本 mod 目录内的程序集；系统/框架程序集返回 null 交给默认上下文，
         // 保证 mscorlib/System.* 与 SMM 本体的类型一致性（IModPlugin 接口可赋值）。
         var local = ProbeDir(_baseDir, assemblyName);
         if (local != null) return local;
@@ -66,6 +77,43 @@ public ModLoadContext(string name, string baseDir, string? managerDir = null)
         }
     }
 
+    /// <summary>
+    /// 在宿主上下文（及默认上下文）中查找已加载的同名程序集。
+    /// 命中则返回该实例，<b>绝不再从磁盘加载第二份</b> —— 类型身份一致是 mod 能被识别的
+    /// 前提（<c>IModPlugin</c> 与宿主必须是同一个 Type）。
+    /// </summary>
+    private static bool TryFindHostAssembly(string? simpleName, out Assembly? assembly)
+    {
+        assembly = null;
+        if (string.IsNullOrEmpty(simpleName)) return false;
+
+        if (TryFind(HostContext, simpleName, out assembly)) return true;
+        return !ReferenceEquals(HostContext, AssemblyLoadContext.Default)
+            && TryFind(AssemblyLoadContext.Default, simpleName, out assembly);
+    }
+
+    private static bool TryFind(AssemblyLoadContext context, string simpleName, out Assembly? assembly)
+    {
+        try
+        {
+            foreach (var loaded in context.Assemblies)
+            {
+                if (string.Equals(loaded.GetName().Name, simpleName, StringComparison.OrdinalIgnoreCase))
+                {
+                    assembly = loaded;
+                    return true;
+                }
+            }
+        }
+        catch (InvalidOperationException)
+        {
+            // 上下文正在卸载，忽略
+        }
+
+        assembly = null;
+        return false;
+    }
+
     protected override nint LoadUnmanagedDll(string unmanagedDllName)
     {
         // 原生库不经 ALC：交由 NativeLibraryResolver / OS 搜索路径处理

StArray.ModManager/Runtime/ModLoader.cs

@@ -129,7 +129,13 @@ private static bool IsPluginType(Type t) =>
                 var assembly = probe.LoadMetadataFromPath(entryDll);
 
                 var pluginType = ResolvePluginType(assembly);
-                if (pluginType == null) return null;
+                if (pluginType == null)
+                {
+                    // 静默跳过会让“共发现 0 个 Mod”难以定位，这里留下原因
+                    Logger.Warn(nameof(ModLoader),
+                        $"No IModPlugin type in {Path.GetFileName(entryDll)} ({dirName}); skipped");
+                    return null;
+                }
 
                 // 实例化以读取元数据（Dependencies 允许实现返回 null —— 接口不变，这里宽容处理）
                 var plugin = (IModPlugin)Activator.CreateInstance(pluginType)!;

StArray.ModManager/UI/IImGuiRenderer.cs

@@ -1,6 +1,7 @@
 using System.Reflection;
 using System.Runtime.InteropServices;
 using ImGuiNET;
+using StArray.ModManager.Manager;
 
 namespace StArray.ModManager.UI;
 
@@ -85,6 +86,11 @@ void InitImGui()
 
             // AddFontFromMemoryTTF 只保存指针，Build() 时才真正读取数据。
             io.Fonts.Build();
+
+            // 图集尺寸是 UV 精度的关键：越大的图集，GLES 上同样的相对误差对应的 texel 越多
+            // （mediump 在 4096 宽图集上约 1 texel、8192 高上约 2 texel）——记录以便核实。
+            Logger.Info("FontAtlas",
+                $"Built {io.Fonts.TexWidth}x{io.Fonts.TexHeight}, {io.Fonts.Fonts.Size} fonts");
         }
         finally
         {

version.json

@@ -1,8 +1,8 @@
 {
   "version": "1.0.6",
-  "versionCode": 13,
+  "versionCode": 14,
   "manager": "https://github.com/StArraySharp/StArray.ModManager/releases/download/1.0.6/modmanager.zip",
-  "sha256": "2eb3066ddfed555d13643e3b9c81af51f79eafc54a1ced28d20cafb418c36928",
+  "sha256": "4381976c1807e8bc58bd9e5ff6033a22c0915b246dd35f40daf3b5bae2f3b6df",
   "entryAssembly": "StArray.ModManager.Android.dll",
   "entryMethod": "StArray.ModManager.Android.Managed::Entry",
   "platforms": [
@@ -16,7 +16,7 @@
     {
       "name": "android",
       "manager": "https://github.com/StArraySharp/StArray.ModManager/releases/download/1.0.6/modmanager-android.zip",
-      "sha256": "79209ef2bcea49049448f9eff11815b005d221fb3f44b0d7bf80fe5b7b0b99f3",
+      "sha256": "4381976c1807e8bc58bd9e5ff6033a22c0915b246dd35f40daf3b5bae2f3b6df",
       "entryAssembly": "StArray.ModManager.Android.dll",
       "entryMethod": "StArray.ModManager.Android.Managed::Entry"
     }