扩展开发 TypeScript

Pi Agent 扩展开发与集成

「Primitives, not features」——别人内置的功能,Pi 交给你用扩展构建。学扩展开发的最佳范本,也是把 Agent 能力嵌入自有产品的最短路径。

为什么学这一模块

Pi 的哲学与 DeepAgents 形成有趣对照:一个给你完整脚手架,一个只给你原语。掌握 Pi 的扩展机制(工具、命令、事件、TUI 全开放 + 热加载),你就拥有了「给任何 Agent 基座加能力」的通用方法论;而它的 RPC/SDK 模式,让 Agent 能力可以嵌进你自己的系统里。

核心技术栈

Pi Agent TypeScript Extensions 热加载 /reload Skills 能力包 MCP + Codemode Pi Packages TUI / RPC / SDK AGENTS.md / SYSTEM.md 会话树分支 npm 分发

技术亮点

Extensions 全能力开放
TypeScript 模块可访问工具、命令、快捷键、事件与完整 TUI,改完 /reload 热加载即时生效——官方 50+ 示例覆盖子智能体、计划模式、权限门控、沙箱等
四种运行模式,极易集成
交互式 TUI / pi -p 打印与 JSON 模式 / stdin-stdout RPC 协议 / 嵌入式 SDK——既能给人用,也能作为引擎嵌进自己的产品
Packages 生态分发
扩展、Skills、提示词、主题可打包为 Pi package,通过 npm 或 git 一键安装(pi install npm:@foo/pi-tools),团队能力资产化

核心内容

Pi 安装与模型配置:15+ 提供商、会话中热切换模型
上下文工程:AGENTS.md / SYSTEM.md、自动压缩与自定义压缩扩展
Extension 开发实战:自定义工具 + 命令 + 状态栏组件
Skills 能力包:渐进式披露设计,节省 Prompt 缓存
MCP 接入与 Codemode:JS 沙箱内组合编排工具调用
过程控制:steer 中途转向、follow-up 追加、会话树 /tree 分支回溯
打包发布:把扩展与技能打包为团队共享的 Pi package
RPC / SDK 集成:把 Pi 作为 Agent 引擎嵌入自有系统

实战产出

  • 自研 Pi Extension 一个并发布为 package
  • Pi RPC 嵌入自有系统的集成 Demo
  • 团队共享的 Skills / 提示词资产包