🎬 分镜大师 Storyboard Studio

AI 驱动的专业分镜工作台 · 让视频创作更简单
_{视频导入 → 智能抽帧 → AI 解析 → 图片/视频生成 → 批量任务 → 成片合成}

中文 | English

快速开始 • 功能特性 • 界面预览 • 技术栈 • 下载

💡 为什么选择分镜大师？

🎥 演示视频

📺 在线演示：http://47.100.163.84/ （仅 UI 界面，无后端）

🌟 核心特性

🎬 双模式创作

🎨 AI 素材生成

⚙️ 专业参数控制

支持电影级专业参数，让 AI 生成更符合预期：

📷 镜头类型：特写、中景、全景、远景、大远景
📐 构图方式：三分法、对称、黄金分割、中心构图
💡 光线设置：自然光、柔光、逆光、侧光、顶光
🎨 色调风格：暖色调、冷色调、高对比度、低饱和度
🎥 镜头运动：推拉摇移、跟随、环绕、升降

🚀 批量任务处理

• ⚡ 并发执行：默认 2 个任务并发，可配置
• 🔄 任务队列：支持取消、重试、删除操作
• 📊 进度监控：实时查看任务状态和进度
• 📜 历史记录：完整的任务执行历史

✨ 功能亮点

🌐 在线演示

🎮 体验地址：http://47.100.163.84/ 💡 说明：仅包含 UI 界面展示，无后端功能实现

🖼️ 界面预览

🏠 首页 - 项目管理 创建新项目，管理最近项目，快速开始创作	🎬 主界面 - 工作区 完整的分镜工作台，视频导入、抽帧、编辑一站式
✏️ 分镜编辑 - 镜头管理 拖拽排序，全字段编辑，多视图切换	🚀 批量生成 - 任务处理 批量生成图片和视频，队列管理，并发执行
📊 任务管理 - 队列监控 实时监控任务状态，支持取消、重试、删除	📤 导出成品 - 视频合成 FFmpeg 合成最终视频，支持多种分辨率和格式

🧭 完整工作流

graph LR
    A[创建项目] --> B{选择模式}
    B -->|视频模式| C[导入视频]
    B -->|文本模式| D[输入描述]
    C --> E[智能抽帧]
    D --> F[AI 生成分镜]
    E --> G[AI 解析镜头]
    F --> G
    G --> H[编辑镜头]
    H --> I[生成图片]
    I --> J[生成视频]
    J --> K[合成成片]
    K --> L[导出]

📋 详细流程

💡 提示：每个环节都可独立执行，支持手动编辑与批量任务处理，灵活适应不同创作需求。

🚀 快速开始

📦 方式一：安装包（推荐）

⚠️ 首次安装必读

本软件需要 .NET 8 桌面运行时（约 55MB），首次使用请先安装：

• 自动安装（推荐）：直接运行安装程序，Windows 会自动提示下载
• 手动预装：访问 .NET 8 下载页面，下载"桌面运行时 x64"

💡 运行时只需安装一次，后续更新无需重新安装

🔄 自动更新

本项目支持 Gitee + GitHub 双源自动更新：

• ✅ 国内用户：优先使用 Gitee 更新源，速度快
• ✅ 国外用户：自动切换到 GitHub 更新源
• ✅ 智能切换：主源不可用时自动切换到备用源
• ✅ 增量更新：只下载变化的部分，节省流量
• ✅ 后台更新：不影响正常使用

更新流程：应用启动 3 秒后自动检查更新 → 发现新版本显示通知 → 点击"立即更新" → 重启后即为最新版本

详细配置请参考：Gitee + GitHub 双源发布指南

💻 方式二：从源码运行（开发者）

环境要求

• .NET 8.0 SDK
• Windows / Linux / macOS（跨平台支持）
• Visual Studio 2022 或 JetBrains Rider（可选）

命令行运行

# 1. 克隆项目
git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd 分镜大师

# 2. 还原依赖
dotnet restore

# 3. 编译项目
dotnet build

# 4. 运行应用
dotnet run

Visual Studio 2022

1. 打开 Storyboard.sln
2. 按 F5 直接运行
3. 开始调试和开发

⚙️ 首次配置

1. 配置 AI 提供商

应用首次启动后，需要配置 AI 提供商才能使用 AI 功能：

1. 点击主界面的 "提供商设置" 按钮
2. 选择要使用的 AI 提供商（通义千问、火山引擎等）
3. 填入 API Key 和 Endpoint
4. 选择默认模型
5. 点击 "保存" 完成配置

2. 创建第一个项目

1. 点击 "创建新项目"
2. 填写项目名称和创意意图（可选）
3. 选择创作模式：
   • 视频导入模式：导入现有视频，自动生成分镜
   • 文本生成模式：输入文本描述，AI 生成分镜
4. 开始创作！

⚙️ 配置管理

🎛️ 配置入口

• 推荐方式：应用内「提供商设置」界面（可视化配置，无需编辑文件）
• 高级方式：直接编辑 appsettings.json（支持更多高级选项）

