Pi Agent: 键盘快捷键与主题定制
最后更新：2026-08-31
工具用得顺手，效率才能拉满。快捷键和主题就是你的"工位调校"。
1. 键盘快捷键
(1) 默认快捷键
| 快捷键 | 功能 |
|---|---|
| Ctrl+C | 中断当前操作 / 退出 |
| Ctrl+D | 退出交互模式 |
| Enter | 发送消息 |
| Ctrl+L | 清屏 |
| Tab | 自动补全（命令/文件名） |
| ↑ / ↓ | 浏览历史消息 |
| Ctrl+R | 重新生成上一条回复 |
| Ctrl+E | 编辑上一条消息 |
| Ctrl+K | 删除光标到行末 |
(2) 自定义快捷键
在 ~/.pi-agent/keybindings.yaml 中配置：
YAML
keybindings:
submit: "enter"
new_line: "ctrl+enter"
clear_screen: "ctrl+l"
retry: "ctrl+r"
edit_last: "ctrl+e"
save_session: "ctrl+s"
load_session: "ctrl+o"
toggle_tools: "ctrl+t"
switch_model: "ctrl+m"
history_up: "up"
history_down: "down"
(3) 在代码中注册快捷键
PYTHON
from pi_agent import Agent
agent = Agent(name="custom")
@agent.keybind("ctrl+shift+r")
def retry_with_reasoner():
agent.switch_model("deepseek-reasoner")
agent.retry()
@agent.keybind("ctrl+shift+s")
def save_and_summarize():
agent.session.save("auto_save.json")
print("会话已保存")
2. 主题定制
(1) 内置主题
BASH
pi-agent config set theme dark
pi-agent config set theme light
pi-agent config set theme monokai
pi-agent config set theme solarized
pi-agent config set theme nord
(2) 交互模式切换
TEXT
📖 仅展示
you> /theme dark
🎨 主题已切换到 dark
(3) 自定义主题
创建 ~/.pi-agent/themes/my_theme.yaml：
YAML
name: my_theme
background: "#1e1e2e"
foreground: "#cdd6f4"
accent: "#89b4fa"
error: "#f38ba8"
warning: "#fab387"
success: "#a6e3a1"
user_input: "#89dceb"
agent_output: "#cdd6f4"
tool_call: "#f9e2af"
code_block:
background: "#313244"
foreground: "#cdd6f4"
keyword: "#cba6f7"
string: "#a6e3a1"
comment: "#6c7086"
function: "#89b4fa"
应用自定义主题：
BASH
pi-agent config set theme my_theme
3. 输出格式定制
(1) 代码高亮
YAML
# ~/.pi-agent/config.yaml
display:
code_highlight: true
code_theme: "monokai"
line_numbers: true
wrap_lines: false
(2) Markdown 渲染
YAML
display:
markdown_render: true
table_render: true
link_clickable: true
(3) 工具调用展示
YAML
display:
show_tool_calls: true
tool_call_format: "compact" # compact | detailed | minimal
show_thinking: false # 是否显示推理过程
▶ 示例 1：编程专用主题配置（难度⭐）
YAML
name: dev_theme
background: "#0d1117"
foreground: "#e6edf3"
accent: "#58a6ff"
user_input: "#79c0ff"
agent_output: "#e6edf3"
tool_call: "#d2a8ff"
code_block:
background: "#161b22"
keyword: "#ff7b72"
string: "#a5d6ff"
function: "#d2a8ff"
display:
code_highlight: true
line_numbers: true
show_tool_calls: true
4. 字体与布局
(1) 字体设置
YAML
display:
font_family: "JetBrains Mono"
font_size: 14
line_height: 1.5
(2) 布局选项
YAML
display:
show_header: true
show_token_count: true
show_timestamp: false
compact_mode: false
max_width: 120
❓ 常见问题
Q 快捷键冲突怎么办？
A Pi Agent 的快捷键优先级低于终端本身的快捷键。如果冲突，修改 Pi Agent 的快捷键配置。
Q 主题设置不生效？
A 确保主题文件名和 config 中设置的一致。自定义主题文件要放在
~/.pi-agent/themes/ 目录下。Q 如何在终端显示 emoji？
A 确保终端支持 Unicode。Windows Terminal、iTerm2、Alacritty 都支持。旧版 cmd.exe 可能不支持。
📖 小节
- 默认快捷键覆盖常用操作，可在 keybindings.yaml 中自定义
- 内置 5 种主题，也支持完全自定义颜色方案
- 输出格式可配置代码高亮、Markdown 渲染、工具调用展示
- 字体和布局选项优化阅读体验
📝 作业
- 基础题（难度⭐）：切换 3 种内置主题，选择你最喜欢的一个。
- 进阶题（难度⭐⭐）：创建一个自定义主题，调整到你满意的颜色方案。
- 挑战题（难度⭐⭐⭐）：为你的自定义主题注册快捷键，一键切换到"编程模式"和"阅读模式"。
