构建与部署

Toolchain 2 从标准布局构建所有插件。旧版独立配置文件（已统一为 manifest.json）与任意构建命令数组已移除。

项目与包布局

Worker 源码插件包含 manifest.base.json、语言契约、可选 Flow/i18n 增量，以及位于 ui-src/package.json 的 UI。纯 UI 的 manifest-first 插件可改用 manifest.json。打包后的 .fyp 始终只有一份编译后的 manifest.json，以及：

text

manifest.json
ui/
  index.html
backend/
  worker.jar | worker.py | worker[.exe]

UI 命令来自项目标准 scripts：dev、可选的 test、build —— 脚手架项目用 npm，仓库内官方插件用 Yarn 4（经 packageManager 锁定版本）。Worker 遵循各语言约定：Java 通过最近的 Maven Wrapper，Python 运行测试并打包 worker.py，Go 运行测试并构建唯一的原生可执行文件。

生命周期

bash

fengyu check .
fengyu build .

build 会按需安装 UI 依赖，运行测试（除非指定 --skip-tests），构建 UI 与 Worker，暂存纯运行时文件，校验 manifest、UI 与 JAR，最后原子写入：

text

dist/<plugin-id>-<version>.fyp
dist/<plugin-id>-<version>.fyp.sha256

使用 --out <file> 选择其他归档路径。构建失败会清理临时 staging 与归档文件。

外部 Java 插件通过生成的 .mvn/settings.xml 解析独立版本的 Worker SDK。设置具有 read:packages 权限的 FENGYU_GITHUB_TOKEN 或 GITHUB_TOKEN；凭据只经环境传递，绝不写入项目。

官方插件

bash

node toolchain/cli/bin/fengyu.mjs build OfficialPlugins/plugin-markdown
node toolchain/cli/bin/fengyu.mjs build OfficialPlugins/plugin-excel
node toolchain/cli/bin/fengyu.mjs build OfficialPlugins/plugin-email
node toolchain/cli/bin/fengyu.mjs build OfficialPlugins/plugin-offlinepython

通过宿主插件市场 UI 或 POST /api/plugin-packages/upload 安装 .fyp（已弃用的 /api/plugin-market/upload 别名仍会转发）。宿主会在注册前校验归档限制、路径、manifest、UI 入口和 Worker 结构。

构建与部署 ​

项目与包布局 ​

生命周期 ​

官方插件 ​

构建与部署

项目与包布局

生命周期

官方插件