💾 Feat(Blueprint): 添加 BuiltinFunctionNode 类型及其在 INodeRegistry 中的创建方法

Author: StardustSeemsInk

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

@@ -88,7 +88,13 @@ public enum BlueprintNodeType
     /// Variable declaration node (ConstBlock variables without initial values).
     /// A floating node with no ports — users can only change the data type.
     /// </summary>
-    Variable
+    Variable,
+
+    /// <summary>
+    /// 通用内置函数节点。通过 <c>BuiltinFunctionNode.FunctionName</c> 区分具体函数。
+    /// 新的内置函数统一使用此类型，无需为每个函数创建专用 enum 值。
+    /// </summary>
+    BuiltinFunction
 }
 
 /// <summary>
@@ -207,6 +213,7 @@ public class BlueprintPin
 [JsonDerivedType(typeof(PrintNode), "Print")]
 [JsonDerivedType(typeof(PauseNode), "Pause")]
 [JsonDerivedType(typeof(VariableNode), "Variable")]
+[JsonDerivedType(typeof(BuiltinFunctionNode), "BuiltinFunction")]
 public abstract class BlueprintNode
 {
     /// <summary>
@@ -655,6 +662,46 @@ public VariableNode()
     public override string GetDisplayTitle() => $"Var: {VarName}";
 }
 
+/// <summary>
+/// 通用内置函数节点。通过 <see cref="FunctionName"/> 区分具体函数。
+/// 引脚布局由 <see cref="IBuiltinFunctionDefinition"/> 驱动，
+/// 消除了为每个内置函数创建专用节点子类的需要。
+/// </summary>
+public class BuiltinFunctionNode : BlueprintNode
+{
+    /// <summary>
+    /// BlockScript 函数名（如 "Flip"），作为具体函数的唯一标识
+    /// </summary>
+    public string FunctionName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 额外属性字典，用于特殊节点（如 Set 的 VarName、Get 的 VarName）
+    /// </summary>
+    public Dictionary<string, string> Properties { get; set; } = [];
+
+    private NodeDescriptor? _descriptor;
+
+    /// <summary>
+    /// 由 BuiltinFunctionRegistry 在创建节点时设置，基于 IBuiltinFunctionDefinition 的引脚描述
+    /// </summary>
+    public void SetDescriptor(NodeDescriptor descriptor) => _descriptor = descriptor;
+
+    public override NodeDescriptor GetDescriptor() => _descriptor ?? new(
+        Width: 120, Height: 60,
+        InputPins: [],
+        OutputPins: [],
+        DisplayName: FunctionName
+    );
+
+    public BuiltinFunctionNode()
+    {
+        NodeType = BlueprintNodeType.BuiltinFunction;
+        Name = "BuiltinFunction";
+    }
+
+    public override string GetDisplayTitle() => FunctionName;
+}
+
 /// <summary>
 /// Connection between two pins
 /// </summary>

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

@@ -25,4 +25,14 @@ public interface INodeRegistry
     /// Returns all registered node types.
     /// </summary>
     IReadOnlySet<BlueprintNodeType> RegisteredTypes { get; }
+
+    /// <summary>
+    /// Creates a <see cref="BuiltinFunctionNode"/> pre-configured from an
+    /// <see cref="IBuiltinFunctionDefinition"/>. The node's pins, dimensions,
+    /// and display name are all driven by the definition.
+    /// </summary>
+    /// <param name="functionName">The built-in function name (must be registered in BuiltinFunctionRegistry)</param>
+    /// <returns>A fully configured BuiltinFunctionNode</returns>
+    /// <exception cref="ArgumentException">Thrown when the function name is not registered</exception>
+    BlueprintNode CreateBuiltinFunctionNode(string functionName);
 }