初始提交：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/Example/GhosttyTerminalApp/ViewController.swift

@@ -0,0 +1,108 @@
+import Cocoa
+import GhosttyTerminal
+import ShellCraftKit
+
+private final class AppearanceAwareView: NSView {
+    var onAppearanceChange: (() -> Void)?
+
+    override func viewDidChangeEffectiveAppearance() {
+        super.viewDidChangeEffectiveAppearance()
+        onAppearanceChange?()
+    }
+}
+
+final class ViewController: NSViewController {
+    private lazy var terminalView: TerminalView = .init(
+        frame: NSRect(x: 0, y: 0, width: 720, height: 480)
+    )
+
+    private lazy var shellSession: ShellSession = .init(shell: defaultSandboxShell)
+
+    private lazy var controller: TerminalController = .init { builder in
+        builder.withBackgroundOpacity(0)
+        builder.withCustom("keybind", "super+k=text:\\x0c")
+    }
+
+    override func loadView() {
+        let container = AppearanceAwareView()
+        container.onAppearanceChange = { [weak self] in
+            self?.applyWindowBackgroundColor()
+        }
+        view = container
+    }
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        configureView()
+        configureTerminalView()
+    }
+
+    override func viewDidAppear() {
+        super.viewDidAppear()
+        activateTerminal()
+    }
+
+    override func viewDidLayout() {
+        super.viewDidLayout()
+        terminalView.fitToSize()
+    }
+
+    private func configureView() {
+        view.wantsLayer = true
+        applyWindowBackgroundColor()
+    }
+
+    private func applyWindowBackgroundColor() {
+        // `NSColor.windowBackgroundColor.cgColor` snapshots whichever
+        // appearance is current at the call site, so drawing it naively
+        // caches yesterday's light/dark value on the layer. Resolve it
+        // under the view's effective appearance so the layer follows
+        // system toggles.
+        view.effectiveAppearance.performAsCurrentDrawingAppearance {
+            view.layer?.backgroundColor = NSColor.windowBackgroundColor.cgColor
+        }
+    }
+
+    private func configureTerminalView() {
+        terminalView.delegate = self
+        terminalView.setAccessibilityElement(true)
+        terminalView.setAccessibilityIdentifier("terminal.surface")
+        terminalView.setAccessibilityLabel("Terminal Surface")
+        terminalView.configuration = TerminalSurfaceOptions(
+            backend: .inMemory(shellSession.terminalSession)
+        )
+        terminalView.controller = controller
+        terminalView.translatesAutoresizingMaskIntoConstraints = false
+        view.addSubview(terminalView)
+
+        NSLayoutConstraint.activate([
+            terminalView.topAnchor.constraint(equalTo: view.topAnchor),
+            terminalView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
+            terminalView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
+            terminalView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
+        ])
+    }
+
+    private func activateTerminal() {
+        view.window?.makeFirstResponder(terminalView)
+        shellSession.start()
+    }
+}
+
+// MARK: - Terminal Callbacks
+
+extension ViewController:
+    TerminalSurfaceTitleDelegate,
+    TerminalSurfaceResizeDelegate,
+    TerminalSurfaceCloseDelegate
+{
+    func terminalDidChangeTitle(_ title: String) {
+        view.window?.title = title
+    }
+
+    func terminalDidResize(columns _: Int, rows _: Int) {}
+
+    func terminalDidClose(processAlive _: Bool) {
+        view.window?.close()
+    }
+}