打包构建

packaging/README.md

@@ -0,0 +1,49 @@
+# PicHost 打包
+
+版本号统一从根目录 `package.json` 的 `version` 读取。
+
+## 环境要求
+
+- Node.js 22 或更高版本
+- npm 11
+- Docker（构建 Docker 镜像和飞牛运行镜像）
+- Windows 构建需要 `ffmpeg.exe` 与 `ffprobe.exe`，可通过 `FFMPEG_DIR` 指定目录
+
+## 构建命令
+
+```bash
+npm ci
+npm run pack:docker
+npm run pack:fpk
+npm run pack:windows
+```
+
+在 Windows 上可以一次构建全部三类产物：
+
+```bash
+npm run pack:all
+```
+
+输出位置：
+
+- Docker 镜像：`dist-docker/*.tar`
+- 飞牛应用：`dist-fpk/*.fpk`
+- Windows 安装程序：`dist-windows/*.exe`
+
+`dist-docker`、`dist-fpk` 和 `dist-windows` 是生成目录，不提交到 Git。可复用的源文件位于 `packaging/fnos`、`desktop` 和 `scripts`。
+
+## 飞牛安装顺序
+
+1. 在飞牛 Docker 中手动导入 `dist-docker/*.tar`。
+2. 确认镜像列表中出现 `yeomaiyelove/pichost:<version>`。
+3. 安装 `dist-fpk/*.fpk`。
+
+FPK 使用 `pull_policy: never`，不会联网拉取 PicHost 镜像。
+
+## 可覆盖参数
+
+- `PICHOST_IMAGE_REPOSITORY`：Docker 镜像仓库名，默认 `yeomaiyelove/pichost`
+- `DOCKER_PLATFORM`：Docker 构建平台，默认 `linux/amd64`
+- `PICHOST_IMAGE`：FPK 使用的完整镜像标签
+- `FPK_PLATFORM`：FPK 平台标识，默认 `x86`
+- `FFMPEG_DIR`：Windows 构建使用的 ffmpeg 目录