PI Extension 是什么？
很多人第一次使用 PI，会把“增加能力”理解成修改提示词。
其实 PI 还提供了 Extension 机制：不用修改 PI 源码，也能增加命令、工具和界面能力。🧩
━━━━━━━━━━━━━━
📌 01｜Skill 和 Extension 的区别
一句话理解：Skill 是告诉 Agent 应该怎么做，Extension 是直接给 Agent 增加程序能力。
Skill 更像一份给模型阅读的知识和操作说明；Extension 则是真正运行的程序代码。两者可以配合使用，但解决的问题并不相同。
两个扩展目录以及它们的生效范围，都整理在第 1 张图里了。
━━━━━━━━━━━━━━
🧰 02｜Extension 能增加什么能力？
第一类是监听生命周期：当任务开始、工具被调用或者回答结束时，自动执行相应操作。
第二类是注册新命令：给 PI 增加自己的斜杠命令，例如查看记忆、导出会话或启动部署。
第三类是增加模型工具：让模型能够查询数据库、访问业务接口或者调用内部系统。
第四类是定制终端界面：显示通知、状态栏、任务面板、确认框和选项列表。
━━━━━━━━━━━━━━
💻 03｜如何创建第一个扩展？
整个过程可以分成三步：先创建扩展文件，再注册一个测试命令，最后重新加载并运行。
完整文件内容、创建步骤和临时测试方法都放在第 2 张图中，可以直接对照操作。TypeScript 扩展可以由 PI 直接加载，不需要先手动编译。
━━━━━━━━━━━━━━
📦 04｜如何安装别人发布的扩展？
PI Package 支持从 npm、GitHub 或本地项目安装，也可以选择只写入当前项目配置，方便团队共享。
具体安装命令放在第 3 张图里。安装完成后，还可以使用 PI 的包管理功能查看、更新或者删除扩展。
━━━━━━━━━━━━━━
🐳 05｜Docker 用户为什么要额外处理？
如果 PI 运行在 Docker 容器中，Mac 上的扩展不会自动进入容器，需要复制进镜像或通过目录挂载提供给容器。
图中的容器路径使用 root，是因为当前镜像默认以 root 用户运行。PI 的全局目录跟随运行用户的 Home 目录；如果以后改为普通用户，路径也要一起调整。
PI piagent CodingAgent