refactor(all): 添加Stub的dll生成器，并优化部分代码

Author: StArray

.gitattributes

@@ -0,0 +1,60 @@
+# Normalize text files to UTF-8 without BOM and LF line endings.
+# This prevents PowerShell and other tools from corrupting encodings.
+
+* text=auto eol=lf
+
+# Source code
+*.cs          text diff=csharp
+*.csproj      text
+*.slnx        text
+*.props       text
+*.targets     text
+*.json        text
+*.xml         text
+*.yml         text
+*.yaml        text
+*.editorconfig text
+*.cmake       text
+Makefile      text
+*.java        text
+*.kt          text
+
+# Scripts
+*.sh          text eol=lf
+*.bat         text eol=crlf
+*.cmd         text eol=crlf
+
+# Docs
+*.md          text diff=markdown
+*.txt         text
+
+# Native code
+*.c           text
+*.h           text
+*.hpp         text
+*.cpp         text
+
+
+# Gradle
+*.gradle      text
+/gradlew      text eol=lf
+
+# Binary / generated
+*.png         binary
+*.jpg         binary
+*.ico         binary
+*.ttf         binary
+*.otf         binary
+*.so          binary
+*.dll         binary
+*.exe         binary
+*.lib         binary
+*.a           binary
+*.obj         binary
+*.pdb         binary
+*.apk         binary
+*.aar         binary
+*.jar         binary
+*.zip         binary
+*.tar         binary
+*.gz          binary

.gitignore

@@ -74,4 +74,6 @@ LevelDebugger
 .vscode
 log.txt
 imgui.ini
-Corehold
+Corehold
+.claude
+.backup

Android/library/src/main/cpp/core/misc.c

@@ -1,4 +1,4 @@
-//
+//
 // Created by StArray on 2026/7/19.
 //
 #include <stdio.h>

StArray.ModManager.Analyzer/Diagnostics.cs

