初始提交：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>

vendor/libghostty-spm/Sources/GhosttyTerminal/Surface/TerminalSurfaceView.swift

@@ -0,0 +1,82 @@
+//
+//  TerminalSurfaceView.swift
+//  libghostty-spm
+//
+//  Created by Lakr233 on 2026/3/16.
+//
+
+import SwiftUI
+
+public struct TerminalSurfaceView: View {
+    @Environment(\.colorScheme) private var colorScheme
+
+    @ObservedObject var context: TerminalViewState
+    let focusBinding: TerminalFocusBinding?
+
+    public init(context: TerminalViewState) {
+        self.context = context
+        focusBinding = nil
+    }
+
+    init(
+        context: TerminalViewState,
+        focusBinding: TerminalFocusBinding?
+    ) {
+        self.context = context
+        self.focusBinding = focusBinding
+    }
+
+    public var body: some View {
+        TerminalViewRepresentable(
+            context: context,
+            controller: context.controller,
+            configuration: context.configuration,
+            focusBinding: focusBinding
+        )
+        .background(.clear)
+        .onChange(of: colorScheme) { newScheme in
+            context.adopt(colorScheme: newScheme)
+        }
+        .onAppear {
+            context.adopt(colorScheme: colorScheme)
+        }
+    }
+
+    public func terminalFocused(
+        _ condition: FocusState<Bool>.Binding
+    ) -> TerminalSurfaceView {
+        TerminalSurfaceView(
+            context: context,
+            focusBinding: .bool(condition)
+        )
+    }
+
+    public func terminalFocused<Value: Hashable>(
+        _ binding: FocusState<Value?>.Binding,
+        equals value: Value
+    ) -> TerminalSurfaceView {
+        TerminalSurfaceView(
+            context: context,
+            focusBinding: .optional(binding, equals: value)
+        )
+    }
+
+    public func terminalFocusOnAppear(
+        _ condition: FocusState<Bool>.Binding
+    ) -> some View {
+        terminalFocused(condition)
+            .onAppear {
+                condition.wrappedValue = true
+            }
+    }
+
+    public func terminalFocusOnAppear<Value: Hashable>(
+        _ binding: FocusState<Value?>.Binding,
+        equals value: Value
+    ) -> some View {
+        terminalFocused(binding, equals: value)
+            .onAppear {
+                binding.wrappedValue = value
+            }
+    }
+}