Seedance 2.0 剧情转提示词助手（视频版）
将你的小说、剧本或短剧情文本，一键转换为 Seedance 2.0「全能参考模式」的视频生成提示词。
- 目标升级：由原来的 Midjourney / SDXL 生图 Prompt，全面升级为 Seedance 2.0 多模态文生视频 Prompt。
- 结构化输出：按「技术参数 → 主体 → 动作序列 → 场景环境与光影 → 镜头语言 → 技术约束 → @引用占位」六段结构输出，顺序稳定，可直接整体粘贴使用。
- 要素抽取：沿用规则+词典的方式，从剧情中抽取人物、场景、时间、天气、动作、道具、情绪等要素。
- 全能参考友好：内置 @Image / @Video / @Audio 占位说明，方便与你上传到 Seedance 2.0 的参考素材绑定。
功能说明（v2.0.0）
1. 核心能力
输入一段中文或英文的小说片段、短剧情或剧本描述，本技能会：
- 抽取剧情中的核心画面要素：
- 主体：角色身份、外貌/服装等稳定特征。
- 动作：按时间顺序的行为链条（偏慢、连贯、可跟拍）。
- 场景：地点/环境 + 时间/天气 + 氛围。
- 光影与动态元素：路灯、雨丝、倒影、雾气等关键词。
- 情绪/风格：紧张、孤寂、治愈、赛博朋克等。 - 将这些要素组装为一段结构化的 Seedance 2.0 视频 Prompt，包含：
- 技术参数兜底：时长、画幅、画质、帧率与稳定性说明。
- 主体描述：保证角色脸型/五官/服装/体型的前后一致性。
- 动作序列：强调“慢、连、稳”的动作链条，避免大幅快速运动。
- 场景环境与光影：地点、时间、天气、光影特征与环境动态元素。
- 镜头语言：景别、运镜方式与焦点切换（若原文没有明确镜头描述，则使用稳健的默认电影机位）。
- 技术约束：面部稳定不变形、无闪烁、无穿模、无帧间风格漂移等。
- 参考素材占位：为 @Image / @Video / @Audio 预留标准用法说明。
生成结果是中文长段落 + 多行结构化块，可以直接整体复制到 Seedance 2.0「全能参考」提示词输入框中，再按需要替换或补充。
2. 触发词
/剧情转提示词/seedance2/scene2prompt
> 在 Agent / Skill 容器中，这些触发词依旧可用，但返回内容已升级为 Seedance 2.0 视频 Prompt，而非 MJ/SDXL 图像 Prompt。
3. 参数格式（面向 Skill 调用）
在对话中调用时，可按如下格式提供剧情文本：
/剧情转提示词 [你的剧情文本]
- [你的剧情文本]（必需）：一段中文或英文的剧情描述，建议 1–3 段，适合生成 8–15 秒的视频。
- 不再需要
--engine mj/sdxl等参数，统一输出 Seedance 2.0 视频 Prompt。
> 若你仍希望在代码层面兼容旧版图像引擎，可在 Python 中调用 generate_prompt(text, engine="mj"|"sdxl")，但这属于兼容接口，文档不再重点介绍。
使用方式
方式一：在命令行本地运行（推荐调试）
- 准备剧情文本，例如保存为
examples/sample.txt：
夜晚的老城区街巷，小雨。男主独自缓慢行走，偶尔停下靠在斑驳墙面，抬头看路灯，轻叹。镜头先平稳跟拍，再缓慢推近至面部特写，焦点顺滑切换。暖黄路灯光，雨丝飘落，地面倒影，氛围孤寂。整段动作连贯、面部稳定不变形，画面无闪烁。
- 运行脚本：
python scripts/main.py --input examples/sample.txt --output outputs/prompt.txt
- 在
outputs/prompt.txt中查看生成的 Seedance 2.0 全能参考 Prompt，可直接复制到即梦 / Seedance 2.0 的提示词输入框使用。
> 参数说明：
>
> - --input：剧情文本文件（UTF-8）。
> - --output：输出 Prompt 文件路径（默认 outputs/prompt.txt）。
> - --duration：可选，自定义“时长”描述，默认 12秒。
> - --ratio：可选，自定义“画面比例”描述，默认 16:9 横屏。
> - --resolution：可选，自定义画质描述，默认 2K 超清。
> - --fps：可选，自定义帧率/稳定性描述，默认 24fps 电影帧率。
方式二：在 Python 代码中调用
from seedance2 import generate_seedance_prompt
story = "夜晚的老城区街巷，小雨。男主独自缓慢行走，偶尔停下靠在斑驳墙面，抬头看路灯，轻叹。"\
"镜头先平稳跟拍，再缓慢推近至面部特写，焦点顺滑切换。暖黄路灯光，雨丝飘落，地面倒影，氛围孤寂。"
prompt = generate_seedance_prompt(
story,
duration="12秒",
ratio="16:9 横屏",
resolution="2K 超清",
fps="24fps 电影帧率",
)
print(prompt)
输出结构示例（节选）
对上面的「老城区雨夜」示例，生成的 Prompt 结构大致如下（仅为示意）：
技术参数：时长 12秒，画面比例 16:9 横屏，基础分辨率 2K 超清，24fps 电影帧率，帧间无缝衔接，无画面闪烁，全程运动流畅稳定。
主体：男主独自行走的形象，整体气质偏疲惫、内敛。需要保证角色在整段视频中的脸型、五官比例、肤色、发型、服装与体型前后一致，无明显漂移和崩坏。
动作序列：围绕缓慢行走、停下靠墙、抬头看路灯、轻叹 设计缓慢、连贯、无跳帧的动作链条。镜头跟随角色完成以下连续动作：夜晚的老城区街巷，小雨 → 男主独自缓慢行走，偶尔停下靠在斑驳墙面，抬头看路灯，轻叹。整体动作节奏偏慢，避免剧烈晃动和大幅度极速运动。
场景环境与光影：地点/环境：老城区街巷；时间与天气：夜晚，小雨；光影特征：暖黄路灯光；环境动态元素：雨丝，地面倒影。需要保证环境光影随时间自然过渡，背景建筑和道具前后一致，无明显结构崩坏，动态元素（如雨丝、倒影等）运动逻辑合理。
镜头语言：镜头先平稳跟拍，再缓慢推近至面部特写，焦点顺滑切换。整体控制在 1-2 种运镜方式之内，避免频繁切换；运镜平稳无抖动，无突然跳镜或大幅度甩镜。
技术约束：全程画面稳定无抖动，无明显噪点和压缩伪影；角色面部稳定不变形，五官结构自然，人体比例合理，无穿模、无多肢体；帧间风格、光影与色调高度一致，无闪烁、无鬼影、无突兀元素刷新；重要道具与场景结构在整段视频中保持一致。
参考素材占位（可选）：
@Image1：主体角色的半身或全身形象参考，用于锁定脸型与服装；
@Image2：场景与光影氛围参考（如老城区街巷夜景、室内打光示意）；
@Video1：运镜与动作节奏参考，用于复刻镜头运动方式和节奏；
@Audio1：背景音乐或环境音参考，用于控制节奏与情绪起伏。
与旧版的区别
- 目标引擎：
- v1.x：面向 Midjourney / Stable Diffusion XL 的单帧或多帧图像提示词。
- v2.0.0：面向 Seedance 2.0 的文生视频 Prompt，重点围绕「全能参考模式」的镜头语言与动态连续性。
- 输出结构：
- v1.x：偏单行/短段落的画面描述 + MJ/SDXL 参数。
- v2.0.0：固定六段结构 + @引用说明，更贴近实际 Seedance 2.0 提示词工程实践。
- 约束重点：
- v1.x：负面提示词（no blur, no distortion 等）。
- v2.0.0：显式声明“面部稳定不变形、无闪烁、无穿模、帧间一致”等视频特有约束，无负向 Prompt 语法。
注意事项
- 要素抽取基于简单规则与词典，无法做到完整的自然语言理解；
- 若剧情较长或结构复杂，建议将关键镜头所在的 1–3 段文字单独放入本技能处理；
- 生成的 Prompt 可作为高质量起点，你可以按 Seedance 官方模板做细节微调。
- 输出中的 @Image/@Video/@Audio 仅为占位说明：
- 在 Seedance 2.0「全能参考」模式中，实际使用时请将它们替换为界面中插入的对应素材引用标签；
- 若本次创作不使用某类参考（如无音频参考），可以保留或删除对应行，Seedance 会自动忽略未绑定素材的标签描述。
- 本技能默认输出中文，适配即梦 / 豆包等中文环境；如需英文提示词，可在上层调用中对生成结果做翻译处理。
