Start here最小的 Extension,
最小的 Extension,
就是一个 Pi 入口。
先让运行时能力独立成立。只有确实需要可视化时,才增加 Pipee Web Surface。
Package structure
pi-hello/ ├── src/ │ └── extension.ts ├── package.json └── README.md
可选
dist/web/仅在需要 Web Surface 时添加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
从代码到可安装归档。
- 01创建
使用 Pi Extension API 定义运行时能力。
- 02验证
在真实 Pi runtime 中验证工具、生命周期和边界。
- 03打包
运行时代码、Skill 和可选 Web 资源由同一 package 拥有。
- 04发布
交付一个来源、版本与权限说明都可验证的归档。