kimi-code/docs/zh/reference/keyboard.md
2026-05-22 15:54:50 +08:00

112 lines
5.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 键盘快捷键
Kimi Code CLI 的 TUI 交互模式支持以下键盘快捷键。键位主要在输入框中生效,部分键位在弹窗(如 `/help` 帮助面板、审批面板或流式输出streaming期间有不同的行为。
在 TUI 中输入 `/help` 可以随时打开内置的快捷键清单。
## 通用快捷键
下列键位在输入框中始终可用:
| 快捷键 | 功能 |
| ------------- | ------------------------------------------- |
| `Enter` | 提交当前输入 |
| `Shift-Enter` | 在输入中插入换行 |
| `↑` / `↓` | 浏览输入历史 |
| `Esc` | 关闭弹窗 / 取消补全 / 中断流式输出或正在进行的上下文压缩compaction |
| `Ctrl-C` | 中断当前流式输出,或清空输入框 |
| `Ctrl-D` | 在输入框为空时退出 Kimi Code CLI |
**流式输出期间**按 `Ctrl-C` 会立即取消,无需二次确认。
**退出程序**(输入框为空时按 `Ctrl-C`,或按 `Ctrl-D`)使用「双击确认」机制:第一次按下时,状态栏会显示提示(例如 `Press Ctrl+C again to exit`),再按一次相同的键才会真正退出。如果中途按了其他键,确认状态会自动清除。
## 模式切换
| 快捷键 | 功能 |
| ----------- | ---------- |
| `Shift-Tab` | 切换 Plan 模式 |
`Shift-Tab` 可以开启或关闭 Plan 模式。开启后Agent 会优先使用只读工具进行研究和规划,并可以写入当前计划文件;必要时也能调用 `Bash`,它会按当前权限模式和普通规则处理,不会因为处于 Plan 模式而额外发起独立审批。单纯切换模式不会创建空计划文件。再次按 `Shift-Tab` 即可退出 Plan 模式。
## 输入与编辑
| 快捷键 | 功能 |
| -------- | --------------------------------------- |
| `Ctrl-G` | 在外部编辑器中编辑当前输入 |
| `Ctrl-V` | 粘贴剪贴板中的图片或视频Unix / macOS |
| `Alt-V` | 粘贴剪贴板中的图片或视频Windows |
| `Ctrl-E` | 展开或折叠 Plan 卡片(无 Plan 卡片时按系统默认行为将光标移到行尾) |
| `Ctrl--` | 撤销Undo |
`Ctrl-G` 会打开外部编辑器,编辑当前输入内容。编辑器按以下优先级选择:
1. `/editor` 命令配置的编辑器
2. `$VISUAL` 环境变量
3. `$EDITOR` 环境变量
保存并退出编辑器后,编辑后的内容会替换输入框中的内容;不保存退出则保持原样。
粘贴图片或视频时会在输入框中显示为占位符实际媒体数据在提交时一并发送给模型。粘贴的优先来源是系统剪贴板里的图片或文件路径Linux 上 Wayland 与 X11 都会被尝试WSL 下还会通过 PowerShell 兜底读取 Windows 剪贴板。
## 流式输出期间
流式输出streaming期间输入框依然可以接收输入并支持以下额外操作
| 快捷键 | 功能 |
| -------- | ---------------------- |
| `Ctrl-S` | Steer将当前输入立即注入正在运行的轮次 |
| `Esc` | 中断当前流式输出 |
| `Ctrl-C` | 中断当前流式输出 |
`Ctrl-S` 时,模型会在下一个可中断的时机立刻看到你的消息,无需等待当前轮次结束。
## 工具输出
| 快捷键 | 功能 |
| -------- | --------- |
| `Ctrl-O` | 展开或折叠工具输出 |
当历史中存在折叠的工具调用结果时,按 `Ctrl-O` 可以在折叠和展开之间切换,便于查看完整的工具输出。
## 审批面板
当 Agent 发起需要确认的工具调用时TUI 会弹出审批面板。详细的审批流程见 [交互与输入](../guides/interaction.md#审批流程),下表给出面板内可用的键位:
| 快捷键 | 功能 |
| --------------------------- | ----------------------------- |
| `↑` / `↓` | 在候选选项之间移动光标 |
| `Enter` | 确认当前选中的选项 |
| `1` ~ `9` | 直接选择对应序号的选项 |
| `Esc` / `Ctrl-C` / `Ctrl-D` | 拒绝当前请求 |
| `Ctrl-E` | 当面板包含 diff 或文件内容预览时,展开或折叠完整内容 |
| `Ctrl-O` | 切换其他工具输出的折叠状态 |
需要附带反馈的选项例如「Reject」「Revise」会在确认后切换到反馈输入态直接输入反馈文本`Enter` 提交;按 `Esc` 退出反馈输入并回到候选列表。
## 弹窗模式
输入 `/help` 打开帮助面板后,可使用以下键位浏览和关闭面板:
| 快捷键 | 功能 |
| --------------------- | ---------- |
| `↑` / `↓` | 单行滚动 |
| `PageUp` / `PageDown` | 每次滚动 10 行 |
| `Esc` | 关闭面板 |
| `Enter` | 关闭面板 |
| `q` / `Q` | 关闭面板 |