✨ feat(fanuc): 添加协议编解码与状态页" -m "* 固化 10010 状态帧、10012 命令帧和 60015 J519 包编解码

* 扩展 ControllerClient 兼容层的执行参数和运行时编排
  * 新增 /status 页面与 /api/status/snapshot 状态快照接口
  * 补充 FANUC 协议、客户端和状态接口的最小验证测试
  * 更新 README、兼容要求和真机 Socket 通信实现计划

tests/Flyshot.Server.IntegrationTests/StatusEndpointTests.cs

@@ -0,0 +1,91 @@
+using System.Net;
+using System.Net.Http.Json;
+using System.Text.Json;
+
+namespace Flyshot.Server.IntegrationTests;
+
+/// <summary>
+/// 验证状态监控页面和状态快照 API 能读取当前 ControllerClient 兼容层状态。
+/// </summary>
+public sealed class StatusEndpointTests(FlyshotServerFactory factory) : IClassFixture<FlyshotServerFactory>
+{
+    /// <summary>
+    /// 验证状态页返回可由浏览器直接打开的 HTML，并引用状态快照 API。
+    /// </summary>
+    [Fact]
+    public async Task GetStatusPage_ReturnsMonitoringHtml()
+    {
+        using var client = factory.CreateClient();
+
+        using var response = await client.GetAsync("/status");
+
+        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
+        Assert.StartsWith("text/html", response.Content.Headers.ContentType?.MediaType);
+
+        var html = await response.Content.ReadAsStringAsync();
+        Assert.Contains("Flyshot Replacement 状态监控", html, StringComparison.Ordinal);
+        Assert.Contains("/api/status/snapshot", html, StringComparison.Ordinal);
+    }
+
+    /// <summary>
+    /// 验证状态快照 API 会返回运行时连接、使能、速度和机器人元数据。
+    /// </summary>
+    [Fact]
+    public async Task GetStatusSnapshot_ReturnsRuntimeStateAfterLegacyInitialization()
+    {
+        using var client = factory.CreateClient();
+        await InitializeRobotAsync(client);
+
+        using (var speedResponse = await client.PostAsJsonAsync("/set_speedRatio/", new { speed = 0.75 }))
+        {
+            Assert.Equal(HttpStatusCode.OK, speedResponse.StatusCode);
+        }
+
+        using var response = await client.GetAsync("/api/status/snapshot");
+
+        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
+
+        await using var responseStream = await response.Content.ReadAsStreamAsync();
+        using var json = await JsonDocument.ParseAsync(responseStream);
+        var root = json.RootElement;
+        var snapshot = root.GetProperty("snapshot");
+
+        Assert.Equal("ok", root.GetProperty("status").GetString());
+        Assert.True(root.GetProperty("isSetup").GetBoolean());
+        Assert.Equal("FANUC_LR_Mate_200iD", root.GetProperty("robotName").GetString());
+        Assert.Equal(6, root.GetProperty("degreesOfFreedom").GetInt32());
+        Assert.Empty(root.GetProperty("uploadedTrajectories").EnumerateArray());
+        Assert.Equal("Connected", snapshot.GetProperty("connectionState").GetString());
+        Assert.True(snapshot.GetProperty("isEnabled").GetBoolean());
+        Assert.False(snapshot.GetProperty("isInMotion").GetBoolean());
+        Assert.Equal(0.75, snapshot.GetProperty("speedRatio").GetDouble(), precision: 6);
+        Assert.Equal(6, snapshot.GetProperty("jointPositions").GetArrayLength());
+    }
+
+    /// <summary>
+    /// 初始化旧 HTTP 兼容链路，使状态页可以读取一个完整的已连接状态。
+    /// </summary>
+    /// <param name="client">测试 HTTP 客户端。</param>
+    private static async Task InitializeRobotAsync(HttpClient client)
+    {
+        using (var setupResponse = await client.PostAsync("/setup_robot/?robot_name=FANUC_LR_Mate_200iD", content: null))
+        {
+            Assert.Equal(HttpStatusCode.OK, setupResponse.StatusCode);
+        }
+
+        using (var activeControllerResponse = await client.PostAsync("/set_active_controller/?sim=true", content: null))
+        {
+            Assert.Equal(HttpStatusCode.OK, activeControllerResponse.StatusCode);
+        }
+
+        using (var connectRobotResponse = await client.PostAsync("/connect_robot/?ip=192.168.10.101", content: null))
+        {
+            Assert.Equal(HttpStatusCode.OK, connectRobotResponse.StatusCode);
+        }
+
+        using (var enableRobotResponse = await client.GetAsync("/enable_robot/"))
+        {
+            Assert.Equal(HttpStatusCode.OK, enableRobotResponse.StatusCode);
+        }
+    }
+}