ZH

 


打包分发:npm 与 git

你攒了一套好用的工具、技能和提示词,想分享给别人或在多个项目复用——这时把它们做成一个Pi Package。它本质就是一个能被 Resource Loader 识别的扩展包,可以通过 npm 或 git 分发。

发布           安装                运行时
 npm publish ─▶ pi add <pkg>     ─▶ Resource Loader
 git push    ─▶ pi add <git-url>     扫描并合并进四源

一个包里有什么

  • 入口export default function(pi) 注册贡献的工具 / 命令 / 事件订阅。
  • 资源目录:技能 Markdown、提示词模板、主题文件。
  • 清单package.json 里的 pi 字段声明各类资源的入口,便于发现。
package.json 里的 pi 清单(PiManifest)
{
  "name": "@you/pi-ext-deploy",
  "pi": {
    "extensions": ["./dist/index.js"],  // 都是字符串数组
    "skills":     ["./skills"],
    "themes":     ["./themes"]
  },
  "files": ["dist", "skills", "themes"]
}

把能力包成包,pi 的生态就「飞轮」起来了:每个人都能发布自己的专长,别人 pi add 一下就拥有同样的能力。这是从「工具」走向「平台」的最后一块拼图。