feat(PushPanel): add /healthz reporting adapter connection state

src/HuaJiBot.NET.Adapter.OneBot/ForwardWebSocketClient.cs

@@ -10,6 +10,8 @@ internal class ForwardWebSocketClient
     private readonly WebsocketClient _client;
     internal readonly OneBotApi Api;
 
+    public bool IsConnected => _client.IsConnected;
+
     public Task StartAsync() => _client.StartAsync();
 
     public ValueTask ConnectAsync() => _client.ConnectAsync();

src/HuaJiBot.NET.Adapter.OneBot/OneBotAdapter.cs

@@ -19,6 +19,8 @@ protected override void ReconnectCore()
 
     protected override Task SetupServiceAsyncCore() => Client.StartAsync();
 
+    public override bool IsConnected => Client.IsConnected;
+
     public override string[] AllRobots => Client.QQ is not null ? [Client.QQ] : [];
 
     public override async Task<string[]> SendGroupMessageAsync(

src/HuaJiBot.NET.Plugin.PushPanel/PanelServer.cs

@@ -14,12 +14,20 @@ internal sealed class PanelServer : IDisposable
     private readonly string _token;
     private readonly ConfigWrapper _config;
     private readonly string _page;
+    private readonly Func<bool> _isConnected;
     private readonly CancellationTokenSource _cts = new();
 
-    public PanelServer(string host, int port, string token, ConfigWrapper config)
+    public PanelServer(
+        string host,
+        int port,
+        string token,
+        ConfigWrapper config,
+        Func<bool>? isConnected = null
+    )
     {
         _token = token;
         _config = config;
+        _isConnected = isConnected ?? (() => true);
         _page = ReadPage();
         _listener.Prefixes.Add($"http://{host}:{port}/");
     }
@@ -81,6 +89,8 @@ private async Task HandleAsync(HttpListenerContext context)
     {
         if (method == "GET" && path is "/" or "/index.html")
             return ServePage;
+        if (method == "GET" && path == "/healthz")
+            return ServeHealth;
         if (path != "/api/rules")
             return null;
         return method switch
@@ -91,6 +101,17 @@ private async Task HandleAsync(HttpListenerContext context)
         };
     }
 
+    // Unauthenticated and public: reports connection state only, nothing from the config.
+    private Task ServeHealth(HttpListenerContext context)
+    {
+        var connected = _isConnected();
+        return WriteJson(
+            context.Response,
+            connected ? 200 : 503,
+            new { status = connected ? "ok" : "disconnected" }
+        );
+    }
+
     private Task ServePage(HttpListenerContext context) =>
         WriteText(context.Response, 200, "text/html; charset=utf-8", _page);
 

src/HuaJiBot.NET.Plugin.PushPanel/PluginMain.cs

@@ -41,7 +41,13 @@ protected override void Initialize()
         }
         try
         {
-            _server = new PanelServer(Config.Host, Config.Port, Config.Token, Service.Config);
+            _server = new PanelServer(
+                Config.Host,
+                Config.Port,
+                Config.Token,
+                Service.Config,
+                () => Service.IsConnected
+            );
             _server.Start();
             Service.Log($"[PushPanel] http://{Config.Host}:{Config.Port}/");
         }

src/HuaJiBot.NET.UnitTest/PushPanelTest.cs

@@ -176,6 +176,30 @@ public async Task Panel_RequiresTokenAndSaves()
         });
     }
 
+    [Test]
+    public async Task Panel_HealthzReportsConnectionWithoutToken()
+    {
+        using var scope = new ConfigScope();
+        var connected = true;
+        var port = FreePort();
+        using var server = new PanelServer("127.0.0.1", port, "panel-secret", scope.Wrapper, () => connected);
+        server.Start();
+        using var http = new HttpClient();
+
+        var up = await http.GetAsync($"http://127.0.0.1:{port}/healthz");
+        connected = false;
+        var down = await http.GetAsync($"http://127.0.0.1:{port}/healthz");
+        var body = await down.Content.ReadAsStringAsync();
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(up.StatusCode, Is.EqualTo(HttpStatusCode.OK));
+            Assert.That(down.StatusCode, Is.EqualTo(HttpStatusCode.ServiceUnavailable));
+            Assert.That(body, Does.Contain("disconnected"));
+            Assert.That(body, Does.Not.Contain("panel-secret"));
+        });
+    }
+
     private static int FreePort()
     {
         var listener = new System.Net.Sockets.TcpListener(IPAddress.Loopback, 0);

src/HuaJiBot.NET/Bot/BotService.cs

@@ -120,6 +120,7 @@ private string AppendSourceInfo(object msg, string? file = null, int? line = nul
     public Config.ConfigWrapper Config { get; internal set; } = null!;
     public abstract IEvents Events { get; }
     public abstract string[] AllRobots { get; }
+    public virtual bool IsConnected => AllRobots.Length > 0;
 
     protected abstract void ReconnectCore();
     protected abstract Task SetupServiceAsyncCore();

src/HuaJiBot.NET/Interfaces/IPluginService.cs

@@ -45,6 +45,9 @@ Func<Task<SendingMessageBase[]>> fallback
     void RecallMessage(string? robotId, string targetGroup, string msgId);
     Task<string[]> FeedbackAt(string? robotId, string targetGroup, string msgId, string text);
     string[] AllRobots { get; }
+
+    /// <summary>Whether the adapter is currently connected to its platform.</summary>
+    bool IsConnected { get; }
     ConfigWrapper Config { get; }
     ILogger Logger { get; }
     IReadOnlyDictionary<string, IEnumerable<AgentFunctionInfo>> ExportFunctions { get; }

src/HuaJiBot.NET/Websocket/WebsocketClient.cs

@@ -71,6 +71,8 @@ public WebsocketClient(
         _client.MessageReceived += OnMessageReceived;
     }
 
+    public bool IsConnected => _client.Connected;
+
     public async Task StartAsync()
     {
         await ConnectAsync();