📊 页面导航

适用角色与上手难度

角色推荐度上手难度
🛠️ 开发★★★★★★☆☆☆☆
🧪 测试★★★★☆★☆☆☆☆
📦 产品★★★★☆★☆☆☆☆

🎯 学习产出: 掌握 Pi 的常用快捷键和消息队列用法,能高效地进行多轮交互

🚀 AI 能力提升: 交互效率、并行任务

快捷键与消息队列

预计阅读时间: 4 分钟

交互式编辑器支持标准编辑键位(删除单词、撤销等),完整列表在会话内按 /hotkeys 查看。快捷键可以通过 ~/.pi/agent/keybindings.json 自定义。

常用快捷键

按键动作
Ctrl+C清空编辑器
Ctrl+C 两次退出 Pi
Escape取消 / 中止当前操作
Escape 两次打开 /tree 分支视图
Ctrl+L打开模型选择器
Ctrl+P / Shift+Ctrl+P循环切换限定的模型(前/后)
Shift+Tab循环切换思考级别
Ctrl+O折叠/展开工具输出
Ctrl+T折叠/展开思考块
Ctrl+X复制最后一条助手消息

消息队列

在 agent 工作时你可以继续输入消息排队:

操作说明
Enter排队一条转向(steering)消息,当前回合工具调用结束后投递
Alt+Enter排队一条跟进(follow-up)消息,等 agent 全部工作完成后再投递
Escape中止当前工作,排队中的消息恢复到编辑器
Alt+Up把排队中的消息取回编辑器
Windows Terminal

在 Windows Terminal 中 Alt+Enter 默认是全屏,需要先改键位,Pi 才能收到"跟进消息"快捷键。参考 terminal-setup.md

消息投递方式可在 /settingssettings.json 中配置:

  • steeringMode / followUpMode"one-at-a-time"(默认,等上一条回复后再投下一条)或 "all"(一次性全部投递)
  • transport:provider 的传输偏好,"sse" / "websocket" / "auto"

编辑器技巧

功能操作
引用文件输入 @ 模糊搜索项目文件
路径补全Tab 补全路径
多行输入Shift+Enter(Windows Terminal 是 Ctrl+Enter
外部编辑器Ctrl+G 打开 $VISUAL / $EDITOR / nano
粘贴图片/文本Ctrl+V(Windows 是 Alt+V),或把图片拖进终端
执行 bash 命令!command 运行并把输出发给 LLM
运行但不上报!!command 运行命令但不把输出发给 LLM

bash 命令示例

!git log --oneline -5      # 把最近的提交记录发给模型
!ls src/                   # 同上,把输出作为上下文
!!pnpm install             # 只执行,不上报输出

界面构成

从上到下依次是:

  • 启动头部 — 快捷键提示(/hotkeys)、加载的 AGENTS.md、提示词模板、技能和扩展
  • 消息区 — 你的消息、助手回复、工具调用与结果、通知、错误和扩展 UI
  • 编辑器 — 输入区域,边框颜色表示思考级别
  • 底部栏 — 工作目录、会话名、token/缓存用量( 输入、 输出、R 缓存读、W 缓存写、CH 最新缓存命中率)、花费、上下文占用、当前模型

下一步