# NOVAI

**Repository Path**: invaders/novai

## Basic Information

- **Project Name**: NOVAI
- **Description**: NOVAI 是一款面向创作者的全能 AI 工作台。你可以在无限画布上拖拽、连线、组合各种 AI 能力——文生图、图生图、AI 视频生成、GPT 多模态对话——所有操作在一个界面中无缝衔接。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 31
- **Forks**: 7
- **Created**: 2026-07-10
- **Last Updated**: 2026-08-21

## Categories & Tags

**Categories**: ai

**Tags**: None

## README

# NOVAI — 无限画布 AI 创作平台

> 自由地在无限画布上生成图像、视频，用节点串联工作流。内置 ModelScope 免费 API，开箱即用。
>
> **[English](README.en.md) · [官网](https://invaders-2.github.io/NOVAI/) · [帮助文档](https://invaders-2.github.io/NOVAI/docs.html)**

NOVAI 是一款面向创作者的全能 AI 工作台。你可以在**无限画布**上拖拽、连线、组合各种 AI 能力——文生图、图生图、AI 视频生成、GPT 多模态对话——所有操作在一个界面中无缝衔接。搭配 **Photoshop 面板**和 **Chrome 扩展**，素材采集与创作流程一气呵成。

![首页](static/images/screenshots/home.png)

![无限画布](static/images/screenshots/canvas.png)

![AI 生图](static/images/screenshots/generate.png)

![API 设置](static/images/screenshots/settings.png)

![资产管理](static/images/screenshots/assets.png)

---

## 快速开始

### 下载安装（推荐）

无需安装 Python、无需配置环境，下载安装包双击即用。

#### Windows

1. 下载 `NOVAI-Setup.exe` 安装包
2. 双击安装，按引导完成（桌面快捷方式自动创建）
3. 双击桌面「NOVAI」图标启动，浏览器自动打开 `http://127.0.0.1:3000/`

#### macOS

1. 下载 `NOVAI.dmg` 磁盘镜像
2. 打开 DMG，将 `NOVAI.app` 拖入 `Applications` 文件夹
3. 双击 `NOVAI.app` 启动，浏览器自动打开 `http://127.0.0.1:3000/`

> **首次启动提示**：macOS 可能提示「无法打开，因为它来自未识别的开发者」，请前往 **系统设置 → 隐私与安全性 → 点击「仍要打开」** 即可。

---

### 手动安装（开发者）

如果你希望从源码运行或参与开发：

```bash
# 克隆仓库
git clone https://github.com/invaders-2/NOVAI.git
cd NOVAI

# 安装依赖
pip install -r requirements.txt

# 启动服务
python main.py
```

浏览器访问 `http://127.0.0.1:3000/`

> 环境要求：Python 3.10+

---

## 常见问题

### Windows

| 问题 | 解决方法 |
|------|---------|
| **安装后打不开** | 检查防火墙是否拦截，尝试以管理员身份运行 |
| **端口 3000 被占用** | 关闭占用该端口的程序，或在启动前设置环境变量 `DEPLOY_RUN_PORT=3001` 修改端口 |
| **依赖安装失败** | 确保 Python 3.10+ 已安装且勾选了「Add Python to PATH」 |
| **杀毒软件误报** | 将 NOVAI 安装目录添加至杀毒软件信任白名单 |

### macOS

| 问题 | 解决方法 |
|------|---------|
| **「无法打开，因为它来自未识别的开发者」** | 前往 **系统设置 → 隐私与安全性** → 点击「仍要打开」 |
| **「已损坏，无法打开」** | 终端运行：`sudo xattr -rd com.apple.quarantine /Applications/NOVAI.app` |
| **端口 3000 被占用** | 终端运行 `lsof -i :3000` 查看占用进程，`kill <PID>` 结束它；或设置 `DEPLOY_RUN_PORT=3001` 修改端口 |
| **依赖问题（手动安装时）** | 确保已安装 Python 3.10+：`python3 --version`，再执行 `pip3 install -r requirements.txt` |

---

## AI 模型

内置 **ModelScope** 免费 API，开箱即用：

| 类型 | 模型 | 说明 |
|------|------|------|
| 对话 | Qwen3-235B | 通义千问旗舰，逻辑推理/写作 |
| 对话 | Qwen3-VL-235B | 多模态，可分析图片 |
| 生图 | Qwen-Image-2512 | 中文文字渲染最优，海报 Banner 首选 |
| 生图 | FLUX.2-klein-9B | 画面质感最好 |
| 生图 | Z-Image-Turbo | 1-2 秒快速出图 |
| 生图 | Qwen-Image-Edit-2511 | 说话就能改图 |
| 视频 | agnes-video-v2.0 | 免费视频生成 |

---

## 特色功能

- 🎨 **无限画布** — 自由缩放、拖拽、连线创作
- ⚡ **节点工作流** — 图像/视频/LLM 节点串联
- 🤖 **生成自动落画布** — AI 生成结果自动创建节点，无需手动导入
- 💡 **快捷建议条** — 生成完成自动弹出「换衣服 / 换场景 / 加运镜」一键继续编辑
- 🔍 **@ 引用素材** — 输入框 @ 一下即可把画布节点作为参考素材
- ✂️ **本地高质量抠图** — RMBG-2.0 按需下载，离线免费抠图 + 边缘精修，失败可降级在线
- 👤 **人脸模糊** — 一键模糊视频中全部人脸，规避平台真人审核（YuNet 检测）
- 🔌 **插件系统** — Photoshop 面板、Chrome 扩展
- 🌐 **多仓库更新** — GitHub / Gitee / ModelScope 三源
- 🇨🇳 **中文优化** — Qwen 生态深度集成

---

## 人脸合规与换脸

NOVAI 的视频编辑基于火山引擎 Seedance 2.0。平台对**未经授权的真人肖像**有严格的内容安全审核，参考素材必须走以下三条合规通道之一：

| 通道 | 适用场景 | 说明 |
|------|---------|------|
| **A · 已授权真人素材** | 换特定真人（艺人 / 模特） | 方舟体验中心 → 真人人像 → 建资产组 → 真人扫码认证 → 拿 Asset ID → `asset://` 引用 |
| **B · 信任模型产物**（推荐） | AI 脸 + AI 视频 | Seedance 视频 / Seedream 图，同账号 30 天内直接可作参考，零门槛不拦截 |
| **C · 预置虚拟人像库** | 不需要指定真人 | 平台免费虚拟人像，零合规风险 |

**拦截规则**：网上下载的含人脸视频 / 自己拍摄的真人素材 / 其他平台生成的 AI 人脸——全部拦截。解决方案：
1. **目标脸**用 Seedream 5.0 lite 生成（30 天信任期）
2. **参考视频**里的人脸先用 NOVAI「人脸模糊」处理（智能画布 → 选中视频节点 → 工具栏「人脸模糊」）

**换脸提示词模板**：

```text
严格编辑 视频1：将 视频1 中人物的面部替换为 图片1 中的人脸，
面部细节参考 图片2（特写）。动作、走位、场景、运镜、光线
全部保持不变，只修改面部。新脸与原脸型、光影自然融合，
表情跟随原动作。保持无字幕，不要生成水印。
```

> 换衣服 / 换场景 / 换人物同理：把「面部替换为图片1中的人脸」换成对应对象，保持「全部保持不变，只修改…」句式。参考素材配置：`视频1`=动作骨架 · `图片1`=目标参考 · `图片2`=细节特写（可选）。

---

## 下载与更新

安装包及更新下载地址：

| 平台 | 地址 |
|------|------|
| GitHub | https://github.com/invaders-2/NOVAI |
| Gitee | https://gitee.com/invaders/novai |
| ModelScope | https://modelscope.cn/studios/bllack/NOVAI |

项目启动后会自动检查三个源的最新版本，推送更新通知，一键升级。

> **Gitee 安装包说明**：Gitee 免费版附件有 100MB 单文件限制，安装包已分卷上传（`.part00`/`.part01`），下载后需先合并再安装：
> - Windows（CMD）：`copy /b NOVAI-Setup-*.exe.part00 + NOVAI-Setup-*.exe.part01 NOVAI-Setup-*.exe`
> - macOS（终端）：`cat NOVAI-Setup-*.dmg.part00 NOVAI-Setup-*.dmg.part01 > NOVAI-Setup-*.dmg`
> - 或直接到 [GitHub Releases](https://github.com/invaders-2/NOVAI/releases) 下载免合并的完整安装包

---

## 桌面客户端（Electron 版 · 测试）

> 新技术路线：用 **Electron** 封装，自带 Chromium 渲染内核（跨平台行为一致，不再受系统 WebView 差异影响），支持 electron-updater 自动更新。

- 源码与构建说明见 **desktop/README.md**
- 桌面端通过 pywebview 兼容桥复用既有前端（window.pywebview.api），前端零改动获得原生对话框 / 窗口控制 / 托盘能力
- **与正式版数据完全互通**：共用 3000 端口和同一份数据目录（Windows `APPDATA/NOVAI`，macOS `~/NOVAI`），画布、配置、对话记录直接共享——**无需重新下载数据，直接安装即可**；正式版正在运行时打开 Electron 版会自动复用已运行的后端，不会双开端口踩踏数据
- **自动更新三仓库通道**：GitHub Releases 为主源；国内网络检查失败时自动切换 ModelScope 镜像（`bllack/NOVAI-releases`）；Gitee Release 提供人工下载兜底。云端构建流水线（push `v*` 标签触发）会自动把安装包同步到三个仓库

---

### v1.0.112-beta.1（测试版）

- **Electron 桌面客户端**：自带 Chromium 内核；与正式版共用 3000 端口 + 同一数据目录，数据完全互通；托盘 / 原生对话框 / 窗口控制
- **一键更新实时进度条**：下载/校验/备份/替换各阶段百分比 + 当前文件名实时可见，更新结果 Toast 轻提示
- **三仓库更新通道**：GitHub 为主，ModelScope 国内镜像自动切换，Gitee 人工下载兜底
- **桌面端侧边栏闪烁修复**：Chromium 下 hover 展开不再反复开关

### v1.0.111

- **本地高质量抠图**：图片节点新增「高质量抠图」——RMBG-2.0 本地模型按需下载（349MB，仅首次），下载后离线免费抠图；边缘精修（alpha 拉伸 + 腐蚀羽化 + 去背景色边）；本地失败可一键降级在线抠图
- **Windows 标题栏拖动修复**：无边框窗口顶部标题栏恢复可拖动移动窗口
- **旧模型自动清理**：升级后自动删除残留的 RMBG-1.4 旧模型，释放磁盘空间

### v1.0.108

- **端口修复**：恢复正式版端口 3000（误推测试版 3001 已纠正）
- **模型入库白名单**：assets/models/ 加入在线更新白名单，人脸检测模型随更新分发

### v1.0.107

- **人脸模糊工具**：选中视频节点 → 工具栏一键模糊全部人脸（YuNet 检测 + 高斯模糊），规避平台真人审核，结果自动入节点
- **视频播放交互修复**：播放 / 暂停 / 全屏 / 进度条全面修复，桌面端与浏览器行为一致（原生控制条）
- **参考素材公网化优化**：云上传（Litterbox / temp.sh）优先，不再依赖本地隧道

### v1.0.86

- **云端构建流水线**：Windows/Mac 云端打包流水线，自动构建发布
- **轮播图资源入库**：修复更新后轮播图失效问题
- **无边框窗口修复**：Win 无边框窗口拖动/边缘缩放/标题栏布局修复
- **Mac 签名优化**：dmg ad-hoc 签名防「已损坏」提示，修复签名被拷贝破坏
- **编码修复**：修复 Windows 云端构建中文编码问题

### v1.0.85

- **智能画布修复**：composer 定位、弹窗裁切、边栏偏移、标题栏布局等修复

### v1.0.84

- **画布列表增强**：卡片支持最多 4 张图片 2×2 网格预览
- **桌面端升级**：无边框窗口 + 系统托盘（关闭最小化到托盘）+ 局域网访问支持
- **桌面图标更新**：白底黑 logo 圆角设计
- **修复**：64 位 ctypes WndProc 指针截断崩溃、pystray 打包、端口占用等
- **仓库整理**：完善 .gitignore，排除设计稿/测试截图/备份文件

### v1.0.83

- **前端性能优化**：Lucide 图标子集化（体积减少 90%）、提取 NovaUtils/NovaMedia 共享模块、Marvis 风格 CSS 去重、修复定时器泄漏、页面隐藏时暂停 rAF 渲染、touch-mouse 布局缓存优化
- **模型选择弹窗重构**：左右两栏布局，悬停联动切换供应商，动态高度自适应屏幕空间
- **修复 GPT 聊天功能**：修复 TDZ 错误导致模型选择弹窗空白、无法选择供应商和模型
- **修复图标与提示问题**：修复多个页面 Lucide 图标不显示，修复素材库状态栏泄露英文错误信息
- **统一设置页面风格**：API 设置与工作流设置页面设计同步为 Marvis 风格，修复 CSS 语法错误
- **新增后端工具 API**：7 个 API 端点（存储管理、图片检测、分类 Prompt、模型规范化、RunningHub 钱包状态）
- **修复竞态问题**：sendChatMessage 防重入、setTimeout 递归轮询、node.running 过早清零