Pi Packages(包) 允许你将 Extensions、Skills、提示词模板和主题打包通过 npm 或 git 进行分发和安装。包管理命令命令功能pi install source安装包-l 参数安装为项目级pi remove source移除包pi uninstall source同 removepi list列出已安装的包pi update --all更新 Pi Agent 和所有包pi update --extensions仅更新包pi update source更新指定包使用示例# 安装 npm 包 $ pi install npm:foo/bar1.0.0 # 安装 git 包 $ pi install git:github.com/user/repov1 # 安装本地包 $ pi install ./relative/path/to/package # 安装为项目级写入 .pi/settings.json $ pi install -l npm:foo/bar # 临时试用包不安装到配置中 $ pi -e npm:foo/bar $ pi -e git:github.com/user/repo包来源npm 包npm 是推荐的包分发方式pi install npm:scope/pkg1.2.3 pi install npm:pkg带版本号的 npm 包会被锁定pi update 不会自动升级它们。包安装位置全局在 ~/.pi/agent/npm/项目级在 .pi/npm/。Git 包支持 HTTPS 和 SSH 协议# HTTPS pi install https://github.com/user/repov1 # SSHgithost:path 需要 git: 前缀 pi install git:gitgithub.com:user/repov1 # SSH 协议 pi install ssh://gitgithub.com/user/repov1Git 包的 ref 会被锁定pi update 不会自动移动到新 ref。克隆位置全局在 ~/.pi/agent/git/项目级在 .pi/git/。本地路径指向本地文件系统路径不会复制文件pi install /absolute/path/to/package pi install ./relative/path/to/package创建 Pi 包在 package.json 中添加 pi 字段实例{name: my-package,keywords: [pi-package],pi: {extensions: [./extensions],skills: [./skills],prompts: [./prompts],themes: [./themes],video: https://example.com/demo.mp4,image: https://example.com/screenshot.png}}如果没有 pi 字段Pi Agent 会自动从约定的目录中发现资源extensions/ - 加载 .ts 和 .js 文件skills/ - 递归查找 SKILL.md 文件夹prompts/ - 加载 .md 文件themes/ - 加载 .json 文件添加 pi-package 关键词可以让你的包出现在 Pi Agent 包画廊 中。video 和 image 字段用于在画廊中展示预览。包过滤安装包时可以精确控制加载哪些资源实例{packages: [npm:simple-pkg,{source: npm:my-package,extensions: [extensions/*.ts, !extensions/legacy.ts],skills: [skills/brave-search],prompts: [],themes: [themes/legacy.json]}]}过滤规则省略某个键 加载该类型的所有资源设为 [] 不加载该类型的任何资源!pattern 排除匹配的资源path 强制包含指定路径-path 强制排除指定路径依赖管理Pi Agent 会为每个已安装的 npm/git 包执行 npm install自动安装依赖。以下核心包由 Pi Agent 自身提供应列为 peerDependencies不要在包中重复打包包名说明earendil-works/pi-aiAI 工具和类型earendil-works/pi-agent-core代理核心earendil-works/pi-coding-agentPi Agent 主包earendil-works/pi-tuiTUI 组件typebox参数 Schema 定义pi config 管理资源使用 pi config 交互式地启用或禁用已安装包的扩展、Skills、模板和主题# 编辑全局配置 $ pi config # 编辑项目配置 $ pi config -lTab 键在全局和项目模式之间切换。作用域与去重同一个包可以同时出现在全局和项目配置中。如果项目条目存在它优先于全局条目。包的身份由以下方式确定npm 包包名git 包仓库 URL不含 ref本地路径解析后的绝对路径