# 美业口播科普视频脚本技能（百炼 wan3 直出版）

把「美业口播科普短视频」从零散需求沉淀为一份**带固定品牌素材、可直接调用阿里云百炼 wan3（万相 3.0）生成视频**的结构化脚本。技能会像专业编导一样设计人物在门店场景里的动线、运镜、插画融入方式与门店丰富元素，确保成片真实、不站桩、不 AI 感。

## 适用场景

- 用户上传/指定人物五视角图、制服细节图、品牌立体 LOGO、指定音色，或要求生成可直出 wan3 的视频脚本与物料。
- 典型触发：「帮我做一条美业口播视频（给 wan3 / 百炼）」「出个护肤科普短视频脚本并生成」。

## 八大硬约束（贯穿全程）

1. **人物**必须用指定人物五视角图（固定锁定，全片不变脸）。
2. **制服**参考指定细节图（可换款式/颜色，**胸牌样式绝对不可变**）。
3. **门店内景**必须有指定立体 LOGO（合成进参考图，前台必现）。
4. **音色**必须用指定文件作 `reference_audio`。
5. 口播文案由用户内容**转口语化**适合口播。
6. 整段视频**一个片段、≤30 秒**（超了反馈精简，循环直到满足；绝不拆片段）。
7. 确认后调用**百炼 wan3** 生成、轮询、下载本地、交付确认。
8. **不支持二次创作**：任何元素修改都重新组装完整脚本、整段重发 wan3（不用编辑/延长模式）。

## 首次配置（必做，只需一步）

> 本技能为「暨北内部 - 朵朵」专用锁定版：人物五视角图、制服细节图、怡呵美立体 LOGO、朵朵音色、百炼工作空间与 base_url **均已固定在 `scripts/config.json` 中**，使用者无需修改。

1. **API Key（唯一需要你提供的）**：登录百炼 / DashScope 控制台 → 切换到 **北京（cn-beijing）** 地域 → 创建 API Key（`sk-` 开头，只显示一次）。复制 `scripts/.env.example` 为 `scripts/.env`，填入 `DASHSCOPE_API_KEY=sk-...` 即可。
   > ⚠️ `.env` 含你的密钥，**严禁提交 git 或随技能 zip 分发**；重新打包技能前请删除本地 `.env`。
2. 固定品牌素材 / 工作空间 / base_url 均已预填，**无需任何改动**即可直接运行。

## 运行

对 WorkBuddy 说：「用美业口播科普视频脚本技能，做一条关于 *[选题]* 的口播视频」。技能按 `SKILL.md` 的 11 步流程执行：

> 文字风格问卷 → 锁定固定素材 → 生成并确认物料（人物形象照 / 门店内景含 LOGO / 插画）→ 确认口播文案 → **敏感词/合规检测（必跑，用户按建议改或自改后复检）** → 确定插画插入点 → 组装编导分镜 Prompt → 逐步确认 → 调 wan3 生成 → 成片交付。

也可手动驱动生成脚本：`python scripts/generate_video.py --help`。

## 生产视频流程图

> 注：GitLab / GitHub 出于安全策略**不渲染 Markdown 中的 SVG 图片**（SVG 可能含脚本），因此流程图改用 **Mermaid 代码块**——GitLab 网页端原生支持、会直接渲染为图，且是纯文本可版本化。原 SVG 文件保留在 `docs/flowchart.svg` 供支持 SVG 的平台使用。

```mermaid
graph TD
    A[用户触发<br/>选题 / 选题+素材] --> B[文字风格问卷<br/>无要求则自动生成物料]
    B --> C[锁定固定素材<br/>4项OSS URL 已写死]
    C --> D[生成并确认物料<br/>人物形象照 / 门店内景含LOGO / 插画]
    D --> E[确认口播文案<br/>转口语化 + 字数约90-110]
    E --> E2[敏感词/合规检测<br/>必跑 · 风险等级+替换建议]
    E2 --> F[确定插画插入点<br/>指定从哪句开始融入]
    F --> G[组装编导分镜 Prompt<br/>动线 + 运镜 + 插画展示 + 门店元素]
    G --> H[逐步确认]
    H --> I[调百炼 wan3 生成<br/>建任务 → 轮询 → 下载]
    I --> J[成片交付]
    J --> K{满意?}
    K -- 否,整段重发 --> G
    K -- 是 --> Z[完成]
```

