交流 QQ 群：346340389 · 647306826 · 
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 接入 · bilibili · 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 # LinuxFeatures
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文件放进技能目录，下次对话自动生效；目录内一键「生成示例模板」 - 机制 — 技能清单以
特色功能：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不再做词法护栏（可使用完整 Python / bpy 能力）；写入仍由 Ask / Plan 在请求级收窄。截图走一次性临时文件，画面只随 MCP 响应回给多模态客户端，不落工程也不进审计日志
完整能力
- 本地工程 — 新建 / 打开 / 最近列表，JSON + 媒体目录落盘，数据不出本机
- 资产库 — 图片 / 视频 / 声音 / 3D 模型；AssetRef GUID；
.aipackage导入导出；多选文件 / 多选目录拖拽到其它目录（磁盘搬移 + descendant asset.relativePath 写回 + 成环检测 + 同名追加 " 2" / " 3"） - 分镜与画布 — 镜头参数、Fabric 构图、可停靠布局
- 一键工作流 — 预设模板（短剧分镜、游戏UI界面、游戏买量、产品广告、电商带货、游戏3D资产、漫画出版、知识口播、3D白模预演等）或 AI 规划拓扑，一键创建可复用宿主资产（边界 I/O + Dive 内图）
- 节点图生成 — 文本 / 图片 / 视频 / 声音 / 3D 模型 / 决策节点，指令面板与模型参数；生成锁定、图库双输出口；端口类型必须相同（单数不能进复数，选取节点只收列表口）；连线样式 / 小地图；任务队列复用共同上游、任务容错模式（节点失败降级不整链中断）；漫画页（分镜格 + 台词气泡，导出透明 PNG）、广告变体矩阵、2D 帧动画与帧动画序列图、图层分离（拆层后可导出 PSD）
- 人像处理（节点） — 像素蛋糕式精修节点
image.portrait（图片精修分组），双击节点卡片进入 dive 编辑器：顶部 16 组工具（修复 / 磨皮 / 肤色 / 五官 / 眼睛 / 妆容 / 身形 / 光影 / 调色 / 质感 / 区域 / 背景 / 证件照 / AI 增强 / 预设 / 导出），档位是关闭 / 轻 / 标准 / 强 / 极强五档分段按钮，妆面 / 滤镜 / 背景处理 / 证件照规格等走具名选项；编辑器内实时提示词预览（发给模型的原话，可复制）、原图对比（按住 / 可拖中缝的分割对比）、滚轮缩放、Shift+滚轮或[]旋转视角、空格 / 中键拖拽平移（双击空白复位）与撤销重做。执行只有一条路径：参数合成提示词 → 调用你选的图片模型出图（本地不做像素滤镜），证件照再按规格精确裁切 / 5 寸相纸拼版；上游接多张图时按同一套参数逐张批量出图（上限 24 张），人脸关键点按源图指纹缓存复用，缺依赖的工具组置灰并在悬停提示与参数面板里说明差什么（7 组需要人脸关键点、背景需要实例分割、身形需要姿态模型）。「只处理对应部位」默认开启：模型整图出图后按「脸（含颈）/ 人物 / 手动区域框」的羽化蒙版贴回原图，未请求部位保持原图像素不变；换背景、证件照与调色属整图语义会自动按整图处理，缺关键点或分割模型时对应部分退回整图并在运行日志说明。检查器提供统一「输出预览」（缩略图 / 全屏 / 存资产库 / 多版本点选）；编辑器里的 AI 增强（智能消除 / 换背景 / 妆容增强 / 超分）直接调图片模型，结果作为版本存回节点可回滚，下次进面板默认显示当前输出那张图 - 宿主资产 — 外层暴露边界口，内图可 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（聚合网关：文本 / 图片 / 视频）、NewAPI（自建中转网关：文本 / 图片，按网关端点元数据自动区分）、Meshy / Tripo / Rodin（Hyper3D） / Luma AI / Lux3D（3D 模型生成，文生 3D / 图生 3D）、自定义提供商（自选 OpenAI 兼容 / Anthropic / Gemini 端点类型，填 Base URL 与 API Key 接 one-api 等中转网关；文本 + 图片，见 NewAPI 教程）
- 3D 模型蒙皮与骨骼 — 生成节点只出几何 GLB（6.4.1 起不再内联「生成骨骼」），蒙皮改为图节点 3D 骨骼蒙皮 调用云端 Rigging API：Meshy
POST /openapi/v1/rigging、TripoPOST /v3/animations/rig（可选骨架命名 Mixamo / Tripo 与输出 GLB / FBX）；Luma AI / Lux3D 不支持蒙皮，卡片里不会出现 - 3D 模型加工（节点） — 加上蒙皮共 8 个加工节点：绑骨检查（免费，给
riggable+ 推荐骨架类型）、动画重定向（Tripo 预设preset:walk/ Meshy 动作库action_id，面板内可直接拉动作库）、模型拆分（网格分割 / 智能分割，拆完列出部件名）、部件补全、重拓扑（Tripo 智能 / 基础档、Meshy remesh）、贴图（含 Meshy retexture）、格式转换（GLTF / FBX / USDZ / OBJ / STL / 3MF，可带 FBX 预设、pivot 归底、UV 打包、四边面、按部件子集导出）。能力按供应商矩阵过滤 UI：Tripo 支持 8 项、Meshy 支持 5 项，卡片下拉只列能做该动作的供应商，Inspector 按能力位隐藏对面不识的参数；部件补全只吃拆件任务 id、动画重定向只吃绑骨任务 id，task id 属于别家时自动退回「上传模型换公网 URL」 - 联网搜索 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 | 文本 / 图片 / 视频 / 决策（聚合目录，决策走 Decisions API） | | 模型 | 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） | | 模型 | NewAPI | 文本 / 图片（自建中转网关，填网关地址与令牌；按端点元数据自动区分，见 NewAPI 教程） | | 模型 | 自定义 | 文本 / 图片（自选端点类型：OpenAI 兼容 / Anthropic / Gemini，填 Base URL 与 API Key，见 NewAPI 教程） | | 模型 | Lux3D | 文生 3D / 图生 3D（含多图生 3D，G1 / G1-Turbo，API Key） | | 对象存储 | 火山 TOS / 阿里云 OSS / 腾讯云 COS | 参考媒体上传与签名 URL；设置中互斥启用 |
配置入口：设置 → 模型 / 设置 → 对象存储。本机 ComfyUI 需先装 comfy-api-proxy（默认 8189），不要直连 8188。
Quick Start
用安装包
- 从 Releases 下载对应平台包
- 安装启动 → 新建工程
- 设置里添加模型提供商并填写密钥；可选配置对象存储
- 顶栏「一键工作流」快速出宿主资产，或在分镜 / 节点图中手搭链路
- 点左侧窄栏「◈」打开 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.jsnpm run typecheck && npm test # 检查
npm run pack # 未封装目录，便于自测npm run dev 走 scripts/dev-launcher.mjs，它在启动前处理两类会让窗口永不出现的问题（需要原始行为时用 npm run dev:raw）：
- 清掉继承来的
ELECTRON_RUN_AS_NODE：本应用自带的终端 / dsh 运行时会设这个变量，继承下来会让 Electron 以「纯 Node」模式执行主进程，表现为打印完start electron app...就回到命令行并报Cannot read properties of undefined (reading 'isPackaged')。 - 修工作区的低完整性级别标签：工作区被打上
Mandatory Label\Low（常见于强沙箱的 agent 宿主）时，该标签 ACE 带(OI)(CI)可继承标志，工作区内新建文件都会继承「低完整性」；而低完整性的 Electron 无法建立 Chromium 沙箱，会在启动阶段以0x80000003中止，不执行任何 JS、不打印任何错误（electron.exe --version也一样）。启动器先修工作区根目录（Windows 会重新计算子对象的继承 ACE，整棵树一起刷新，因此不必/T递归），再单独确认 electron 解包目录。/setintegritylevel在没有标签时是空操作，所以普通机器上不会改动任何东西。
npm run fix:integrity # 重置工作区根目录（+ electron 解包目录）为中等完整性
npm run fix:integrity -- --check # 只查看当前标签，不做修改两者共用 scripts/lib/integrity-label.mjs / scripts/lib/repair-integrity.mjs，避免逻辑漂移。自动重置失败（权限不足）时会打印手动命令：
icacls "<工作区根目录或 electron 解包目录>" /setintegritylevel M /T /C
或者把 electron 解包目录放到工作区之外，再设 ELECTRON_OVERRIDE_DIST_PATH 指向它
文档
- 使用手册（源码
website/manual.html） - ComfyUI 教程 · NewAPI 教程 · MCP 接入
- 架构 · 节点图插件 · 文档目录
- 资产模型 · AssetRef · 素材包
- 路线图 · 变更记录
版本与更新
- 版本号以
package.json的version为准（SemVer），变更记录见CHANGELOG.md。 - 发版：先改
package.json与 CHANGELOG，提交后打 tag 并推送，例如：
git tag v5.0.0
git push origin v5.0.0CI 会校验 tag（去掉 v）与 package.json 一致，再构建并发布 GitHub Release（含 latest.yml 等更新元数据）。
- 客户端更新：安装包启动后会检查 Releases；也可在 设置 → 通用 → 关于与更新 中手动检查，下载完成后重启安装。开发模式（
npm run dev）不检查更新。
Contribute
欢迎 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 群：
346340389·647306826 - X：
- 邮箱：[email protected]
Stack
Electron · Vue 3 · Pinia · TypeScript · Cordis · Fabric.js · electron-vite · electron-builder
License
GPL-3.0 — 修改并再分发时，衍生作品需以相同协议开源。