02 交互模式与日常操作
02 交互模式与日常操作
1. 输入
| 操作 | 按键 |
|---|---|
| 发送消息 | Enter |
| 插入换行 | Shift+Enter |
| 用外部编辑器写长 prompt | Ctrl+G（编辑器由 externalEditor 决定，默认取 $VISUAL → $EDITOR → 平台默认） |
| 搜索并附加文件 | 输入 @ |
| 补全路径 | Tab |
| 附加图片 | 粘贴或拖入兼容终端 |
2. 观察 Pi 的工作
- 每个工具调用与结果都会实时显示；
Ctrl+O展开/折叠工具输出。 Ctrl+T显示/隐藏 thinking 块（也可用hideThinkingBlock永久隐藏）。- 编辑器边框颜色表示当前 thinking level。
- footer 随模型消耗上下文而更新，显示用量与费用。
- 启动头部列出本次加载的指令与资源。
Pi 不会在每次工具调用前询问。这既是效率来源，也是风险来源：要么盯住 transcript，要么用沙箱。
3. 工作中改变方向（Pi 的关键交互设计）
| 目标 | 操作 |
|---|---|
| 调整当前任务 | 输入消息按 Enter（steering） |
| 在当前任务之后追加工作 | 输入消息按 Alt+Enter（follow-up） |
| 把排队消息退回编辑器 | Alt+Up |
| 中止当前任务 | Escape |
两者时机不同：
- steering：等当前 assistant 响应及其工具调用结束后进入，用来引导下一次响应。
- follow-up：等 agent 把当前所有待办工作做完后才进入。
- abort：停止当前 run，并把排队消息交还编辑器（不会丢）。
投递方式由设置控制：steeringMode / followUpMode 取值 "all" 或 "one-at-a-time"，默认都是 "one-at-a-time"。
Windows Terminal 会抢占部分 Alt 快捷键，替代方案见官方 docs/terminal-setup.md。
4. 斜杠命令
输入 / 搜索命令。最常用的一批：
| 命令 | 作用 |
|---|---|
/model | 选择模型（Ctrl+L 同样打开选择器） |
/thinking | 选择推理强度（Shift+Tab 循环可用档位） |
/login /logout | 管理供应商凭据 |
/settings | 修改常用偏好 |
/new /resume /name /session | 会话新建/切换/命名/查看 |
/tree /fork /clone | 分支与复制（见 05） |
/compact [instructions] | 手动压缩上下文（见 06） |
/copy（Ctrl+X） | 复制最后一条 assistant 回复 |
/export | 导出为 HTML 或 JSONL |
/share | 上传会话拿查看链接 |
/trust | 保存项目信任决策 |
/hotkeys | 查看当前会话生效的快捷键 |
/debug | 把渲染行与当前会话消息写入 pi-debug.log（在 agent 目录） |
/bug [描述] | 生成给开发者的私有报告（可含会话转录，注意敏感信息） |
/reload | 手动改配置/资源后重新加载 |
/scoped-models | 控制 Ctrl+P 的模型循环范围 |
/llama | 管理 llama.cpp router（本地模型） |
Prompt template、skill、extension 都能往同一个菜单里加命令。
5. 直接跑终端命令
!git status # 执行，并把输出纳入对话上下文
!!git status # 执行，但不把输出发给模型
这两者产生的是 bashExecution 消息，而不是模型工具调用的结果，是两种不同来源的「命令输出」。
6. 复制、导出、分享
/copy（或Ctrl+X）复制最后一条回复。/export写 HTML 或 JSONL。/share上传并返回查看链接：配置了 Radius 认证时是 Radius 组织内可见的 artifact，否则通过 GitHub CLI 创建私有 gist。
分享前务必自己过一遍：会话可能包含 prompt、工具参数、命令输出、文件内容，以及在对话过程中暴露过的凭据。
7. 终端外观
fullscreen（默认）：编辑器与状态区固定，transcript 在窗口内滚动。regular：使用终端自身的滚动缓冲。
用 /settings 或 --tui-mode 切换。鼠标、快捷键、内联图片的支持度因终端而异，见 docs/terminal-setup.md、docs/keybindings.md。
8. 排障
终端渲染或会话状态异常时运行 /debug，它把渲染后的终端行与当前会话消息写入 agent 目录下的 pi-debug.log。分享该文件前要检查——它可能含 prompt、模型回复、工具输出、文件内容与终端数据。
溯源
- 官方
docs/usage.md、docs/slash-commands.md、docs/keybindings.md、docs/settings.md