01. 安装、凭证与第一次跑通
退出并恢复终端
全屏 TUI 会接管终端：备用屏幕、隐藏光标、鼠标和括号粘贴。安全恢复意味着每条退出路径 — 确认退出、斜杠退出、首次运行的 q、一次 SIGINT / SIGTERM — 都会离开原始模式、显示光标，并回到普通屏幕。拆卸之后不得再出现 ?1049h（重新进入备用屏幕）。
退出方式
请求 TUI 退出有几种方式。确认行为并不都一样：
| 怎么做 | 确认 | 典型用途 |
|---|---|---|
Ctrl+Q（或 VS Code 系终端里的 Ctrl+D） | 约 1000 ms 内连按两次。第一次显示 press again to quit，并不退出 | 防误触 |
/quit 或 /exit | 无 — 立即退出 | 有意的斜杠命令 |
| 在欢迎屏点击 Quit | 无 — 立即退出 | 鼠标 |
未配置服务商的配置屏上单独按 q | 无 — 立即退出 | 首次运行拦截 |
已配置的欢迎屏 / 会话中单独按 q | 不是退出 — 当作输入（或 vim/看板浮层规则） | 有了服务商之后，不要依赖单独的 q |
一次 SIGINT / SIGTERM（仅当 Ctrl+C 未绑定为取消时） | 优雅恢复；完成路径以 0 退出 | 宿主信号 |
一轮正在流式输出时，Ctrl+C 不是退出（它取消本轮）；权限卡打开时也不是（它取消该权限）。空闲且有草稿时，第一次 Ctrl+C 清空草稿；输入栏为空后再按一次 Ctrl+C，才是快捷栏所描述的通常取消/退出升级。
在 VS Code、Cursor、Windsurf 和 Zed 的集成终端里，宿主常常吞掉 Ctrl+Q。此时 Matcha CLI 把 Ctrl+D 绑成唯一退出键（不绑定 Ctrl+Q）。下翻半页变成单独的 Shift+D。
键盘：确认后再退出
- 从已配置的欢迎屏或会话中，按一次
Ctrl+Q（VS Code 系终端里用Ctrl+D）。 - 快捷栏（或确认提示）应显示
press again to quit。进程仍在运行。 - 约一秒内再按同一组合键。
进程应以 0 退出。提示符应回到普通屏幕，光标可见，鼠标上报关闭。
单独按一次视为误触，确认窗口过期后忽略。提示期间调整窗口大小不得丢掉确认。
斜杠：/quit 或 /exit
在提示处输入：
/quit或
/exit/quit 是命令名；/exit 是别名。任一都会立即派发退出（无需连按）。光杆词 quit、exit、:q、:q!、:wq 和 :wq! 在斜杠解析之外（空提示发送 / 看板）也被当作退出。单独的 q 不在该别名列表里。
首次运行的配置屏
若你在 No model Provider is configured 屏上，按 q（或激活 Quit 行）。那会立即退出，以免困在 Configure。配置好服务商之后，不要指望单独的 q 会退出 — 用连按两次 Ctrl+Q、/quit，或 Quit 控件。
信号
从另一个终端，或由宿主投递：
kill -INT <pid> # SIGINT
kill -TERM <pid> # SIGTERM一次信号应像确认退出一样恢复（关掉备用屏幕、打开光标、重置鼠标/粘贴），并在优雅路径上以 0 退出。不要把第二次信号写成文档流程；双信号窗口不是受支持的交互。
恢复意味着什么
成功退出后，宿主应：
- 显示你的普通 shell 回滚（已离开备用屏幕）
- 显示闪烁/块状光标
- 不再向程序发送鼠标事件
- 接受粘贴，且没有来自 Matcha CLI 的残留括号粘贴包装
窗口标题恢复尚不保证。若标签标题仍写 matcha，那是已知未完成项，不是退出失败。
这些不是退出
| 操作 | 它做什么 |
|---|---|
Responding 期间按 Ctrl+C | 取消本轮；草稿保留 |
权限卡上按 Ctrl+C | 取消该权限；不退出 |
/home | 回到欢迎屏；进程仍在 |
退出后再跑 matcha update | 不可用。从源码重新构建 |