漫影工作室 · MYStudio

本地优先的 AI 漫剧与短剧制作工作台

从小说到成片，把剧本、分镜、素材、配音和剪辑放进同一条可追踪的工作流。

文档中心 · English · 商业授权

---

项目介绍

漫影工作室是一个面向 AI 漫剧、短剧和小说影视化创作的桌面生产工具，目标是把长文本改编、剧本整理、角色与场景资产、分镜生产、视频候选生成、本地剪辑合成和项目配置管理放在同一个可追踪的工作流中。

项目强调本地优先和创作过程可控：素材、项目数据和生成记录优先保存在用户本机；AI 生成结果以草稿、候选和可编辑数据的形式进入项目，而不是直接覆盖正式内容；本地视频合成通过 FFmpeg 完成，便于在桌面端快速生成可预览、可复查、可继续编辑的片段和成片。

核心定位

• 面向小说改编、AI 漫剧、短剧分镜和本地成片的统一工作台。
• 用结构化工作流承接从文本到视频的完整生产过程。
• 用项目级存储管理原文、剧本、分镜、素材、候选视频和配置。
• 用本地 FFmpeg 支撑图片/视频素材转候选片段和整集拼接。
• 用配置中心管理模型、供应商能力和不同任务的模型绑定。

生产链路

项目的核心链路是：

风格与导演 -> 小说导入 -> 逐章剧本 -> 剧本资产 -> 塑角造景/导演计划 -> 分镜计划/配音 -> 剪辑导出

这条链路适合分阶段推进：可以只做剧本和分镜，也可以继续绑定素材、生成候选片段，再通过本地合成得到完整视频。每个阶段都保留人工修订入口，便于在 AI 生成质量不稳定时继续保持创作者控制权。

架构特征

• 桌面端应用：基于 Electron 运行，适合管理本地素材、调用本机能力和输出文件。
• 前端工作台：使用 React 和 TypeScript 构建交互界面。
• 状态管理：使用 Zustand 管理项目工作流、素材、分镜、候选和配置状态。
• 文件型存储：面向个人创作项目，减少数据库部署和后端维护成本。
• 本地合成：Electron 主进程调用 FFmpeg，处理候选片段渲染、字幕烧录和拼接输出。

设计目标

• 让小说、剧本、分镜、素材和视频候选之间有清晰的引用关系。
• 让 AI 输出可审查、可回退、可替换，而不是一次性黑盒生成。
• 让短剧生产需要的角色、场景、音色、字幕和镜头状态逐步结构化。
• 让普通用户可以按工作流顺序完成成片，高级用户可以进入更细的分镜、剪辑和配置环节。
• 让后续扩展到 TTS、字幕样式、多轨导出、Agent/Skill 编排时，不破坏当前项目数据。

内置艺术风格

内置 60 种美术风格，覆盖 2D 动画、3D 渲染、定格动画和真人影像，分镜生产时一键套用。

2D自然手绘动画

水墨国风修仙

定格动画黏土

真人复古武侠

👉 查看全部 60 种艺术风格 →

当前入口

进入项目后打开左侧 工作流：

1. 小说导入 导入 .txt/.md 或粘贴正文。
2. 逐章剧本 按章节生成故事骨架、改编策略、剧本草稿和审核报告。
3. 剧本资产 从剧本提取角色、场景和道具，并与资产库匹配。
4. 塑角造景 运行导演计划，补齐角色、场景、道具图片。
5. 分镜配音 生成分镜计划，维护时长、对白、画面素材和角色音色。
6. 剪辑导出 用本地 FFmpeg 生成候选片段，选择后拼接成片。

更多操作文档见 文档中心。本地 TTS 与 Python 配置见 Python 与本地 TTS 配置，角色音色绑定见 资产库音色分配，开发入口见 开发者架构与代码入口，问题排查见 常见故障排查。

许可证

本项目采用双重许可模式：

• 社区版默认使用 GNU Affero General Public License v3.0（AGPL-3.0）发布。
• 如果你修改、分发本项目，或基于本项目向网络用户提供服务，需要遵守 AGPL-3.0 的源代码开放、版权声明保留等要求。
• 如果你希望将本项目集成到闭源商业产品、闭源 SaaS 服务或不公开修改内容的商业场景中，需要获取商业许可。

商业授权、闭源使用和企业支持说明见 COMMERCIAL_LICENSE.md。

最低系统要求

本项目的 AI 能力（TTS 声音克隆、语音识别、图像/视频生成等）依赖本地模型推理，必须配备独立显卡（GPU），集成显卡无法满足算力需求。

macOS（Apple Silicon）

项目	最低要求	推荐配置
芯片	Apple Silicon M1（自带 GPU）	M2 Pro / M3 及以上
系统	macOS 13 Ventura	macOS 14 Sonoma+
统一内存	16 GB	32 GB+
磁盘	20 GB 可用空间	50 GB+ SSD

⚠️ 不支持 Intel 芯片的 Mac（无 MLX GPU 加速）。

Windows

项目	最低要求	推荐配置
系统	Windows 10 64 位	Windows 11
显卡	NVIDIA 独立显卡，8 GB 显存（支持 CUDA）	NVIDIA RTX 系列，16 GB+ 显存
内存	16 GB	32 GB+
磁盘	20 GB 可用空间	50 GB+ SSD

⚠️ 必须 NVIDIA 独立显卡。集成显卡（Intel UHD / AMD 核显）和无 CUDA 的显卡无法运行本地 AI 推理。

通用

• Node.js >= 18（推荐 LTS 最新版）
• Python 3.12（首次使用本地 TTS 前，在设置里手动配置到用户数据目录）

开发环境配置

前置要求

• Node.js >= 18
• macOS (Apple Silicon) / Windows 10+ (NVIDIA GPU) / Linux x86_64

一键配置

macOS / Linux：

git clone https://github.com/xinzhuzi/MYStudio.git
cd MYStudio
bash apps/build/packaging/setup.sh

Windows（PowerShell）：

git clone https://github.com/xinzhuzi/MYStudio.git
cd MYStudio
powershell -ExecutionPolicy Bypass -File apps\build\setup-win.ps1

脚本会自动：

1. 安装 Node.js 依赖
2. 保持 Python runtime 延迟安装，不写入后端源码目录
3. 首次使用本地 TTS 前，在应用设置 > Python 配置中点击“开始配置”

启动

cd apps && npm run dev

打包

# macOS
cd apps && npm run build:mac
# Windows
cd apps && npm run build:win

桌面打包必须从 apps/ 执行。npm run build:mac 会经由 build-mac.sh 完成固定 bundle 校验、构建、覆盖安装、installed smoke 和关闭应用；正常打包不会每次重新 bundle。Remotion 版本或 composition 变化后，先执行 cd apps && npm run remotion:bundle 和 cd apps && npm run remotion:versions，再运行目标打包命令。完整流程见 打包、安装与 Smoke 测试。