屏幕与输入模式

屏幕模式是对本会话的一次重开。输入和显示开关是当前进程上的设置（有的会持久化，有的不会）。驱动另一种模式所没有的表面的命令，会从 / 和 Ctrl+P 里隐藏。若你仍键入了，Matcha CLI 会说明原因。

全屏是标准的备用屏 TUI：可交互回看区、浮层、主题、看板。精简（--minimal）是回看原生：对话打印进终端自己的历史。内联（--no-alt-screen）在这里的每道命令门槛上仍算全屏。

/minimal 和 /fullscreen（别名 /full）用另一种模式重开当前会话。它们不写入 [ui] screen_mode。重开横幅会告诉你怎么切回去。CLI 上的 --minimal / --fullscreen 同样只作用于本会话。要让普通的 matcha 以指定模式打开，用 /settings → "Default screen mode"，或设置 [ui] screen_mode。

面板很小、用了多路复用器，或更喜欢原生回看，都是切到精简的理由。浮层（教程、主题选择器、看板、查找）需要全屏。切换不会另开一段对话，也不会误改配置。

切换屏幕模式

/minimal
/fullscreen

两者都需要有活动会话。/minimal 只在全屏（含内联）里提供。/fullscreen 只在精简里提供。键入你已经在用的那一个，会打印 You're already in … mode.

仅全屏命令

在精简里隐藏。仍键入时，会让你运行 /fullscreen（除非本模式已有替代）：

仅精简命令

精简里的 Ctrl+E 与 /expand 是同一次再打印。全屏里，Ctrl+E 切换思考块。

`/vim-mode`

/vim-mode

切换 vim 风格的回看区按键：j/k、h/l、g/G、y/Y、H/L、e/E，以及 i 聚焦提示框。默认关闭：回看区里单独的字母会把焦点移到提示框并键入该字符。方向键、Tab、Esc、Space、PageUp/PageDown 以及所有 Ctrl+letter 在两种模式下都可用。

会持久化到 ~/.matcha/config.toml 的 [ui] vim_mode。也可以在 [ui] 下手工写 vim_mode = true。

`/multiline`

/multiline

别名：/ml。切换多行输入。Enter 插入换行；Shift+Enter 或 Alt+Enter 发送。一轮进行中，空输入框上的 Enter 仍会立即发送队列最上方那条后续。

焦点在提示框时也绑定到 Ctrl+M。从回看区按 Ctrl+M 会打开模型选择器。

`/compact-mode`

/compact-mode

切换紧凑显示（更少留白、更密的输出）。会持久化 compact_mode。终端很矮时，即便你关掉了用户设置，仍可能自动紧凑；toast 会说明。

`/timestamps`

/timestamps

切换消息上的时间戳。会持久化。菜单可能显示 on/off 提示；该命令忽略参数，总是翻转当前值。

`/toggle-mouse-reporting`

/toggle-mouse-reporting

翻转终端鼠标捕获，好让原生点击拖选复制/粘贴能用。需主动打开：除非 ~/.matcha/config.toml 里 [ui] mouse_reporting_toggle = true，否则隐藏且无效。标志关闭时，命令会打印该路径，而不是切换。

对应按键是焦点在回看区（不是提示框）时的 Ctrl+R。斜杠命令从两处都能跑，不会让输入失焦。精简不注册该按键。