#!/usr/bin/env python # -*- coding: UTF-8 -*- """ @Project: 短剧解说-文案画面匹配 @File : script_generation.py @Author : viccy同学 @Date : 2025/1/7 @Description: 短剧解说脚本生成提示词 - 优化版本 """ from ..base import ParameterizedPrompt, PromptMetadata, ModelType, OutputFormat class ScriptGenerationPrompt(ParameterizedPrompt): """短剧解说脚本生成提示词 - 优化版本""" def __init__(self): metadata = PromptMetadata( name="script_generation", category="short_drama_narration", version="v2.1", description="基于已规划片段生成高质量短剧解说脚本,重点补足剧情承接、因果解释和观众理解路径", model_type=ModelType.TEXT, output_format=OutputFormat.JSON, tags=["短剧", "解说脚本", "文案生成", "原声片段", "黄金开场", "爽点放大", "个性吐槽", "悬念预埋"], parameters=[ "drama_name", "drama_genre", "plot_analysis", "subtitle_content", "segment_plan", "narration_language", ] ) super().__init__(metadata, required_parameters=["drama_name", "plot_analysis", "segment_plan"]) self._system_prompt = ( "你是一位短剧解说文案写手。你必须严格按照JSON格式输出," "只能补充picture和narration,不能改动上游片段规划中的_id、video_id、video_name、timestamp和OST。" ) def get_template(self) -> str: return """# 短剧解说脚本文案生成任务 ## 任务目标 为短剧《${drama_name}》生成最终可剪辑解说脚本。片段已经由上游规划完成,你只能补充 picture 和 narration,不能改变片段来源和时间戳。 ## 输入材料 ### 剧情概述 ${plot_analysis} ### 已规划片段(必须逐项照抄结构字段) ${segment_plan} ### 原始字幕(含视频编号和精确时间戳) ${subtitle_content} ### 解说台词语言 ${narration_language} ### 用户选择的短剧类型 ${drama_genre} 字幕可能来自多个视频文件。每个字幕分段标题会以“视频 1: 文件名”“视频 2: 文件名”等形式标识来源。 生成脚本时必须把每个片段绑定到对应视频来源,时间戳表示该视频文件内部的局部时间,不是把多个视频拼接后的全局时间。 所有 OST=0 的 narration 字段必须使用上方指定的解说台词语言输出;不要因为原始字幕是其他语言就切回字幕原语言。 OST=1 的原声片段 narration 字段必须继续使用“播放原片+序号”格式,不要翻译这个固定标记。 ## 绝对绑定规则 1. 输出 items 数量、顺序和 _id 必须与 segment_plan 完全一致。 2. 每个 item 的 _id、video_id、video_name、timestamp、OST 必须逐字复制 segment_plan,不得新增、删除、合并、拆分或改动。 3. 你只能补充 picture 和 narration 两个字段。 4. OST=1 的 narration 必须写成“播放原片+_id”,例如 _id 为 5 时写“播放原片5”。 5. OST=0 的 narration 必须使用 ${narration_language},并严格基于剧情和字幕,不虚构字幕外的具体事件。 ## 叙事连续性要求 - 你必须把每个 OST=0 当成“观众理解剧情的桥”,不能只概括当前画面。 - 每个 OST=0 narration 要尽量回答:上一段发生了什么、为什么会发展到这一段、这一段带来什么新矛盾。 - 跨 video_id 或跨时间大跳跃时,OST=0 必须明确补出承接句,例如“可这段婚姻真正难的不是相爱,而是两个孩子和婆婆都还没接纳她”。 - 原声片段前后的 OST=0 要解释原声的重要性,避免观众只看到对白片段合集。 - 如果 segment_plan 中有 story_role、intent、transition 字段,必须利用它们组织 narration,但不要把这些字段输出到最终 JSON。 - 结尾 OST=0 要留下后续阻力或悬念;如果结尾是 OST=1,则前一个 OST=0 必须提前点出这段原声会把矛盾推向哪里。 ## 开头钩子要求 - 第一段必须是 OST=0 解说钩子,不能直接播放原片。 - 开头用“高能反转 + 情绪冲突 + 悬念钩子”:强身份/强处境 + 致命反差 + 后续悬念。 - 写法示例方向:一个刚立功的兵王,下一秒却被迫脱下军装;他回家的第一天,家里的钱和尊严都被赌桌吞了。 - 示例只用于理解公式,必须基于当前字幕事实原创,不要夸大到字幕没有的情节。 ## 解说密度与画面节奏 - OST=0 文案必须能被当前 timestamp 的画面承载,按“解说字数 / 5 = 所需视频秒数”估算。 - 如果画面只有 6 秒,就不要写 80 字;应压缩到约 30 字,或依赖 segment_plan 选择更长画面。 - 优先短句,单句只表达一个信息点;不要把人物介绍、前因、反转和悬念全塞进一个短画面。 - 长信息要拆成多段,每段只承担一个叙事功能,让画面节奏跟上解说。 ## 用户选择类型文案规则 短剧类型由用户手动选择为 ${drama_genre},不得自行改判。必须按对应方向写: - 霸总/甜宠:突出误会、身份差、暧昧拉扯、守护感和情绪反差。 - 逆袭/复仇:突出羞辱、反击、打脸、身份揭露和爽点升级。 - 家庭伦理:突出亲情撕扯、秘密、委屈、选择和道德冲突。 - 古装/权谋:突出身份、局势、算计、立场和反转。 - 悬疑/犯罪:突出线索、危机、动机和未揭开的疑问。 - 都市情感:突出关系裂痕、现实压力、误会和情绪拉扯。 - 年代/乡村:突出家庭处境、人情压力、生活困境和命运转折。 - 自定义类型:严格服从用户填写的类型方向。 ## 文案质量要求 - 开场片段要有强钩子,直接点出冲突、悬念或情绪爆点。 - 每段解说优先 25-90 字,具体长度必须服从画面时长;短画面宁可少说,不要密集灌信息。 - 可以使用“没想到”“可下一秒”“而这时”“真正的问题来了”等短剧转折语,但不要堆砌。 - picture 要描述画面和人物状态,便于后期识别素材。 - 少用孤立信息句,多用承接句;不要让观众感觉剧情突然跳场。 - 不要解释规则,不要输出 Markdown,不要输出代码块。 ## 输出格式 请严格按照以下JSON格式输出,绝不添加任何其他文字、说明或代码块标记: { "items": [ { "_id": 1, "video_id": 1, "video_name": "1.mp4", "timestamp": "00:00:01,000-00:00:05,500", "picture": "女主角林小雨慌张地道歉,男主角沈墨轩冷漠地看着她", "narration": "一个普通女孩的命运即将因为一杯咖啡彻底改变!她撞到的这个男人,竟然是...", "OST": 0 }, { "_id": 2, "video_id": 1, "video_name": "1.mp4", "timestamp": "00:00:05,500-00:00:08,000", "picture": "沈墨轩质问林小雨,语气冷厉威严", "narration": "播放原片2", "OST": 1 }, { "_id": 3, "video_id": 2, "video_name": "2.mp4", "timestamp": "00:00:08,000-00:00:12,000", "picture": "林小雨惊慌失措,沈墨轩眼中闪过一丝兴趣", "narration": "霸道总裁的经典开场!一杯咖啡引发的爱情故事就这样开始了...", "OST": 0 } ] } 现在请基于以上要求,为短剧《${drama_name}》创作解说脚本:"""