Flatten skill category directory structure

2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,78 @@
+# 视频生成
+
+## 目标
+
+基于分镜规划和脚本，生成 AI 视频片段。
+
+## 生成模型
+
+使用 **Seedance 2.0** 多参考图模式（`seedance_multimodal_video`）：
+- 模型：`seedance2.0`
+- 输入：多张参考图（背景参考图 + 角色参考图 + 物件参考图），通过 `reference_image_paths` 传入
+- 时长：与脚本每幕的秒数一致（4～15 秒），从时间码标签直接读取
+- 分辨率：`720p`，比例 `16:9`
+- 音频：`generate_audio: false`（最终合成时统一嵌入歌曲音频）
+- **并发度：1**（逐幕顺序生成，避免 API 限流）
+
+## 参考图策略
+
+视频生成使用分镜选定图作为画面构图基准，配合角色和物件参考图确保一致性：
+
+| 场景类型 | reference_image_paths | prompt 引用示例 |
+|----------|----------------------|----------------|
+| 角色场景 | [分镜选定图, 角色 selected.jpg] | `use image 1 as the scene composition, image 2 as the character reference` |
+| 角色 + 物件场景 | [分镜选定图, 角色 selected.jpg, 物件 selected.jpg] | `use image 1 as the scene composition, image 2 as the character, image 3 as the prop reference` |
+| 多角色场景 | [分镜选定图, 角色1 selected.jpg, 角色2 selected.jpg] | `use image 1 as the scene composition, image 2 and image 3 as character references` |
+| 纯空镜 | [分镜选定图] | `use image 1 as the scene composition` |
+
+> 分镜选定图路径：`storyboard/scene_{NN}.jpg`（其中 NN 为幕序号，如 scene_01.jpg）
+
+## 生成流程
+
+1. 读取 `storyboard.md`，提取每幕的参考图路径、出场角色、场景背景和时长
+2. 为每幕编写视频提示词（英文），描述画面动态和镜头运动，引用参考图
+3. 逐幕调用 `seedance_multimodal_video`，传入参考图列表和提示词
+4. 每幕生成完成后，将视频保存到 `clips/` 目录
+5. 全部完成后，生成 `video_prompts.md` 记录每幕的提示词和生成参数
+
+## 提示词结构
+
+```
+[参考图引用], [主体描述], [动作/运动], [环境/场景], [光线/氛围], [镜头语言], [风格修饰]
+```
+
+## 提示词原则
+
+- 使用英文撰写（AI 视频工具对英文支持最佳）
+- 先引用参考图（image 1, image 2...），再写主体和动作
+- 明确指定镜头运动方式（camera pan left, dolly in, static shot...）
+- 包含光线描述（golden hour, neon lights, dramatic shadows...）
+- 添加风格标签（oil painting, thick brushstrokes, impressionist...）
+- 避免否定描述，用正面表述替代
+
+## 文件存储
+
+```
+./.mv/{song_name}/{theme}/video_prompts.md                  # 视频提示词
+./.mv/{song_name}/{theme}/clips/{scene_name}.mp4            # 生成的视频片段
+```
+
+## 视频预览
+
+全部视频生成完成后，调用 MCP 工具 `preview_and_collect_feedback` 启动视频预览：
+- **script**: `.opencode/skills/mv-creator/scripts/render_preview.py`
+- **args**: `[".mv/{song_name}/{theme}", "--type", "videos", "--lang", "{lang}"]`
+- **feedback_path**: `.mv/{song_name}/{theme}/feedback.md`
+
+预览页面展示：
+- 每幕视频播放器（支持播放/暂停/拖拽）
+- 场景信息（标题、时间码、歌词、出场角色、场景描述）
+- 视频提示词（可折叠）
+- 参考图缩略图
+- 生成状态（已生成 / 缺失）
+
+用户反馈处理（工具返回反馈内容后）：
+- `LGTM` → 进入视频剪辑阶段
+- `@scene_03 镜头运动改为缓慢推进` → 修改指定幕的提示词并重新生成
+- `@scene_05 重新生成` → 使用原提示词重新生成指定幕
+- 可上传参考图辅助修改：`@scene_02 参考 @uploaded/ref.jpg 的构图`