@@ -0,0 +1,75 @@
+using Microsoft.CodeAnalysis;
+
+namespace StArray.ModManager.Analyzer;
+
+/// <summary>
+/// 生成器诊断。此前所有失败路径都是静默 return/continue —— 用户漏写 partial、漏写 static、
+/// 或程序集名少了 .dll，都不会有任何提示，只能在运行时表现为「功能不存在」。
+/// </summary>
+internal static class Diagnostics
+{
+    private const string Category = "StArray.ModManager";
+
+    /// <summary>类标了 [UnmanagedType] 却不是 partial</summary>
+    public static readonly DiagnosticDescriptor TypeNotPartial = new(
+        "SAMM001",
+        "标记 [UnmanagedType] 的类必须是 partial",
+        "类型 '{0}' 标记了 [UnmanagedType]，但不是 partial —— 不会为它生成任何存根实现",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>成员标了 [UnmanagedMember] 却不是 partial 定义</summary>
+    public static readonly DiagnosticDescriptor MemberNotPartial = new(
+        "SAMM002",
+        "标记 [UnmanagedMember] 的方法必须是 partial 定义",
+        "方法 '{0}' 标记了 [UnmanagedMember]，但不是无实现的 partial 定义 —— 会被跳过",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>类里没有任何可生成的成员</summary>
+    public static readonly DiagnosticDescriptor NoMembers = new(
+        "SAMM003",
+        "[UnmanagedType] 类型没有可生成的成员",
+        "类型 '{0}' 标记了 [UnmanagedType]，但没有任何标记 [UnmanagedMember] 的 partial 方法",
+        Category, DiagnosticSeverity.Warning, isEnabledByDefault: true);
+
+    /// <summary>程序集名缺少 .dll 后缀</summary>
+    public static readonly DiagnosticDescriptor AssemblyNameMissingDll = new(
+        "SAMM004",
+        "程序集名应带 .dll 后缀",
+        "程序集名 '{0}' 缺少 .dll 后缀；运行时通过 OpenAssembly 解析，需要文件名形式（如 \"{0}.dll\"），否则会在运行时静默解析失败",
+        Category, DiagnosticSeverity.Warning, isEnabledByDefault: true);
+
+    /// <summary>Hook 方法不是 static</summary>
+    public static readonly DiagnosticDescriptor HookNotStatic = new(
+        "SAMM005",
+        "Hook 方法必须是 static",
+        "方法 '{0}' 标记了 Hook 特性，但不是 static —— 不会为它生成任何 hook 代码",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>Hook 的目标类型/方法名为空</summary>
+    public static readonly DiagnosticDescriptor HookMissingTarget = new(
+        "SAMM006",
+        "Hook 缺少目标信息",
+        "方法 '{0}' 的 Hook 特性缺少必要的目标参数（{1}）",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>[NativeImport] 方法不是 partial / 有实现体</summary>
+    public static readonly DiagnosticDescriptor ImportNotPartial = new(
+        "SAMM007",
+        "标记 [NativeImport] 的方法必须是无实现的 partial 定义",
+        "方法 '{0}' 标记了 [NativeImport]，但不是无实现的 partial 定义 —— 会被跳过",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>[NativeImport] 未指定库名，且所在类也没有类级默认库</summary>
+    public static readonly DiagnosticDescriptor ImportMissingLibrary = new(
+        "SAMM008",
+        "[NativeImport] 缺少库名",
+        "方法 '{0}' 未指定库名，且其所在类型没有类级默认库",
+        Category, DiagnosticSeverity.Error, isEnabledByDefault: true);
+
+    /// <summary>实例 Hook 的首参不是 nint</summary>
+    public static readonly DiagnosticDescriptor HookFirstParamNotThis = new(
+        "SAMM009",
+        "实例方法 Hook 的首个参数应为 nint（this 指针）",
+        "方法 '{0}' 的首个参数是 '{1}'；被 hook 的实例方法在 native 侧首参为 this 指针，通常应声明为 nint",
+        Category, DiagnosticSeverity.Info, isEnabledByDefault: true);
+}

StArray.ModManager.Analyzer/EquatableArray.cs

@@ -0,0 +1,68 @@
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Linq;
+
+namespace StArray.ModManager.Analyzer;
+
+/// <summary>
+/// 带值相等语义的不可变数组。
+///
+/// 增量生成器靠模型的 <c>Equals</c> 判断下游要不要重算，而 <see cref="ImmutableArray{T}"/>
+/// 比较的是底层数组引用 —— 直接把它放进模型会让缓存永远 miss，
+/// <c>IIncrementalGenerator</c> 退化成每次全量重跑。
+/// </summary>
+internal readonly struct EquatableArray<T> : IEquatable<EquatableArray<T>>, IEnumerable<T>
+    where T : IEquatable<T>
+{
+    private readonly T[]? _items;
+
+    public EquatableArray(T[]? items) => _items = items;
+
+    public EquatableArray(ImmutableArray<T> items) => _items = items.IsDefault ? null : items.ToArray();
+
+    public static EquatableArray<T> Empty => new(Array.Empty<T>());
+
+    public int Count => _items?.Length ?? 0;
+
+    public T this[int index] => _items![index];
+
+    public bool Equals(EquatableArray<T> other)
+    {
+        if (_items is null || other._items is null) return _items is null && other._items is null;
+        return _items.AsSpan().SequenceEqual(other._items.AsSpan());
+    }
+
+    public override bool Equals(object? obj) => obj is EquatableArray<T> a && Equals(a);
+
+    public override int GetHashCode()
+    {
+        if (_items is null) return 0;
+        var hash = 17;
+        foreach (var item in _items)
+            hash = hash * 31 + (item?.GetHashCode() ?? 0);
+        return hash;
+    }
+
+    public IEnumerator<T> GetEnumerator() => ((IEnumerable<T>)(_items ?? Array.Empty<T>())).GetEnumerator();
+
+    IEnumerator IEnumerable.GetEnumerator() => GetEnumerator();
+
+    public static implicit operator EquatableArray<T>(T[] items) => new(items);
+    public static implicit operator EquatableArray<T>(ImmutableArray<T> items) => new(items);
+}
+
+internal static class EquatableArrayExtensions
+{
+    public static EquatableArray<T> ToEquatable<T>(this IEnumerable<T> source) where T : IEquatable<T>
+        => new(source.ToArray());
+}
+
+/// <summary>参数的类型与名称。用 record struct 以获得值相等。</summary>
+internal readonly record struct ParamInfo(string Type, string Name);
+
+/// <summary>特性的具名参数。</summary>
+internal readonly record struct NamedArg(string Key, string Value);
+
+