Pi 命令速查
这是一份面向日常使用的参考页。第一次使用请先完成10 分钟快速上手。
常用 command 速记
先记住这十几条，就覆盖了绝大多数日常操作。完整分类参考见下方各节。
启动与任务
| 命令 | 用途 |
|---|---|
pi | 启动交互式终端界面 |
pi -p "任务" | 输出最终回复后退出（脚本友好） |
pi -c | 继续最近一次会话 |
pi -r | 浏览并选择历史会话 |
pi --no-session | 临时会话，不写入会话文件 |
pi @README.md "概览" | 启动时引用项目文件 |
会话内斜杠命令
| 命令 | 用途 |
|---|---|
/login / /logout | 登录或清除供应商凭据 |
/model | 选择模型 |
/new | 开始新会话 |
/resume | 选择历史会话继续 |
/name <名称> | 设置当前会话显示名称 |
/tree | 跳到会话树中的任意节点 |
/fork / /clone | 分支 / 克隆当前会话 |
/compact [说明] | 压缩旧上下文，释放窗口 |
/settings | 修改主题、thinking 级别等偏好 |
/trust | 保存项目信任决策 |
/quit | 退出 Pi |
编辑器快捷键
| 操作 | 行为 |
|---|---|
@ | 模糊搜索项目文件 |
| Shift+Enter | 多行输入（Windows Terminal 用 Ctrl+Enter） |
| Ctrl+V | 粘贴文本或图片（Windows 常用 Alt+V） |
!command | 执行命令并把输出加进上下文 |
!!command | 执行命令但输出不进上下文 |
| Ctrl+G | 在外部编辑器里编辑消息 |
命令行结构
pi [options] [@files...] [messages...]启动模式
| 命令 | 用途 |
|---|---|
pi | 启动交互式终端界面 |
pi "任务" | 带首条消息启动交互会话 |
pi -p "任务" | 输出最终回复后退出 |
pi --mode json "任务" | 以 JSON Lines 输出所有事件 |
pi --mode rpc | 通过 stdin/stdout JSONL 供程序控制 |
pi --no-session | 临时会话，不写入会话文件 |
模型与认证
| 命令 | 用途 |
|---|---|
/login | 登录订阅供应商或保存 API Key |
/logout | 清除选定供应商的凭据 |
pi auth print-api-key --model <model> [--provider <provider>] | 输出指定模型使用的 API Key |
pi auth print-bearer-token --model <model> [--provider <provider>] | 输出指定模型使用的 Bearer Token |
/model | 选择模型 |
/scoped-models | 配置快捷循环的模型范围 |
/llama | 管理 llama.cpp 路由器中的模型 |
pi --list-models [关键词] | 列出或搜索可用模型 |
pi --provider <名称> | 启动时指定供应商 |
pi --model <模型> | 启动时指定模型或匹配模式 |
pi --thinking <级别> | 设置思考级别 |
--thinking 支持 off、minimal、low、medium、high、xhigh 和 max。实际可用级别取决于模型。
pi auth print-* 会把真实凭据写到标准输出。只把它用于受控的进程管道，不要粘贴到聊天、日志或 CI 输出中；不确定时继续使用密钥管理系统注入环境变量。
如何在订阅、本机 API Key 和 CI 之间选择，见认证与模型。
会话
| 命令 | 用途 |
|---|---|
pi -c | 继续最近一次会话 |
pi -r | 浏览并选择历史会话 |
pi --name "名称" | 启动时设置会话显示名称 |
pi --session <路径或 ID> | 打开指定会话 |
pi --fork <路径或 ID> | 从指定会话创建新的会话文件 |
/session | 查看当前会话文件、ID、用量和成本 |
/resume | 在交互界面选择历史会话 |
/new | 开始新会话 |
/name <名称> | 设置当前会话的显示名称 |
/tree | 跳到会话树中的任意节点 |
/fork | 从早期用户消息创建新会话 |
/clone | 把当前活动分支复制为新会话 |
/compact [说明] | 总结旧上下文，释放上下文窗口 |
会话默认保存在 ~/.pi/agent/sessions/，并按工作目录组织。
需要理解分支树和 steering / follow-up 队列，见日常使用与会话。
文件与输入
| 操作 | 用途 |
|---|---|
在编辑器中输入 @ | 模糊搜索项目文件 |
pi @README.md "概览" | 启动时引用单个文件 |
pi @a.ts @a.test.ts "审查" | 同时引用多个文件 |
| Shift+Enter | 输入多行消息；Windows Terminal 通常使用 Ctrl+Enter |
| Ctrl+V | 粘贴文本或图片；Windows 通常使用 Alt+V |
| Ctrl+G | 在外部编辑器中编辑消息 |
Shell
| 输入 | 行为 |
|---|---|
!command | 执行命令，并把输出加入模型上下文 |
!!command | 执行命令，但不把输出加入模型上下文 |
这两个形式都以启动 Pi 的用户权限执行。它们的区别只在于输出是否进入模型上下文。
常用斜杠命令
| 命令 | 用途 |
|---|---|
/settings | 修改思考级别、主题、消息投递和传输设置 |
/reload | 重载快捷键、上下文、扩展、技能、模板和主题 |
/trust | 保存项目信任决策 |
/copy | 复制最后一条助手消息 |
/export [文件] | 导出会话为 HTML 或 JSONL |
/import <文件> | 导入并恢复 JSONL 会话 |
/share | 上传为未公开（secret）的 GitHub Gist 并生成链接 |
/hotkeys | 显示快捷键 |
/changelog | 查看版本变更 |
/quit | 退出 Pi |
/share 会产生外部网络与云端状态变化。secret Gist 不出现在公开列表中，但知道链接的人仍可访问；它不是访问控制意义上的私有存储。不要用它分享机密会话。
工具范围
Pi 的内置工具包括：
readwriteeditbashgrepfindls
默认主要工具是 read、write、edit 和 bash。可以在启动时限制：
pi --tools read,grep,find,ls
pi --exclude-tools bash,write,edit
pi --no-tools工具 allowlist 能缩小可调用能力，但不是操作系统级沙箱。
项目信任
| 参数 | 行为 |
|---|---|
--approve, -a | 本次运行信任项目本地资源 |
--no-approve, -na | 本次运行忽略项目本地资源 |
/trust | 保存以后使用的信任决策 |
非交互模式不会显示信任提示。没有已保存决策时，默认 ask 会让非交互运行跳过受保护的项目资源。
项目信任不限制文件和 shell 权限，完整解释见权限与安全边界。
Pi 包
| 命令 | 用途 |
|---|---|
pi install <来源> [-l] | 安装 Pi 包；-l 写入项目设置 |
pi remove <来源> [-l] | 移除 Pi 包 |
pi list | 列出已安装包 |
pi config | 启用或停用包资源 |
pi update --self | 更新 Pi |
pi update --extensions | 更新已安装的 Pi Packages |
pi update --models | 刷新模型目录 |
pi update --all | 更新 Pi 与已安装的 Pi Packages |
安装第三方包会引入与当前用户同权限运行的代码。安装前先审查来源。
还不确定应该使用 AGENTS.md、Skill、Extension 还是 Package？查看配置与扩展。
选择哪种模式
| 目标 | 推荐模式 |
|---|---|
| 和 Pi 一起探索、修改项目 | 交互模式 |
| CI 中生成一段文本 | -p，并显式配置项目信任 |
| 记录完整结构化事件 | --mode json |
| 从 IDE 或自定义 UI 控制 Pi | --mode rpc |
| 只做一次、不保留历史 | --no-session |
需要协议约束、Node 子进程和 SDK 示例时，继续读自动化与程序集成。
完整 CLI 参考以 Using Pi 为准。