💾 Feat(Workflow): 添加实时活动日志，仅在调试版本中可见，记录工作流事件

Author: StardustSeemsInk

KitX Dashboard/ViewModels/Pages/WorkflowPageViewModel.cs

@@ -23,6 +23,38 @@ internal class WorkflowPageViewModel : ViewModelBase
     private readonly IWorkflowManagementService _workflowService;
     private readonly IEventService _eventService;
 
+    /// <summary>
+    /// Real-time activity log shown at the bottom of the Workflow page. Only populated
+    /// in Debug builds so Release users get a clean UI. Each entry is a timestamped line.
+    /// Capped at 500 entries (older trimmed) to bound memory.
+    /// </summary>
+#if DEBUG
+    public ObservableCollection<string> ExecutionLog { get; } = new();
+    public bool IsDebugLogVisible => true;
+#else
+    public ObservableCollection<string> ExecutionLog { get; } = new();
+    public bool IsDebugLogVisible => false;
+#endif
+
+    private const int MaxLogEntries = 500;
+
+    /// <summary>
+    /// Appends a timestamped line to <see cref="ExecutionLog"/>. Safe to call from any
+    /// thread; marshals onto the UI thread. No-op unless DEBUG.
+    /// </summary>
+    private void AppendLog(string message)
+    {
+#if DEBUG
+        Avalonia.Threading.Dispatcher.UIThread.Post(() =>
+        {
+            var line = $"[{DateTime.Now:HH:mm:ss.fff}] {message}";
+            ExecutionLog.Add(line);
+            while (ExecutionLog.Count > MaxLogEntries)
+                ExecutionLog.RemoveAt(0);
+        });
+#endif
+    }
+
     public WorkflowPageViewModel()
     {
         _storageService = App.GetService<IWorkflowStorageService>();
@@ -70,6 +102,11 @@ public sealed override void InitCommands()
         {
             await LoadWorkflowsAsync();
         });
+
+        ClearLogCommand = ReactiveCommand.Create(() =>
+        {
+            ExecutionLog.Clear();
+        });
     }
 
     public sealed override void InitEvents()
@@ -138,7 +175,11 @@ private async Task LoadWorkflowsAsync()
             }
 
             WorkflowCases.Add(w);
+            AppendLog($"Mounted workflow '{w.Name}' (id={w.Id}, trigger={w.TriggerType}" +
+                (w.TriggerConfig?.PluginName is { } pn && !string.IsNullOrEmpty(pn)
+                    ? $":{pn}/{w.TriggerConfig.TriggerName}" : "") + ")");
         }
+        AppendLog($"Loaded {workflows.Count} workflow(s)");
     }
 
     /// <summary>
@@ -236,6 +277,7 @@ private async void DeleteWorkflowAsync(IWorkflowCase workflow)
                 await _storageService.DeleteWorkflowAsync(workflow.Id);
                 WorkflowCases.Remove(workflow);
                 _eventService.Publish(EventNames.WorkflowDeleted, EventArgs.Empty);
+                AppendLog($"[Delete] Removed workflow '{workflow.Name}' (id={workflow.Id})");
             }
         }
         catch (Exception ex)
@@ -267,6 +309,8 @@ private async void RunWorkflowAsync(IWorkflowCase workflow)
                     workflow.IsError = true;
                     workflow.ErrorMessage = $"Plugin '{workflow.TriggerConfig.PluginName}' is not connected";
                     RefreshWorkflowInList(workflow);
+                    AppendLog($"[Trigger] '{workflow.Name}' requires plugin " +
+                        $"'{workflow.TriggerConfig.PluginName}' which is NOT connected — trigger not armed");
                     return;
                 }
 
@@ -278,8 +322,14 @@ private async void RunWorkflowAsync(IWorkflowCase workflow)
                 {
                     var triggerManager = KitX.Core.DI.ServiceHost.GetRequiredService<KitX.Core.Contract.Workflow.ITriggerManager>();
                     triggerManager?.RegisterWorkflowTrigger(workflow.Id, workflow.TriggerConfig);
+                    AppendLog($"[Trigger] '{workflow.Name}' armed — fires on " +
+                        $"'{workflow.TriggerConfig.PluginName}/{workflow.TriggerConfig.TriggerName}'");
+                }
+                catch (Exception trigEx)
+                {
+                    AppendLog($"[Trigger] '{workflow.Name}' failed to register trigger: {trigEx.Message}");
+                    /* non-critical */
                 }
-                catch { /* non-critical */ }
 
                 RefreshWorkflowInList(workflow);
             }
@@ -289,6 +339,7 @@ private async void RunWorkflowAsync(IWorkflowCase workflow)
                 workflow.IsError = false;
                 workflow.ErrorMessage = null;
                 RefreshWorkflowInList(workflow);
+                AppendLog($"[Run] Manual run of '{workflow.Name}' (id={workflow.Id}) started");
 
                 // Offload to thread pool to prevent UI deadlock — script execution
                 // may synchronously wait for plugin responses (PluginCall uses
