02. 日常对话与屏幕

命令从哪里来

/、面板、速查表、/docs 和 /tutorial 是不同的列表。你不必把它们都背下来。

以现场菜单为准。技能、插件、屏幕模式和会话状态会改变 / 和 Ctrl+P 显示什么。若命令不在现场列表里，以现场列表为准。

入口	列出什么	怎么打开
斜杠菜单	能从提示框跑的命令	空提示框上键入 `/`
命令面板	命令、键盘快捷键和技能	`Ctrl+P`、`?` 或 `/help`
快捷键速查表	仅按键绑定	`Ctrl+.`（或 `Ctrl+X`）
How-to Guides	应用内的用户指南页	`/docs`（别名 `/howto`、`/guides`）
教程浮层	九篇短的入门页	`/tutorial`（别名 `/tour`、`/onboarding`）

/home（别名 /welcome）不是目录。它离开会话，回到欢迎屏。没有对应的按键绑定。

斜杠菜单是日常列表。记得动作但分不清是按键还是命令时，用面板。速查表是键盘。/docs 是应用内参考。/tutorial 是第一小时。

斜杠菜单（`/`）

空提示框上键入 /。会出现可搜索的下拉，边打边模糊匹配。Tab 或 Enter 接受高亮行。

命令来自三处，合在一个菜单里：

Pager 内建 — TUI（/find、/vim-mode、/docs，…）。
Shell 内建 — Matcha CLI 后端（/new、/model、/compact，…）。
SKILL.md 里 user-invocable: true 的技能。

内建永远赢得裸名。若技能也叫 login，/login 仍是内建，技能是 /plugin-name:login。菜单会给两者打标（built-in 对 skill · local / skill · acme）。

同一菜单会按屏幕模式过滤。仅全屏和仅精简的命令，在跑不了它们的模式里会隐藏。

命令面板（`Ctrl+P`）

Ctrl+P 或 ?（Shift+/）打开一份可搜索列表：

每个键盘快捷键及其当前绑定
每条斜杠命令
可用技能

键入以过滤，Enter 以运行。

/help 打开的就是这份面板。它不是另一本手册。精简模式没有始终可见的快捷键栏，所以会宣传 /help 作为入口（状态行里也会显示）。

/help

快捷键速查表（`Ctrl+.`）

Ctrl+. 需要 Kitty 键盘协议（或 tmux extended-keys on）。在 VS Code / Cursor / Windsurf / Zed、VTE、Apple Terminal、Windows Terminal、JetBrains、extended-keys off 的 tmux，以及类似环境里，Matcha CLI 会把 Ctrl+X 宣传为速查表首选键。Ctrl+X 作为经典控制字符始终可用。tmux 里修饰键行为异常时，运行 /doctor。

这不是 /help，也不是 /docs。

`/docs`

/docs
/docs Getting Started

光写 /docs（或 /docs how-to、howto、guides、list、tui）会在 Matcha CLI 里打开 How-to Guides 选择器。/docs <title> 按不区分大小写的标题打开一篇指南。

`/tutorial`

/tutorial

仅全屏。

九个短主题（第一条提示、附上上下文、导航、斜杠命令、worktree、计划模式、自定义、从其他工具切过来）。→ 到下一主题。不会自动弹出；进入的唯一方式是这条命令或面板。

`/home`

/home

别名：/welcome。退出当前会话，回到欢迎屏。它不会退出 Matcha CLI（那是 /quit / Ctrl+Q）。

`/release-notes`

/release-notes

别名：/changelog。这条命令不可用。它不会拉取远程发行说明，也不会打开浏览器。请用 /docs。