[Pull Request] Dev=UI separate si

KitX Contracts/KitX.Contract.CSharp/TriggerHelper.cs

@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using System.Text.Json;
+using KitX.Shared.CSharp.WebCommand;
+using KitX.Shared.CSharp.WebCommand.Infos;
+
+namespace KitX.Contract.CSharp;
+
+/// <summary>
+/// 插件触发器辅助工具。插件通过此类发送触发信号到 Dashboard。
+/// 触发器是纯信号，不携带业务数据。工作流被触发后通过调用插件函数获取数据。
+/// </summary>
+public static class TriggerHelper
+{
+    private static readonly JsonSerializerOptions _options = new()
+    {
+        WriteIndented = false,
+        IncludeFields = true,
+        PropertyNameCaseInsensitive = true,
+    };
+
+    /// <summary>
+    /// 触发一个信号事件
+    /// </summary>
+    /// <param name="sendAction">SetSendCommandAction 提供的发送回调</param>
+    /// <param name="triggerName">触发器名称</param>
+    public static void FireTrigger(Action<Request>? sendAction, string triggerName)
+    {
+        if (sendAction is null) return;
+
+        var request = new Request
+        {
+            Type = RequestTypes.Command,
+            Version = RequestVersions.V1,
+            Content = JsonSerializer.Serialize(new Command
+            {
+                Request = CommandRequestInfo.TriggerFired,
+                Tags = new Dictionary<string, string> { { "TriggerName", triggerName } }
+            }, _options)
+        };
+
+        sendAction.Invoke(request);
+    }
+}

KitX Core Contracts/KitX.Core.Contract/Activity/IActivityService.cs

@@ -0,0 +1,93 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Threading.Tasks;
+
+namespace KitX.Core.Contract.Activity;
+
+/// <summary>
+/// Activity management service interface
+/// </summary>
+public interface IActivityService
+{
+    /// <summary>
+    /// Records app start event
+    /// </summary>
+    void RecordAppStart();
+
+    /// <summary>
+    /// Records app exit event
+    /// </summary>
+    void RecordAppExit();
+
+    /// <summary>
+    /// Records an activity
+    /// </summary>
+    /// <param name="type">The activity type</param>
+    /// <param name="details">Optional details</param>
+    void RecordActivity(string type, Dictionary<string, object>? details = null);
+
+    /// <summary>
+    /// Gets activities
+    /// </summary>
+    /// <param name="startDate">Optional start date</param>
+    /// <param name="endDate">Optional end date</param>
+    /// <param name="limit">Maximum number of activities to return</param>
+    /// <returns>List of activities</returns>
+    IList<IActivity> GetActivities(DateTime? startDate = null, DateTime? endDate = null, int limit = 100);
+
+    /// <summary>
+    /// Gets activity statistics
+    /// </summary>
+    /// <param name="startDate">Start date</param>
+    /// <param name="endDate">End date</param>
+    /// <returns>Activity statistics</returns>
+    IActivityStatistics GetStatistics(DateTime startDate, DateTime endDate);
+
+    /// <summary>
+    /// Event raised when activities are updated
+    /// </summary>
+    event EventHandler? ActivitiesUpdated;
+}
+
+/// <summary>
+/// Activity interface
+/// </summary>
+public interface IActivity
+{
+    /// <summary>
+    /// Gets the activity ID
+    /// </summary>
+    string Id { get; }
+
+    /// <summary>
+    /// Gets the activity type
+    /// </summary>
+    string Type { get; }
+
+    /// <summary>
+    /// Gets the timestamp
+    /// </summary>
+    DateTime Timestamp { get; }
+
+    /// <summary>
+    /// Gets the details
+    /// </summary>
+    Dictionary<string, object> Details { get; }
+}
+
+/// <summary>
+/// Activity statistics interface
+/// </summary>
+public interface IActivityStatistics
+{
+    /// <summary>
+    /// Gets the total number of activities
+    /// </summary>
+    int TotalActivities { get; }
+
+    /// <summary>
+    /// Gets the activities grouped by type
+    /// </summary>
+    Dictionary<string, int> ActivitiesByType { get; }
+}

