Pi Agent 斜杠命令手册

以下是 Pi Agent 交互模式下所有内置斜杠命令的速查表。

---

账户与认证

本节命令用于登录和登出 AI 提供商，凭证保存在 ~/.pi/agent/auth.json 中。

命令	功能	示例
/login	登录 AI 提供商	首次使用时输入 /login，在列表中选择 Anthropic 完成订阅登录
/logout	登出，清除凭证	无参数；换用其他提供商或 API Key 认证前先执行，避免旧凭证干扰

---

模型管理

本节命令用于切换模型、调整推理等级以及管理 Ctrl+P 循环时可用的模型列表。

命令	功能	示例
/model	打开模型选择器	打开选择器后输入 sonnet 过滤并回车选择，按 Ctrl+S 可保存为启动默认
/thinking	切换推理等级	无参数；在等级列表中从 medium 切到 high，按 Ctrl+S 可保存为启动默认
/scoped-models	管理 Ctrl+P 可用模型列表	无参数；只想在少数几个模型间循环时，用它勾选常用模型
/llama	管理 llama.cpp 本地模型（见《与 llama.cpp 本地模型》一章）	无参数；打开模型菜单，选中未加载模型回车加载，选中已加载模型回车卸载

---

会话管理

本节命令用于新建、恢复、命名、导航与压缩会话。

命令	功能	示例
/new	开始新会话	无参数；当前方向走不通时，开一个干净的会话重新开始
/resume	恢复历史会话	重启终端后输入 /resume，从列表中选中上次的会话继续
/name <名称>	设置当前会话名	/name 重构认证模块，之后在 /resume 列表中按名称快速定位
/session	查看会话信息	压缩前后各执行一次，对比 token 用量与费用变化
/tree	打开会话树浏览器	同一问题试了两种实现后，用它跳回之前的节点换条路走
/fork	从历史消息分叉新会话	想从第 3 轮提问重新开始，又不影响当前会话时使用
/clone	克隆当前分支到新会话	让 AI 大改代码之前先 /clone 留一份副本，改坏了随时回退
/compact	手动压缩上下文	无参数时按默认策略压缩；也可用 /compact 重点关注安全变更 指定摘要重点

---

内容操作

本节命令用于复制、导出、导入与分享会话内容。

命令	功能	示例
/copy	复制 AI 最后一条回复	无参数；要把解决方案粘到 issue 或文档里时使用
/export <文件>	导出为 HTML 或 JSONL 文件	/export ~/Desktop/session.html
/import <文件>	导入 JSONL 会话文件	/import session.jsonl
/share	上传为私有 GitHub Gist 并分享	无参数；执行后生成私有 Gist 的可分享 HTML 链接

---

设置与管理

本节命令用于调整设置和维护运行环境。

命令	功能	示例
/settings	打开设置面板	无参数；想调整推理等级、主题或传输协议时使用
/trust	保存项目信任决策	确认项目来源可信后执行，避免每次启动都弹出信任询问
/reload	热重载所有资源	修改扩展或 Skill 代码后执行，无需退出重启
/hotkeys	显示快捷键列表	无参数；忘记某个操作对应哪个快捷键时查看
/changelog	显示版本更新日志	升级后执行，快速了解本次更新带来了哪些变化
/quit	退出 Pi Agent	无参数；会话已自动保存，退出不会丢失记录

---

扩展命令

Extensions 可以注册自定义命令。

Skills 自动注册为 /skill:名称 命令。

提示词模板通过 /模板名 调用。

命令类型	格式	示例
扩展命令	/命令名	/stats
Skill 命令	/skill:技能名	/skill:brave-search
提示词模板	/模板名	/review

---

Shell 命令

在输入框以 ! 或 !! 开头即可直接执行终端命令，无需退出 Pi Agent。

前缀	功能	示例
!	执行命令，输出发送给 AI	!npm test，让 AI 根据测试失败信息继续修复
!!	执行命令，输出不发送给 AI	!!cat ~/.zshrc，只是自己查看内容，不占用上下文