test(generator): 添加批量注册集合生成器的单元测试

- 添加了针对注解集合生成批处理注册方法的测试用例
- 添加了当集合元素类型无法推断时报告诊断的测试
- 添加了注册方法使用数组参数时的批处理注册测试
- 添加了从继承接口获取注册方法的批处理注册测试
- 添加了从基类获取注册方法的批处理注册测试
- 添加了当集合成员不可实例读取时报告诊断的测试
- 添加了当注册成员不可实例读取时报告诊断的测试
- 添加了当注册方法对所有者类型不可访问时报告诊断的测试
- 添加了当注册导出集合属性参数无效时报告诊断的测试
- 添加了多个分部声明注解时仅生成一个源文件的测试
- 为枚举候选方法功能添加了详细的XML文档注释

GFramework.Godot.SourceGenerators.Tests/Registration/AutoRegisterExportedCollectionsGeneratorTests.cs

@@ -278,6 +278,76 @@ public class AutoRegisterExportedCollectionsGeneratorTests
             ("TestApp_Bootstrapper.AutoRegisterExportedCollections.g.cs", expected));
     }
 
+    [Test]
+    public async Task Generates_Batch_Registration_Method_When_Register_Method_Comes_From_Base_Class()
+    {
+        const string source = """
+                              #nullable enable
+                              using System;
+                              using System.Collections.Generic;
+                              using GFramework.Godot.SourceGenerators.Abstractions;
+
+                              namespace GFramework.Godot.SourceGenerators.Abstractions
+                              {
+                                  [AttributeUsage(AttributeTargets.Class, Inherited = false, AllowMultiple = false)]
+                                  public sealed class AutoRegisterExportedCollectionsAttribute : Attribute { }
+
+                                  [AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, Inherited = false, AllowMultiple = false)]
+                                  public sealed class RegisterExportedCollectionAttribute : Attribute
+                                  {
+                                      public RegisterExportedCollectionAttribute(string registryMemberName, string registerMethodName) { }
+                                  }
+                              }
+
+                              namespace TestApp
+                              {
+                                  public class BaseRegistry
+                                  {
+                                      public void Register(int value) { }
+                                  }
+
+                                  public sealed class DerivedRegistry : BaseRegistry
+                                  {
+                                  }
+
+                                  [AutoRegisterExportedCollections]
+                                  public partial class Bootstrapper
+                                  {
+                                      private readonly DerivedRegistry? _registry = new();
+
+                                      [RegisterExportedCollection(nameof(_registry), nameof(BaseRegistry.Register))]
+                                      public List<int>? Values { get; } = new();
+                                  }
+                              }
+                              """;
+
+        const string expected = """
+                                // <auto-generated />
+                                #nullable enable
+
+                                namespace TestApp;
+
+                                partial class Bootstrapper
+                                {
+                                    private void __RegisterExportedCollections_Generated()
+                                    {
+                                        if (this.Values is not null && this._registry is not null)
+                                        {
+                                            foreach (var __generatedItem in this.Values)
+                                            {
+                                                this._registry.Register(__generatedItem);
+                                            }
+                                        }
+                                    }
+                                }
+
+                                """;
+
+        await GeneratorTest<AutoRegisterExportedCollectionsGenerator>.RunAsync(
+            source,
+            ("TestApp_Bootstrapper.AutoRegisterExportedCollections.g.cs", expected));
+    }
+
     [Test]
     public async Task Reports_Diagnostic_When_Collection_Member_Is_Not_Instance_Readable()
     {

GFramework.Godot.SourceGenerators/Registration/AutoRegisterExportedCollectionsGenerator.cs

@@ -318,6 +318,20 @@ public sealed class AutoRegisterExportedCollectionsGenerator : IIncrementalGener
         return compilation.ClassifyConversion(elementType, parameterType).IsImplicit;
     }
 
+    /// <summary>
+    ///     枚举给定注册表类型上可能承载批量注册入口的候选实例方法。
+    /// </summary>
+    /// <param name="registryType">声明注册表成员的静态类型。</param>
+    /// <param name="registerMethodName">特性参数中声明的注册方法名称。</param>
+    /// <returns>
+    ///     按“当前类型 -> 基类链 -> 已实现接口”顺序返回所有同名方法，供后续签名和可访问性筛选使用。
+    /// </returns>
+    /// <remarks>
+    ///     生成器需要沿这三条继承路径查找方法，因为用户代码可能通过派生类字段引用基类实现，
+    ///     或通过接口类型引用由上层接口声明的契约方法。这里故意不做去重：同一个语义方法可能同时经由
+    ///     覆盖链、接口继承或显式声明被枚举多次，但当前调用方只使用 <c>Any</c> 判断“是否存在至少一个可用候选”，
+    ///     因此重复项只会带来额外的符号检查成本，不会改变生成结果或诊断边界。
+    /// </remarks>
     private static IEnumerable<IMethodSymbol> EnumerateCandidateMethods(
         INamedTypeSymbol registryType,
         string registerMethodName)