Add post-obfuscation tips (#198)

Print a short list of actionable tips after a run (how to exclude members
via [MethodImpl(NoInlining)] / [Obfuscation], disable the watermark, use
the libs directory, pick a preset). Implemented as a TipsNotifier in the
obfuscation pipeline, gated by a new "Tips" setting (default on).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: sunnamed434

src/BitMono.Host/obfuscation.json

@@ -28,6 +28,10 @@
   // Set to true indicates whether enabled
   "NotifyProtections": true,
 
+  // Outputs short, helpful tips after obfuscation (how to exclude members, disable watermark, etc)
+  // Set to true indicates whether enabled
+  "Tips": true,
+
   // Exclude from obfuscation if method has [MethodImpl(MethodImplOptions.NoInlining)] attribute or NoInlining bit
   // Set to true indicates whether enabled
   "NoInliningMethodObfuscationExclude": true,

src/BitMono.Obfuscation/BitMonoObfuscator.cs

@@ -13,6 +13,7 @@ public class BitMonoObfuscator
     private readonly ProtectionsNotifier _protectionsNotifier;
     private readonly ProtectionsConfigureForNativeCodeNotifier _protectionsConfigureForNativeCodeNotifier;
     private readonly ProtectionExecutionNotifier _protectionExecutionNotifier;
+    private readonly TipsNotifier _tipsNotifier;
     private readonly ILogger _logger;
     private ProtectionsSort? _protectionsSort;
     private PEImageBuildResult? _imageBuild;
@@ -39,6 +40,7 @@ public BitMonoObfuscator(
         _protectionsNotifier = new ProtectionsNotifier(_obfuscationSettings, _logger);
         _protectionsConfigureForNativeCodeNotifier = new ProtectionsConfigureForNativeCodeNotifier(_obfuscationSettings, _logger);
         _protectionExecutionNotifier = new ProtectionExecutionNotifier(_logger);
+        _tipsNotifier = new TipsNotifier(_obfuscationSettings, _logger);
     }
 
     public async Task ProtectAsync()
@@ -63,6 +65,12 @@ public async Task ProtectAsync()
         await _pipeline.InvokeAsync(WriteModuleAsync);
         await _pipeline.InvokeAsync(PackAsync);
         await _pipeline.InvokeAsync(OutputElapsedTime);
+        await _pipeline.InvokeAsync(OutputTips);
+    }
+
+    private void OutputTips()
+    {
+        _tipsNotifier.Notify();
     }
 
     private void OutputLoadedModule()

src/BitMono.Obfuscation/Notifiers/TipsNotifier.cs

@@ -0,0 +1,37 @@
+namespace BitMono.Obfuscation.Notifiers;
+
+public class TipsNotifier
+{
+    // Short, actionable hints shown once after a run. Kept in sync with the defaults in
+    // obfuscation.json (NoInlining/ObfuscationAttribute excludes are enabled by default).
+    private static readonly string[] Tips =
+    {
+        "Mark a method with [MethodImpl(MethodImplOptions.NoInlining)] to exclude it from obfuscation.",
+        "Mark a type or member with [Obfuscation(Feature = \"ProtectionName\", Exclude = true)] to skip a single protection for it.",
+        "Set \"Watermark\": false in obfuscation.json (or pass --no-watermark) to disable the BitMono watermark.",
+        "Drop your dependencies into the 'libs' directory (or pass -l/--libraries) so references resolve and obfuscation goes deeper.",
+        "Choose how aggressive obfuscation is with --preset Minimal|Balanced|Maximum (or set \"Preset\" in obfuscation.json).",
+        "See all protections and which runtimes they support: https://bitmono.readthedocs.io",
+    };
+
+    private readonly ObfuscationSettings _obfuscationSettings;
+    private readonly ILogger _logger;
+
+    public TipsNotifier(ObfuscationSettings obfuscationSettings, ILogger logger)
+    {
+        _obfuscationSettings = obfuscationSettings;
+        _logger = logger.ForContext<TipsNotifier>();
+    }
+
+    public void Notify()
+    {
+        if (_obfuscationSettings.Tips == false)
+        {
+            return;
+        }
+        foreach (var tip in Tips)
+        {
+            _logger.Information("[Tip]: {0}", tip);
+        }
+    }
+}

src/BitMono.Shared/Models/ObfuscationSettings.cs

@@ -8,6 +8,7 @@ public class ObfuscationSettings
     public string ReferencesDirectoryName { get; set; }
     public string OutputDirectoryName { get; set; }
     public bool NotifyProtections { get; set; }
+    public bool Tips { get; set; } = true;
     public bool NoInliningMethodObfuscationExclude { get; set; }
     public bool SerializableBitObfuscationExclude { get; set; }
     public bool ObfuscationAttributeObfuscationExclude { get; set; }