Pi Agent 手册：极简设计，极致高效的 AI 编程工具（插件、技能、WebUI 一站式配置）-平芜编程栈

文章目录

- Pi agent 概述
- 安装配置
- 第三方 Web UI
- - 核心插件推荐
  - agent skills 扩展

Pi agent 概述

pi agent 是一个轻量的命令行工具，也是小龙虾底层使用的 harness agent 工具。它只提供最基础的模型交互的能力，至于其他的harness agent的能力（例如Agent记忆、接入交流通道、多Agent这些），都是通过自定义拓展的方式来开发的，非常适合想定制 harnesse agent 的朋友。

对比同类产品，仅打招呼的简单交互场景下，Pi 的上下文总占用仅约 1100token（其中用户输入仅占 4token）；而 Codex 同类操作会消耗 18000token，直接占用 7% 的上下文窗口。

根据 composio 的基准测试，Pi 完成编程任务的速度比主流 Coding Agent 快 1.5~2 倍，任务成本也显著更低。

代码质量层面，DataBricks 在百万行代码仓库的基准测试显示，同等成本下 Pi 的任务通过率优于 Cloud Code 与 Codex；其中Pi + Claude Opus 4.8的组合达到了测试中代码质量的最高点。
DataBricks

Pi 的核心原则是 “用最小的工具集覆盖绝大多数编程场景”，默认仅内置 4 个基础工具：

读文件
写文件
改文件
运行命令行

其中命令行工具本身具备极高灵活性，可直接调用find、grep、ls等系统命令完成各类操作。Pi 不内置 MCP、子代理、计划模式、待办清单等复杂功能 —— 核心越精简，大模型的发挥空间越大，同时用户可根据自身工作流自由组装能力，真正实现“让工具适应你的工作流，而非你去适应工具”。

项目地址：pi-agent github地址

安装配置

powershell 中运行一键安装命令：

powershell-c"irm https://pi.dev/install.ps1 | iex"

macos电脑使用curl命令：

curl-fsSLhttps://pi.dev/install.sh|sh

Pi 仅提供基础安全校验：在包含插件 / 技能的陌生目录启动时，会询问用户是否信任加载。一旦启动运行，Pi 默认拥有最高权限，文件编辑、命令执行均自动执行，无内置沙箱与拦截机制 —— 这是其极简设计的取舍，优先保障执行效率。

官方推荐使用 WSL、Hyper-V 虚拟机、Docker 容器等运行 Pi，即使环境被破坏也不会影响宿主机。Pi 轻量高效的特性非常适合容器化部署与批量调度。

相关内容参考文章：WSL超详细保姆级教程：Windows极致运行AI Agent（含 pi、Hermes agent 实践）

第三方 Web UI

对于不习惯命令行界面的用户，社区提供了高人气 Web UI 项目（GitHub 星标 6.4k+，国内开发者 “第四种黑猩猩” 开发），提供可视化操作界面。

pi_web项目地址

终端执行对应 npx 一键安装命令，安装完成后自动打开网页界面。

npx @agegr/pi-web@latest

项目切换与自定义路径选择
可视化模型配置与管理
技能、插件的可视化开关管理（区分项目级 / 全局）
对话面板支持所有原生命令、截图、文件引用
实时显示 Token 消耗与成本预估
支持调整模型思考强度

在设置中可以查看下载的项目/全局的skills和插件，可以选中技能把它开启或关闭，及时关闭用不到的技能可以帮助模型更加节省token。

核心插件推荐

可以在 pi 的官网寻找需要的插件，复制对应的一键安装命令然后在终端运行即可：

使用默认安装命令是把插件安装到 pi 的全局目录下，对所有项目生效。每安装一个插件都是增加了一部分系统提示词，如果有的模型用不到这个插件其实是给模型增加负担，所以可以进行项目级安装，在命令后面加入一个 -l 。

pi-web-access 联网插件
- 功能：赋予 Pi 联网搜索与网页信息提取能力
- 特点：零配置，接入 XR MCP 服务，无需额外 API Key
- 卸载：将安装命令中的install改为uninstall即可

pi-subagents 子代理插件
- 功能：支持并行运行多个子代理，协同完成任务
- 用法：输入/pi-sub-agents调用，可并行生成多方案、并行审查代码
pi-mcp-adapter MCP 适配插件
- 功能：让 Pi 支持 MCP 协议，接入各类 MCP 服务
- 配置：在项目根目录创建.mcp.json配置文件，Pi 会自动读取。或者直接让模型配置。

高德地图 MCP 地址

BTW 旁路对话插件
- 功能：在 AI 执行任务时开启旁路对话，提问不打断主任务
- 用法：输入/btw + 问题开启子窗口对话，Ctrl+C退出旁路
Plan Mode 计划模式插件
- 功能：AI 先输出执行计划而非直接动手，用户确认后再执行
- 用法：输入/plan mode开启 / 关闭，计划会生成到plan.md文件
Go Mode 迭代模式插件
- 功能：给定目标后，AI 自动多轮迭代直至达成目标
- 用法：输入/go + 目标描述，支持多轮自动优化
Dynamic Workflows 动态工作流插件
- 功能：根据任务复杂度自动调度子代理协同工作，支持大规模长时间任务
- 用法：输入/workflows触发，可查看后台子代理工作状态
Pi-Wechat-Assistant 微信插件
- 功能：对接微信，实现手机端与 Pi 的消息交互
- 用法：/wechat login扫码登录，/wechat start启动连接