feat: replace xterm with flutter_alacritty for true industrial-grade rendering

desktop/README.md

@@ -1,23 +1,29 @@
 # Rtty Desktop (桌面端)
 
-Rtty 的 Flutter Windows 桌面终端客户端。连接 `rtty-server`（Rust 后端），消费
-服务端下发的**原始 ANSI 二进制帧**，通过 `xterm`（Dart 版 xterm.js）做工业级
-ANSI 渲染，保证对 vim / htop / tmux 等全屏软件 100% 兼容。
+Rtty 的 Flutter Windows 桌面终端客户端。连接 `rtty-server`（Rust 后端），通过
+**`flutter_alacritty`**（Alacritty Rust 引擎的 Flutter 绑定）做 **100% 工业级
+ANSI 渲染**，完美支持 vim / neovim / htop / tmux 等全屏 TUI 应用。
 
 ## 架构
 
 ```
-rtty-server (Rust)
-    │  WebSocket (ws://host:8080/ws)
-    │   • JSON 控制帧 (ready / snapshot / control / error)
-    │   • 二进制帧 = 原始 ANSI 字节流 (PC 端渲染)
+rtty-server (Rust, alacritty_terminal 真相源)
+    │  WebSocket (ws://host:8080/ws?client=desktop)
+    │   • JSON 控制帧 (ready / error / session_closed)
+    │   • 二进制帧 = 原始 ANSI 字节流
     ▼
 rtty-desktop (Flutter / Windows)
-    • RttyClient   —— WebSocket 连接管理 + 协议解析
-    • Terminal     —— xterm 终端网格 / ANSI 解析
-    • ConnectionBar —— 顶部连接控制条
+    • RttyPtyBackend  —— 实现 flutter_alacritty 的 PtyBackend 接口，桥接 WebSocket
+    • TerminalEngine  —— Alacritty Rust 引擎（解析 ANSI / 维护网格 / GPU 渲染）
+    • TerminalView    —— 终端渲染 + 输入/剪贴板/滚动
+    • ConnectionBar   —— 顶部连接控制条
 ```
 
+关键点：`PtyBackend` 抽象正是 `flutter_alacritty` 为远程（WebSocket/SSH）数据源
+预留的扩展点。本地版用 `FlutterPtyBackend`（自带 PTY），本项目用自定义
+`RttyPtyBackend` 把 WebSocket 原始 ANSI 流接入引擎，实现"远程 PTY + 本地
+alacritty 渲染"，服务端与 PC 端共享同一 Alacritty 引擎。
+
 ## 运行
 
 ```bash
@@ -32,6 +38,7 @@ flutter run -d windows
 ## 构建
 
 ```bash
+# release 会连同 Alacritty Rust 引擎一起编译（首次较慢）
 flutter build windows --release
 # 产物：build/windows/x64/runner/Release/rtty_desktop.exe
 ```
@@ -42,14 +49,15 @@ flutter build windows --release
 # Widget 测试（无需服务端）
 flutter test test/widget_test.dart
 
-# 端到端集成测试（需先启动 Rust 服务端）
+# 端到端集成测试（需先启动 Rust 服务端；离线时自动跳过）
 flutter test test/e2e_ws_test.dart
+flutter test test/regression_ws_test.dart
 ```
 
 ## 协议要点
 
-- 连接 `ws://host:port/ws`（可选 `?session=<id>` 复用会话）。
-- 服务端 `ready` 帧携带会话 ID 与初始尺寸，驱动 xterm 网格。
-- PTY 输出以二进制帧下发，桌面端直接喂给 xterm 渲染。
-- 键盘输入与终端回写经 `{"type":"input","data":...}` 发回服务端写入 PTY。
-- 窗口尺寸变化时发送 `{"type":"resize","cols":..,"rows":..}` 同步网格。
+- 连接 `ws://host:port/ws?client=desktop`（`client` 声明端类型，实现多端解耦）。
+- 服务端 `ready` 帧携带会话 ID 与初始尺寸，驱动引擎网格。
+- PTY 输出以二进制帧下发，经 `RttyPtyBackend.output` 喂给引擎渲染。
+- 键盘输入由引擎产生，经 `RttyPtyBackend.write` 发回服务端写入远端 PTY。
+- 窗口尺寸变化经 `TerminalView.onPtyResize` → `RttyPtyBackend.resize` 同步。