02. 日常对话与屏幕

发送、排队与取消

输入你想说的,发出去,助手干活时你仍能接管。MatchaCode 没有官方云,也没有 MatchaCode 账号。

发出一条提示就开始一轮。输入框不会被锁住。你可以排队下一条、打断并立即发送,或取消并保留草稿。

一轮是助手的一次完整处理:内容会流式写入提示框上方的回看区(回复、shell 命令、文件修改)。这一轮还在跑时,单独按 Enter 不会再开一轮,而是把刚打的字排进队列。排队的后续会在当前轮结束后再跑。

立即发送会停下当前轮,接着跑你这条,所以新提示总是落在记录最底下。后台任务、子助手和队列里其余项继续跑。

取消会停下正在跑的这一轮,什么都不发送。Esc 保留草稿。Ctrl+C 会先清空非空草稿。

想让助手把当前轮做完,就排队。想让它改方向,就立即发送。想把键盘拿回来,就取消。底部快捷键栏会显示当前状态对应的按键:空闲、运行中,或队列已打开。

发送

按键时机效果
Enter空闲,焦点在提示框发送当前提示,开始一轮。
Shift+EnterAlt+Enter焦点在提示框插入换行。
Ctrl+M/multiline焦点在提示框对调这两项:Enter 插入换行,Shift+Enter / Alt+Enter 发送。仅当前会话;不写入 config.toml

排队

按键或命令效果
有文字时按 Enter,一轮正在跑把这段文字排进队列,等当前轮结束。
输入框为空时按 Enter,一轮正在跑,队列里已有内容立即发送队列最上方那条后续。不必打开队列面板。
Ctrl+;(备选 Ctrl+'队列非空时切换队列面板。
/queue打印一份只读的等待列表。全屏和精简都可用。

队列面板的 [Send now] 按钮(或焦点行上的立即发送组合键)发送选中的那一行。从提示框触发时,立即发送总是取最上方那一行。

助手被后台任务或子助手挡住时,排队的后续会先挂起。界面会提示为何挂起。卡住等待时,输入框有内容再单独按 Enter 也会立刻送达:Matcha CLI 会取消被挡住的这一轮,接着跑你这条消息。

/queue 不改列表。要编辑,请用全屏 TUI 里的队列面板。

/queue

立即发送

这个组合键的意思是「停下手里的事,改听这条」:

终端首选备选
默认Ctrl+EnterCtrl+I
Apple TerminalCtrl+OCtrl+Enter, Ctrl+I
VS Code 系Ctrl+L
  • 输入框非空 → 取消当前轮,立刻发送这段文字。
  • 输入框为空 + 队列里已有后续 → 立刻发送队列最上方那一行。
  • 空闲,或输入框为空且队列为空 → 无操作。

想给助手留条备注但不打断它,用单独的 Enter 排队。

取消

操作效果
一轮正在跑时按 Esc(默认)立刻取消。草稿保留。从提示框或回看区都可以。
一轮正在跑、全屏 vim 模式时按 Esc被吞掉。不会取消。改用 Ctrl+C 或命令面板。
一轮已经在取消中时按 Esc任何模式下都会再发一次取消(第一次确认丢失时用来重试)。
草稿非空、一轮正在跑时按 Ctrl+C清空草稿,这一轮继续。空提示框上再按一次 Ctrl+C 才会取消。
空提示框、一轮正在跑时按 Ctrl+C取消。

空闲时的 Esc 不是取消:800ms 内连按两次 Esc,会清空非空提示框;若提示框为空且会话里已有消息,则打开回退选择器。由 Esc 触发取消后,回退会抑制大约一秒,避免连按 Esc 误打开。

取消过程中再按 Ctrl+C 会升级为退出。Ctrl+Q(VS Code 系终端里是 Ctrl+D)连按两次退出。