目录

魔因漫创 Moyin Creator:AI影视生产级工具的完整技术指南

魔因漫创 Moyin Creator:AI影视生产级工具的完整技术指南

§1 项目概述

1.1 核心定位

魔因漫创是一款面向AI影视创作者的生产级工具,logo为一只卡通狐狸,寓意"魔因"(Magic Factor)。

🎬 AI 影视生产级工具 · 支持 Seedance 2.0 · 剧本到成片全流程批量化

五大核心板块环环相扣

┌─────────────────────────────────────────────────────────────┐
│              魔因漫创 创作链路                           │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  📝 剧本 ──→ 🎭 角色 ──→ 🌄 场景 ──→ 🎬 导演 ──→ ⭐ S级  │
│                                                              │
│   │           │           │           │           │         │
│   ↓           ↓           ↓           ↓           ↓         │
│ 智能拆解   6层锚点   多视角图   电影级参数  Seedance 2.0 │
│ 场景分镜   角色圣经   生成       分镜导出    多模态创作   │
│                                                              │
└─────────────────────────────────────────────────────────────┘

1.2 竞品对比

维度魔因漫创RunwayPikaStable Video
剧本解析✅ 智能拆解
角色一致性✅ 6层锚点⚠️ 有限⚠️ 有限
批量化生产✅ 全链路
分镜系统✅ 专业级
多模态输入✅ 图文音视频⚠️
开源✅ AGPL-3.0

1.3 技术栈

层级技术选型
桌面框架Electron 30
前端框架React 18 + TypeScript
构建工具electron-vite (Vite 5)
状态管理Zustand 5
UI组件Radix UI + Tailwind CSS 4
AI核心@opencut/ai-core(提示词编译、角色圣经、任务轮询)

§2 五大功能模块详解

2.1 S级板块 — Seedance 2.0 多模态创作

核心能力

功能说明
多镜头合并叙事将多个分镜分组合并生成连贯叙事视频
多模态引用@Image/@Video/@Audio 角色参考图、场景图、首帧图自动收集
三层融合提示词动作 + 镜头语言 + 对白/唇形同步
首帧图网格拼接N×N 策略自动拼接
参数校验Seedance 2.0 ≤9图 + ≤3视频 + ≤3音频,prompt≤5000字符

技术流程

┌─────────────────────────────────────────────────────────────┐
│              Seedance 2.0 生成流程                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  分镜输入 ──→ 首帧图生成 ──→ 多模态融合 ──→ 视频生成    │
│                                                              │
│       │              │              │                         │
│       ↓              ↓              ↓                         │
│   角色参考      场景图生成    唇形同步                     │
│   角色/场景      首帧图      动作融合                     │
│                                                              │
└─────────────────────────────────────────────────────────────┘

2.2 剧本解析引擎

核心能力

## 智能拆解维度

1. **结构拆解**
   - 场景(Scene)识别
   - 分镜(Shot)切分
   - 对白(Dialogue)提取

2. **元素识别**
   - 角色识别与标注
   - 场景描述提取
   - 情绪标签生成
   - 镜头语言标记

3. **多集支持**
   - 多集/多幕剧本结构
   - 集间关联分析
   - 角色出场统计

2.3 角色一致性系统

6层身份锚点架构

┌─────────────────────────────────────────────────────────────┐
│                角色一致性 6层锚点                          │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Layer 1: 外观特征(面部轮廓、体型、服装)                  │
│      ↓                                                       │
│  Layer 2: 肤色色调(肤色、发型、发色)                      │
│      ↓                                                       │
│  Layer 3: 服装配饰(常穿服装、配饰风格)                    │
│      ↓                                                       │
│  Layer 4: 表情习惯(常用表情、情绪表达)                    │
│      ↓                                                       │
│  Layer 5: 行为模式(动作习惯、肢体语言)                    │
│      ↓                                                       │
│  Layer 6: 声音语调(音色、语速、口头禅)                  │
│                                                              │
└─────────────────────────────────────────────────────────────┘

角色圣经(Character Bible)管理

// 角色圣经示例结构
{
  "character_name": "李逍遥",
  "layers": {
    "appearance": {
      "face_shape": "国字脸",
      "body_type": "修长",
      "clothing": "古装侠客"
    },
    "color_palette": {
      "skin_tone": "白皙",
      "hair": "黑色长发",
      "clothing_colors": ["青", "白"]
    },
    "expressions": ["剑眉星目", "嘴角微扬"],
    "actions": ["拔剑", "拱手", "轻功飞行"],
    "voice": {
      "timbre": "清朗",
      "speed": "中等偏快",
      "catchphrases": ["江湖险恶"]
    }
  },
  "reference_images": ["url1", "url2"]
}

