AI-Playground

环境要求

• 搭载 Intel® Core™ Ultra（内置 Intel Arc GPU）、Intel Arc A/B 系列独立显卡（8GB+ 显存）或 NVIDIA RT
• 安装后端组件需要干净、无过滤的网络连接，公司 VPN/防火墙常导致失败
• 从源码构建需 Node.js ≥ 20（Ubuntu 24.04/Debian 建议用 NodeSource 装 Node 22 LTS）
• Windows 若提示缺少库，需先更新显卡驱动并安装 64 位 VC++ 运行库
• Linux 支持为实验性，仅支持 Ubuntu 24 或更高版本

安装与启动步骤

1. 1下载安装包

   从 GitHub Releases 下载 v3.2.0-beta-rc2 的 Windows 安装器或 Linux .deb 包，这是面向所有受支持硬件的单一安装包。

2. 2运行安装向导

   首次运行弹出 Set Up 向导，选硬件模式并安装 Llama.cpp、OpenVINO、ComfyUI 等后端组件，建议保持默认并全部启用。

3. 3确认 Arc GPU

   开始菜单搜索“设备管理器”，在“显示适配器”下确认 GPU 名称含 Intel Arc，否则不满足最低配置。

4. 4安装 Node.js

   从源码构建需 Node.js ≥ 20；Ubuntu 的 apt 自带 Node 18 太旧，改用 NodeSource 安装 Node 22 LTS。

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt install -y nodejs
   node --version
   npm --version

   复制

5. 5初始化 WebUI

   进入 WebUI 目录执行一次性 setup，安装 Node 依赖、拉取 uv/7-Zip 等外部资源并配置 Electron。

   cd WebUI
   npm run setup

   复制

6. 6构建安装包

   可选步骤。执行后安装包输出在 build/electron 目录，文件名包含版本号与提交短哈希。

   npm run build

   复制

7. 7构建 Linux 包

   可选，需先完成 Intel GPU（OMIX + Vulkan）主机设置；产物为 AppImage 与 .deb，位于 build/electron。

   cd WebUI
   npm install
   npm run fetch-external-resources
   npm run build:linux

   复制

关键配置

如何确认成功

首次启动出现 AI Playground 设置向导，后端组件安装完成后应用主界面能正常打开并看到版本号。

常见问题

注意事项

• 这是开源 beta 软件，可能存在组件与版本冲突。
• 安装期间请断开企业 VPN、关闭防火墙并保持系统不睡眠。
• 安装中断后可能残留临时文件，需清理后再重装。
• 若卡在 Llama.cpp 嵌入环节，可禁用杀毒软件并重启，必要时用 DDU 清理驱动缓存。