diff --git a/GFramework.SourceGenerators.Common/AnalyzerReleases.Unshipped.md b/GFramework.SourceGenerators.Common/AnalyzerReleases.Unshipped.md
index 7f402e3..84445da 100644
--- a/GFramework.SourceGenerators.Common/AnalyzerReleases.Unshipped.md
+++ b/GFramework.SourceGenerators.Common/AnalyzerReleases.Unshipped.md
@@ -5,4 +5,5 @@
 
  Rule ID             | Category          | Severity | Notes             
 ---------------------|-------------------|----------|-------------------
- GF_Common_Class_001 | GFramework.Common | Error    | CommonDiagnostics 
\ No newline at end of file
+ GF_Common_Class_001 | GFramework.Common | Error    | CommonDiagnostics 
+ GF_Common_Trace_001 | GFramework.Trace  | Info     | CommonDiagnostics 
\ No newline at end of file
diff --git a/GFramework.SourceGenerators.Common/diagnostics/CommonDiagnostics.cs b/GFramework.SourceGenerators.Common/diagnostics/CommonDiagnostics.cs
index e55ebac..fad409b 100644
--- a/GFramework.SourceGenerators.Common/diagnostics/CommonDiagnostics.cs
+++ b/GFramework.SourceGenerators.Common/diagnostics/CommonDiagnostics.cs
@@ -24,6 +24,37 @@ public static class CommonDiagnostics
             "Class '{0}' must be declared partial for code generation",
             "GFramework.Common",
             DiagnosticSeverity.Error,
-            true
+            isEnabledByDefault: true
         );
+
+    /// <summary>
+    ///     定义源代码生成器跟踪信息的诊断描述符
+    /// </summary>
+    /// <remarks>
+    ///     诊断ID: GF_Common_Trace_001
+    ///     诊断消息: "{0}"
+    ///     分类: GFramework.Trace
+    ///     严重性: Info
+    ///     是否启用: true
+    /// </remarks>
+    public static readonly DiagnosticDescriptor GeneratorTrace =
+        new(
+            "GF_Common_Trace_001",
+            "Source generator trace",
+            "{0}",
+            "GFramework.Trace",
+            DiagnosticSeverity.Info,
+            isEnabledByDefault: true
+        );
+
+    /// <summary>
+    ///     源代码生成器跟踪信息
+    /// </summary>
+    public static void Trace(SourceProductionContext context, string message)
+    {
+        context.ReportDiagnostic(Diagnostic.Create(
+            GeneratorTrace,
+            Location.None,
+            message));
+    }
 }
\ No newline at end of file
diff --git a/GFramework.SourceGenerators.Common/generator/AttributeClassGeneratorBase.cs b/GFramework.SourceGenerators.Common/generator/AttributeClassGeneratorBase.cs
index 28d972f..80efdd8 100644
--- a/GFramework.SourceGenerators.Common/generator/AttributeClassGeneratorBase.cs
+++ b/GFramework.SourceGenerators.Common/generator/AttributeClassGeneratorBase.cs
@@ -70,22 +70,49 @@ public abstract class AttributeClassGeneratorBase : IIncrementalGenerator
         ClassDeclarationSyntax classDecl,
         INamedTypeSymbol symbol)
     {
-        var attr = ResolveAttribute(compilation, symbol);
-        if (attr is null)
-            return;
+        // ① 进入 Execute
+        CommonDiagnostics.Trace(context, $"[GEN] Enter Execute: {symbol.ToDisplayString()}");
 
+        var attr = ResolveAttribute(compilation, symbol);
+
+        // ② 属性是否解析到
+        if (attr is null)
+        {
+            CommonDiagnostics.Trace(context,
+                $"[GEN] Attribute NOT resolved on {symbol.ToDisplayString()}");
+            return;
+        }
+
+        CommonDiagnostics.Trace(context,
+            $"[GEN] Attribute resolved: {attr.AttributeClass?.ToDisplayString()}");
+
+        // ③ partial 校验
         if (!classDecl.Modifiers.Any(SyntaxKind.PartialKeyword))
         {
+            CommonDiagnostics.Trace(context,
+                $"[GEN] Class is NOT partial: {symbol.Name}");
+
             ReportClassMustBePartial(context, classDecl, symbol);
             return;
         }
 
-        if (!ValidateSymbol(context, classDecl, symbol, attr))
+        // ④ ValidateSymbol
+        if (!ValidateSymbol(context, compilation, classDecl, symbol, attr))
+        {
+            CommonDiagnostics.Trace(context,
+                $"[GEN] ValidateSymbol FAILED: {symbol.ToDisplayString()}");
             return;
+        }
 
-        context.AddSource(GetHintName(symbol), Generate(symbol, attr));
+        // ⑤ Generate
+        var hintName = GetHintName(symbol);
+        CommonDiagnostics.Trace(context,
+            $"[GEN] Generating source: {hintName}");
+
+        context.AddSource(hintName, Generate(symbol, attr));
     }
 
