Justin-sky/ai-art-engine

AI Art Engine

专业 AI 创作工具 · 短剧 · 广告 · 成片

本地工程与素材 · 分镜与节点图驱动生成 · 内置 MCP Server 可被 Claude Code 等 AI Agent 驱动
对接 OpenRouter · OpenAI · DeepSeek · 智谱 · Kimi · xAI · Google · vLLM · Ollama · LM Studio · 火山方舟 · 可灵 · MiniMax · 通义千问 · 魔塔 · ComfyUI · MagicRouter · Meshy · Tripo · Rodin（Hyper3D） · Luma AI · Lux3D · 自定义提供商（OpenAI 兼容 / Anthropic / Gemini 端点）
对象存储：火山 TOS · 阿里云 OSS · 腾讯云 COS

官网 ·
使用手册 ·
视频生成指南 ·
短视频教程 ·
ComfyUI 教程 · MCP 接入 ·
视频教程 ·
Download ·
GitHub ·
Gitee ·
交流 ·
Features ·
Quick Start ·
English

源码仓库

- GitHub（主仓库）：https://github.com/Justin-sky/ai-art-engine
- Gitee（国内镜像）：https://gitee.com/beijing_blue_whale_era_zhangjian/ai-art-engine

两个仓库的 main 分支保持同步；Release 与客户端自动更新仍以 GitHub 为准。

Download

| Platform    | Package                   | Get it                                                                                                                                                      |
| ----------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | .exe                    | GitHub Releases                                                                                     |
| macOS   | .dmg（x64 / arm64） | GitHub Releases：Intel 选 x64，Apple Silicon 选 arm64（仅 arm64 时 Intel Mac 会提示不支持） |
| Linux   | .AppImage               | GitHub Releases（chmod +x 后运行）                                                                |

推送 v* tag 可由 GitHub Actions 自动构建并发布多平台安装包。也可自行打包：

npm run dist:win    # Windows
npm run dist:mac    # macOS
npm run dist:linux  # Linux

Features

AIArtEngine 是面向短剧、广告与成片制作的专业 AI 创作工具：资产、分镜、节点图在同一桌面端完成，工程本地优先，模型调用走你自己的 API Key。

特色功能：AI 对话 + MCP

应用内聊天即可驱动全部生成与编排能力；Claude Code / Codex 等外部 AI Agent 也能直连操作你的工程。

- AI 对话面板 — 应用内 AI 助手（DeepSeek Harness 运行时）：在对话里 @ 引用工程资产、让 Agent 调用 MCP 工具直接干活——生成图片 / 视频 / 3D / 语音、编辑节点图、运行工作流并查状态；多会话历史、模型可选任意已配置文本模型
- MCP 工具服务 — 内置 MCP Server，Claude Code / Codex 等外部 AI Agent 可经 stdio 桥或 HTTP 直连操作你的工程（规划并落盘工作流、运行生成、读写资产与节点图）；token 跨重启持久复用、操作审计、并发闸门

特色功能：Skill 技能系统

技能是"职业手册"——告诉 Agent 怎么做（流程、规范、输出格式）；MCP 工具是"手脚"——真正动手执行。两者配合，对话才能"说到做到"。

- 内置创作技能 — 随对话自动就位，无需配置：分镜 / 动画（9 宫格分镜表、节拍拆解表、动态提示词表、4 宫格动态分镜表等）、导演审核、系统创作（剧本、图生提示词、图片 / 视频生成、声音、情绪、灯光、多角度、扩图、重绘、抠图、高清放大、界面图、界面拆分、世界提取、节拍拆分、节拍单元生成、策划案、肖像贴图、提示词优化、擦除）
- 自定义技能 — 设置 → 自定义技能：把符合 dsh SKILL.md 格式（frontmatter name / description + Markdown 正文）的 .md 文件放进技能目录，下次对话自动生效；目录内一键「生成示例模板」
- 机制 — 技能清单以  注入对话上下文，Agent 判断任务匹配时按需加载技能文件作为指令；内置技能由程序自动管理（快照 + 指纹去重），自定义技能不受影响。节点图节点也使用同一套技能定义节点行为

特色功能：Blender MCP Server（让 AI 直接操作 Blender）

