docs: 新增项目知识图谱与新会话自动加载指引

- KNOWLEDGE_GRAPH.md: 架构/实体关系/数据流/WebSocket 协议/设计不变量/构建测试/环境踩坑/路线图
- CLAUDE.md + AGENTS.md: claude 与 Codex 会话自动加载的对接入口
- 记录关键运维约束: 服务端不可在沙盒等受限环境运行(否则 claude 等 TUI 子进程无法写状态)

AGENTS.md

@@ -0,0 +1,18 @@
+# Rtty 项目指引（Codex 会话自动加载）
+
+Rtty 是一个仿 dinotty 的分布式虚拟终端系统，**只保留终端同步能力**：Rust 服务端
+（Axum + portable-pty + alacritty_terminal 真相源）通过 WebSocket 同步到
+Flutter 桌面端（原始 ANSI 渲染）与移动端（语义快照）。
+
+**对接前必读**：
+- [KNOWLEDGE_GRAPH.md](./KNOWLEDGE_GRAPH.md) —— 知识图谱：架构、协议、数据流、不变量、踩坑记录
+- [PROJECT_SUMMARY.md](./PROJECT_SUMMARY.md) —— 项目总览与目录导航
+
+**关键约束**：
+- 服务端 alacritty 引擎是唯一真相源；Raw/快照/重绘帧都在引擎锁内广播（严格有序）
+- 协议见 KNOWLEDGE_GRAPH.md §5；移动端颜色分段 `segments` 是扩展字段
+- 会话空闲 60s 回收；`RTTY_TOKEN` 可选鉴权；桌面端输入走二进制帧
+- 本机 flutter/git 命令需要提权（沙盒外）执行；`PUB_CACHE=C:\Users\NianJiu\AppData\Local\Pub\Cache`
+
+**⚠️ 最重要的一条**：服务端不能在文件写入受限的环境（沙盒）里运行，否则子进程
+（如 claude）无法写入用户状态文件，表现为 TUI 应用确认后卡死/退出。