🤖 支持的 AI 提供商

📝 配置示例

{
  "AIServices": {
    "Providers": {
      "Qwen": {
        "ApiKey": "sk-your-qwen-api-key",
        "Endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "DefaultModels": {
          "Text": "qwen-plus",
          "Image": "wanx-v1"
        }
      },
      "Volcengine": {
        "ApiKey": "your-volcengine-api-key",
        "Endpoint": "https://ark.cn-beijing.volces.com/api/v3",
        "DefaultModels": {
          "Text": "ep-20241218xxxxx-xxxxx",
          "Image": "seedream-v1",
          "Video": "seedance-v1"
        }
      },
      "OpenAI": {
        "ApiKey": "sk-your-openai-api-key",
        "Endpoint": "https://api.openai.com/v1",
        "DefaultModels": {
          "Text": "gpt-4"
        }
      }
    },
    "Defaults": {
      "Text": {
        "Provider": "Volcengine",
        "Model": "ep-20241218xxxxx-xxxxx"
      },
      "Image": {
        "Provider": "Volcengine",
        "Model": "seedream-v1"
      },
      "Video": {
        "Provider": "Volcengine",
        "Model": "seedance-v1"
      }
    }
  }
}

✨ 配置能力

• ✅ 多 Provider 并存：同时配置多个提供商，按需切换
• ✅ 多模型配置：每个提供商可配置多个模型
• ✅ 独立默认设置：文本/图片/视频各自独立配置默认模型
• ✅ 任务级切换：每个任务可选择不同的模型和提供商
• ✅ 本地与云端并存：本地渲染/合成与云端模型可并行配置

🗂️ 项目结构

分镜大师/
├─ 📱 App/                          # Avalonia UI 层
│  ├─ Views/                        # XAML 视图组件
│  ├─ ViewModels/                   # MVVM 视图模型
│  ├─ Converters/                   # 值转换器
│  ├─ Messages/                     # 消息传递
│  └─ App.axaml.cs                  # 依赖注入配置
│
├─ 🎯 Application/                  # 应用层（用例）
│  ├─ Abstractions/                 # 服务接口
│  ├─ Services/                     # 应用服务
│  │  ├─ ProjectService.cs          # 项目管理服务
│  │  ├─ ShotService.cs             # 镜头管理服务
│  │  ├─ VideoAnalysisService.cs   # 视频分析服务
│  │  └─ TaskQueueService.cs        # 任务队列服务
│  └─ DTOs/                         # 数据传输对象
│
├─ 🏛️ Domain/                       # 领域层（业务逻辑）
│  └─ Entities/                     # 核心领域模型
│     ├─ Project.cs                 # 项目实体（350+ 属性）
│     ├─ Shot.cs                    # 镜头实体（完整分镜参数）
│     └─ ShotAsset.cs               # 素材资产实体
│
├─ 🔧 Infrastructure/               # 基础设施层
│  ├─ AI/                           # AI 服务集成
│  │  ├─ Core/                      # AI 提供商接口
│  │  ├─ Providers/                 # 通义千问、火山引擎实现
│  │  │  ├─ QwenProvider.cs         # 通义千问适配器
│  │  │  └─ VolcengineProvider.cs   # 火山引擎适配器
│  │  ├─ Prompts/                   # 提示词模板管理
│  │  │  ├─ shot_analysis.json      # 镜头分析模板
│  │  │  ├─ text_to_shots.json      # 文本生成分镜模板
│  │  │  └─ image_generation.json   # 图片生成模板
│  │  └─ AIServiceManager.cs        # AI 服务编排
│  │
│  ├─ Media/                        # 媒体处理
│  │  ├─ Providers/                 # 图片/视频生成提供商
│  │  │  ├─ QwenImageProvider.cs    # 通义千问图片生成
│  │  │  ├─ SeedreamProvider.cs     # Seedream 图片生成
│  │  │  └─ SeedanceProvider.cs     # Seedance 视频生成
│  │  └─ FfmpegLocator.cs           # FFmpeg 集成
│  │
│  ├─ Persistence/                  # 数据库与 EF Core
│  │  ├─ StoryboardDbContext.cs     # 数据库上下文
│  │  └─ Repositories/              # 仓储实现
│  │
│  ├─ Configuration/                # 配置管理
│  │  └─ AIServiceConfiguration.cs  # AI 服务配置
│  │
│  └─ Services/                     # 基础设施服务
│     ├─ VideoProcessingService.cs  # 视频处理服务
│     └─ FileStorageService.cs      # 文件存储服务
│
├─ 🔗 Shared/                       # 共享模型与 DTO
├─ 🛠️ Tools/ffmpeg/                 # 内置 FFmpeg/FFprobe
├─ 📋 Prompts/                      # AI 提示词模板
├─ ⚙️ appsettings.json              # 应用配置文件
└─ 📦 Storyboard.sln                # 解决方案文件

🏗️ 架构特点

📦 数据与输出

