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

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

上篇发了安装教程（[点击查看](https://doc.softlv.top/doc/80)），不少人装好之后问：**进去之后那些斜杠命令都是干嘛的？**

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

---

## 一、模型切换

### /model — 切换模型

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

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

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+L` | 打开模型选择 |
| `Ctrl+P` | 循环浏览收藏的模型 |

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

---

## 二、会话管理

### /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
```

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

| 设置项 | 说明 |
|--------|------|
| Thinking level | 模型思考深度，越高越慢但质量越好 |
| Theme | 终端主题 |
| Transmission protocol | HTTP 还是 WebSocket |

### /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 消耗、运行时间等。

---

## 快速查询表

| 命令 | 功能 | 常用场景 |
|------|------|----------|
| `/model` | 切换模型 | 对比回答、换用国内模型 |
| `/tree` | 会话树 | 回溯、改分支 |
| `/compact` | 压缩上下文 | 长对话收尾 |
| `/export` | 导出 HTML | 存档分享 |
| `/share` | 分享链接 | 发给同事 |
| `/goto` | 跳转目录 | 换项目 |
| `/search` | 全文搜索 | 找代码 |
| `/settings` | 设置 | 调主题 |
| `/reload` | 重载扩展 | 装完 Skill 后 |
| `/install` | 安装技能 | 扩展能力 |
| `/abort` | 中断 | 跑偏了 |
| `/help` | 帮助 | 忘了命令 |

---

## 写在最后

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

下期预告：**Pi + 多模型实战：Claude/GPT/MiniMax 怎么配合用**。

---

## 评论区预置内容

/reload 装完 Skill 必用
Ctrl+P 切模型真方便
compact 我之前都不知道
tree 这个功能太实用了

摘要

标签多个标签用逗号分隔

分类