KitX Core Contracts/KitX.Core.Contract/Announcement/IAnnouncementService.cs

@@ -0,0 +1,109 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Threading.Tasks;
+using KitX.Core.Contract.Configuration;
+
+namespace KitX.Core.Contract.Announcement;
+
+/// <summary>
+/// Announcement service interface
+/// </summary>
+public interface IAnnouncementService
+{
+    /// <summary>
+    /// Gets the announcement configuration
+    /// </summary>
+    IAnnouncementConfig AnnouncementConfig { get; }
+
+    /// <summary>
+    /// Checks for new announcements
+    /// </summary>
+    /// <returns>List of new announcements</returns>
+    Task<IReadOnlyList<IAnnouncement>> CheckNewAnnouncementsAsync();
+
+    /// <summary>
+    /// Marks an announcement as read
+    /// </summary>
+    /// <param name="announcementId">The announcement ID</param>
+    void MarkAsRead(string announcementId);
+
+    /// <summary>
+    /// Gets all read announcement IDs
+    /// </summary>
+    /// <returns>List of read announcement IDs</returns>
+    IReadOnlyList<string> GetReadAnnouncementIds();
+
+    /// <summary>
+    /// Saves the announcement configuration
+    /// </summary>
+    void SaveAnnouncementConfig();
+
+    /// <summary>
+    /// Event raised when new announcements are available
+    /// </summary>
+    event EventHandler<NewAnnouncementsEventArgs>? NewAnnouncementsAvailable;
+}
+
+/// <summary>
+/// Announcement interface
+/// </summary>
+public interface IAnnouncement
+{
+    /// <summary>
+    /// Gets the announcement ID
+    /// </summary>
+    string Id { get; }
+
+    /// <summary>
+    /// Gets the announcement title
+    /// </summary>
+    string Title { get; }
+
+    /// <summary>
+    /// Gets the announcement content
+    /// </summary>
+    string Content { get; }
+
+    /// <summary>
+    /// Gets the publish date
+    /// </summary>
+    DateTime PublishDate { get; }
+
+    /// <summary>
+    /// Gets the version
+    /// </summary>
+    string Version { get; }
+}
+
+/// <summary>
+/// New announcements event arguments
+/// </summary>
+public class NewAnnouncementsEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the announcements
+    /// </summary>
+    public IReadOnlyList<IAnnouncement> Announcements { get; set; } = Array.Empty<IAnnouncement>();
+
+    /// <summary>
+    /// Gets or sets announcements as dictionary (date -> content)
+    /// </summary>
+    public Dictionary<string, string>? AnnouncementsDict { get; set; }
+}
+
+/// <summary>
+/// Announcement error event arguments
+/// </summary>
+public class AnnouncementErrorEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the error message
+    /// </summary>
+    public string ErrorMessage { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the stack trace
+    /// </summary>
+    public string StackTrace { get; set; } = string.Empty;
+}

KitX Core Contracts/KitX.Core.Contract/Configuration/ConfigChangedEventArgs.cs

@@ -0,0 +1,29 @@
+using System;
+
+namespace KitX.Core.Contract.Configuration;
+
+/// <summary>
+/// Configuration changed event arguments
+/// </summary>
+public class ConfigChangedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the configuration type (e.g., "App", "Plugins", "Security")
+    /// </summary>
+    public string ConfigType { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the property name that changed
+    /// </summary>
+    public string PropertyName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// Gets or sets the old value
+    /// </summary>
+    public object? OldValue { get; set; }
+
+    /// <summary>
+    /// Gets or sets the new value
+    /// </summary>
+    public object? NewValue { get; set; }
+}

