Extensions 快速开始

位置与加载

全局 Extensions 放在 ~/.pi/agent/extensions，项目 Extensions 放在 .pi/extensions。自动发现的扩展可通过 /reload 热重载，pi -e path.ts 适合一次性测试。

项目扩展是可执行代码，只在信任项目后加载。第三方扩展应审查源码和依赖。

import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";

export default function (pi: ExtensionAPI) {
  pi.on("agent_start", async (_event, ctx) => {
    ctx.ui.notify("Extension loaded", "info");
  });
}

开发循环

1. 从单一事件或命令开始。
2. 用 pi -e 显式加载并观察错误。
3. 处理长资源的 shutdown。
4. 移动到自动发现目录并运行 /reload。
5. 打包前为行为写测试和权限说明。