企业官网建设流程全解析

LumenX 是一个AI 短漫剧一站式生产平台，能把小说文本自动转化为动态视频，打通剧本分析、角色定制、分镜绘制到视频合成的完整链路。本文带你完成LumenX 本地部署：全程只需 5 步、1 个 API Key，约 10 分钟即可跑起来，并开始你的第一部 AI 漫剧创作。

📌 开始之前：认识 LumenX 的两大模块

LumenX 包含两个核心模块，本地部署后一次全部可用：

Studio 的创作流水线为 5 步：Script（剧本）→ Art Direction（美术风格）→ Cast（角色）→ Storyboard（分镜）→ Assembly（合成导出），侧边栏随时可点击跳转，详见 ProjectClient.tsx。

🔑 部署前置准备：环境要求与 API Key

环境要求（3 个依赖）

• Python 3.11+（后端服务）
• Node.js 18+（前端服务）
• FFmpeg（视频合成必备）

只需要 1 个 API Key

LumenX 采用本地优先架构，最简配置只需一个DASHSCOPE_API_KEY（阿里云 DashScope 平台），即可解锁 Wan 图像/视频、Qwen 剧本分析、CosyVoice 配音等核心能力：

1. 注册/登录阿里云账号，进入 DashScope 控制台
2. 在API-KEY 管理中创建并复制你的 Key
3. 后续步骤中填入即可

💡 更多模型（Seedance 2.0、GPT-Image-2、Kling/Vidu 原厂直连、OSS 云端存储）均为可选项，之后随时补充配置，不阻塞起步。完整说明见 USER_MANUAL.md。

🚀 5 步完成 LumenX 本地部署

第 1 步：克隆项目

git clone https://gitcode.com/gh_mirrors/lu/lumenx cd lumenx

第 2 步：创建配置文件并填入 API Key

cp .env.example .env

打开.env，只填一行即可：

DASHSCOPE_API_KEY=你的DashScope_API_Key

其余字段（OSS、Kling、Vidu、MuleRun 等）全部为可选项，保持注释状态。变量说明参考 .env.example。

第 3 步：一键启动

npm run dev

这一条命令会自动完成所有依赖安装：

• 自动创建 Python 虚拟环境.venv并安装 requirements.txt 中的后端依赖
• 自动执行前端npm install
• 同时拉起后端（端口17177）与前端（端口3008），并自动打开浏览器

自动化逻辑位于 scripts/dev-setup.js，无需你手动操作任何环境。

第 4 步：验证服务是否正常

浏览器打开后若看到 Studio 主界面，说明部署成功 ✅

第 5 步：应用内确认 Key 配置（双保险）

打开设置页（左上角 ⚙️），确认DASHSCOPE_API_KEY已生效并保存。应用内设置会写入~/.lumen-x/config.json，后续启动无需再改.env。

💡分开启动方式：如果希望前后端独立调试，可分别运行./start_backend.sh（见 start_backend.sh）与cd frontend && npm install && npm run dev。

🎬 10 分钟做出第一部 AI 漫剧

部署完成后，进入 Studio 新建项目，沿 5 步流水线走一遍即可：

① Script｜粘贴剧本，AI 自动提取实体

粘贴一段小说文本（40 字以上），点击提取实体，LLM 会自动识别角色、场景、道具，右侧生成实体识别面板：

② Art Direction｜定调全片美术风格

选择或自定义视觉风格（如 Cinematic Realism），保证全片画风统一。

③ Cast｜生成角色资产

为每个出场角色生成三视图/定妆照，AI 会参考角色描述保证跨镜头一致性。

④ Storyboard｜分镜图 + 视频批量生成

AI 依据剧本自动拆分镜头，为每个分镜生成画面，并可一键切换 I2V / R2V 模式批量生成视频，支持多候选"抽卡"：

⑤ Assembly｜时间线合成，导出成片

在合成时间线中为每个镜头挑选最佳版本，点击Merge & Proceed，FFmpeg 自动拼接，直接下载 MP4 成片：

到这里，你的第一部 AI 漫剧就完成了 🎉

❓ 常见问题速查

更多模型接入细节可参考 docs/2-model-catalog-design/ 与 API 说明 docs/1-api-reference/README.md。

下一步建议：先用 Playground 练手单图/单视频生成（零门槛），熟悉参数后再回到 Studio 走完整漫剧流水线——这是大多数创作者的最快上手路径。