10. 配置、主题与终端

设置

在会话里改常见偏好。/settings 打开本地面板,写入 ~/.matcha/config.toml(以及少量内存中的 pager 标志)。什么都不会上传。没有远程设置同步,也没有官方云。

打开面板

以下任一:

/settings
/config
/preferences
/prefs

键盘(会话中):F2、Ctrl+,,或 Cmd+,(macOS)。

/settings 在全屏和精简模式都可用。精简模式没有 Matcha 色板,因此 Theme、auto-dark、auto-light 行会隐藏 — 先用 /fullscreen,或用仅全屏的 /theme。见「主题」。

/settings 后面的参数会被忽略。面板总是从顶部打开。在面板里输入 /,可按标签、说明或关键字过滤。

操作

输入效果
j / k 或方向键在行间移动
Space切换布尔值
Enter打开选择器或行内编辑
/过滤;Esc 退出过滤但不关闭设置
Esc(浏览时)关闭面板
F2 / Ctrl+, / Cmd+,从任一内部模式关闭

多数改动立即生效,并写入用户 config.toml。标成需要重启的行(例如 Default screen mode)等到下次启动才生效。

没有 /settings <id> 跳转。用过滤,或从别的命令打开聚焦行(例如 /privacy 会聚焦 Coding data (local))。

分类

面板按此顺序:

分区常见行
AppearanceTheme、自动深/浅色、紧凑模式、默认屏幕模式、时间戳、时间线、发送时贴顶、思考块、合并工具调用、折叠编辑
Mouse滚动速度 / 输入 / 行数、反转滚动、文本选择
Editor & Input关闭 vim 输入模式(simple_mode)、vim 回看导航、多行
Agent & Approval权限模式、记住工具批准、默认选中的权限、Ask-Question 超时、计划模式
PrivacyCoding data (local) — 留在本机
Models默认模型
Session合并排队提示、回退前确认、提示建议
Advanced自动更新、hunk tracker、情境提示(含 SSH wrap)

Default screen mode 写入 [ui] screen_mode/minimal/fullscreen(以及 --minimal / --fullscreen)只对当前会话有效,不写该键。

Voice shortcut / capture / language 行可能会出现。/voice 与语音采集不可用。不要依赖它们。

Coding data (local) 不会把提示或轨迹发到设备外。不提供远程训练选择加入。

设置不会做的事

  • 把偏好同步到 MatchaCode 账号或组织控制面。没有账号,也没有官方云。
  • 代替 matcha login --provider 或服务商环境变量密钥。
  • 编辑 pager.toml 的布局键。那些仍在文件里;见「文件与环境变量」。

磁盘上的组织配置或残留的 requirements.toml / managed_config.toml 仍可能钉住 matcha inspect 会显示的值。设置只写入你的用户 config.toml

核对一下

  1. /settings,过滤 screen,设置 Default screen mode,退出后重新启动。确认直接运行 matcha 会跟随该选择。
  2. 切换 Snap prompt to top on send 并发送一条提示:无需重启。
  3. 在精简模式打开 /settings,确认没有 Theme;/fullscreen 后再用 /theme 仍然可用。