Developers

为 Pi 构建新的能力。

你开发的是 Pi Extension。Pipee 只提供发现、安装说明和可选的 Web Surface,不创造第二套插件运行时。

Start here

最小的 Extension,
就是一个 Pi 入口。

先让运行时能力独立成立。只有确实需要可视化时,才增加 Pipee Web Surface。

Package structure
pi-hello/
├── src/
│   └── extension.ts
├── package.json
└── README.md
可选dist/web/仅在需要 Web Surface 时添加
src/extension.tsPi Extension
export default function (pi: ExtensionAPI) {
  pi.registerTool({
    name: "hello_pipee",
    description: "返回一个问候",
    parameters: Type.Object({}),
    async execute() {
      return { content: [{ type: "text", text: "你好" }] }
    }
  })
}
Ownership

一个运行时,两个清楚的层。

RequiredPi Extension

工具、事件、状态、后台服务和生命周期。

OptionalPipee Web Surface

当能力需要专属界面时,由同一 package 提供。

Delivery

从代码到可安装归档。

  1. 01创建

    使用 Pi Extension API 定义运行时能力。

  2. 02验证

    在真实 Pi runtime 中验证工具、生命周期和边界。

  3. 03打包

    运行时代码、Skill 和可选 Web 资源由同一 package 拥有。

  4. 04发布

    交付一个来源、版本与权限说明都可验证的归档。

阅读完整开发文档