前两篇已经装好了 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 MessagesOpenAI Responses
接入 ID(必填)deepseek-officialdeepseek-official
名称DeepSeekDeepSeek
Base URLhttps://api.deepseek.com/anthropichttps://api.deepseek.com
本机代理关闭关闭
API key填入在 DeepSeek 开放平台申请的密钥,或填 $DEEPSEEK_API_KEY同左
认证头默认默认
请求头自动推荐自动推荐

注意: 「接入 ID」不能直接填 deepseek,因为 deepseek 是 pi 内置的接入名,重名会无法保存,填 deepseek-official 即可。

填好接入信息后,按 Ctrl+S 进入第一个模型的配置页面。

2. 配置模型参数(上下文与输出等)#

以 DeepSeek 官方的 deepseek-flash(或 deepseek-v4-pro)为例,各字段设置如下:

字段配置值说明
模型 IDdeepseek-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
EscAI 正在输出或执行工具时,随时按 Esc 立即中断任务
Shift+Enter在输入框内换行(直接按 Enter 是发送消息)
Ctrl+O展开或折叠工具调用的详细输出内容
Ctrl+T显示或隐藏 AI 的思考过程(Thinking 块)
/copy(或 Ctrl+X)一键复制 AI 最后一条回复的内容
/hotkeys查看当前会话支持的所有键盘快捷键