本机 Blender 跑着，AI 就能在对话里搭场景、写材质、截图自查、导出 GLB —— 出站直连 addon，不需要 uv / Python / 子进程。
- 直接驱动 Blender — 9 个 MCP 工具覆盖「看清现状 → 写 bpy 建模 → 截图自查 → 导出 GLB」闭环：get_scene_info / get_world_state_snapshot / get_object_info 查场景与选中对象，execute_blender_code 在 Blender 进程内执行 Python（完整访问 bpy / bmesh / mathutils），get_viewport_screenshot 抓视口画面回给多模态客户端，export_scene 出 GLB / GLTF / FBX / OBJ / USD / STL（配 asset_import 一键入资产库），describe_node_type / bpy_api_lookup / get_addon_status 查节点端口、查 bpy API、查 addon 版本
- 双 addon 兼容 — 同时支持社区方案 blender-mcp 的 addon.py 与官方方案 Blender Lab「MCP Server」 扩展，在「设置 → MCP → Blender 工具集」里切换；两种后端下工具名、入参、输出结构完全一致，模型侧无感
- 零额外依赖 — 不装 uv、不起 Python 子进程、不改 Blender 配置：应用主动出站连 addon 的 localhost:9876 监听端口；安装包 / 仓库 / 容器环境开箱即用
- 应用内对话 + 外部 Agent 同源 — 工作区左侧 ◈ AI 对话面板（在聊天里说「用 Blender 把这几个 Cube 拼成底座，做完截张图」）与 Claude Code / Codex 等外部 Agent 走同一套 Blender 工具集；设置里关掉即整组从工具清单里消失，主工具集不受影响；面板的 Ask / Plan 模式同样约束 Blender 工具 —— 它不是绕过面板模式的侧门
- 安全护栏 — execute_blender_code 走词法护栏（拒绝 os / subprocess / 网络模块、open / __import__ 逃脱链、装饰器 / class / type() 造类等结构性写法；渲染 / 保存 / 导入导出等 bpy 操作符不受限）；截图走一次性临时文件、画面只随 MCP 响应回给多模态客户端，不落工程也不进审计日志

详细工具清单、协议细节与安全设计见 MCP 接入指南 / MCP 接入教程。

完整能力