2.4 场景生成

多视角联合图生成

生成模式说明
单一视角标准中景/近景/远景
多视角组合同一场景的多个视角拼接
连续场景时间线上的场景递进

场景描述 → 视觉提示词转换

原始场景描述:
"月光下的竹林,微风吹过,远处有古筝声"

转换后的视觉提示词:
"bamboo forest at moonlight, gentle breeze, 
distant guzheng music, cinematic lighting, 
wide shot, atmospheric mist, 
traditional Chinese aesthetics, 4K"

2.5 专业分镜系统

电影级摄影参数

参数类型选项
景别远景/全景/中景/近景/特写/大特写
机位平视/俯视/仰视/倾斜
运动方式固定/推/拉/摇/移/跟/升降
构图中心/三分法/螺旋/对称/框架

视觉风格一键切换

支持风格:
- 2D 动画
- 3D 建模
- 写实风格
- 定格动画
- 水墨风格
- 赛博朋克
- 古装仙侠

§3 技术架构深度解析

3.1 项目结构

moyin-creator/
├── electron/                 # Electron 主进程 + Preload
│   ├── main.ts              # 主进程(存储管理、文件系统、协议处理)
│   └── preload.ts           # 安全桥接层
├── src/                      # React 前端
│   ├── components/
│   │   ├── panels/          # 主面板(剧本、角色、场景、分镜、导演)
│   │   └── ui/              # 基础 UI 组件库
│   ├── stores/               # Zustand 全局状态
│   ├── lib/                  # 工具库(AI 调度、图片管理、路由)
│   ├── packages/
│   │   └── ai-core/          # AI 核心引擎
│   └── types/                # TypeScript 类型定义
├── build/                    # 构建资源(图标)
└── scripts/                  # 工具脚本

3.2 AI核心引擎 @opencut/ai-core

核心职责

职责说明
提示词编译将场景描述转换为AI模型可理解的提示词
角色圣经管理存储和加载角色一致性参数
任务轮询监控AI生成任务状态,自动重试
多供应商调度API Key轮询、负载均衡

3.3 状态管理 Zustand 5

全局状态划分

// 核心Store划分
interface AppStore {
  // 剧本状态
  scriptStore: {
    currentScript: Script;
    scenes: Scene[];
    shots: Shot[];
  };
  
  // 角色状态
  characterStore: {
    characters: Character[];
    activeCharacter: string;
    characterBible: CharacterBible;
  };
  
  // 场景状态
  sceneStore: {
    scenes: GeneratedScene[];
    generationQueue: Task[];
  };
  
  // 导演/分镜状态
  directorStore: {
    storyboard: Storyboard;
    exportSettings: ExportConfig;
  };
}

§4 批量化生产工作流

4.1 全链路自动化

┌─────────────────────────────────────────────────────────────┐
│              批量化生产工作流                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐  │
│  │剧本解析 │──→│角色生成 │──→│场景生成 │──→│分镜切割 │  │
│  └────┬────┘    └────┬────┘    └────┬────┘    └────┬────┘  │
│       │              │              │              │          │
│       └──────────────┴──────────────┴──────────────┘          │
│                              │                                  │
│                              ↓                                  │
│                    ┌─────────────────┐                        │
│                    │   批量生图任务   │                        │
│                    └────────┬────────┘                        │
│                              │                                  │
│                              ↓                                  │
│                    ┌─────────────────┐                        │
│                    │   批量生视频     │                        │
│                    │  (Seedance 2.0) │                        │
│                    └────────┬────────┘                        │
│                              │                                  │
│                              ↓                                  │
│                    ┌─────────────────┐                        │
│                    │   最终导出       │                        │
│                    │  MP4/MOV/序列帧 │                        │
│                    └─────────────────┘                        │
│                                                              │
└─────────────────────────────────────────────────────────────┘

4.2 任务队列管理

多任务并行队列

interface TaskQueue {
  // 队列配置
  maxConcurrent: 3;              // 最大并发数
  retryAttempts: 3;             // 失败重试次数
  retryDelay: 5000;             // 重试间隔(ms)
  
  // 任务优先级
  priority: {
    character: 1,               // 角色生成最高优先
    scene: 2,                   // 场景次之
    storyboard: 3,              // 分镜第三
    video: 4                    // 视频生成最后
  };
}

§5 多供应商AI调度

5.1 支持的AI服务商

类型支持的服务商
图像生成Midjourney, DALL-E, Stable Diffusion, Firefly
视频生成Seedance 2.0, Pika, Runway, Sora
音频生成ElevenLabs, Azure TTS
GPT模型OpenAI GPT-4, Claude, Gemini

