# 美业口播科普视频脚本技能（百炼 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`。

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

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