Skip to main content

安装部署

info

Web 模式、Window 模式和 Pet 模式共享同一个代码仓库和项目结构,开发者/用户只需要维护/配置一套代码即可支持所有模式的部署与使用。

tip

对于 Electron 应用,你可以从 Github Release 下载对应平台的安装包。

如果你想从源码构建应用,请按照以下步骤操作:

前置要求

  • Node.js 18.0 或更高版本 (可通过运行 node -v 检查版本)。建议使用 nvm 管理多个 Node.js 版本

克隆仓库并安装依赖

git clone [placeholder]
cd [placeholder]
npm install

项目结构

open-llm-vtuber-web/
├── resources/
├── src/
│ ├── main/
│ │ ├── index.ts
│ │ ├── menu-manager.ts
│ │ └── window-manager.ts
│ ├── preload/
│ │ ├── index.d.ts
│ │ └── index.ts
│ └── renderer/
│ ├── public/
│ └── src/
│ ├── assets/
│ ├── components/
│ │ ├── canvas/
│ │ ├── electron/
│ │ ├── footer/
│ │ └── sidebar/
│ │ └── setting/
│ ├── context/
│ ├── hooks/
│ │ ├── canvas/
│ │ ├── electron/
│ │ ├── footer/
│ │ └── sidebar/
│ │ └── setting/
│ ├── services/
│ ├── types/
│ ├── App.tsx
│ └── main.tsx
├── electron.vite.config.ts
└── package.json

开发模式 (可选, 通常用于开发者测试)

npm run dev
info

npm run dev 会同时启动 Electron 和 Web 模式 (默认在 5137 端口上)

根据目标平台/模式选择相应的构建命令:

npm run build:win
info

Electron 构建输出的文件将位于 dist 目录下。

Web 构建输出的文件将位于 src/renderer/dist 目录下。