KitX Core Contracts/KitX.Core.Contract/Configuration/IActivityConfig.cs

@@ -0,0 +1,9 @@
+namespace KitX.Core.Contract.Configuration;
+
+/// <summary>
+/// Activity configuration section
+/// </summary>
+public interface IActivityConf
+{
+    int TotalRecorded { get; set; }
+}

KitX Core Contracts/KitX.Core.Contract/Configuration/IAnnouncementConfig.cs

@@ -0,0 +1,16 @@
+using System.Collections.Generic;
+
+namespace KitX.Core.Contract.Configuration;
+
+public interface IAnnouncementConfig
+{
+    /// <summary>
+    /// Gets or sets the list of accepted announcement IDs
+    /// </summary>
+    List<string> Accepted { get; set; }
+
+    /// <summary>
+    /// Gets or sets the config file location
+    /// </summary>
+    string? ConfigFileLocation { get; set; }
+}

KitX Core Contracts/KitX.Core.Contract/Configuration/IAppConfig.cs

@@ -0,0 +1,68 @@
+using System.Collections.Generic;
+
+namespace KitX.Core.Contract.Configuration;
+
+/// <summary>
+/// Application configuration interface (complete structure)
+/// </summary>
+public interface IAppConfig
+{
+    /// <summary>
+    /// Gets or sets the application configuration
+    /// </summary>
+    IAppConf App { get; set; }
+
+    /// <summary>
+    /// Gets or sets the windows configuration
+    /// </summary>
+    IWindowsConf Windows { get; set; }
+
+    /// <summary>
+    /// Gets or sets the pages configuration
+    /// </summary>
+    IPagesConf Pages { get; set; }
+
+    /// <summary>
+    /// Gets or sets the web configuration
+    /// </summary>
+    IWebConf Web { get; set; }
+
+    /// <summary>
+    /// Gets or sets the log configuration
+    /// </summary>
+    ILogConf Log { get; set; }
+
+    /// <summary>
+    /// Gets or sets the IO configuration
+    /// </summary>
+    IIOConf IO { get; set; }
+
+    /// <summary>
+    /// Gets or sets the activity configuration
+    /// </summary>
+    IActivityConf Activity { get; set; }
+
+    /// <summary>
+    /// Gets or sets the loaders configuration
+    /// </summary>
+    ILoadersConf Loaders { get; set; }
+}
+
+/// <summary>
+/// Application configuration section
+/// </summary>
+public interface IAppConf
+{
+    string IconFileName { get; set; }
+    string CoverIconFileName { get; set; }
+    string AppLanguage { get; set; }
+    string Theme { get; set; }
+    string ThemeColor { get; set; }
+    Dictionary<string, string> SurpportLanguages { get; set; }
+    string LocalPluginsFileFolder { get; set; }
+    string LocalPluginsDataFolder { get; set; }
+    bool DeveloperSetting { get; set; }
+    bool ShowAnnouncementWhenStart { get; set; }
+    ulong RanTime { get; set; }
+    int LastBreakAfterExit { get; set; }
+}

KitX Core Contracts/KitX.Core.Contract/Configuration/IConfigLoader.cs

@@ -0,0 +1,21 @@
+namespace KitX.Core.Contract.Configuration;
+
+/// <summary>
+/// Loads configuration from files
+/// </summary>
+public interface IConfigLoader
+{
+    /// <summary>
+    /// Loads a config file from the specified location
+    /// </summary>
+    /// <typeparam name="T">Config type</typeparam>
+    /// <param name="location">Directory path</param>
+    /// <param name="fileName">File name</param>
+    /// <returns>The loaded config or default</returns>
+    T Load<T>(string location, string fileName) where T : class, new();
+
+    /// <summary>
+    /// Loads SecurityConfig with special handling
+    /// </summary>
+    ISecurityConfig LoadSecurityConfig(string location);
+}