Alfred/docs/user/deploy.md

生产部署

本文档说明如何构建和运行生产环境的应用。

生产构建和运行

bun run build
./dist/my-app config.yaml

启动后：

地址	行为
http://127.0.0.1:3000/	返回前端 SPA
http://127.0.0.1:3000/api/meta	返回应用元信息 JSON
http://127.0.0.1:3000/health	返回健康检查

构建流程

scripts/build.ts 执行三步流水线：

1. Vite build        -> dist/web/（前端静态资源，含 code splitting）
2. Code generation   -> .build/static-assets.ts + .build/server-entry.ts（含版本号字面量注入）
3. Bun compile       -> dist/my-app（单可执行文件）

• Vite 构建前端资源到 dist/web/，自动 code splitting（vendor-react、vendor-tdesign、vendor-chart）
• Code generation 扫描 dist/web/ 生成 import with { type: "file" } 声明，将资源嵌入 binary
• Bun compile 以 .build/server-entry.ts 为入口编译最终可执行文件
• .build/ 临时目录在构建完成后自动清理

产物

产物	用途
dist/my-app	生产可执行文件（含前端资源，单文件部署）
dist/web/	Vite 构建的前端资源（构建中间产物）

构建参数

环境变量	说明
BUN_TARGET / BUILD_TARGET	交叉编译目标平台（如 bun-linux-x64）

清理

bun run clean

清理 dist/ 构建产物和 .build/ 临时文件。