💾 Feat(Workflow): 添加工作流编译与持久化功能，支持跨会话重用

Author: StardustSeemsInk

KitX Clients/KitX Core/KitX.Core/Workflow/BlockScripting/BlockScriptExecutionGlobals.cs

@@ -1,8 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Threading;
-using Kscript.CSharp.Parser.Core;
-using Kscript.CSharp.Parser.Models;
+using KitX.Core.Contract.Workflow;
 using KitX.Core.Workflow;
 using Serilog;
 

KitX Clients/KitX Core/KitX.Core/Workflow/BlockScripting/BlockScriptExecutor.cs

@@ -5,13 +5,12 @@
 using System.Reflection;
 using System.Threading;
 using System.Threading.Tasks;
-using Kscript.CSharp.Parser.Core;
+using KitX.Core.Contract.Workflow;
 using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp;
 using Microsoft.CodeAnalysis.CSharp.Syntax;
 using Microsoft.CodeAnalysis.CSharp.Scripting;
 using Microsoft.CodeAnalysis.Scripting;
-using KitX.Core.Contract.Workflow;
 using KitX.Core.Workflow;
 using Serilog;
 
@@ -40,6 +39,9 @@ public class BlockScriptExecutor : IBlockScriptExecutor
     private BlockScriptExecutionGlobals? _globals;
     private IPluginManager? _pluginManager;
 
+    // Workflow ID for disk persistence of compiled assemblies
+    private string? _workflowId;
+
     // Block-level precompilation
     private readonly BlockCompiler _blockCompiler = new();
     private Dictionary<string, string>? _blockCodeCache;
@@ -80,6 +82,48 @@ public void SetPluginManager(IPluginManager? pluginManager)
         _pluginManager = pluginManager;
     }
 
+    /// <summary>
+    /// Sets the workflow ID for disk persistence of compiled assemblies.
+    /// When set, compiled assemblies are saved to and loaded from disk
+    /// to enable cross-session reuse.
+    /// </summary>
+    public void SetWorkflowId(string? workflowId)
+    {
+        _workflowId = workflowId;
+    }
+
+    /// <summary>
+    /// Compiles a BlockScript and persists it to disk (without executing).
+    /// Used for pre-compilation at workflow save time.
+    /// </summary>
+    /// <param name="script">The block script to compile.</param>
+    /// <param name="workflowId">Workflow ID for disk persistence.</param>
+    /// <returns>True if compilation and persistence succeeded.</returns>
+    public bool CompileForPersistence(BlockScript script, string workflowId)
+    {
+        try
+        {
+            var compiled = _assemblyCompiler.CompileScript(script, workflowId);
+            return compiled != null;
+        }
+        catch (Exception ex)
+        {
+            Log.Warning(ex, "[BlockScriptExecutor] CompileForPersistence failed for workflow {WfId}", workflowId);
+            return false;
+        }
+    }
+
+    /// <summary>
+    /// Preloads all persisted compiled scripts for a workflow from disk
+    /// into the in-memory cache.
+    /// </summary>
+    /// <param name="workflowId">Workflow ID to preload scripts for.</param>
+    /// <returns>Number of scripts successfully loaded.</returns>
+    public int PreloadFromDisk(string workflowId)
+    {
+        return _assemblyCompiler.PreloadFromDisk(workflowId);
+    }
+
     /// <summary>
     /// Executes a block script
     /// </summary>
@@ -100,7 +144,7 @@ public async Task<BlockScriptExecutionResult> ExecuteAsync(
             // On failure, falls back to the existing CSharpScript execution path.
             try
             {
-                var compiled = _assemblyCompiler.CompileScript(script);
+                var compiled = _assemblyCompiler.CompileScript(script, _workflowId);
                 if (compiled != null)
                 {
                     Log.Debug("[BlockScriptExecutor] Using assembly-compiled execution path");

KitX Clients/KitX Core/KitX.Core/Workflow/BlockScripting/CompiledScriptMeta.cs

@@ -0,0 +1,32 @@
+using System;
+
+namespace KitX.Core.Workflow.BlockScripting;
+
+/// <summary>
+/// Metadata for a persisted compiled script assembly on disk.
+/// Stored alongside the .dll as {hash}.meta.json.
+/// </summary>
+internal class CompiledScriptMeta
+{
+    /// <summary>
+    /// Script hash — must match the .dll filename and the in-memory cache key.
+    /// </summary>
+    public string ScriptHash { get; set; } = string.Empty;
+
+    /// <summary>
+    /// UTC timestamp when the assembly was compiled.
+    /// </summary>
+    public DateTime CompileTimeUtc { get; set; } = DateTime.UtcNow;
+
+    /// <summary>
+    /// KitX assembly version at compile time.
+    /// Mismatch triggers re-compilation (API surface may have changed).
+    /// </summary>
+    public string KitXVersion { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Full type name of the compiled script class in the assembly,
+    /// e.g. "KitX.Core.Workflow.BlockScripting.Generated.CompiledScript_1a2b3c4d".
+    /// </summary>
+    public string TypeName { get; set; } = string.Empty;
+}