前两篇已经装好了 Node.js、pi 本体和常用插件。这一篇介绍如何用 pi-model-manager 配置模型(以 DeepSeek 官方 API 为例),以及在 Linux 下日常使用 pi 的高频命令与操作。
一、使用 pi-model-manager 配置模型#
先在终端启动 pi:
pi
在底部输入框输入以下命令并回车,打开模型管理面板:
/model-manager
1. 新建接入(以 DeepSeek 官方 API 为例)#
在 /model-manager 主界面按 N 新建接入,用 ↑ / ↓ 移动光标,按 Enter 编辑字段,按 ← / → 切换开关。
DeepSeek 官方同时支持 Anthropic 兼容接口和 OpenAI Responses 接口,按下面任意一套填写即可(推荐 Anthropic Messages):
| 字段 | 推荐配置(Anthropic 协议) | 备选配置(OpenAI Responses 协议) |
|---|---|---|
| API 协议 | Anthropic Messages | OpenAI Responses |
| 接入 ID(必填) | deepseek-official | deepseek-official |
| 名称 | DeepSeek | DeepSeek |
| Base URL | https://api.deepseek.com/anthropic | https://api.deepseek.com |
| 本机代理 | 关闭 | 关闭 |
| API key | 填入在 DeepSeek 开放平台申请的密钥,或填 $DEEPSEEK_API_KEY | 同左 |
| 认证头 | 默认 | 默认 |
| 请求头 | 自动推荐 | 自动推荐 |
注意: 「接入 ID」不能直接填
deepseek,因为deepseek是 pi 内置的接入名,重名会无法保存,填deepseek-official即可。
填好接入信息后,按 Ctrl+S 进入第一个模型的配置页面。
2. 配置模型参数(上下文与输出等)#
以 DeepSeek 官方的 deepseek-flash(或 deepseek-v4-pro)为例,各字段设置如下:
| 字段 | 配置值 | 说明 |
|---|---|---|
| 模型 ID | deepseek-flash | 也可点击「重新拉取」从上游列表直接选择,或填 deepseek-v4-pro |
| 显示名称 | 留空(默认与模型 ID 一致) | 自定义在列表里展示的名字 |
| 视觉支持 | 开启 | deepseek-flash 支持图片输入;deepseek-v4-pro 设为 关闭 |
| Thinking | 开启 | 开启深度思考能力 |
| Adaptive | 开启 · 新版协议 | Anthropic 协议下开启思考后显示,保持开启即可 |
| 上下文窗口 | 1000000(或输入 1M) | DeepSeek 官方支持 1M 上下文,可按 ← / → 切换预设档位,或按 Enter 手动输入 1M |
| 最大输出 | 128000(或输入 384K) | 单次回复最大输出 token 数,常用 128000(128K),官方上限为 384K |
如果后续要配置其他平台或中转的模型,按同样的流程以此类推。如果不清楚模型的具体参数,上下文窗口默认填 500K(500000),最大输出默认填 128K(128000)。
重要使用建议:
平时使用时千万不要用完所有的上下文,上下文塞满后模型会变得很蠢。建议将上下文占用控制在 50% 以内,看到底部状态栏占比高了,就及时用
/new开启新对话或用/compact压缩。
确认无误后,按 Ctrl+S 保存并启用模型,再按 Esc 退出 /model-manager 面板。
二、在指定目录下启动 pi#
pi 是按工作目录来检索文件、读取项目配置和保存对话记录的。平时使用时,先 cd 到你的项目目录再启动:
# 进入项目目录
cd ~/workspace/my-project
# 启动 pi
pi
首次进入某个项目目录时,pi 可能会询问是否信任该目录,确认即可。
如果想直接恢复当前目录上一次的对话,启动时加上 --continue:
pi --continue
三、pi 常用命令与操作#
进入 pi 后,在输入框里输入 / 就能看到命令菜单。下面是最常用的命令与快捷操作。
1. /model:切换模型#
刚才在 /model-manager 里保存模型后,不会自动切换当前会话的模型。输入:
/model
(或直接按快捷键 Ctrl+L)打开模型选择器,输入关键词找到刚才配好的 deepseek-official/deepseek-flash:
- 按
Enter:当前会话立即切换到该模型。 - 按
Ctrl+S:将该模型设为以后新开会话的默认模型。
2. 切换思考等级(Thinking)#
对于开启了 Thinking 的模型,可以随时调整推理深度:
- 快捷键切换:直接按
Shift+Tab,可以在模型支持的思考等级(如off、minimal、low、medium、high、xhigh、max)之间循环切换,输入框边框和状态栏会实时变化。 - 命令切换:输入
/thinking,在列表中选择等级;选中后按Ctrl+S可将其保存为默认启动等级。
3. @:引用项目文件#
想让 AI 读取或修改某个文件时,不需要手打完整路径:
- 在输入框里输入
@,会自动弹出当前项目的文件搜索列表。 - 输入文件名关键词筛选,按
Enter或Tab即可把文件引用插入到提示词中。
例如:
帮我检查 @src/main.py 里的异常处理有没有问题
4. /new 与会话管理#
一个任务处理完、准备开始新任务时,不要混在同一个超长对话里,直接新建会话:
/new:清空当前画面,开启一个全新的对话会话。/resume:打开历史会话列表,切回之前的某次对话。/compact:当对话太长、上下文占用过高时,主动压缩历史上下文以节省 token。
5. /quit:退出 pi#
结束使用想要退出终端界面时,输入:
/quit
6. 其他高频技巧#
| 操作 / 命令 | 说明 |
|---|---|
!命令 | 在 pi 里直接执行 shell 命令并把输出发给 AI(例如 !git status) |
!!命令 | 执行 shell 命令,但输出仅自己查看,不发给 AI |
Esc | AI 正在输出或执行工具时,随时按 Esc 立即中断任务 |
Shift+Enter | 在输入框内换行(直接按 Enter 是发送消息) |
Ctrl+O | 展开或折叠工具调用的详细输出内容 |
Ctrl+T | 显示或隐藏 AI 的思考过程(Thinking 块) |
/copy(或 Ctrl+X) | 一键复制 AI 最后一条回复的内容 |
/hotkeys | 查看当前会话支持的所有键盘快捷键 |