交互模式与终端操作

上一章你发了第一条消息，pi 帮你读了项目、改了代码。但 pi 的交互界面能做的事远不止打字回车。你看到的那些边框颜色、状态栏、快捷键提示都不是装饰——每一块都有它存在的理由。

这一章把交互界面翻个底朝天。

界面四个区域，各干什么

启动 pi 后，终端分成四块。从头到尾过一遍。

启动头部

每次启动时顶上那几行文本，告诉你三件事：

• 快捷键速查：一个小备忘录，提醒你 Ctrl+C 清空编辑区、Ctrl+D 退出等
• 加载了什么：pi 找到了哪些 AGENTS.md / CLAUDE.md、哪些 skills、哪些扩展
• 当前模型：你在用什么模型、什么推理等级

觉得这些信息太啰嗦，在 /settings 里开 quietStartup 就行。

消息区

这是主体区域，占据屏幕中部。你发的消息、AI 的回复、它调用过的工具和结果、报错和通知都在这里。

pi 会展开显示每次工具调用的详情——读了哪个文件、搜索了什么关键词、执行了哪条命令、输出是什么。想看更细的可以按 Ctrl+O 展开 / 折叠工具输出。

编辑区

屏幕底部那行就是你打字的地方。它的边框颜色告诉你当前的推理等级——不用看菜单也知道 pi 现在是”浅思考”还是”深推理”：

边框颜色含义	对应等级	适合干什么
常规色	off	一般问答、简单查询
浅色提示	minimal / low	日常编码
中等提示	medium	默认推荐，均衡效果和成本
深色提示	high / xhigh	复杂逻辑、跨文件重构
最深色	max	极复杂问题，最大深度思考

按 Shift+Tab 循环切换推理等级。

状态栏

最底下一行，从左到右依次显示：当前目录 → 会话名 → token / 缓存用量 → 上下文占用 → 费用估算 → 当前模型。

这里的 token 总额包含了 AI 回复、工具上报的用量和摘要生成消耗，会比你自己估算的多一些。

消息怎么发、怎么追、怎么取消

普通发送

输入内容，回车。pi 开始干活。这是最基本的交互。

Steering 消息：中途纠正方向

pi 正在执行一连串工具调用（比如 read → edit → bash），你突然想说”等等，别改那个文件，改另一个”。这时候按 Enter。

这条消息会在当前轮次的工具调用全部执行完毕后、下一轮 LLM 调用之前插入。pi 会立刻收到你的纠正指令，而不是把错误方向跑完再回头。

Follow-up 消息：干完活再追加

pi 快完成当前任务了，你想说”顺便把单测也跑一下”。按 Alt+Enter。

这条消息会等 pi 完成所有工作——没有更多工具调用需要执行——之后才插入。不会打断它手里正在做的事。

取消和取回

消息排队中但还没发出去？按 Escape 取消，内容回到编辑区。已经排队了但想改一改再发？按 Alt+Up 取回编辑区修改。

命令模式：/ 开头的东西

在编辑区输入 /，pi 弹出命令自动补全菜单。以下是日常最常用的：

命令	干什么
/model	打开模型选择器，浏览和切换 AI 模型
/settings	推理等级、主题、消息传递策略等
/new	开始全新会话
/resume	从历史会话中选一个继续
/name 重构模块	给当前会话取名
/session	看当前会话的路径、ID、消息数、token 用量和费用
/tree	打开会话树，跳到任意历史节点继续对话
/compact	手动压缩上下文，释放窗口空间
/export	导出会话为 HTML 或 JSONL
/share	上传为私有 GitHub Gist 生成分享链接
/reload	热重载扩展、skills、提示词模板和上下文文件
/hotkeys	显示所有快捷键
/quit	退出 pi

模型管理：切换和推理

打开模型选择器

输入 /model 或按 Ctrl+L。在弹出面板里按名称搜索、按提供商过滤，选中回车就切换好了。

快速循环

不用打开面板，直接按 Ctrl+P 向前切下一个模型、Shift+Ctrl+P 向后切。

在 pi 里直接跑命令

不用退出 pi 再开一个新终端。在编辑区打 ! 前缀就能执行 shell 命令：

!npm run lint
!git diff --stat

! 开头的命令执行后，输出会发给 pi 看。适合让 pi 参考测试结果、lint 报告、git 状态来做下一步决策。

!!cat ~/.zshrc
!!echo "纯本地查看"

!! 开头不会把输出发给 pi，只在终端显示。适合打开文件看一眼、检查环境变量这种不需要 AI 参与的操作。

编辑器里的实用技巧

操作	怎么做
引用文件	输入 @ 触发模糊搜索，继续打字缩小范围
路径补全	按 Tab 自动补全路径
多行输入	Shift+Enter（Windows Terminal 用 Ctrl+Enter）
粘贴图片	Ctrl+V（Windows 用 Alt+V），或拖拽图片到终端
发大段文字	Ctrl+G 打开外部编辑器，保存后内容自动填入 pi
复制 pi 回复	Ctrl+X 复制最后一条 AI 消息

Ctrl+G 这个功能很实用。你需要贴几十行日志或者写一大段需求描述时，在外部编辑器里写比在单行输入框里挤着写舒服太多了。

常用快捷键速查

以下是日常最高频的按键。想看完整列表输 /hotkeys。

编辑和输入

操作	快捷键
提交输入	Enter
换行	Shift+Enter（Windows: Ctrl+Enter）
清空编辑区	Ctrl+C（第一次清空，第二次退出）
退出（编辑区为空时）	Ctrl+D
打开外部编辑器	Ctrl+G
复制 AI 最后一条回复	Ctrl+X
粘贴图片	Ctrl+V（Windows: Alt+V）

模型和思考

操作	快捷键
打开模型选择器	Ctrl+L
向前切模型	Ctrl+P
向后切模型	Shift+Ctrl+P
循环切换推理等级	Shift+Tab
展开 / 折叠推理过程	Ctrl+T

显示和消息队列

操作	快捷键
展开 / 折叠工具输出	Ctrl+O
中途发送纠正消息	Enter（AI 工作时）
完成后发送追加消息	Alt+Enter
取消排队消息	Escape
取回排队消息	Alt+Up

光标和历史

操作	快捷键
上一条历史	Up
下一条历史	Down
删到行首	Ctrl+U
删到行尾	Ctrl+K
光标移一个词（左/右）	Alt+Left / Alt+Right
光标跳到行首/行尾	Home / End（或 Ctrl+A / Ctrl+E）