文旅宣传片生成器（Cultural Tourism Promo）

把「一个地名」变成「一部有根有据的精美宣传片」。核心不是堆画面，而是用真实的人文/非遗/民俗/规划，撑起每一帧画面的意义，并产出带片头文字、分段字幕、全程配音、背景配乐的完整成片。

何时使用

• 用户输入地点/景点名，希望得到文旅宣传片、城市形象片、非遗推广片、招商文旅短片。
• 触发语示例：「给金秀圣堂山做个宣传片」「把XX县的瑶族文化剪成短视频」「XX古镇文旅推广视频」。

工作流（五步）

步骤 1 · 解析输入与确认范围

• 提取目标地点与隐含诉求（形象片？招商片？竖屏短视频？）。
• 地点过宽泛（如仅「广西」）时，先确认具体县市/景区，避免调研发散。
• 确认规格：横屏 1920×1080（官网/电视）或竖屏 1080×1920（抖音/视频号）；时长 60–120s。
• 提前告知 VideoGen 信用点消耗（见步骤 4），征得同意后再生成。

步骤 2 · 五维调研（必做，且必须真实）

加载 references/research_checklist.md，按五个维度检索（WebSearch / WebFetch）：

1. 人文底蕴　2. 文化底蕴　3. 非遗（ICH）　4. 民俗　5. 政府规划

• 严禁虚构非遗名称、传承人、民俗活动或规划数据。
• 非遗定名以中国非物质文化遗产网（ihchina.cn）为准；规划/数据以政府门户（xx.gov.cn）/统计公报为准。
• 产出 research_brief.md（结构化摘要，含 5–8 个可视觉化「高光符号」）。

步骤 3 · 创意分镜

加载 references/storyboard_template.md，按「起承转合」结构写 9 镜左右的分镜表：

• 每镜含：画面描述、镜头运动、旁白/介绍文案、统一影调。
• 文案从调研摘要提炼，确保每帧都有真实依凭。
• 把结果填入本任务的 manifest.json（shots[] 每镜 {label,title,caption}，外加 title/subtitle/outro_line/overview 等），作为后续脚本的唯一输入。

步骤 4 · 生成分镜视频片段

• 逐镜调用 VideoGen（文生视频，或先 ImageGen 出概念图再图生视频保一致性）。每条 5–8 秒、1080P。
• 按顺序命名为 shot01.mp4…shot09.mp4 放入工作目录。
• 成本：约 50–100 信用点/5秒，9 镜预计 900–1800 点——生成前必须告知并征得同意。

步骤 5 · 增强与合成（文字/字幕/配音/配乐）

加载 references/video_assembly.md，按其中的命令顺序执行技能脚本：

1. concat_videos.py — 分镜基础拼接 → orig.mp4
2. build_timeline.py — 计算真实镜位时间轴（字幕/旁白锁定依据）
3. make_master.py — 生成片头/片尾文字段并拼接 → master.mp4
4. gen_subtitles.py — 每镜「第N镜·标题」角标 + 介绍字幕（锁定镜位）
5. gen_narration.py — 全程纪录片语调旁白（自适应加速填满本镜，不重叠）
6. gen_bgm.py — 配乐（合成氛围乐占位，或复用 bgm_file 真音乐）
7. assemble.py — 字幕烘入 + 旁白 + 配乐 → final.mp4

三种交付模式（assemble.py --mode）：

• full：全程 9 段配音 + 字幕 + 配乐（标准宣传片）
• subtitle：仅字幕 + 配乐，无旁白（后期自配）
• overview：仅片头总述 + 片尾升华 2 段解说 + 字幕 + 配乐

环境/语音/工程坑见 references/tts_voices.md 与 references/video_assembly.md。

核心约束（不可违反）

• 真实优先：所有非遗/民俗/规划/数据必须可考，定名以 ihchina.cn、政府门户为准，严禁编造。
• 对齐不脱节：字幕与旁白锁定 timeline.json 计算的真实镜位，旁白自适应加速填满本镜，杜绝延迟与重叠。
• 信用点告知：VideoGen 生成前必须告知消耗并征得同意。

资源索引

• references/research_checklist.md — 五维调研维度、搜索词、可信来源优先级
• references/storyboard_template.md — 分镜表格式、镜头运动词库、文案风格
• references/video_assembly.md — 完整合成流水线、manifest 字段、ffmpeg 环境、工程坑
• references/tts_voices.md — 旁白语音来源（macOS say / 自定义录音）
• scripts/concat_videos.py build_timeline.py make_master.py gen_subtitles.py gen_narration.py gen_bgm.py assemble.py ffmpeg_utils.py — 流水线脚本
• scripts/manifest.example.json — manifest 完整字段示例