经过好几周的摸索和各种尝试，pi agent 的配置基本稳定，之前发了一个 list，没有解释不太友好，这次发个全量带注释的。

首先 Pi Agent 的优点就是原生 Pi 的功能极其简单，而扩展机制非常完善，所以即使社区没有你需要的扩展，也很容易 Vibe 出一个自用。 非常适合需要对 Agent 上下文进行精细控制的人。如果你需要的是开箱即用的产品，推荐还是使用 Claude Code 或者 Codex。

扩展选择原则：

1. 占用上下文最小化，尽可能的摒弃大量注册 Tools 的行为
2. 同类插件选更新活跃、功能齐全的。
3. 有些不占用上下文没什么副作用，只是单纯显示优化和扩展功能的，入围标准很低。

更新时间：2026.6.1 简化选择，更换扩展

功能扩展类：增加MCP Adapter、WebSearch、SubAgent、Goal 等功能

• npm:pi-mcp-adapter：使用 Lazy load 的方式加载 mcp 服务器，我基本全局不会开启 MCP，在某些特定项目上会用。
• npm:pi-web-access：支持多个 Provider 的搜索聚合，效果很佳（社区有更多别的选择，可以自己找更好的实现）
• npm:pi-subagents / npm:pi-intercom ：这个更稳定一些。
• npm:pi-codex-goal：实现 /goal 功能
• npm:@juicesharp/rpiv-todo：实现 Todo 功能
• npm:@juicesharp/rpiv-ask-user-question：实现结构化对用户提问的功能（可选，其实我不爱用，这个工具要占 1k tokens 上下文）
• npm:@cnife/pi-simple-plannotator：官方的 plannotator 逻辑太重，这个封装后就很简单。
• https://github.com/davebcn87/pi-autoresearch：增加 autoresearch 功能，不过我默认是禁用的，或者可以安装到项目级中，全局开启没必要。
• npm:showsignature：增加一个tool，可以只搜索函数名等关键信息
• npm:@ogulcancelik/pi-herdr：控制 herdr，比skills+CLI 控制更稳

功能优化和管理类：各种 TUI 优化、扩展管理、体验优化等

• npm:pi-cache-graph：显示缓存命中率的变化，可用来 Debug 影响上下文的扩展
• npm:pi-command-history：使用 Ctrl + Up 来找相同目录的历史 command。(Pi 默认 Up 只能着同 session 的，很怪)
• npm:pi-discord-remote：这个插件很有意思，开启后它会为每个 session 都配置单独的会话，结束对话后自动销毁。这样在 discord 那边用起来就很简单，尤其是自动销毁。
• npm:@vanillagreen/pi-extension-manager：可以不用卸载扩展，而是禁用扩展。这玩意很卡，可以不用。
• npm:@vanillagreen/pi-session-manager：可以更好的在历史 session 中检索、跳转什么的，用处不大。
• https://github.com/monotykamary/pi-tps：显示模型输出速度等信息
• npm:pi-cost：打开webui 显示tokens 使用情况
• npm:pi-inspect：打开webui 显示模型完整的上下文用于调试

Agent 行为优化类：会修改 Pi Agent 自身行为，影响较大

• npm:pi-rtk-optimizer：使用 rtk 大幅压缩 Bash Tool 的输出
• npm:@ff-labs/pi-fff：优化文件、内容的搜索功能，效果很好，推荐。之前有Bug老crash，最新版本修了一些。
• npm:pi-loadout：可以关闭特定的tools和skills
• npm:pi-dynamic-workflows：增加类似于 Claude Dynamic Workflow 的功能。

---

原文发布于 GitHub Issue #162
创建于 2026-05-15T05:22:39Z，更新于 2026-06-01T01:56:47Z