@@ -335,6 +386,8 @@ private async void StopWorkflowAsync(IWorkflowCase workflow)
             workflow.ErrorMessage = null;
             workflow.IsRunning = false;
             RefreshWorkflowInList(workflow);
+            AppendLog($"[Stop] '{workflow.Name}' stopped" +
+                (workflow.TriggerConfig?.TriggerType == "PluginEvent" ? " (trigger disarmed)" : ""));
         }
         catch (Exception ex)
         {
@@ -365,6 +418,7 @@ private void OnWorkflowExecutionResult(object? sender, EventArgs e)
                 if (workflow.TriggerConfig?.TriggerType != "PluginEvent")
                     workflow.IsRunning = false;
                 RefreshWorkflowInList(workflow);
+                AppendLog($"[Done] '{workflow.Name}' completed successfully");
             }
             else
             {
@@ -375,6 +429,7 @@ private void OnWorkflowExecutionResult(object? sender, EventArgs e)
                 if (workflow.TriggerConfig?.TriggerType != "PluginEvent")
                     workflow.IsRunning = false;
                 RefreshWorkflowInList(workflow);
+                AppendLog($"[Error] '{workflow.Name}' failed: {args.ErrorMessage}");
             }
         });
     }
@@ -481,4 +536,7 @@ internal double NoWorkflow_TipHeight
     internal ReactiveCommand<IWorkflowCase, Unit>? StopWorkflowCommand { get; set; }
 
     internal ReactiveCommand<Unit, Unit>? RefreshWorkflowsCommand { get; set; }
+
+    /// <summary>Clears the Debug activity log. Bound from the broom button in the log panel.</summary>
+    internal ReactiveCommand<Unit, Unit>? ClearLogCommand { get; set; }
 }

KitX Dashboard/Views/Pages/WorkflowPage.axaml

@@ -56,6 +56,46 @@
             </StackPanel>
         </Grid>
 
+        <!-- Real-time activity log (Debug builds only).
+             Shows mounted/triggered/run/complete/error events so users can see which
+             workflow fired, when, and why it failed — without digging through Log/. -->
+        <Border DockPanel.Dock="Bottom"
+                Height="160"
+                IsVisible="{Binding IsDebugLogVisible}"
+                BorderBrush="{DynamicResource ControlElevationBorderBrush}"
+                BorderThickness="1,1,0,0"
+                Background="{DynamicResource LayerFillColorDefaultBrush}">
+            <Grid>
+                <Grid.RowDefinitions>
+                    <RowDefinition Height="Auto" />
+                    <RowDefinition Height="*" />
+                </Grid.RowDefinitions>
+                <DockPanel Grid.Row="0" Margin="10,4">
+                    <TextBlock DockPanel.Dock="Left"
+                               FontWeight="SemiBold"
+                               Text="Activity Log (Debug)" />
+                    <Button DockPanel.Dock="Right"
+                            HorizontalAlignment="Right"
+                            Padding="6,2"
+                            Command="{Binding ClearLogCommand}"
+                            ToolTip.Tip="Clear log">
+                        <icon:MaterialIcon Width="14" Height="14" Kind="Broom" />
+                    </Button>
+                </DockPanel>
+                <ListBox Grid.Row="1"
+                         x:Name="ActivityLogList"
+                         Margin="0"
+                         Padding="4,0"
+                         Background="Transparent"
+                         BorderThickness="0"
+                         FontFamily="Cascadia Mono,Consolas,Courier New"
+                         FontSize="11"
+                         ItemsSource="{Binding ExecutionLog}"
+                         ScrollViewer.HorizontalScrollBarVisibility="Auto"
+                         ScrollViewer.VerticalScrollBarVisibility="Auto" />
+            </Grid>
+        </Border>
+
         <DockPanel Margin="10">
             <!-- Empty State -->
             <Border Height="{Binding NoWorkflow_TipHeight}"

KitX Dashboard/Views/Pages/WorkflowPage.axaml.cs

@@ -1,3 +1,4 @@
+using System.Collections.Specialized;
 using Avalonia.Controls;
 using KitX.Dashboard.ViewModels.Pages;
 
@@ -12,5 +13,21 @@ public WorkflowPage()
         InitializeComponent();
 
         DataContext = workflowViewModel;
+
+        // Auto-scroll the activity log to the newest line as items arrive.
+        // Hooking here (rather than in the VM) keeps UI concerns out of the VM and lets
+        // us reach the ListBox's internal ScrollViewer cleanly.
+        if (workflowViewModel.ExecutionLog is INotifyCollectionChanged ncc)
+        {
+            ncc.CollectionChanged += (_, args) =>
+            {
+                if (args.Action == NotifyCollectionChangedAction.Reset) return;
+                if (ActivityLogList?.ItemCount is > 0)
+                {
+                    // Scroll to the last item; Avalonia's ListBox.ScrollIntoView is 0-based.
+                    ActivityLogList.ScrollIntoView(ActivityLogList.ItemCount - 1);
+                }
+            };
+        }
     }
 }