LLM之Agent（六十四）｜PI（三）交互模式与 CLI 命令

把 Pi 当成一个熟悉的终端伙伴而不是黑盒工具——本篇把界面构成、slash 命令和命令行参数摊开讲清楚。

学习目标

• 理解交互模式界面的四个组成区域
• 掌握编辑器内的关键操作（文件引用、多行输入、shell 命令等）
• 记住高频使用的 slash 命令及其作用
• 理解交互模式与非交互模式（-p/JSON/RPC）的本质区别
• 能够查表使用 CLI 的模型、会话、工具、资源相关参数

交互模式的界面构成

Pi 的交互界面（TUI，Terminal UI）由四个区域组成：

• 启动头部（Startup header）：显示快捷键提示、已加载的上下文文件、Prompt 模板、Skills 和扩展列表
• 消息区（Messages）：用户消息、助手回复、工具调用与结果、通知、错误信息，以及扩展自定义 UI
• 编辑器（Editor）：你输入内容的地方，边框颜色会随当前 thinking level（思考强度）变化
• 底部状态栏（Footer）：显示工作目录、会话名称、token/缓存用量、费用、上下文占用比例，以及当前模型

编辑器区域在打开 /settings 等内置面板或自定义扩展 UI 时会被临时替换。

编辑器常用操作

所有快捷键都可以在 ~/.pi/agent/keybindings.json 中自定义，完整清单和自定义方法见《05-配置与个性化》。

Slash 命令一览

在编辑器中输入 / 会弹出命令补全。扩展可以注册自定义命令，Skills 会以 /skill:名称 的形式出现，Prompt 模板则通过 /模板名 展开。内置的常用命令包括：

消息队列：Agent 工作时你还能做什么

Agent 执行一轮任务往往需要多次工具调用，中途你可以继续输入消息，Pi 提供两种排队方式：

• Enter 排队一条"引导消息"（steering message），会在当前这轮助手回复的工具调用执行完之后立即插入；
• Alt+Enter 排队一条"后续消息"（follow-up message），要等 Agent 彻底完成当前所有工作后才会送达；
• Escape 中止当前操作，并把已排队的消息重新放回编辑器；
• Alt+Up 把已排队的消息重新取回编辑器编辑。

这两种投递方式的具体策略（一次性发送全部排队消息，还是逐条发送）可以在 /settings 里通过 steeringMode 和 followUpMode 配置，详见《05-配置与个性化》。

交互模式 vs 非交互模式

Pi 默认启动即进入交互模式（Interactive Mode）,这也是本篇前面介绍的一切的运行环境。但 Pi 同样支持三种非交互模式，适合脚本化、CI 集成或程序化调用：

在 print 模式下，Pi 还会读取管道传入的 stdin 并合并进初始提示词：

cat README.md | pi -p "Summarize this text"

–mode json 和 –mode rpc 面向的是把 Pi 作为其他程序的"引擎"来调用的场景，具体协议格式会在后续《07-协议服务化与遥测》章节详细讲解，本篇只需要知道它们的存在和触发方式。

上下文文件回顾

Pi 在启动时会从 ~/.pi/agent/AGENTS.md（全局）以及当前目录向上追溯的各级目录中加载 AGENTS.md/CLAUDE.md（项目级，逐层叠加）。若某目录存在 AGENTS.override.md，会替代该层原本的文件。用 –no-context-files（或简写 -nc）可以彻底关闭这一发现机制。

Pi 还支持完全替换默认系统提示词：

• 项目级：.pi/SYSTEM.md
• 全局级：~/.pi/agent/SYSTEM.md

如果只是想在默认系统提示词基础上追加内容而不是替换，用同目录下的 APPEND_SYSTEM.md 即可。这部分内容在《02-快速开始》中已经从"让 Pi 了解你的项目"的角度介绍过，这里作为 CLI 参考的一部分再次列出。

CLI 参数参考

Pi 的基本调用形式：

pi [options] [@files…] [messages…]

包管理命令

pi install <source> [-l] # 安装包，-l 表示仅当前项目生效
pi remove <source> [-l] # 移除包
pi uninstall <source> [-l] # remove 的别名
pi update [source|self|pi] # 只更新 pi 本体，或更新指定包源
pi update –all # 更新 pi 和所有包，并调和已固定的 git 引用
pi update –extensions # 只更新包，调和已固定的 git 引用
pi update –models # 只刷新模型目录
pi update –self # 只更新 pi 本体
pi update –extension <src> # 更新单个包
pi list # 列出已安装的包
pi config # 启用/禁用包资源

pi update 不会弹出项目信任询问；pi config 和项目包命令支持 –approve/–no-approve 为单次命令临时信任或忽略项目本地设置。这些命令用于管理 Pi 的扩展生态（详见后续 Pi Packages 相关内容），卸载 Pi CLI 本体请参考《01-安装指南》。

模型选项

会话选项

工具选项

内置工具共 7 个：read、bash、edit、write、grep、find、ls。

资源选项

–no-* 系列参数可以和显式加载参数组合，实现"精确只加载我指定的资源，忽略配置文件里的其他设定"：

pi –no-extensions -e ./my-extension.ts

其他选项

文件参数

在文件路径前加 @ 可以把文件内容附加进消息：

pi @prompt.md "Answer this"
pi -p @screenshot.png "What's in this image?"
pi @code.ts @test.ts "Review these files"

常用示例

# 带初始提示词的交互模式
pi "List all .ts files in src/"

# 一次性非交互调用
pi -p "Summarize this codebase"

# 非交互模式配合管道输入
cat README.md | pi -p "Summarize this text"

# 指定会话名称的一次性任务
pi –name "release audit" -p "Audit this repository"

# 指定 provider 和模型
pi –provider openai –model gpt-4o "Help me refactor"

# 用 provider 前缀指定模型
pi –model openai/gpt-4o "Help me refactor"

# 用简写指定 thinking level
pi –model sonnet:high "Solve this complex problem"

# 限制可循环切换的模型集合
pi –models "claude-*,gpt-4o"

# 只读模式，不允许写文件/执行命令
pi –tools read,grep,find,ls -p "Review the code"

# 禁用某个内置工具或扩展工具
pi –exclude-tools ask_question

设计理念小贴士

Pi 官方文档特别强调一点：它刻意不内置 MCP（Model Context Protocol）支持、子 Agent、权限弹窗、Plan Mode、待办事项列表或后台 bash 执行这些功能。核心保持精简，把工作流相关的能力都下放给扩展、Skills、Prompt 模板和 Pi 包去实现，或者依赖容器、tmux 等外部工具组合完成。理解这个设计取舍，有助于你判断"某个功能该不该向 Pi 团队提需求"还是"该不该自己写个扩展"。

动手练习

小结

交互模式的四区域界面、常用编辑器操作和 slash 命令构成了 Pi 日常使用的骨架；-p/JSON/RPC 三种非交互模式则让 Pi 可以被脚本或其他程序当作引擎调用。CLI 参数按模型、会话、工具、资源四大类组织，–no-* 与显式加载参数搭配使用能精确控制每次运行加载哪些能力。Pi 有意把复杂工作流能力（MCP、子 Agent、权限系统等）排除在核心之外，这个设计取舍会在后面讲解扩展系统和工程实践时反复出现。

延伸阅读：会话的 JSONL 存储格式与 /tree 分支导航背后的实现见《03-Agent核心原理》模块；–mode json/–mode rpc 的完整协议格式见《07-协议服务化与遥测》模块。