> 详细分步说明见 `docs/暨北内部-朵朵口播视频专用技能.md`。

## 编导分镜要点（确保真实感）

- **人物行为动线**：30 秒单段 ≤2 个动作、方向不反向（「走动→落座」则落座后不再起身；「坐姿→起身走动」则走动后不再落座）；口播时不设计整理产品等手部摆弄动作，手部只用自然手势 / 点头。
- **运镜组合**：2–3 种随机穿插（跟随 / 推近 / 拉远 / 横移 / 手持微晃）。
- **插画展示方式**：仅限局部呈现——圆形画中画 / 顶部或底部条状画中画 / 侧边画中画，**禁止全屏铺盖与人物画中画式全屏**（用户 2026-09-17 规则）。
- **门店丰富元素**：前台 / 美容床 / 沙发 / 桌椅 / 其他店员虚化走过，随机点缀 2–3 个增加景深。

详细元素、wan3 工程要点、物料收集流程分别见 `references/elements.md`、`references/wan3-workflow.md`、`references/asset-collection.md`；单段脚本骨架见 `assets/script-template.md`。

## 目录结构

```
beauty-talk-science-video-script/
├── SKILL.md                  # 主流程与硬约束（11 步）
├── README.md                 # 本文件（快速上手）
├── references/
│   ├── elements.md           # 全部可参数化元素与可选项
│   ├── wan3-workflow.md       # 百炼 wan3 端点/鉴权/参考映射/编导分镜 prompt 范式
│   └── asset-collection.md   # 固定 4 项素材 + 自动生成物料确认 + 物料登记
├── assets/
│   ├── script-template.md     # 单段结构化脚本骨架（交付物模板）
│   └── brand/README.md        # 固定品牌素材包说明
└── scripts/
    ├── generate_video.py      # 解析素材 → 建任务 → 轮询 → 下载
    ├── config.json            # region/workspace_id/model/分辨率/比例/品牌 URL（密钥走 .env）
    └── .env.example           # API Key 模板（复制为 .env 填入真实 key）
```

## 任务产物目录结构（每次任务独立归档）

每个任务在收集输入后即**新建一个独立文件夹**存全部产物，避免跨任务文件混杂，便于交付与回看。产物区与技能目录分离：

- **基础目录**：工作区内 `beauty-video-materials/`
- **任务文件夹**：`beauty-video-materials/<任务短名>/`（`<任务短名>` 由选题/主题派生，如 `敏感肌功效型护肤品`、`贵产品无效`，去除特殊字符与空格）
- **自包含**：本任务实际用到的参考图（人物完整形象照 / 门店内景 / 插画）也复制进该文件夹，使文件夹独立可交付、可归档（复用上次素材则复制一份进来）

```
beauty-video-materials/
├── _shared/                       # 共享素材库（跨任务复用，可选）
│   ├── 人物_完整形象照.png
│   ├── 门店_内景_1.png
│   ├── 门店_内景_2.png
│   ├── 门店_内景_3.png
│   └── 插画_参考1.png / 插画_参考2.png
└── <任务短名>/                    # 单个视频任务（自包含）
    ├── 脚本_<主题>.md             # 结构化交付脚本（Step 8/9）
    ├── prompt.txt                 # 提交 wan3 的纯文本 prompt（Step 8 写出）
    ├── 成片_<主题>.mp4            # 下载的视频成片（Step 10）
    ├── 人物_完整形象照.png         # Image 1（本任务生成或复用复制）
    ├── 门店_内景_采用.png          # Image 2（含 LOGO）
    └── 插画/
        ├── 插画_参考1.png          # Image 3
        └── 插画_参考2.png          # Image 4
```

- 后续 `--media` / `--output` 一律引用本任务文件夹内路径；生成脚本已支持**自动创建输出父目录**，传任务文件夹路径无需手动 `mkdir`。
- 历史归档示例：两支视频 `敏感肌功效型护肤品/`、`贵产品无效/`，共享参考图归在 `_shared/`。