界面与快捷键

Qoder CLI 的交互界面（TUI）提供了主题、状态栏、快捷键、Vim 编辑模式和语音输入等可定制项。合理配置这些界面选项，可以让终端下的使用体验更顺手、更贴合个人习惯。本页介绍界面相关的配置与操作。配置文件的分层与合并规则见配置文件与生效顺序。

主题

主题控制界面的配色方案。通过 /theme 可以在交互界面中切换，也可以在配置中指定：

{
  "ui": {
    "theme": "Tokyo Night",
    "autoThemeSwitching": true
  }
}

内置主题

Qoder CLI 提供多套内置主题：AyuDark、AyuLight、AtomOneDark、Dracula、DefaultLight、DefaultDark、GitHubDark、GitHubLight、GoogleCode、Holiday、ShadesOfPurple、SolarizedDark、SolarizedLight、XCode、TokyoNight、ANSI、ANSILight。

自动切换

ui.autoThemeSwitching（默认开启）会根据终端背景色自动在默认的明暗主题间切换。终端背景色的轮询间隔由 ui.terminalBackgroundPollingInterval（默认 60 秒）控制。

自定义主题

通过 ui.customThemes 可以定义自己的配色方案，然后在 ui.theme 中引用其名称。

状态栏

状态栏显示在输入框下方。内置的默认状态栏展示 模型 · 工作区 · +N -N（模型名、工作目录、代码增删行数）等信息，并会在终端宽度不足时按优先级省略低优先级段落。

自定义状态栏命令

你可以运行一个自定义 Shell 命令来生成状态栏内容。该命令通过 stdin 接收会话数据的 JSON（包含会话 ID、工作目录、模型、上下文使用情况、Git 分支、Vim 模式等），其标准输出（含 ANSI 颜色）显示在输入框下方：

{
  "statusLine": {
    "type": "command",
    "command": "~/.qoder/statusline-command.sh",
    "padding": 0
  }
}

在交互界面中运行 /statusline 可以借助内置的状态栏配置能力，自动读取你的 Shell 配置并生成脚本。

段落颜色

对于内置默认状态栏，可以通过 statusLine.colors 自定义各段落颜色（如 model、branch、separator）。颜色值可以是十六进制（如 #ff6600）、ANSI 名称（如 red、cyan）或自然语言色名（如 ocean blue）。留空表示使用主题默认色。上下文进度条会忽略自定义颜色，根据使用量自动变色（绿/黄/红）。

快捷键

在交互界面中运行 /shortcuts 可查看当前的快捷键列表。常用快捷键如下：

快捷键	作用
`Enter`	提交输入。
`Shift+Enter` / `Ctrl+J`	换行（不提交）。
`Ctrl+C`	中断当前操作 / 清空输入。
`Ctrl+D`	退出。
`Ctrl+A` / `Home`	移动到行首。
`Ctrl+E` / `End`	移动到行尾。
`Ctrl+左` / `Alt+左`	向左移动一个单词。
`Ctrl+右` / `Alt+右`	向右移动一个单词。
`Ctrl+W`	删除光标前的单词。
`Ctrl+K`	删除到行尾。
`Ctrl+U`	删除到行首。
`Ctrl+P` / `Ctrl+N`	浏览历史（上/下）。
`Ctrl+R`	反向搜索历史。
`Shift+Up` / `Shift+Down`	向上 / 向下滚动。
`Ctrl+X`	打开外部编辑器编辑输入。
`Ctrl+V`	粘贴剪贴板内容。
`Alt+V`	粘贴剪贴板图片。
`Shift+Tab`	切换权限模式。
`Ctrl+Y`	切换绕过权限模式。
`Ctrl+T`	展开查看完整任务列表。
`Ctrl+L`	清屏。

具体按键在不同终端和平台上可能略有差异，以 /shortcuts 显示的为准。

外部编辑器

运行 /editor 可以配置用于编辑输入的外部编辑器。配置后，按 Ctrl+X 会用该编辑器打开当前输入内容，适合编写较长的提示词。

Vim 模式

运行 /vim 可以切换 Vim 编辑模式。启用后，输入框支持常见的 Vim 操作：

移动：h / j / k / l（左/下/上/右）。
词移动：w（下一个词）、b（上一个词）、e（词尾）。
行首行尾：0（行首）、$（行尾）。
进入编辑：i（插入）、a（追加）、o（新起一行）。
编辑操作：d（删除）、c（更改）、y（复制）、x（删除字符）。
撤销/重做：u（撤销）、Ctrl+R（重做）。

状态栏会显示当前的 Vim 模式（INSERT / NORMAL）。

语音输入

运行 /voice 可以启用语音输入，通过语音识别把语音转成文字输入。语音识别服务地址可通过环境变量 QODER_ASR_URL 指定。

其他界面选项

ui 分组下还有许多可调项，常用的包括：

配置项	默认值	说明
`ui.hideBanner`	`false`	隐藏启动横幅。
`ui.hideFooter`	`false`	隐藏页脚。
`ui.showLineNumbers`	`true`	在对话中显示行号。
`ui.loadingPhrases`	`off`	加载时显示：`tips` / `witty` / `all` / `off`。
`ui.dynamicWindowTitle`	`true`	用状态图标动态更新终端窗口标题。
`ui.accessibility.screenReader`	`false`	屏幕阅读器模式，输出纯文本（需重启）。

完整界面配置项见配置项、环境变量与文件路径。

下一步

配置文件与生效顺序：配置文件与生效顺序。
调整回复表达方式：输出风格。
全部配置项与环境变量：配置项、环境变量与文件路径。

​主题

​内置主题

​自动切换

​自定义主题

​状态栏

​自定义状态栏命令

​段落颜色

​快捷键

​外部编辑器

​Vim 模式

​语音输入

​其他界面选项

​下一步

主题