Pi Agent 命令大全：30+命令一文搞懂，看这张表就够了

上篇发了安装教程（Pi Agent 安装指南，3分钟跑起来），不少人装好之后问：进去之后那些斜杠命令都是干嘛的？

今天整理一份完整命令手册，按功能分类，附使用场景。收藏好，用的时候直接查。

一、模型切换

/model — 切换模型

/model claude-sonnet-4-20250514
/model gpt-4o
/model deepseek-chat
/model kimi
/model minimax
/model gemini-2.0-flash

Pi 支持 15+ provider，随时切换。快速调出切换界面：

切换后立即生效，不用开新会话。这个功能特别适合对比不同模型的回答质量——同一个问题，让多个模型答，横向对比。

二、会话管理

/tree — 查看会话树

/tree

Pi 的会话是树结构存储的。不是线性的一条对话，而是可以分叉、回到任意节点继续。

这条命令会显示完整的会话树，带编号。你可以：

• 选择某个编号，跳回去继续对话
• 从任意节点开一个新分支
• 查看之前放弃的那些分支

/compact — 压缩上下文

/compact

长对话跑久了，Token 消耗越来越大。Pi 会自动在接近上下文上限时压缩，但如果想手动触发，执行这条命令。

压缩逻辑：保留关键上下文，合并相似的来回试探，丢弃冗余信息。

/export — 导出对话

/export

把当前会话导出为 HTML 文件。打开后是完整的对话记录，格式和终端里看到的一致。

适合：存档、分享给同事、汇报给领导。

/share — 分享会话链接

/share

把会话上传到 GitHub Gist，生成一个可分享的 URL。别人打开链接可以直接查看对话内容。

/clear — 清空当前会话

/clear

不退出 Pi，直接清空当前会话，重新开始。新会话会保留模型选择和当前目录。

三、文件操作

/goto — 跳转到目录

/goto ~/projects/my-app
/goto /d/workspace

切换当前工作目录。Pi 会记住你当前在哪，这样后续的文件操作都在这个目录下。

/open — 打开文件

/open src/main.ts
/open README.md

用默认编辑器打开文件。在终端里直接调起系统关联的编辑器。

/read — 读取文件内容

/read src/main.ts

在终端里直接打印文件内容，不开编辑器。适合快速查看小文件。

/write — 写入文件

/write src/test.ts

进入写入模式，输入内容后 Ctrl+D 保存，Ctrl+C 取消。

/ls — 列出目录内容

/ls
/ls src

列出当前目录或指定目录的文件和文件夹。

四、搜索

/search — 全局搜索

/search "function calculate"
/search "TODO"

在当前目录及子目录下搜索文件内容。支持正则表达式。

/grep — 按文件内容搜索

/grep "error" --glob "*.log"

类似命令行的 grep，指定文件模式匹配内容。

五、系统配置

/settings — 打开设置

/settings

打开设置界面，可以调整：

/model-settings — 调整模型参数

/model-settings

单独调整某个模型的参数，比如 temperature、max tokens 等。

/login — OAuth 登录

/login

有些 provider（Anthropic、OpenAI）支持 OAuth 登录，不用手动填 API Key。适合不想折腾环境变量的人。

六、扩展与技能

/reload — 热重载扩展

/reload

装了新的 Skills 或扩展后，执行这条命令重新加载，不用退出 Pi。

/skills — 查看已安装的技能

/skills

列出当前 Pi 已加载的所有 Skills，显示名称和功能说明。

/install — 安装新技能

/install npm:@heygen/pi-hyperframes
/install git:github.com/badlogic/pi-tools

从 npm 或 git 安装新的 Skill/Package。装完记得 /reload。

/prompt — 列出提示模板

/prompt

查看当前可用的提示模板，输入 /模板名 可以直接展开使用。

七、工具与执行

/run — 执行命令

/run npm install
/run npm test

在终端里执行 Shell 命令。Pi 默认有这个能力，但有些场景下用这个更直观。

/abort — 中断当前任务

/abort

Pi 正在执行某个任务（比如批量改文件），按这个可以中断。

/retry — 重试上一条请求

/retry

如果上一条回答不满意，用这个重新生成。

八、帮助与信息

/help — 查看帮助

/help
/help /model

不加参数列出所有命令，加参数查看某个命令的详细说明。

/version — 查看版本

/version

显示 Pi 当前版本号。

/stats — 查看会话统计

/stats

显示 Token 消耗、API 调用次数、当前上下文大小等信息。

九、其他

/history — 查看历史会话

/history

列出当前工作目录下所有会话历史，可以选择加载某个历史会话。

/bookmark — 书签

/bookmark 这是一个关键节点

给当前对话位置加一个书签，方便以后 /tree 时快速识别重要节点。

/status — 查看状态

/status

显示 Pi 当前状态：模型、目录、Token 消耗、运行时间等。

快速查询表

写在最后

命令不用背，用多了自然记住。这篇存好，用的时候 Ctrl+F 搜一下。