启动 Pi
在项目目录里输入 pi 回车，就进入交互界面。第一次进来别急着干活，先看懂它长什么样。
pi
贯穿项目这一节我们先随便进个空目录启动。等第 4 模块做
md-tools 时，会在那个项目目录里启动 pi 干活。界面有四个主要区域
Pi 的交互界面分四块：
| 区域 | 作用 |
|---|---|
| 启动头部 | 快捷键、已加载的上下文文件、提示词模板、技能、扩展 |
| 消息区 | 你的消息、模型回复、工具调用、工具结果、通知、错误、扩展 UI |
| 编辑器 | 你输入的地方；边框颜色表示当前思考等级 |
| 底部栏 | 工作目录、会话名、token/缓存用量、成本、上下文占用、当前模型 |
编辑器平时是你打字的地方，也可以被内置 UI（如 /settings）或自定义扩展 UI 临时替换。
四个内置工具：让它动手的钥匙
Pi 给模型的是这四个工具。你描述需求，它用工具干活：
| 工具 | 作用 |
|---|---|
read |
读取文件 |
write |
创建或覆盖文件 |
edit |
打补丁式修改文件 |
bash |
运行 shell 命令 |
外加只读辅助（grep、find、ls）通过工具选项可用。
和聊天框最大的区别：Pi 会真正读文件、改文件、跑命令。你在消息区会看到它的工具调用轨迹——这是它能动手的证据。
第一个请求
输入一句请求，按回车：
Summarize this repository and tell me how to run its checks.
观察它：先 read 读文件，可能 bash 跑命令，然后给你结构化总结。你体验到了「它能动手」。
非交互模式：pi -p
不想进交互界面时，用 pi -p 做单次问答：
pi -p "Summarize this codebase"
cat README.md | pi -p "Summarize this text"
pi -p @screenshot.png "What's in this image?"
-p 适合快速验证、脚本、管道处理。更多程序化用法（JSON/RPC）后面生产课讲。
落地练习：让 Pi 动手
- 建个空目录，
cd进去，启动pi - 输入「当前目录有什么文件」，观察它用工具列目录
- 再输入「帮我看看这个项目的结构」，观察它
read文件
怎么判断做对了？——你能在消息区看到它的工具调用轨迹（读了哪个文件、跑了什么命令），而不只是纯文字回复。
卡住了怎么办？ 它没动手只回文字？再明确一点「读一下当前目录的文件并说明」。它报错？把报错贴给它或对照上节的认证排查。
常见坑：只盯着「答案」看
刚上手的人只注意最后那段文字，忽略上面的工具调用轨迹。
轨迹才是关键——它告诉你 Pi「真读了哪些文件、真跑了什么命令、有没有越界」。盯着轨迹看，你才能审查它。这是后面「审查」环节的基础。
小结
pi启动，界面分四块：头部/消息/编辑器/底部栏- 四个内置工具：
read/write/edit/bash - 消息区能看到工具调用轨迹
pi -p做单次问答，pi进交互界面
下一节，我们细看交互界面和斜杠命令。