用途:帮助开发者为 Activepieces 构建集成(piece),包括新建 piece、为已有 piece 添加 action/trigger、修复 bug。
主要能力:提供五步工作流(调研 API、规划、脚手架、实现、接线与验证);给出目录结构、package.json、tsconfig、eslint 等模板;覆盖认证类型(SecretText、OAuth2、BasicAuth、CustomAuth、None)及访问方式;要求 UX 友好(动态下拉、Markdown 说明、默认值)与输出扁平化;要求新 action/trigger 带 audience 与 aiMetadata。
使用方式:新建 piece 时按五步执行,默认放在 packages/pieces/community/,自定义 piece 放 custom/。已有 piece 修改时跳过前三步,遵循该 piece 既有约定并提升版本号。实现时按需查阅 auth-patterns.md、action-patterns.md、trigger-patterns.md、props-patterns.md、common-patterns.md、ux-guidelines.md、output-quality.md、ai-metadata.md。接线需在 src/index.ts 注册 action/trigger 并加入 createCustomApiCallAction,在根 tsconfig.base.json 按字母序注册路径。构建与 lint 命令:bun install(仅新 piece)、npx turbo run build --filter=@activepieces/piece-<name>、npx turbo run lint --filter=@activepieces/piece-<name>,两者均须通过。本地测试在 packages/server/api/.env 加 AP_DEV_PIECES=<name>,npm start 后访问 localhost:4200。
适用场景:为第三方应用创建集成、扩展已有集成、修复集成缺陷。
限制:action/trigger 名称发布后不可更改;认证须定义在 src/lib/auth.ts;trigger 必须提供 sampleData;已有 piece 每次改动须升版本(移除或新增必填属性为 MAJOR,新增 action/trigger 或可选属性为 PATCH);OAuth2 配置缺失、认证方式不明、可选 action 超过 10 个或需测试凭据时应先询问用户。具体收费、价格与平台支持信息暂未提供。