- 本地工程 — 新建 / 打开 / 最近列表，JSON + 媒体目录落盘，数据不出本机
- 资产库 — 图片 / 视频 / 声音 / 3D 模型；AssetRef GUID；.aipackage 导入导出；多选文件 / 多选目录拖拽到其它目录（磁盘搬移 + descendant asset.relativePath 写回 + 成环检测 + 同名追加 " 2" / " 3"）
- 分镜与画布 — 镜头参数、Fabric 构图、可停靠布局
- 一键工作流 — 预设模板（短剧分镜、游戏UI界面、游戏买量、产品广告、电商带货、游戏3D资产、漫画出版、知识口播、3D白模预演等）或 AI 规划拓扑，一键创建可复用宿主资产（边界 I/O + Dive 内图）
- 节点图生成 — 文本 / 图片 / 视频 / 声音 / 3D 模型节点，指令面板与模型参数；生成锁定、图库双输出口；端口类型必须相同（单数不能进复数，选取节点只收列表口）；连线样式 / 小地图；任务队列复用共同上游、任务容错模式（节点失败降级不整链中断）；漫画页（分镜格 + 台词气泡，导出透明 PNG）、广告变体矩阵、媒体质检 / 返工（专用质检模型五维评分 → FAIL 自动注入原因重试）、2D 帧动画与帧动画序列图、图层分离（拆层后可导出 PSD）
- 宿主资产 — 外层暴露边界口，内图可 Dive；多汇点各建独立出口
- 导演台 — 3D 站位截图与动作录制（写入 Cache/Videos）；方形口 out-shots / out-actions；3D 模型输入端口，dive 自动实例化到舞台；全景图输入自动设为背景；AI 白模搭场景、20+ 种基础几何体、材质贴图覆盖（基础 / 法线贴图）、着色模式与线框模式
- 成片时间线 — 素材分组与上轨编排；画中画叠加（位置 / 尺寸 / 不透明度 / 音量）与视频轨转场；预览播选中 / 时间线整轨联播；导出成片
- 多模型提供商 — OpenRouter、OpenAI（GPT 文本 / gpt-image 图片）、DeepSeek（文本）、智谱（GLM 文本 / CogView 图片）、Kimi / 月之暗面（文本）、xAI / Grok（文本 / 图片 / 视频）、Google / Gemini（文本 / 图片 / 视频）、本地 vLLM（文本 / Wan 视频）、Ollama / LM Studio（文本，OpenAI 兼容，无需 API Key）、火山方舟（Seedream / Seedance / 声音）、可灵、MiniMax、通义千问（DashScope）、魔塔（ModelScope）、ComfyUI（API 2：图片 / 视频 / 声音，本机或云端 Base URL）、MagicRouter（聚合网关：文本 / 图片 / 视频）、Meshy / Tripo / Rodin（Hyper3D） / Luma AI / Lux3D（3D 模型生成，文生 3D / 图生 3D）、自定义提供商（自选 OpenAI 兼容 / Anthropic / Gemini 端点类型，填 Base URL 与 API Key 拉取文本模型）
- 3D 模型蒙皮与骨骼 — 3D 节点勾选「生成骨骼」后由上游骨骼蒙皮：Tripo 发 rig=true、Meshy 发 rigging=true + rig_type（humanoid 等） + pose、Rodin (Hyper3D) 发 rig=true + rig_type + rig_animation（multipart，部分 tier 需 rig=true 才出 rigged GLB）；Luma AI / Lux3D 不支持蒙皮，强行开启会被拒并给明确文案
- 联网搜索 provider（设置面板配置） — DeepSeek Search（默认）/ Tavily / Brave / SerpAPI / Mock 五种适配器并行可用，每个独立开关、Base URL、API Key、搜索深度与时间窗；面板自带连通性测试；与模型 provider 体系刻意分离（数量少、无上下文注入）
- HTTP 网络错诊断通用化 — axios 网络错 (err.code + err.cause.code / err.cause.message) 从 Kling 适配器抽到通用 readHttpError，覆盖全部 33 个 provider —— DNS / TCP / TLS 握手前 socket 被断等场景，UI 现在能直接看到 ECONNRESET / UND_ERR_SOCKET 这种稳定标签，便于一眼判断是防火墙断握手还是连接被拒
- 对象存储 — 火山引擎 TOS、阿里云 OSS、腾讯云 COS（同时仅可启用一个，用于参考视频等公网外链）
- 可扩展 — Editor Kernel + Cordis 内部扩展（窗口 / Inspector / 节点 / Skill / 执行器）+ 声明式外部插件清单

模型与对象存储一览

| 类型     | 提供商                             | 能力概要                                                                       |
| -------- | ---------------------------------- | ------------------------------------------------------------------------------ |
| 模型     | OpenRouter                         | 文本 / 图片 / 视频（聚合目录）                                                 |
| 模型     | OpenAI                             | 文本 / 图片（需可访问 api.openai.com 的网络与账号）                            |
| 模型     | DeepSeek                           | 文本（deepseek-chat / deepseek-reasoner）                                      |
| 模型     | 智谱                               | GLM 文本 / CogView 文生图                                                      |
| 模型     | Kimi（月之暗面）                   | 文本（kimi-k2 系列 / moonshot-v1 系列）                                        |
| 模型     | xAI（Grok）                        | 文本 / Grok Imagine 图片 / Grok Imagine Video（异步轮询）                      |
| 模型     | Google（Gemini）                   | 文本 / Nano Banana 图片 / Veo 3.1 视频（异步轮询，官方 OpenAI 兼容层）         |
| 模型     | vLLM                               | 本地文本 / 视频（Wan T2V / I2V，OpenAI 兼容，无需 API Key）                    |
| 模型     | Ollama / LM Studio                 | 本地文本（OpenAI 兼容，无需 API Key）                                          |
| 模型     | 火山方舟                           | 文本 / Seedream 图 / Seedance 视频 / 声音设计                                  |
| 模型     | 可灵                               | 图片 / 视频（API Key）                                                         |
| 模型     | MiniMax                            | 文本 / 图片 / 视频 / 音色设计                                                  |
| 模型     | 通义千问                           | 文本（兼容模式）/ 万相图 / 万相视频（含 HappyHorse 等）                        |
| 模型     | 魔塔                               | 文本 / 文生图（访问令牌）                                                      |
| 模型     | ComfyUI                            | 图片 / 视频 / 声音（API 2；本机 8189 或云端 Base URL）                         |
| 模型     | MagicRouter                        | 文本 / 图片 / 视频（OpenAI 兼容聚合网关，视频异步轮询）                        |
| 模型     | Meshy                              | 文生 3D / 图生 3D（含多图生 3D，API Key）                                      |
| 模型     | Tripo                              | 文生 3D / 图生 3D（API Key）                                                   |
| 模型     | Rodin（Hyper3D）                   | 文生 3D / 图生 3D（API Key）                                                   |
| 模型     | Luma AI                            | 文生 3D / 图生 3D（API Key）                                                   |
| 模型     | 自定义                             | 文本（自选端点类型：OpenAI 兼容 / Anthropic / Gemini，填 Base URL 与 API Key） |
| 模型     | Lux3D                              | 文生 3D / 图生 3D（含多图生 3D，G1 / G1-Turbo，API Key）                       |
| 对象存储 | 火山 TOS / 阿里云 OSS / 腾讯云 COS | 参考媒体上传与签名 URL；设置中互斥启用                                         |

