Pi Packages — 可发布的 Pi 插件包

Pi Package 是将 extensions、skills、Prompt Templates、Themes 打包发布的标准方式，可通过 npm 或 git 安装。

安装与管理

pi install npm:@foo/pi-tools
pi install npm:@foo/pi-tools@1.2.3      # 锁定版本
pi install git:github.com/user/repo
pi install git:github.com/user/repo@v1  # tag 或 commit
pi install git:git@github.com:user/repo
pi install https://github.com/user/repo
 
pi remove npm:@foo/pi-tools
pi list
 
pi update                               # 只更新 pi 本身
pi update --all                         # 更新 pi 和所有包
pi update --extensions                  # 只更新包
pi update npm:@foo/pi-tools             # 更新单个包
 
pi config                               # 启用/禁用各包资源

加 -l 进行项目级安装（安装到 .pi/）。

创建 Package

在 package.json 中加 pi 字段：

{
  "name": "my-pi-package",
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./extensions"],
    "skills": ["./skills"],
    "prompts": ["./prompts"],
    "themes": ["./themes"]
  }
}

无 pi 字段时，pi 自动从约定目录（extensions/、skills/、prompts/、themes/）发现资源。

安装位置

来源	位置
npm（全局）	~/.pi/agent/npm/
git（全局）	~/.pi/agent/git/
npm（项目）	.pi/npm/
git（项目）	.pi/git/

安全注意事项

Pi 包以完整系统权限运行。Extensions 可执行任意代码，Skills 可引导模型执行任意操作（包括运行可执行文件）。安装第三方包前请务必审查源码。

发现包：npmjs.com 搜索 pi-package | Discord 社区频道