# 推广素材（首页与视频源）

- `index.html`：静态完整落地页参考；线上 Vue 首页已与之对齐，素材路径以本目录为准。
- `social/`：产品视频与封面已与 **二维码图** 同目录，使用 **英文文件名**（见 `social/README.md`）。线上 URL：`/promotion/social/video-*.mov`。后台上传到 `promotion/social/`，勾选 **保留原文件名**。旧「视频发布」中文路径可用 `scripts/sync-video-assets-to-social.sh` 一键复制并改名。
- `social/`：**关注我们** 统一资源包（建议只用此目录上线），首页读取：
  - `social/xiaohongshu.png`、`social/douyin.png`、`social/wechat-official.png`、`social/wechat-channels.jpg`
  - 若需换图，直接替换 `social/` 下对应文件（ASCII 文件名利于网关与日志）。
- `宇恒一号宣传册.pptx`：宣传册文案结构来源；SPA 中对应路由为 `/brochure/:topic`。

## 生产部署

1. **关键**：线上文档根是 **`deploy/web/dist/`**，`/promotion/social/...` 对应 **`deploy/web/dist/promotion/social/...`**。`pull-and-restart.sh` 会把 **`web/promotion/`** 整体 rsync 到 dist，**包含 `social/*.mov`**；仅排除 **`视频发布/`** 与 **`_pptx_extract/`**（避免重复大文件）。改完素材后务必重新执行部署脚本或手动 rsync。
2. **权限**：目录建议 `755`、文件 `644`（或 `chmod -R a+rX promotion/social`），避免 `640` 导致 Nginx worker 读不到（表现为 404/403）。
3. **视频**：可静态放在 **`social/`** 英文文件名；也可用 **后台上传** `promotion/social/`，由 `/api/web/sites/.../promotion-media/` 提供，二者与 `promotionVideos.js` 的路径一致即可。

---

（以下为原 Nginx alias 说明，可与上面 dist 同步二选一）

1. **前端构建产物**（`dist/`）默认不含本目录时，除脚本自动同步外，也可把素材 **复制** 到站点根下 `promotion/`，或通过 Nginx alias。**视频**推荐仅通过后台上传到 API 存储目录。
2. 或使用 Nginx：

```nginx
location /promotion/ {
    alias /path/to/yh_web/web/promotion/;
}
```

3. 开发环境：`npm run dev` 时已通过 Vite 中间件将 `/promotion` 映射到本目录，无需再拷贝。