💾 数据存储

📂 输出目录结构

output/
└─ projects/
   └─ <ProjectId>/              # 项目 ID 目录
      ├─ images/                # 图片素材
      │  ├─ shot_1_first.png    # 镜头 1 首帧
      │  ├─ shot_1_last.png     # 镜头 1 尾帧
      │  └─ ...
      ├─ videos/                # 视频素材
      │  ├─ shot_1.mp4          # 镜头 1 视频
      │  └─ ...
      └─ exports/               # 导出文件
         ├─ storyboard.json     # 分镜 JSON
         └─ final_video.mp4     # 最终合成视频

🧰 FFmpeg 依赖

📦 内置工具

项目已内置 Tools/ffmpeg 目录，包含：

✨ 特性

• ✅ 无需安装：开箱即用，自动检测
• ✅ 跨平台：Windows / Linux / macOS 支持
• ✅ 自动定位：优先使用内置版本，支持系统版本
• ✅ 完整功能：支持所有主流视频格式和编码

🧪 技术栈

🎯 核心特性深度解析

1. 🎨 创意意图融合

在 AI 生成过程中，可以设置完整的创意意图，让 AI 生成更符合预期：

AI 会根据这些意图生成更符合预期的分镜和素材，大幅提升创作效率。

2. 🎬 专业参数控制

支持电影级专业参数，让 AI 生成更加精准：

3. 📦 素材资产管理

• 多次生成：每个镜头可生成多次图片/视频，保留所有历史
• 显式绑定：用户手动选择最佳素材，精准控制
• 预览对比：并排对比不同生成结果，快速决策
• 元数据记录：记录生成参数、模型、提示词，可追溯

4. ⚡ 批量任务处理

• 任务队列：独立执行，互不干扰
• 并发控制：默认 2 个并发，可配置（1-10）
• 任务管理：支持取消、重试、删除操作
• 进度监控：实时查看任务状态和进度
• 历史记录：完整的任务执行历史，支持查询和审计

🗺️ 产品路线图

🚀 即将推出（v2.0）

• 🔊 TTS 智能配音：自动生成旁白和对话配音
• ✂️ 自动剪辑优化：AI 优化镜头时长和转场
• 🎨 自动风格迁移：一键应用电影级调色风格
• 📱 社交平台一键发布：直接发布到抖音、B站等平台

🔮 未来规划（v3.0+）

• 🎵 背景音乐智能匹配：根据视频节奏自动匹配音乐
• 📊 数据分析与优化建议：分析视频数据，提供优化建议
• 👥 团队协作功能：多人协作编辑，实时同步
• ☁️ 云端同步与备份：项目云端存储，多设备同步
• 🌍 多语言支持：支持英语、日语等多种语言
• 🎭 角色库管理：预设角色库，快速应用到分镜

🤝 贡献指南

我们欢迎所有形式的贡献！无论是报告 Bug、提出新功能建议，还是提交代码改进。

🐛 报告问题

发现 Bug？请通过 GitHub Issues 报告：

1. 描述问题现象
2. 提供复现步骤
3. 附上错误日志（如有）
4. 说明运行环境（操作系统、.NET 版本）

💡 功能建议

有好的想法？欢迎通过 GitHub Discussions 讨论：

1. 描述功能需求
2. 说明使用场景
3. 提供参考案例（如有）

🔧 开发环境搭建

# 1. Fork 并克隆项目
git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd 分镜大师

# 2. 安装依赖
dotnet restore

# 3. 运行项目
dotnet run

# 4. 运行测试（如有）
dotnet test

📝 提交规范

• 代码风格：遵循现有代码风格，使用 EditorConfig
• 提交信息：清晰描述改动内容，使用中文或英文
• 单元测试：为新功能添加测试（如适用）
• 文档更新：更新相关文档和注释

🎯 贡献方向

我们特别欢迎以下方向的贡献：

• 🌍 国际化：添加多语言支持
• 🎨 UI/UX 改进：优化界面设计和用户体验
• 🤖 AI 提供商：集成更多 AI 服务提供商
• 📚 文档完善：改进文档、添加教程
• 🐛 Bug 修复：修复已知问题
• ⚡ 性能优化：提升应用性能

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

这意味着您可以：

• ✅ 商业使用
• ✅ 修改代码
• ✅ 分发代码
• ✅ 私人使用

但需要：

• 📋 保留版权声明
• 📋 保留许可证声明

📧 联系方式

⭐ Star History

如果这个项目对您有帮助，请给我们一个 Star ⭐！

Star History

🙏 致谢

感谢以下开源项目和服务：

• Avalonia - 跨平台 UI 框架
• FFmpeg - 强大的媒体处理工具
• Serilog - 结构化日志库
• SkiaSharp - 跨平台 2D 图形库

🎬 让创意更快落地，让分镜更加专业 🎬

_{用分镜大师，开启高效视频创作之旅！}

立即开始 • 下载安装 • 在线演示

Made with ❤️ by the Storyboard Studio Team