Videohub Film Commentary

VideoHub Film Commentary

先读取 videohub-story-editor/SKILL.md，本 Skill 只增加影视剧专用的讲述策略和 旁白/原声混合规则，不复制基础流水线。

片名为《东京大饭店》或 Grand Maison Tokyo 时，必须读取并执行 tokyo-grand-maison-production-preset.md。

处理连续剧后续集、要求“沿用上一集规格”或批量制作多集时，必须读取 series-episode-production.md，先继承上一集可验证的制作参数， 再按当前集素材重新建立剧情证据和剪辑计划。新建批量项目还必须读取 series-job-schema.md，使用 scripts/run_series_commentary.py 统一执行预检、计划、渲染、发布包和审计；不得在项目目录继续复制通用生产代码。

用户只提供剧集目录时，先执行 videohub-story-editor 的“剧集素材项目目录”流程，读取目录内 的 videohub_project.json 自动定位当前集视频和最佳字幕，不再要求用户重复提供字幕路径。

默认成片

• 目标时长沿用用户要求；未指定时使用 240 秒。
• 第三者旁白主导，原声锚点通常占成片 5%-12%。剧情高度依赖对白时可提高，但超过 20% 必须解释。
• 旁白区原片声音为 0.30；原声锚点恢复到 1.00。
• 单个原声锚点优先为 2-10 秒，默认保留 4-8 个；不能为了凑比例保留普通对白。
• 外语原声必须有中文或双语字幕。旁白字幕只显示实际播出的解说词。
• 完成影视解说成片后默认生成抖音发布包，包括 1080x1920 封面、3-5 个标题候选、 已选标题、50-100 字文案和 3-8 个话题；用户明确不要时才省略。
• 每期成片默认生成章节信息。通常按剧情转折划分 4-7 章，同时提供带起止时间和内容说明的 chapters.md，以及可直接粘贴到平台的 chapters.txt。
• 只处理用户有权下载、剪辑和发布的素材。

1. 理解完整剧情

按 videohub-story-editor 建立 evidence_pack.json 和 story_analysis.json。影视剧分析 必须额外明确：

• 主要人物、关系、欲望、阻碍、秘密和认知变化。
• 引发后续结果的关键选择，而不只是按时间罗列事件。
• 可重排的信息与不能倒置的因果、悬念、身份揭示和情绪积累。
• 角色声音、表情、沉默或环境声不可被旁白替代的表演时刻。

不要根据剪辑前机翻决定人物动机。先使用原文字幕和画面证据理解，再完成选段和重排。

1.1 联网剧情校验

读取 plot-research-and-fact-checking.md。用户明确 要求联网，或片名、集数、人物译名、人物关系、时代背景、字幕含义存在歧义时，必须先检索 可靠资料进行交叉核验，并把查询词、来源、链接、访问日期、被核验事实和可信度写入当前项目 的 references/plot_research.md。

联网资料只是辅助校验层，不能替代字幕和画面证据。具体到本集发生了什么、角色在何时做了 什么、某段能否被剪入成片，必须以用户提供的视频、原文字幕和实际画面为准。网络梗概与本地 素材冲突时，优先采用本地素材；无法消解的冲突写入 story_analysis.json 的 uncertainties， 不得用推测补齐剧情。默认避免引用后续集数的剧透。

2. 设计第三者旁白

读取 narration-and-source-audio.md。旁白用于：

• 快速交代人物、关系、处境、时间跨度和必要文化背景。
• 压缩重复对话、行动过程、支线与低信息场景。
• 在场景跳跃之间补足因果，让观众知道“为什么下一幕会发生”。
• 在转折之后解释其影响，但不要抢在表演之前替角色下结论。

使用具体动词和可验证事实。第三者视角可以解释，但不能把推测写成角色真实想法，也 不能把解说者观点伪装成原片台词。

3. 选择影视原声

只在“声音和表演本身比信息摘要更重要”时保留原声：

• 角色第一次显露核心性格或关系张力。
• 决定、拒绝、揭露、反问、告白、承诺、和解或告别。
• 演员停顿、哭泣、笑声、呼吸和环境声共同完成情绪的场面。
• 反复出现的主题句、关键笑点或结局回响。

不要保留只负责解释设定、重复旁白、信息密度低、收音差或无法可靠翻译的对白。原声 前用旁白提供最低限度上下文，原声结束后留 0.3-1.0 秒反应或环境声，再恢复旁白。

4. 编写混合解说计划

读取 film-commentary-plan-schema.md。在 narration_plan.json 中设置：

{
  "style": "film_commentary",
  "settings": {
    "audio_strategy": "hybrid_source_anchors",
    "original_audio_volume": 0.3,
    "source_audio_volume": 1.0
  },
  "blocks": [],
  "source_audio_windows": []
}

旁白块和原声窗口全部使用最终成片时间轴，二者不能重叠。每个条目必须说明叙事用途并 引用真实字幕、画面、事件或剪辑片段证据。

python .agents/skills/videohub-film-commentary/scripts/validate_commentary_plan.py `
  "<job_dir>/narration_plan.json" `
  --story-plan "<job_dir>/story_plan.json" `
  --evidence "<job_dir>/evidence_pack.json" `
  --analysis "<job_dir>/story_analysis.json"

校验错误必须修正。原声比例、单段长度等警告必须解释或调整。

5. 后置翻译、TTS 和渲染

先按最终剪辑时间轴生成原文字幕，再翻译和可选 DeepSeek 轻度润色。为旁白生成对齐的 MiniMax 或豆包 TTS，然后把同一 narration_plan.json 传给渲染器：