+
     /// <summary>
     ///     验证符号的有效性
     /// </summary>
@@ -96,9 +123,11 @@ public abstract class AttributeClassGeneratorBase : IIncrementalGenerator
     /// <returns>验证是否通过</returns>
     protected virtual bool ValidateSymbol(
         SourceProductionContext context,
+        Compilation compilation,
         ClassDeclarationSyntax syntax,
         INamedTypeSymbol symbol,
-        AttributeData attr) => true;
+        AttributeData attr)
+        => true;
 
     /// <summary>
     ///     生成源代码
diff --git a/GFramework.SourceGenerators/enums/EnumExtensionsGenerator.cs b/GFramework.SourceGenerators/enums/EnumExtensionsGenerator.cs
index dea3a3c..62fa564 100644
--- a/GFramework.SourceGenerators/enums/EnumExtensionsGenerator.cs
+++ b/GFramework.SourceGenerators/enums/EnumExtensionsGenerator.cs
@@ -26,12 +26,14 @@ public sealed class EnumExtensionsGenerator : MetadataAttributeClassGeneratorBas
     /// 验证符号是否为有效的枚举类型
     /// </summary>
     /// <param name="context">源生产上下文</param>
+    /// <param name="compilation">编译对象</param>
     /// <param name="syntax">类声明语法节点</param>
     /// <param name="symbol">命名类型符号</param>
     /// <param name="attr">属性数据</param>
     /// <returns>验证是否通过</returns>
     protected override bool ValidateSymbol(
         SourceProductionContext context,
+        Compilation compilation,
         ClassDeclarationSyntax syntax,
         INamedTypeSymbol symbol,
         AttributeData attr)
diff --git a/GFramework.SourceGenerators/logging/LoggerGenerator.cs b/GFramework.SourceGenerators/logging/LoggerGenerator.cs
index 90064fe..f8c1292 100644
--- a/GFramework.SourceGenerators/logging/LoggerGenerator.cs
+++ b/GFramework.SourceGenerators/logging/LoggerGenerator.cs
@@ -31,6 +31,7 @@ public sealed class LoggerGenerator : TypeAttributeClassGeneratorBase
     /// </summary>
     protected override bool ValidateSymbol(
         SourceProductionContext context,
+        Compilation compilation,
         ClassDeclarationSyntax syntax,
         INamedTypeSymbol symbol,
         AttributeData attr)
diff --git a/GFramework.SourceGenerators/rule/ContextAwareGenerator.cs b/GFramework.SourceGenerators/rule/ContextAwareGenerator.cs
index 09efa4b..b8fd5a7 100644
--- a/GFramework.SourceGenerators/rule/ContextAwareGenerator.cs
+++ b/GFramework.SourceGenerators/rule/ContextAwareGenerator.cs
@@ -1,6 +1,5 @@
 using System.Linq;
 using System.Text;
-using GFramework.Core.Abstractions.rule;
 using GFramework.SourceGenerators.Common.constants;
 using GFramework.SourceGenerators.Common.generator;
 using GFramework.SourceGenerators.diagnostics;
@@ -31,19 +30,40 @@ public sealed class ContextAwareGenerator : MetadataAttributeClassGeneratorBase
     /// </summary>
     protected override bool ValidateSymbol(
         SourceProductionContext context,
+        Compilation compilation,
         ClassDeclarationSyntax syntax,
         INamedTypeSymbol symbol,
         AttributeData attr)
     {
-        if (symbol.AllInterfaces.Any(i =>
-                i.ToDisplayString() == typeof(IContextAware).FullName)) return true;
-        context.ReportDiagnostic(Diagnostic.Create(
-            ContextAwareDiagnostic.ClassMustImplementIContextAware,
-            syntax.Identifier.GetLocation(),
-            symbol.Name));
-        return false;
+        var iContextAware = compilation
+            .GetTypeByMetadataName(
+                $"{PathContests.CoreAbstractionsNamespace}.rule.IContextAware");
+
+        if (iContextAware is null)
+        {
+            context.ReportDiagnostic(Diagnostic.Create(
+                ContextAwareDiagnostic.ClassMustImplementIContextAware,
+                syntax.Identifier.GetLocation(),
+                symbol.Name));
+
+            return false;
+        }
+
+        if (!symbol.AllInterfaces.Any(i =>
+                SymbolEqualityComparer.Default.Equals(i, iContextAware)))
+        {
+            context.ReportDiagnostic(Diagnostic.Create(
+                ContextAwareDiagnostic.ClassMustImplementIContextAware,
+                syntax.Identifier.GetLocation(),
+                symbol.Name));
+
+            return false;
+        }
+
+        return true;
     }
 
+
     /// <summary>
     ///     生成源码
     /// </summary>