入门
创建一个带 Java、Python 或 Go Worker 的 Vue 插件:
fengyu init ./my-plugin --id com.example.my-plugin --runtime java
cd my-plugin使用 --runtime python 或 --runtime go 选择对应 Worker SDK;构建基线分别为 Python 3.12+ 与 Go 1.26+。使用 --no-install 跳过依赖安装,或用 --ui-only 省略 Worker。生成项目遵循 Toolchain 2 标准布局:
my-plugin/
├── manifest.base.json
├── manifest/
│ ├── flow-nodes.json
│ └── i18n/
├── mvnw, mvnw.cmd
├── .mvn/
├── ui-src/
│ ├── package.json
│ ├── vite.config.ts
│ └── src/
└── worker/
├── pom.xml
├── src/main/java/…
└── src/test/java/…/PluginDevMain.javaWorker 项目默认采用代码优先:语言契约拥有 RPC Schema,短小的 manifest.base.json 拥有包元数据。 fengyu generate 将两者合并到 target/fengyu-manifest/manifest.json,不要编辑该生成文件。CLI 使用 npm 的 dev、可选 test、build scripts, 以及 Maven 的 test、package 生命周期。Java Worker 构建必须产出唯一的 worker/target/*-worker.jar。Python 脚手架使用 worker/worker.py 与 vendored fengyu_plugin_sdk;Go 脚手架使用 worker/main.go 与 vendored SDK module,并构建单个原生 可执行文件。打包时分别规范化为 backend/worker.py 与 backend/worker[.exe]。
通过统一命令运行 UI 模拟器:
fengyu dev还需启动真实开发 Worker:Java 在 IDE 中 Debug PluginDevMain.main(),Python 在 worker/ 运行 python3 worker.py --dev,Go 运行 go run . --dev。三者都通过令牌认证的回环 TCP 暴露与生产环境相同的处理器。模拟器地址为 http://127.0.0.1:5173/__fengyu。
检查并打包项目:
fengyu check
fengyu build包与校验和写入 dist/<id>-<version>.fyp[.sha256]。通过宿主插件市场 UI 安装 .fyp。 更多契约见 SDK 与 CLI 和构建与部署。