首次选择 MiniMax 音色或用户要求比较音色时，使用统一文案批量生成带缓存的试听页：

python .agents/skills/videohub-film-commentary/scripts/generate_minimax_voice_samples.py

输出位于 workspace/dubbing_temp/voice_previews/minimax_comparison/。同一模型、文案和音色 已有有效 WAV 时直接复用；index.html 用同一段解说词并列比较男声、女声、播报、抒情和 生活化音色。不能只根据几秒样片决定整片音色，正式生成前还应抽取 30-60 秒真实旁白检查 长句停顿、情绪一致性和听觉疲劳。

python .agents/skills/videohub-story-editor/scripts/render_story.py `
  "<job_dir>/story_plan.json" `
  --evidence "<job_dir>/evidence_pack.json" `
  --analysis "<job_dir>/story_analysis.json" `
  --translated-subtitle "<job_dir>/final_zh-CN.srt" `
  --narration-plan "<job_dir>/narration_plan.json" `
  --narration-audio "<job_dir>/narration_audio_minimax.wav" `
  --narration-subtitle "<job_dir>/narration_minimax.srt" `
  --burn-subtitles bilingual `
  --output "<output_dir>/<name>_film_commentary.mp4" `
  --qa-report "<job_dir>/film_commentary_qa.md"

中文原片可省略 --translated-subtitle。外语原声烧录中文或双语字幕时必须提供覆盖 最终原文时间轴的译文。覆盖范围是所有入选视频片段中实际保留、可听见的外语对白，不能只 检查恢复到 100% 音量的关键原声窗口。必须按全部入选片段执行严格覆盖检查，明确口语对白 缺失数必须为 0。完整解码、字幕边界和时长 QA 通过后才能交付。

AI 初剪和首次渲染完成后，如需人工调整片段切点、旁白块、原声锚点或字幕，使用 videohub-story-editor 的本地五轨时间线工作台。所有调整保存为项目内独立修订，并复用 未变化片段和旁白缓存；不要直接覆盖本 Skill 生成的原始故事计划与 TTS 资产。

6. 生成抖音封面和发布物料

封面必须调用 videohub-cover-designer，由该 Skill 统一处理剧名、集数徽标、人物焦点、 四种画幅和主页缩略图检查；不要在每个项目里重新复制一套封面脚本。

成片 QA 通过后，读取 douyin-publish-plan-schema.md，结合 story_analysis.json、最终旁白和实际成片编写 publish_plan.json。

• 提供 3-5 个角度不同的标题候选，并选出一个主标题。每个候选都引用真实事件或剪辑证据。
• 封面使用实际影视画面，不生成与演员、服装或场景不一致的 AI 剧照。
• 选择清晰的人物近景、关系对峙或关键转折帧；尽量避开黑场、模糊、血腥特写和无关字幕。
• 横版成片只为封面生成 1080x1920 竖版构图，不强制把完整视频裁成竖版。
• 封面标题比发布标题更短，控制为一眼能读完的主标题和副标题，文字避开人物眼睛与表情。
• 连续剧封面必须让剧名和集数在个人主页小缩略图中仍可辨认。默认同时输出 9:16、3:4、 4:3、16:9；集数使用高对比、大字号独立标记，不能依赖小号副标题表达。
• 文案为 50-100 个可见中文字符，话题为 3-8 个；标题、封面和文案不能泄露成片没有 讲到的情节，也不能夸大为真实事件、禁播或完整结局。

python .agents/skills/videohub-film-commentary/scripts/build_film_commentary_publish_package.py `
  "<film_commentary.mp4>" `
  --plan "<job_dir>/publish_plan.json" `
  --qa-report "<job_dir>/film_commentary_qa.md" `
  --cover-source "<optional_clean_video.mp4>"

脚本输出 cover_9x16.jpg、titles.txt、caption.txt、hashtags.txt、发布视频、 publish_notes.md、原始 publish_plan.json 和带媒体/封面校验信息的 publish_manifest.json。必须打开封面和至少抽查一张发布视频画面，确认人物裁切、文字换行、 字幕、标题事实和抖音安全区后才能交付。

连续剧项目完成后运行统一审计；外语剧必须传入全片段对白覆盖报告：

python .agents/skills/videohub-film-commentary/scripts/audit_series_episode.py `
  "<project_dir>" `
  --video "outputs/<final>.mp4" `
  --package "outputs/douyin_delivery" `
  --expected-duration <seconds> `
  --coverage-report "docs/story_job/source_dialogue_coverage.json" `
  --full-decode `
  --json-out "docs/series_episode_audit.json"

时长、流规格、全片段外语对白覆盖、封面尺寸、发布包视频哈希、SHA-256 清单或完整解码任一 失败时，不得标记完成。

7. 交付

除基础故事剪辑产物外，至少交付：

• narration_plan.json，包含旁白块和原声锚点。
• TTS 音轨及实际时长字幕。
• 合并后的旁白/原声字幕。
• 原声动态混音成片和 QA 报告。
• publish_plan.json、1080x1920 竖版封面、标题候选、已选标题、50-100 字文案、话题和 完整抖音发布包。
• chapters.md 和 chapters.txt。章节边界必须使用最终成片时间轴，优先落在场景、目标、 冲突或叙事阶段真正发生变化的位置；通常划分 4-7 章，不按固定分钟机械等分。每章标题 应在小空间内可读，内容说明概括该段主要人物、冲突和结果，不泄露成片未讲到的剧情。

不要用旁白覆盖原声锚点，不要用原声承担大段剧情交代，也不要把样本中的具体比例当成 所有题材的硬指标。喜剧、悬疑、爱情、家庭剧和动作片应根据表演价值调整节奏。