yhm-ai-video-duoduo

美业口播科普视频脚本技能（百炼 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 的平台使用。

graph TD
    A[用户触发<br/>选题 / 选题+素材] --> B[文字风格问卷<br/>无要求则自动生成物料]
    B --> C[锁定固定素材<br/>4项OSS URL 已写死]
    C --> D[生成并确认物料<br/>人物形象照 / 门店内景含LOGO / 插画]
    D --> E[确认口播文案<br/>转口语化 + 字数约120-150]
    E --> 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 种随机穿插（跟随 / 推近 / 拉远 / 横移 / 手持微晃）。
• 插画展示方式：全屏铺盖 / 圆形画中画 / 顶部或底部条状画中画 / 侧边画中画 / 人物画中画式全屏，随机混用不固化。
• 门店丰富元素：前台 / 美容床 / 沙发 / 桌椅 / 其他店员虚化走过，随机点缀 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）