Pi Agent: CLI 参考手册与斜杆命令
最后更新：2026-08-31
CLI 是 Pi Agent 的"驾驶舱"——熟记命令，操控自如。
1. 全局选项
BASH
pi-agent [选项] [命令]
选项:
--version 显示版本号
--help 显示帮助
--config <path> 指定配置文件路径
--verbose 详细输出模式
--quiet 静默模式
--debug 调试模式
2. 核心命令
(1) chat - 交互式对话
BASH
pi-agent chat [选项] [消息]
选项:
--provider <name> 指定 LLM 提供商
--model <name> 指定模型
--skill <name> 加载技能
--system <prompt> 系统提示词
--session <name> 恢复会话
--context <file> 加载上下文文件
--sandbox 启用沙箱模式
(2) run - 非交互执行
BASH
pi-agent run [选项] <提示词>
选项:
--input <file> 从文件读取输入
--output <file> 输出到文件
--format <type> 输出格式 (text|json|markdown)
--skill <name> 使用技能
--stream 流式输出
--timeout <seconds> 超时时间
(3) config - 配置管理
BASH
pi-agent config set <key> <value> # 设置配置
pi-agent config get <key> # 获取配置
pi-agent config list # 列出所有配置
pi-agent config validate # 验证配置
3. 工具与技能命令
(1) skills - 技能管理
BASH
pi-agent skills list # 列出所有技能
pi-agent skills show <name> # 查看技能详情
pi-agent skills create <name> # 创建技能骨架
pi-agent skills install <package> # 安装技能包
pi-agent skills remove <name> # 删除技能
(2) tools - 工具管理
BASH
pi-agent tools list # 列出所有工具
pi-agent tools show <name> # 查看工具详情
pi-agent tools test <name> # 测试工具
(3) ext - 扩展管理
BASH
pi-agent ext list # 列出已安装扩展
pi-agent ext install <name> # 安装扩展
pi-agent ext update <name> # 更新扩展
pi-agent ext remove <name> # 卸载扩展
pi-agent ext create <name> # 创建扩展骨架
pi-agent ext package <name> # 打包扩展
pi-agent ext publish <name> # 发布扩展
4. 会话命令
BASH
pi-agent sessions list # 列出所有会话
pi-agent sessions show <name> # 查看会话详情
pi-agent sessions delete <name> # 删除会话
pi-agent sessions export <name> # 导出会话
pi-agent sessions search <query> # 搜索会话
5. 包管理命令
BASH
pi-agent pkg search <query> # 搜索包
pi-agent pkg install <name> # 安装包
pi-agent pkg update [name] # 更新包
pi-agent pkg remove <name> # 卸载包
pi-agent pkg list # 列出已安装包
pi-agent pkg info <name> # 查看包详情
pi-agent pkg build <name> # 构建包
pi-agent pkg validate <name> # 验证包
pi-agent pkg publish <name> # 发布包
6. 斜杆命令（交互模式）
| 命令 | 说明 | 示例 |
|---|---|---|
| /help | 显示帮助 | /help |
| /exit | 退出 | /exit |
| /clear | 清空对话 | /clear |
| /model | 切换模型 | /model deepseek-reasoner |
| /provider | 切换提供商 | /provider openai |
| /tools | 列出工具 | /tools |
| /use | 启用工具 | /use shell |
| /unuse | 禁用工具 | /unuse search |
| /skill | 加载技能 | /skill code_review |
| /save | 保存会话 | /save session.json |
| /load | 加载会话 | /load session.json |
| /context | 显示上下文 | /context |
| /history | 显示历史 | /history |
| /retry | 重新生成 | /retry |
| /edit | 编辑上条消息 | /edit |
| /theme | 切换主题 | /theme dark |
| /trust | 设置信任 | /trust readonly |
| /cost | 费用统计 | /cost |
| /branch | 创建分支 | /branch experiment |
7. 常用组合示例
▶ 示例 1：代码审查工作流（难度⭐）
BASH
pi-agent chat --skill code_review --system "你是 Python 专家"
# 进入交互模式后：
# /use file_reader
# /use search
# 审查 main.py 的代码质量
# /save review_20260828.json
# /exit
▶ 示例 2：管道批处理（难度⭐⭐）
BASH
find . -name "*.py" -exec echo {} \; | pi-agent run --skill code_review "审查文件列表"
❓ 常见问题
Q 命令太多记不住？
A 交互模式输入 /help 查看斜杆命令。CLI 用
pi-agent --help 查看全局命令。Q 命令可以缩写吗？
A 部分命令支持缩写，如
pi-agent c = pi-agent chat，pi-agent r = pi-agent run。用 --help 查看支持的缩写。Q 如何在脚本中获取 JSON 输出？
A 加
--format json 参数：pi-agent run "问题" --format json。📖 小节
- 核心 CLI 命令：chat、run、config
- 管理命令：skills、tools、ext、sessions、pkg
- 20+ 斜杆命令覆盖交互模式所有操作
- 支持 JSON 输出，便于脚本集成
📝 作业
- 基础题（难度⭐）：用 CLI 完成：创建会话 → 对话 3 轮 → 保存 → 重新加载。
- 进阶题（难度⭐⭐）：用
pi-agent run配合管道，批量审查目录下的 Python 文件。 - 挑战题（难度⭐⭐⭐）：编写一个 shell 脚本，封装常用的 Pi Agent CLI 命令组合，实现一键代码审查+修复+测试。
