# cmui

**Repository Path**: rymaker/cmui

## Basic Information

- **Project Name**: cmui
- **Description**: cmui前台客户端项目
- **Primary Language**: JavaScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-20
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Studio

一个基于 Nuxt 3 构建的 AI 工具集合平台，集成多种 AI 能力，包括视频生成、视频转文字、图像处理等功能。

## 功能特性

### 视频生成
- **PPIO 视频生成** - 支持 Wan 2.1/2.5/2.6 多种模型
  - 文生视频：根据文字描述生成视频
  - 图生视频：基于图片生成动态视频
- **硅基流动** - Wan 2.2 AI 视频引擎

### 视频转文字
- 智能语音识别（基于 Whisper）
- 自动生成文字转录
- 一键生成思维导图

### 图像处理
- 清程极智 AI 生图（阿里云百炼）
- 支持文生图、图生图
- 智能图片识别与处理

### 系统功能
- JWT 用户认证
- MinIO 文件存储
- 响应式 UI 设计

## 技术栈

| 类别 | 技术 |
|------|------|
| 前端框架 | Nuxt 3 + Vue 3 |
| 状态管理 | Pinia + pinia-plugin-persistedstate |
| 样式 | SCSS |
| 后端 | Nuxt Server API (Nitro) |
| 数据库 | MySQL 8 + TypeORM |
| 文件存储 | MinIO |
| AI 集成 | LangChain、OpenAI API、阿里云百炼 |
| 部署 | PM2 |

## 环境要求

- Node.js >= 18.x
- Yarn 1.22+
- MySQL 8.x
- MinIO Server

## 快速开始

### 1. 安装依赖

```bash
yarn install
```

### 2. 配置环境变量

复制环境变量模板并修改配置：

```bash
cp .env.example .env
```

主要配置项：

```env
# 服务端口
PORT=8080
HOST=0.0.0.0

# 外部服务
TTS_SERVICE_URL="http://your-tts-service"
COMFYUI_API_URL="http://your-comfyui-api"

# LLM 服务
LLM_API_KEY="your-api-key"
LLM_API_URL="https://api.example.com/v1/chat/completions"

# MinIO 配置
MINIO_ENDPOINT="your-minio-host"
MINIO_PORT=9000
MINIO_USE_SSL=false
MINIO_ACCESS_KEY=your-access-key
MINIO_SECRET_KEY=your-secret-key
MINIO_BUCKET=your-bucket

# MySQL 配置
DB_HOST=127.0.0.1
DB_PORT=3306
DB_USER=your-user
DB_PASSWORD=your-password
DB_NAME=your-database

# JWT 密钥
AUTH_JWT_SECRET="your-jwt-secret"

# AI 服务 API Keys
QINGCHENG_API_KEY="your-qingcheng-key"
SLICONFLOW_API_KEY="your-siliconflow-key"
PPIO_API_KEY="your-ppio-key"
```

### 3. 启动开发服务器

```bash
yarn dev
```

访问 http://localhost:8080

## 构建部署

### 构建生产版本

```bash
yarn build
```

### 使用 PM2 部署

```bash
# 设置环境文件
export PM2_ENV_FILE=.env.production

# 启动服务
pm2 start ecosystem.config.cjs

# 查看状态
pm2 status

# 查看日志
pm2 logs aiStudio
```

## 项目结构

```
├── assets/              # 静态资源 (SCSS)
├── components/          # Vue 组件
├── composables/         # 组合式函数
├── middleware/          # 路由中间件
├── pages/               # 页面路由
│   ├── home/            # 首页
│   ├── login.vue        # 登录页
│   ├── ppio/            # PPIO 视频生成
│   ├── qingcheng-ai/    # 清程极智 AI
│   ├── siliconflow/     # 硅基流动
│   ├── video-to-text/   # 视频转文字
│   └── image-tools/     # 图片处理
├── plugins/             # Nuxt 插件
├── public/              # 公共静态文件
├── server/              # 服务端代码
│   ├── api/             # API 接口
│   ├── db/              # 数据库配置
│   └── utils/           # 工具函数
├── stores/              # Pinia 状态管理
├── utils/               # 通用工具函数
├── app.vue              # 根组件
├── nuxt.config.ts       # Nuxt 配置
└── ecosystem.config.cjs # PM2 配置
```

## 脚本命令

| 命令 | 说明 |
|------|------|
| `yarn dev` | 启动开发服务器 |
| `yarn build` | 构建生产版本 |
| `yarn preview` | 预览生产构建 |
| `yarn generate` | 静态站点生成 |

## License

本项目基于 [AGPL-3.0](LICENSE) 许可证开源。