引用文件：@ 符号
想让 Pi 参考某个具体文件，用 @ 模糊搜索，或直接在命令行传文件：
pi @README.md "Summarize this"
pi @src/app.ts @src/app.test.ts "Review these together"
图片或文本可以 Ctrl+V 粘贴（Windows 用 Alt+V），图片也能拖进支持的终端。
贯穿项目做
md-tools 时，你会经常用 pi @某个.md 文件 "处理一下" 来让 Pi 处理具体文档——这是这套工具的核心用法。在交互模式里跑 shell 命令
想让 Pi 执行命令，用 ! 前缀：
!npm run lint
命令的输出会被发送给模型，让 Pi 能「看到」结果、基于它继续干活。
隐藏命令：!!
如果只想跑命令、不想把输出加进模型上下文（省 token），用双感叹号：
!!command
! 和 !! 的区别，一句话：! 结果给模型看，!! 结果不给模型看。
切换模型与思考等级
/model或Ctrl+L选模型Shift+Tab切换思考等级（编辑器边框颜色会变）Ctrl+P/Shift+Ctrl+P循环切换已启用的「作用域模型」
提示编辑器边框颜色表示当前思考等级——颜色一变，你就知道现在跑的是「快思考」还是「深思考」。
落地练习：引用 + 跑命令
- 建一个
test.md，写几行字 - 启动
pi，输入pi @test.md "用一句话总结这个文件"（或在交互里打@test.md选中它） - 输入
!ls，看命令输出进了模型上下文 - 再输入
!!ls，对比两次——这次输出没给模型
怎么判断做对了？——你理解了
@引用文件、!给模型看输出、!!不给模型看输出这三者的区别。
卡住了怎么办？ @ 搜不到文件 → 先确认文件在当前目录。! 命令没执行 → 检查是不是拼错了，或终端权限。分不清 !/!! → 记住「单给看、双不给看」。
常见坑：把不该给模型的输出塞进上下文
新手常犯的错，是把 ! 和 !! 混用——该用 !! 的排查命令用了 !，导致一堆无关输出塞进上下文，既费 token 又干扰模型。
判断标准：命令输出对 Pi 继续干活有用 → 用 !；只是你自己想看结果、不想污染模型 → 用 !!。分清这条，上下文干净又省额度。
小结
@引用文件，可传多个、可传图片!命令跑命令且输出给模型!!命令跑命令但输出不给模型/model/Ctrl+L切模型，Shift+Tab切思考等级- 编辑器边框颜色 = 当前思考等级
下一节，进入会话管理：会话怎么存、怎么续、怎么分支。