上一篇配好了 Node.js 和 npm 镜像。这一篇安装本系列使用的 AI harness:pi,并装齐常用插件。
一、什么是 pi#
pi 是一个运行在终端里的极简、可扩展 AI 编程助手底座(harness),可以通过插件、技能、提示词模板和主题按自己的工作流定制。
- 官网:
https://pi.dev - 插件中心:
https://pi.dev/packages
二、在 Linux 下安装 pi#
官方提供两种安装方式,任选其一即可。
方式一:官方脚本安装(推荐)
官方脚本会锁定所有依赖版本,后续可以直接用 pi update 升级:
curl -fsSL https://pi.dev/install.sh | sh
方式二:使用 npm 全局安装
上一篇已经配好了 Node.js(需 22.19 及以上)和淘宝镜像源,也可以直接用 npm 安装:
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
安装完成后,验证版本:
pi --version
能正常输出版本号即安装成功。
三、安装推荐插件#
pi 本体保持精简,推荐安装下面 6 个插件来补齐模型管理、权限控制、终端界面、文件搜索、交互提问和任务清单能力:
pi install npm:pi-model-manager
pi install npm:@gotgenes/pi-permission-system
pi install npm:pi-open-tui
pi install npm:@ff-labs/pi-fff
pi install npm:@juicesharp/rpiv-ask-user-question
pi install npm:@juicesharp/rpiv-todo
各插件的作用如下:
| 插件 | 说明 |
|---|---|
pi-model-manager | 终端可视化模型与服务商管理,支持配置持久化、请求头与代理路由 |
@gotgenes/pi-permission-system | 权限管控插件,拦截高风险命令,防止误操作 |
pi-open-tui | 终端界面美化,提供状态栏、圆角输入框与消息框样式 |
@ff-labs/pi-fff | 高速模糊文件查找与全文内容检索工具 |
@juicesharp/rpiv-ask-user-question | 结构化提问工具,需求不明确时提供选项卡片让用户确认 |
@juicesharp/rpiv-todo | 任务列表插件,在界面中实时展示多步骤任务的执行进度 |
安装后可以查看已配置的插件列表:
pi list
四、更新 pi 和插件#
后续日常维护使用 pi update 命令即可:
# 仅更新 pi 本体
pi update
# 更新所有已安装的插件
pi update --extensions
# 更新某一个指定插件
pi update npm:pi-model-manager
# 同时更新 pi 本体和所有插件
pi update --all
常用管理命令汇总:
| 命令 | 说明 |
|---|---|
pi update | 更新 pi 本体 |
pi update --extensions | 更新全部已安装插件 |
pi update <插件名> | 更新指定插件 |
pi update --all | 同时更新 pi 本体与全部插件 |
pi list | 查看已安装的插件 |
pi remove <插件名> | 卸载指定插件 |