CORE · ARCHITECTURE
终端状态只有一个权威来源。
控制序列在服务端解释一次，客户端复制经过验证的语义状态。这个约束让断线恢复、多端显示和历史分页共享同一套事实。
状态链路
PTY bytes→TerminalEngine→State v2→Replica→Renderer
核心对象
- Workspace
- 服务端持久资源容器，组织多个 Terminal。
- Terminal
- 长期持有 PTY、进程和权威终端引擎。
- Attachment
- 一次设备订阅，携带角色、状态与 fencing 身份。
- Worker
- Managed 模式下按 Unix UID 隔离的长期降权进程。
职责边界
| 位置 | 负责 |
|---|---|
| 服务端 | PTY、VT 解释、语义 Cell、历史、租约和资源准入 |
| Apple 客户端 | Replica、原生渲染、本地标签布局和设备级可见性 |
| 传输层 | TLS 1.3、认证、能力协商与独立 Stream |
传输组织
一条 QUIC 连接可以承载控制请求、Terminal Attachment 与 Files/1。相互独立的 Stream 避免文件传输或慢请求阻塞终端交互。