药物科普视频生成器（drug-video-generator）
Overview
将"一个药物 / 一个用药主题"转化为一条可发布的科普短视频。整条视频由分镜（scene）组成：每幕包含讲解词、画面提示词与建议时长；流程覆盖写稿、审核、生成画面、配音、合成、交付。重点保证医学准确性与合规免责，因此写稿后必须经由药师确认，才进入耗积分的生成与合成阶段。
When to use
- 用户说："帮我做个关于 XX 药的科普视频""把 XX 做成短视频""生成一条讲 XX 的用药科普"。
- 用户提供药物名（通用名/商品名）或科普角度（如"抗生素滥用""退烧药间隔"）。
- 需要批量、稳定地产出带配音+字幕的用药科普内容。
工作目录约定
为每次任务新建独立工作目录（推荐 outputs/drug_video/<药物名>/），在其中放置：
<workdir>/
manifest.json # 分镜脚本（见 references/script_format.md）
scene_1.mp4 # VideoGen 生成的动态短片
scene_1.mp3 # tts.py 生成的中文配音
scene_2.mp4 ...
...
Workflow
第 1 步：写稿（AI 自动）
- 加载并遵守
references/drug_safety.md的合规与事实核查规范。 - 围绕用户给的药物/主题，撰写 3~6 幕分镜脚本，输出为
manifest.json（结构见references/script_format.md）。
- 每幕含narration（讲解词）、visual_prompt（画面提示词，写法见references/video_prompts.md）、duration（秒）。
- 单条视频总时长建议 60~180 秒；处方药必须标注"需医师处方"。 - 脚本末尾固定加入片尾免责声明（规范第 2 节），合成阶段会自动叠加，但写稿时也应在备注标明。
> 若用户已自带讲解词，则直接按 script_format.md 整理成 manifest，跳到审核。
第 2 步：药师审核（关键门禁，不可跳过）
- 向用户展示
manifest.json的全部 narration 与画面提示词。 - 提醒用户按
drug_safety.md第 4 节"事实核查清单"逐条核对（剂量、禁忌、相互作用、特殊人群）。 - 只有用户确认无误后，才进入第 3~5 步（这些步骤消耗积分，且生成后修改成本高）。
第 3 步：生成画面（VideoGen 为主，ImageGen 兜底）
对每一幕：
- 调用文生视频能力（VideoGen），传入该幕
visual_prompt，将返回的视频保存为<workdir>/scene_<i>.mp4。
- 提示词规范见references/video_prompts.md：扁平插画 / 医疗信息图风格，避免写实真人特写与需精确文字的画面；让画面可循环（缓慢旋转/缩放）以便拉伸到讲解时长。 - 若 VideoGen 不可用或某幕失败：改用文生图（ImageGen）生成一张静态配图，保存为
<workdir>/scene_<i>.png，合成阶段会做缓慢缩放（Ken Burns）兜底。 - 分镜数量按审核后的 manifest 为准，不要临时增减。
第 4 步：生成中文配音
运行（用受管 Python 解释器）：
python <skill>/scripts/tts.py --manifest <workdir>/manifest.json --workdir <workdir> [--voice zh-CN-XiaoxiaoNeural]
- 脚本为每幕生成
scene_<i>.mp3与同名.txt讲解词；首次运行自动安装edge-tts（需联网）。 - 可选音色：
zh-CN-XiaoxiaoNeural（女声，默认）、zh-CN-YunxiNeural（男声）等。
第 5 步：合成成品视频
运行：
python <skill>/scripts/build_video.py --workdir <workdir> --out <workdir>/final.mp4
- 脚本自动安装
moviepy + imageio-ffmpeg（首次），并用其自带的 ffmpeg 烧录中文字幕。 - 合成顺序：片头标题卡(3s) + 各分镜片段(配音时长对齐，短片不足则循环) + 片尾免责声明卡(4s)。
- 中文字幕字体自动复制系统 Microsoft YaHei 到工作目录，确保中文不乱码（建议在 Windows 下运行）。
第 6 步：交付
- 用
present_files展示<workdir>/final.mp4供用户预览/下载。 - 提示用户：发布前再次核对片尾免责声明与整体口播准确性；如用于公域平台，确认不涉及具体医疗机构/真人背书。
Resources
references/drug_safety.md— 医学准确性、合规边界、事实核查清单、片尾免责声明模板。references/script_format.md— 分镜 manifest 的 JSON 结构与完整示例（二甲双胍 / 阿莫西林）。references/video_prompts.md— VideoGen 提示词写法、风格词库、费用提示。scripts/tts.py— edge-tts 中文配音生成（支持单条 / 批量 manifest）。scripts/build_video.py— moviepy 合成 + ffmpeg 烧录中文字幕。
Dependencies & 费用
- 运行环境：用 WorkBuddy 受管 Python（如
C:/Users/ASUS/.workbuddy/binaries/python/versions/3.13.12/python.exe）。脚本在首次运行时自动 pip 安装edge-tts、moviepy、imageio-ffmpeg，无需手动配置。 - 联网：edge-tts 与 VideoGen/ImageGen 均需联网。
- 积分成本（参考
video_prompts.md第 6 节）：VideoGen 约 50~100 积分/条（5 秒级），ImageGen 约 5~10 积分/张。生成前应向用户预估总成本（分镜数 × 单价），并在第 2 步审核时锁定分镜数量。
注意事项
- 医学准确性由药师最终负责；AI 生成内容仅作 draft，发布前必须人工核对。
- 不在视频中展示真实患者服药特写或模拟医疗操作；角色建议用插画风。
- 若合成报错，检查
<workdir>/_nosub.mp4与subs.ass是否生成，便于定位（画面缺失 / 字幕乱码 / 音频不匹配）。
