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))。
分类
面板按此顺序:
| 分区 | 常见行 |
|---|---|
| Appearance | Theme、自动深/浅色、紧凑模式、默认屏幕模式、时间戳、时间线、发送时贴顶、思考块、合并工具调用、折叠编辑 |
| Mouse | 滚动速度 / 输入 / 行数、反转滚动、文本选择 |
| Editor & Input | 关闭 vim 输入模式(simple_mode)、vim 回看导航、多行 |
| Agent & Approval | 权限模式、记住工具批准、默认选中的权限、Ask-Question 超时、计划模式 |
| Privacy | Coding 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。
核对一下
/settings,过滤screen,设置 Default screen mode,退出后重新启动。确认直接运行matcha会跟随该选择。- 切换 Snap prompt to top on send 并发送一条提示:无需重启。
- 在精简模式打开
/settings,确认没有 Theme;/fullscreen后再用/theme仍然可用。