Pi Agent 交互模式

本章全面介绍 Pi Agent 交互模式下的核心操作，包括 Slash 命令、模型管理和键盘操作。

Slash 命令大全

在编辑区输入 / 会触发命令自动补全。

以下是 Pi Agent 交互模式下的所有内置命令：

命令	功能	说明
/login	登录提供商	选择 OAuth 订阅或 API Key 提供商进行认证
/logout	登出	清除已存储的认证凭证
/model	切换模型	打开模型选择器，浏览并选择可用的 AI 模型
/scoped-models	模型范围管理	设置 Ctrl+P 循环切换时可用的模型列表
/settings	设置面板	打开内置设置界面：推理等级、主题、消息传递、传输协议等
/resume	恢复会话	从历史会话中选择并恢复
/new	新建会话	开始一个全新的对话
/name	命名会话	为当前会话设置一个易读的名称
/session	会话信息	显示会话文件路径、ID、消息数、token 用量和费用
/tree	会话树导航	跳转到对话树的任意节点继续对话
/trust	信任项目	保存项目信任决策，避免每次启动都询问
/fork	分叉会话	从之前的用户消息分叉出一个新会话文件
/clone	克隆会话	复制当前活动分支到新会话文件
/compact	压缩上下文	手动压缩对话历史，释放上下文窗口空间
/copy	复制回复	复制 AI 最后一条回复到剪贴板
/export	导出会话	将会话导出为 HTML 或 JSONL 文件
/import	导入会话	从 JSONL 文件导入并恢复会话
/share	分享会话	上传为私有 GitHub Gist，生成可分享的 HTML 链接
/reload	热重载	重新加载扩展、Skills、提示词模板、主题和上下文文件
/hotkeys	快捷键帮助	显示所有键盘快捷键列表
/changelog	更新日志	显示版本更新历史
/quit	退出	退出 Pi Agent

除了内置命令，Extensions（扩展）也可以注册自定义命令。Skills 会自动注册为 /skill:名称命令，提示词模板则通过 /模板名来调用。

使用 /model 命令或 Ctrl+L 打开模型选择器，浏览所有可用的 AI 模型。

在模型选择器中，你可以按名称搜索、按提供商过滤，并选择当前想要使用的模型。

Ctrl+P 向前循环切换模型，Shift+Ctrl+P 向后切换。

切换范围由 /scoped-models 命令或 enabledModels 设置控制。

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

编辑器边框颜色会随等级变化，让你直观感知当前的推理深度：

对于非推理型模型（如部分旧版模型），无论设置什么推理等级，实际都以 off 运行。模型的能力决定了推理等级的上限。

你可以在编辑区直接执行 shell 命令，无需离开 Pi Agent：

前缀	行为	输出处理	使用场景
!	执行命令，输出发给 AI	AI 可见	让 AI 查看测试结果、lint 输出、git 状态
!!	执行命令，输出不发给 AI	仅本地显示	打开文件、查看环境、快速检查

使用示例：

!npm test
!git diff --stat
!python -m pytest -v

!!cat ~/.zshrc
!!ls -la

! 命令的输出会占用 AI 的上下文窗口。如果输出很大（如完整日志），考虑使用 !! 或者将输出重定向到文件再让 AI 读取。

消息队列让你在 AI 正在工作时也能发送指令，大幅提升交互效率：

消息类型	快捷键	发送时机	典型场景
Steering（导向）	Enter	当前工具调用完成后立即发送	AI 正在读文件时你想纠正方向
Follow-up（跟进）	Alt+Enter	AI 完成所有工作后才发送	AI 完成任务后你想追加新需求

发送时机对比：

Steering 消息：假设 AI 正在执行一连串的工具调用（read -> edit -> bash）。你按 Enter 发送的 steering 消息会在当前轮次的工具调用全部执行完毕后、下一轮 LLM 调用之前插入。适合中途纠正 AI 的方向。
Follow-up 消息：你按 Alt+Enter 发送的消息会等 AI 完成所有工作（没有更多工具调用需要执行）后才插入。适合 AI 完成当前任务后追加新的需求。

你可以通过设置中的 steeringMode 和 followUpMode 来控制消息的发送策略。

功能	操作方式
文件引用搜索	输入 @ 触发模糊搜索项目文件
路径自动补全	按 Tab 自动补全路径
多行输入	Shift+Enter 换行（Windows Terminal 用 Ctrl+Enter）
粘贴图片	Ctrl+V（Windows 用 Alt+V），或拖拽图片到终端
复制 AI 回复	Ctrl+X 复制最后一条 AI 消息
外部编辑器	Ctrl+G 打开外部编辑器编辑当前内容