Skip to main content

Pi 包管理

Pi 包打包扩展、技能、提示模板和主题,通过 npm 或 git 分享。


安装和管理

# 安装
pi install npm:@foo/bar@1.0.0
pi install git:github.com/user/repo@v1
pi install https://github.com/user/repo
pi install /绝对路径/包
pi install ./相对路径/包

# 移除
pi remove npm:@foo/bar

# 列出
pi list

# 更新
pi update

⚠️ 安全注意:Pi 包以完整系统权限运行。安装第三方包前请审查源代码。


包来源

npm

npm:@scope/pkg@1.2.3
npm:pkg

git

git:github.com/user/repo@v1
git:git@github.com:user/repo@v1
https://github.com/user/repo@v1
ssh://git@github.com/user/repo@v1

支持 HTTPS 和 SSH,SSH 使用配置的 SSH 密钥。


创建 Pi 包

package.json 中添加 pi 键:

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

包结构

my-pi-package/
├── package.json
├── dist/
│ └── extension.js
├── skills/
│ └── my-skill/
│ └── SKILL.md
├── prompts/
│ └── my-prompt.md
└── themes/
└── my-theme.json

翻译自 pi-coding-agent/docs/packages.md