💾 Feat(Plugin): 新增 IPluginManager 接口及 PluginCallInfo 类，支持插件调用和参数传递；扩展 IWorkflowService 接口以编译和持久化工作流脚本；扩展 IWorkflowStorageService 接口以预加载已编译脚本

Author: StardustSeemsInk

KitX Core Contracts/KitX.Core.Contract/Workflow/IPluginManager.cs

@@ -0,0 +1,39 @@
+namespace KitX.Core.Contract.Workflow;
+
+/// <summary>
+/// 插件管理器接口 - BlockScripting 使用此接口调用插件方法。
+/// Copy of Kscript.CSharp.Parser.Core.IPluginManager for BlockScripting use
+/// without depending on the KCS parser assembly.
+/// 实际实现由外部项目（RealPluginManager）提供。
+/// </summary>
+public interface IPluginManager
+{
+    /// <summary>
+    /// 调用插件方法
+    /// </summary>
+    /// <typeparam name="T">返回值类型</typeparam>
+    /// <param name="callInfo">调用信息</param>
+    /// <returns>插件方法的返回值</returns>
+    T Call<T>(PluginCallInfo callInfo);
+
+    /// <summary>
+    /// 调用插件方法（无返回值）
+    /// </summary>
+    /// <param name="callInfo">调用信息</param>
+    void Call(PluginCallInfo callInfo);
+
+    /// <summary>
+    /// 检查插件是否存在
+    /// </summary>
+    /// <param name="pluginName">插件名称</param>
+    /// <returns>插件是否存在</returns>
+    bool IsPluginExists(string pluginName);
+
+    /// <summary>
+    /// 检查插件方法是否存在
+    /// </summary>
+    /// <param name="pluginName">插件名称</param>
+    /// <param name="methodName">方法名称</param>
+    /// <returns>方法是否存在</returns>
+    bool IsMethodExists(string pluginName, string methodName);
+}

KitX Core Contracts/KitX.Core.Contract/Workflow/IWorkflowService.cs

@@ -165,6 +165,14 @@ Task<BlockScriptExecutionResult> ExecuteBlockScriptAsync(
 public interface IWorkflowService : IWorkflowManagementService, IScriptExecutionService,
     IWorkflowPluginService, IBlockScriptService
 {
+    /// <summary>
+    /// Compiles a workflow's BlockScript into a persisted assembly on disk.
+    /// The compiled assembly is saved under <c>Data/CompiledScripts/{workflowId}/</c>
+    /// and will be reused on subsequent runs instead of recompiling.
+    /// </summary>
+    /// <param name="workflowId">The workflow ID to compile and persist.</param>
+    /// <returns>True if compilation and persistence succeeded.</returns>
+    Task<bool> CompileAndPersistWorkflowAsync(string workflowId);
 }
 
 /// <summary>

KitX Core Contracts/KitX.Core.Contract/Workflow/IWorkflowStorageService.cs

@@ -60,4 +60,11 @@ public interface IWorkflowStorageService
     /// <param name="workflowId">Workflow ID</param>
     /// <returns>Full file path</returns>
     string GetWorkflowFilePath(string workflowId);
+
+    /// <summary>
+    /// Preloads all persisted compiled scripts for discovered workflows from disk
+    /// into the in-memory cache. Called at startup to enable fast first-run execution.
+    /// </summary>
+    /// <returns>Number of scripts successfully loaded.</returns>
+    Task<int> PreloadCompiledScriptsAsync();
 }

KitX Core Contracts/KitX.Core.Contract/Workflow/PluginCallInfo.cs

@@ -0,0 +1,54 @@
+using System;
+
+namespace KitX.Core.Contract.Workflow;
+
+/// <summary>
+/// 插件调用信息，用于传递给 IPluginManager.Call 的参数。
+/// Copy of Kscript.CSharp.Parser.Models.PluginCallInfo for BlockScripting use
+/// without depending on the KCS parser assembly.
+/// </summary>
+public class PluginCallInfo
+{
+    /// <summary>
+    /// 插件名称
+    /// </summary>
+    public string PluginName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 方法名称
+    /// </summary>
+    public string MethodName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 方法参数值数组
+    /// </summary>
+    public object[] Parameters { get; set; } = Array.Empty<object>();
+
+    /// <summary>
+    /// 参数类型数组
+    /// </summary>
+    public Type[] ParameterTypes { get; set; } = Array.Empty<Type>();
+
+    /// <summary>
+    /// 参数名称数组
+    /// </summary>
+    public string[] ParameterNames { get; set; } = Array.Empty<string>();
+
+    public PluginCallInfo()
+    {
+    }
+
+    public PluginCallInfo(string pluginName, string methodName, object[] parameters, Type[] parameterTypes, string[] parameterNames)
+    {
+        PluginName = pluginName;
+        MethodName = methodName;
+        Parameters = parameters;
+        ParameterTypes = parameterTypes;
+        ParameterNames = parameterNames;
+    }
+
+    public override string ToString()
+    {
+        return $"{PluginName}.{MethodName}({string.Join(", ", Parameters)})";
+    }
+}