💾 Feat(DeviceService): 添加设备登录状态检查、获取设备令牌及已登录设备列表功能；新增 ServerStatus 枚举

💾 Feat(Plugin): 新增插件连接接口及相关事件，支持插件连接状态管理和消息处理

Author: StardustSeemsInk

KitX Core Contracts/KitX.Core.Contract/Device/IDeviceService.cs

@@ -126,6 +126,26 @@ public interface IDeviceServer
     /// Stops the device server
     /// </summary>
     void Stop();
+
+    /// <summary>
+    /// Checks if a device is signed in
+    /// </summary>
+    /// <param name="locator">The device locator</param>
+    /// <returns>True if the device is signed in</returns>
+    bool IsDeviceSignedIn(KitX.Shared.CSharp.Device.DeviceLocator locator);
+
+    /// <summary>
+    /// Gets the signed device token for a device locator
+    /// </summary>
+    /// <param name="locator">The device locator</param>
+    /// <returns>The token or null if not found</returns>
+    string? GetDeviceToken(KitX.Shared.CSharp.Device.DeviceLocator locator);
+
+    /// <summary>
+    /// Gets all signed-in device locators
+    /// </summary>
+    /// <returns>Read-only list of signed-in device locators</returns>
+    System.Collections.Generic.IReadOnlyList<KitX.Shared.CSharp.Device.DeviceLocator> GetSignedInDevices();
 }
 
 /// <summary>

KitX Core Contracts/KitX.Core.Contract/Device/ServerStatus.cs

@@ -0,0 +1,13 @@
+namespace KitX.Core.Contract.Device;
+
+/// <summary>
+/// Server status enumeration
+/// </summary>
+public enum ServerStatus
+{
+    Pending,
+    Starting,
+    Running,
+    Stopping,
+    Errored
+}

KitX Core Contracts/KitX.Core.Contract/Plugin/Events/PluginEventArgs.cs

@@ -81,4 +81,42 @@ public class PluginUnregisteredEventArgs : EventArgs
     /// Gets or sets the plugin info
     /// </summary>
     public PluginInfo? PluginInfo { get; set; }
+}
+
+/// <summary>
+/// Plugin connected event arguments
+/// </summary>
+public class PluginConnectedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the connection ID
+    /// </summary>
+    public string? ConnectionId { get; set; }
+}
+
+/// <summary>
+/// Plugin disconnected event arguments
+/// </summary>
+public class PluginDisconnectedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the connection ID
+    /// </summary>
+    public string? ConnectionId { get; set; }
+}
+
+/// <summary>
+/// Plugin message received event arguments
+/// </summary>
+public class PluginMessageReceivedEventArgs : EventArgs
+{
+    /// <summary>
+    /// Gets or sets the connection ID
+    /// </summary>
+    public string? ConnectionId { get; set; }
+
+    /// <summary>
+    /// Gets or sets the message
+    /// </summary>
+    public string? Message { get; set; }
 }

KitX Core Contracts/KitX.Core.Contract/Plugin/IPluginConnection.cs

@@ -0,0 +1,48 @@
+using System;
+using KitX.Shared.CSharp.Plugin;
+using KitX.Core.Contract.Device;
+using CTask = System.Threading.Tasks.Task;
+
+namespace KitX.Core.Contract.Plugin;
+
+/// <summary>
+/// Plugin connection interface
+/// </summary>
+public interface IPluginConnection : IPluginConnector
+{
+    /// <summary>
+    /// Gets or sets the plugin info
+    /// </summary>
+    new PluginInfo? PluginInfo { get; set; }
+
+    /// <summary>
+    /// Gets the connection status
+    /// </summary>
+    ServerStatus Status { get; }
+
+    /// <summary>
+    /// Event raised when a message is received
+    /// </summary>
+    event EventHandler<string>? MessageReceived;
+
+    /// <summary>
+    /// Event raised when connection is closed
+    /// </summary>
+    event EventHandler? Closed;
+
+    /// <summary>
+    /// Initializes the connection
+    /// </summary>
+    void Initialize();
+
+    /// <summary>
+    /// Sends a message
+    /// </summary>
+    /// <param name="message">The message to send</param>
+    void Send(string message);
+
+    /// <summary>
+    /// Closes the connection
+    /// </summary>
+    CTask CloseAsync();
+}

KitX Core Contracts/KitX.Core.Contract/Plugin/IPluginConnector.cs

@@ -12,7 +12,7 @@ public interface IPluginConnector
     /// <summary>
     /// Gets the connection ID
     /// </summary>
-    string ConnectionId { get; }
+    string? ConnectionId { get; }
 
     /// <summary>
     /// Gets the plugin info

KitX Core Contracts/KitX.Core.Contract/Plugin/IPluginServer.cs

@@ -18,7 +18,7 @@ public interface IPluginServer
     /// <summary>
     /// Gets the list of currently connected plugins
     /// </summary>
-    IReadOnlyList<IPluginConnector> Connections { get; }
+    IReadOnlyList<IPluginConnection> Connections { get; }
 
     /// <summary>
     /// Starts the plugin server
@@ -38,11 +38,33 @@ public interface IPluginServer
     /// <returns>The plugin connector or null if not found</returns>
     IPluginConnector? FindConnector(PluginInfo pluginInfo);
 
+    /// <summary>
+    /// Finds a connection by connection ID
+    /// </summary>
+    /// <param name="connectionId">The connection ID</param>
+    /// <returns>The plugin connection or null if not found</returns>
+    IPluginConnection? FindConnection(string connectionId);
+
     /// <summary>
     /// Event raised when server port changes
     /// </summary>
     event EventHandler<int>? PortChanged;
 
+    /// <summary>
+    /// Event raised when a plugin connects
+    /// </summary>
+    event EventHandler<PluginConnectedEventArgs>? PluginConnected;
+
+    /// <summary>
+    /// Event raised when a plugin disconnects
+    /// </summary>
+    event EventHandler<PluginDisconnectedEventArgs>? PluginDisconnected;
+
+    /// <summary>
+    /// Event raised when a plugin message is received
+    /// </summary>
+    event EventHandler<PluginMessageReceivedEventArgs>? PluginMessageReceived;
+
     /// <summary>
     /// Event raised when a plugin registers with the server
     /// </summary>
@@ -52,4 +74,9 @@ public interface IPluginServer
     /// Event raised when a plugin unregisters/disconnects from the server
     /// </summary>
     event EventHandler<PluginUnregisteredEventArgs>? PluginUnregistered;
+
+    /// <summary>
+    /// Event raised when a plugin sends a response (has RequestId)
+    /// </summary>
+    event EventHandler<PluginResponseEventArgs>? PluginResponse;
 }