# 🚀 Rtty 项目设计总结与架构指南

## 📝 一句话描述

> **Rtty 是一款基于 Rust 与 Flutter 构建的高性能、跨平台虚拟终端系统，通过服务端状态保持与多端解耦渲染，实现 PC 端工业级 ANSI 兼容与移动端原生语义化重排。**

---

## 🏗️ 系统整体架构图

```
                       ┌───────────────────────────────┐
                       │   Rtty Server (Rust 后端)     │
                       │  • portable-pty (进程/Shell)  │
                       │  • alacritty_terminal (真相源)│
                       └───────────────┬───────────────┘
                                       │
                         WebSocket (JSON / ANSI 字节流)
                                       │
             ┌─────────────────────────┴─────────────────────────┐
             ▼                                                   ▼
┌───────────────────────────────┐               ┌───────────────────────────────┐
│   Rtty Desktop (PC 客户端)    │               │   Rtty Mobile (移动客户端)    │
│  • flutter_alacritty (FFI)    │               │  • Flutter Native Controls    │
│  • Canvas 经典 ANSI 网格      │               │  • ListView + RichText 重排   │
│  • 100% 工业级 ANSI 兼容       │               │  • 自适应换行 / 卡片化 UI     │
└───────────────────────────────┘               └───────────────────────────────┘

```

---

## 🛠️ 核心组件与职责划分

### 1. **服务端内核 (`rtty-server`)**

* **`portable-pty`**：负责底层的 POSIX/Windows 伪终端创建、子进程（Shell/Bash/Zsh）拉起与文件描述符读写。
* **`alacritty_terminal`**：作为整个系统的“真相源 (Source of Truth)”，在内存中实时解析 ANSI 序列，维护 2D 屏幕网格（Grid）、光标位置及历史回滚缓冲区，同时提供断线重连时的快照恢复（Dump Screen Snapshot）。
* **`WebSocket (Axum/Tokio)`**：负责与各终端建立双向实时通信，分发事件流与控制信号。

### 2. **桌面端渲染管线 (`rtty-desktop`)**

* **`flutter_alacritty` (Rust FFI 绑定)**：PC 端放弃纯 Dart 的轻量级解析，直接调用本地 C-Bindings 共享 `alacritty_terminal` 的 Rust 渲染引擎。
* **渲染特性**：Canvas 纯网格高效绘制，保持对 `vim`、`htop`、`tmux` 等全屏 ANSI 软件的 100% 工业级兼容与真彩显示。

### 3. **移动端渲染管线 (`rtty-mobile`)**

* **Flutter Native 组件重排**：移动端抛弃传统 2D 字符网格，采用语义化数据拆解。
* **渲染特性**：
* **命令与输出**：封装为 `ListView` 卡片，支持文本按词软换行（Word Wrap），彻底消除横向滚动条与小字号看不清的痛点。
* **键盘与交互**：吸底 Command Input 配合移动端专属快捷键工具栏（Keybar）。



---

## 💡 Rtty 的三大核心设计优势

1. **状态与渲染解耦**：服务端 Rust 负责维持单一终端状态，客户端按平台特性自由渲染。
2. **前后端内核统一**：后端与 PC 端共享 `alacritty_terminal` 引擎，解析行为 100% 绝对一致。
3. **移动端体验革新**：告别画面缩放与 TUI 错乱，用 Native UI 呈现命令行数据。