5.2 API Key轮询负载均衡

interface AIRouter {
  // 多API Key配置
  apiKeys: {
    openai: ['sk-xxx1', 'sk-xxx2', 'sk-xxx3'],
    seedance: ['sd-xxx1', 'sd-xxx2']
  };
  
  // 轮询策略
  polling: {
    strategy: 'round-robin',  // 轮询
    // 或 'random'
    // 或 'least-used'
  };
  
  // 熔断器配置
  circuitBreaker: {
    errorThreshold: 5,          // 连续错误次数
    timeout: 60000,             // 超时时间(ms)
    resetTimeout: 300000        // 重置时间(ms)
  };
}

§6 安装与配置

6.1 环境要求

组件要求
Node.js>= 18
npm>= 9
系统Windows/macOS/Linux

6.2 安装步骤

# 克隆仓库
git clone https://github.com/MemeCalculate/moyin-creator.git
cd moyin-creator

# 安装依赖
npm install

# 启动开发模式
npm run dev

# 配置API Key
# 启动后进入 设置 → API配置,填入AI服务商API Key

6.3 构建打包

# 编译 + 打包 Windows 安装程序
npm run build

# 仅编译(不打包)
npx electron-vite build

§7 许可证说明

7.1 双重许可模式

许可类型说明
AGPL-3.0开源使用,修改后代码必须以相同许可证开源
商业许可闭源使用或集成到商业产品中,需联系我们获取

7.2 合规建议

## 合规检查清单

### 开源使用(AGPL-3.0)
- [ ] 修改后的代码以AGPL-3.0开源
- [ ] 保留原有许可证声明
- [ ] 在显著位置注明基于本项目

### 商业使用
- [ ] 联系获取商业许可
- [ ] 支付许可费用
- [ ] 获得闭源使用授权

§8 最佳实践

8.1 角色一致性维护

## 角色创建检查清单

### 1. 基础信息
- [ ] 角色名称和背景设定
- [ ] 外貌特征详细描述
- [ ] 性格特点和行事风格

### 2. 参考素材
- [ ] 上传3张以上不同角度的角色参考图
- [ ] 确保光线和背景一致
- [ ] 避免过度PS的图

### 3. 一致性验证
- [ ] 在5个不同场景中测试角色一致性
- [ ] 检查服装、发型、肤色是否统一
- [ ] 验证表情和动作习惯

8.2 批量化生产优化

// 推荐:分批次提交任务
const batchSubmit = async (scenes: Scene[]) => {
  const batchSize = 10;  // 每批10个场景
  
  for (let i = 0; i < scenes.length; i += batchSize) {
    const batch = scenes.slice(i, i + batchSize);
    await Promise.all(
      batch.map(scene => generateScene(scene))
    );
    // 批次间休息30秒,避免API限流
    await sleep(30000);
  }
};

8.3 提示词优化

## Seedance 2.0 提示词模板

### 结构化提示词

[主体描述] + [场景环境] + [镜头语言] + [情绪氛围] + [风格标签]

示例

人物: young Chinese woman in traditional martial arts costume 场景: moonlight, bamboo forest, misty atmosphere 镜头: medium shot, slight low angle, gentle push-in 情绪: nostalgic, serene, longing 风格: cinematic, 4K, wuxia fantasy aesthetic


## §9 总结

魔因漫创作为AI影视生产级工具,提供了:

- ✅ **完整创作链路**:从剧本到成片的端到端自动化
- ✅ **角色一致性**:6层身份锚点确保角色外观统一
- ✅ **专业分镜系统**:电影级摄影参数支持
- ✅ **批量化生产**:多任务并行队列 + 自动重试
- ✅ **多供应商调度**:API Key轮询 + 熔断器保护
- ✅ **开源可扩展**:AGPL-3.0 + 商业许可双模式

**适用场景**:

| 场景 | 推荐功能 |
|------|---------|
| 短剧创作 | 剧本解析 → 角色 → 分镜 → 批量生成 |
| 动漫番剧 | 角色圣经 → 多集剧本 → 批量场景 → 分镜导出 |
| 预告片 | 精选分镜 → Seedance 2.0 → 多模态融合 |
| 广告制作 | 品牌素材 → 场景生成 → 专业分镜 |

**官方资源**:

- GitHub:github.com/MemeCalculate/moyin-creator
- 官网:moyincreator.com
- 教程:哔哩哔哩视频
- 交流群:微信群二维码

---

🦞 文档版本:v1.0 | 写作日期:2026-04-09