在终端里使用 Pi

在你想工作的文件夹里运行 pi：Pi 用该文件夹发现文件、指令和配置，并给保存的会话分组；在加载项目资源前可能会问你是否信任该文件夹（见「服务商与安全」）。界面里，对话区显示你的提示、Pi 的回复、工具调用、结果和错误；你在编辑器里写提示和命令；页脚显示当前文件夹、会话、模型、上下文用量和累计用量与费用。

输入提示：Enter 发送，Shift+Enter 换行，Ctrl+G 在外部编辑器里写长提示。加入文件或图片：输入 @ 搜索文件加入提示、Tab 补全路径、粘贴图片或拖进兼容的终端。跟随 Pi 的工作：Pi 在工作时显示每个工具调用和结果；Ctrl+O 展开/折叠工具输出，Ctrl+T 显示/隐藏思考块；编辑器边框指示当前思考级别。Pi 不会在每次工具调用前询问你，请审查命令和改动的文件，对不受信任或无人值守的工作使用沙箱。

中途转向：Pi 工作时你可以继续发送输入：输入消息并 Enter——调整当前任务（等当前回复及其工具调用完成后引导下一次回复）；输入消息并 Alt+Enter——在当前任务之后追加工作（follow-up，等 Pi 完成当前任务）；Alt+Up——把排队的消息拿回编辑器；Escape——停止当前任务（中止时排队消息回到编辑器）。Windows Terminal 保留部分 Alt 快捷键，参见 Terminal Setup 的替代方案。常用命令：输入 / 搜索命令：/model 选模型（Ctrl+L 打开同一选择器）、/thinking 选推理量（Shift+Tab 循环支持的级别）、/login、/logout、/settings、/reload（手动改设置、键位、指令或资源后重新加载）；提示模板、技能和扩展会往同一个菜单里添加命令。

工作原理：Pi 协调模型请求、工具执行、上下文组装和会话存储。一个提交的消息加入活动分支，Pi 用系统提示、活动分支、可用工具和模型设置构建请求，经所选服务商发送；服务商流式返回含文本和工具调用的回复，Pi 记录回复、执行每个工具调用并记录结果，这构成一个回合；若工具结果或排队消息需要再次请求就开始新回合。内置工具有 read、bash（Windows 上 powershell）、edit（对已有文件做精确文本替换）、write、grep、find、ls，以及 codemode（运行调用其他工具的 JavaScript）和 tool_search。