快速开始

在 5 分钟内启动并运行 PlotCraft。

前置要求

• Node.js 18+
• npm 9+ 或 pnpm 8+
• Git
• AI 提供商的 API Key（见配置指南）

安装

1. 克隆仓库

git clone https://github.com/Agions/PlotCraft.git
cd PlotCraft

2. 安装依赖

npm install

3. 配置 AI 提供商

在项目根目录创建 .env.local 文件：

# 文字生成（至少配置一个）
VITE_ALIBABA_API_KEY=your-alibaba-key
VITE_MINIMAX_API_KEY=your-minimax-key
VITE_OPENAI_API_KEY=your-openai-key

# 图像生成（可选）
VITE_SEEDDREAM_API_KEY=your-seedream-key

# 语音合成（可选）
VITE_TTS_PROVIDER=edge

4. 运行开发服务器

npm run dev

应用将在 http://localhost:5173 可用。

七步工作流

PlotCraft 的核心是七步 AI 驱动工作流：

┌─────────────────────────────────────────────────────────────┐
│  步骤 1: 导入  →  步骤 2: AI分析  →  步骤 3: 脚本生成      │
│       ↓                    ↓                    ↓            │
│  上传小说/脚本/提示词    多模型并行分析    结构化视频脚本    │
│                                                             │
│  步骤 4: 分镜设计  →  步骤 5: 角色设计  →  步骤 6: 渲染   │
│       ↓                    ↓                    ↓            │
│  自动分镜图          AI角色参考图        多模型并行渲染      │
│                                                             │
│                     步骤 7: 导出                             │
│                         ↓                                   │
│                 MP4/WebM/MOV 视频                           │
└─────────────────────────────────────────────────────────────┘

分步指南

步骤 1: 导入 📥

上传源材料：

• 小说：TXT 或 Markdown 格式，支持 UTF-8/GBK/GB2312 自动检测
• 脚本：JSON 格式的结构化视频脚本
• 提示词：自定义 AI 提示词

AI 自动完成章节切分、角色识别、对话提取。

步骤 2: AI 分析 🧠

多模型并行处理：

• GLM-5（智谱）、M2.5（MiniMax）、Kimi K2.5（月之暗面）等
• 识别章节结构、角色关系、场景类型、情感基调
• 输出结构化分析报告

步骤 3: 脚本生成 📝

基于分析结果生成结构化视频脚本：

• 分镜头描述（镜头类型、景别、时长）
• 对话台词（带情感标注）
• 场景描述（背景、动作、情绪）

步骤 4: 分镜设计 🎬

自动生成分镜图，包含：

• 镜头角度建议（广角、中景、特写等）
• 构图参考
• 时间轴估算

可手动编辑所见即所得。

步骤 5: 角色设计 🎭

AI 创建角色参考图：

• 基于种子机制，确保多场景一致性
• 表情/姿态可编辑
• 支持风格预设

步骤 6: 批量渲染 🖼️

多模型并行渲染：

• Seedream 5.0、Kling 1.6、Vidu 2.0 等图像模型
• 支持光照/风格/调色预设
• 批量生成场景图、角色肖像、背景素材

步骤 7: 导出 📤

一键合成视频：

• 格式：MP4、WebM、MOV
• 分辨率：720p、1080p、4K
• 字幕：自动嵌入
• 唇形同步：TTS 语音对齐动画

下一步

• 安装指南 - 详细的安装说明
• 配置 - 所有配置选项
• 工作流程概述 - 深入了解工作流程