初始提交：terminalX 可运行态（M0/M1/M1.5 已真机验证）

- M0: libghostty SSH 终端（渲染/输入/连接）+ 白屏修复(OutputGate) + 会话状态机/自动重连
- M1: tsnet 用户态组网 + SSH-over-tsnet(fd 桥)，shell 级真机验证；R5(Go+gvisor+C+++Swift 同进程) retire
- M1.5: tmux -CC 原生 tab（MVP）
- 结构: packages/(TXCore·TXTransport), apps/TerminalX, vendor/(libghostty-spm/libssh2/mbedtls/tsnet-bridge), artifacts/
- 文档: CLAUDE.md + docs/HANDOFF.md（新会话入口）
- 环境: 认证代理→依赖 vendor 本地化；Go 在 ~/.local/go；仅模拟器/未签名
- 待续: M2 mosh, tmux 多 pane, M4 安全(host key/SE)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,36 @@
+# terminalX
+
+原生苹果生态终端运维 / vibe coding 工具。平台优先级：**iPadOS > iOS > macOS(Apple Silicon)**。
+
+核心选型：**libghostty**(终端引擎) · **mosh** · **Tailscale (tsnet 用户态)** · **tmux control mode hook**。
+
+> 设计与决策见 `docs/`（若缺失，参见会话记忆 / 架构蓝图）。当前处于 **M0**（骨架 + 引擎 + libssh2 直连），走 SSH-first 路线。
+
+## 仓库结构
+
+```
+packages/      纯 Swift SPM 包（源码构建，依赖只向下）
+  TXCore       零依赖：模型 / 状态机 / 协议 / 纯算法（含 tmux control-mode 解析器）
+  TXTransport  SSH(libssh2) 引导 · mosh 驱动 · UDP relay · 连接编排        [M1+]
+  TXTailnet    tsnet 多节点 · DialerRouter · fd 桥                          [M1+]
+  TXTerminal   GhosttyKit 包装：Metal 渲染 · 键盘 · IME                     [M0]
+  TXSecurity   Keychain / Secure Enclave / known_hosts                      [M4]
+  TXPTY        本地 PTY（仅 macOS）                                         [M4]
+  TXUI         SwiftUI 界面层                                               [M0+]
+apps/          Xcode app targets（XcodeGen 生成，iOS/iPadOS 合一 + macOS 独立）
+vendor/        非 Swift 语言源（zig/go/c++），CI 产出 xcframework            [M1+]
+artifacts/     预编译 xcframework 落地（gitignore）
+```
+
+## 开发
+
+```sh
+# M0：纯逻辑包，命令行即可测，无需 Xcode 工程
+cd packages/TXCore && swift test
+```
+
+## 工具链要求
+
+- Xcode 26+ / Swift 6.x（M0）
+- Go + gomobile（M1，tsnet）
+- CMake + Ninja + zig（M1/M2，vendor 构建）