配置入口：设置 → 模型 / 设置 → 对象存储。本机 ComfyUI 需先装 comfy-api-proxy（默认 8189），不要直连 8188。

快速开始

用安装包

1. 从 Releases 下载对应平台包
2. 安装启动 → 新建工程
3. 设置里添加模型提供商并填写密钥；可选配置对象存储
4. 顶栏「一键工作流」快速出宿主资产，或在分镜 / 节点图中手搭链路
5. 点左侧窄栏「◈」打开 AI 对话，@ 引用资产让助手直接生成；或按 MCP 接入教程 接入 Claude Code 等外部 Agent

完整操作说明见 使用手册（源码在 website/manual.html）。本机 ComfyUI 需先装 comfy-api-proxy（默认 8189），不要直连 8188。

从源码

GitHub
git clone https://github.com/Justin-sky/ai-art-engine.git

或使用 Gitee 国内镜像
git clone https://gitee.com/beijing_blue_whale_era_zhangjian/ai-art-engine.git

cd ai-art-engine
npm install
npm run dev

开发构建需要 Node.js 22+（运行时已内置 Node，用户无需安装）。Electron 下载失败时可：

set ELECTRON_MIRROR=https://cdn.npmmirror.com/binaries/electron/
node node_modules/electron/install.js

npm run typecheck && npm test   # 检查
npm run pack                    # 未封装目录，便于自测

文档

- 使用手册（源码 website/manual.html）
- 架构 · 节点图插件 · 文档目录
- 资产模型 · AssetRef · 素材包
- 路线图 · 变更记录

版本与更新

- 版本号以 package.json 的 version 为准（SemVer），变更记录见 CHANGELOG.md。
- 发版：先改 package.json 与 CHANGELOG，提交后打 tag 并推送，例如：

git tag v5.0.0
git push origin v5.0.0

CI 会校验 tag（去掉 v）与 package.json 一致，再构建并发布 GitHub Release（含 latest.yml 等更新元数据）。

- 客户端更新：安装包启动后会检查 Releases；也可在 设置 → 通用 → 关于与更新 中手动检查，下载完成后重启安装。开发模式（npm run dev）不检查更新。

贡献

欢迎 Issue 与 Pull Request。提交前建议：

npm run typecheck && npm test
讨论与缺陷跟踪可使用 GitHub Issues 或
Gitee Issues。

交流

- 官网：GitHub Pages · 阿里云 OSS（见 npm run site:deploy）
- 视频教程：Bilibili 空间
- 国内镜像：阿里云 OSS 静态托管（自定义域名 / publicBaseUrl）
- GitHub：Justin-sky/ai-art-engine
- Gitee：beijing_blue_whale_era_zhangjian/ai-art-engine
- QQ 群：647306826（扫码入群）

- 邮箱：284139554@qq.com

技术栈

Electron · Vue 3 · Pinia · TypeScript · Cordis · Fabric.js · electron-vite · electron-builder

许可证

GPL-3.0 — 修改并再分发时，衍生作品需以相同协议开源。

如果这个项目对你有帮助，请点一颗 ⭐ Star