# vivo-AI-应用案例

**Repository Path**: codehubot/vivo-ai-application-cases

## Basic Information

- **Project Name**: vivo-AI-应用案例
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# vivo AI 应用能力教学案例

本项目用一个个独立可交互的小案例，演示 vivo 蓝心大模型 / AIGC 平台的常见应用能力，便于教学与对接参考。

- 前端：React 18 + TypeScript + Vite + Ant Design
- 后端：Go 1.24.2 + Gin + GORM + [`github.com/dingdinglz/vivo`](https://github.com/dingdinglz/vivo) SDK
- 数据库：MySQL 8（同时兼容阿里云 RDS）
- 部署：Docker Compose，仅对外暴露前端端口 `28318`

## 已覆盖的应用能力（一个能力 = 一个案例）

1. 蓝心大模型 70B 文本对话（含流式 SSE）
2. 蓝心多模态（图片理解）
3. AI 绘画（文生图）
4. 通用 OCR
5. 实时短语音识别
6. 方言自由说
7. 长语音听写
8. 长语音转写（异步任务，含进度轮询）
9. 同声传译（长语音听写 + 翻译 + TTS 组合）
10. 音频生成（TTS）
11. 声音复刻（创建音色 + 复刻发声）
12. 文本翻译
13. 文本向量
14. 文本相似度
15. 查询改写（RAG 场景）
16. 地理编码 / POI 搜索
17. Function Calling（工具调用）

## 快速开始

### 1. 准备 .env

```bash
cp .env.example .env
# 编辑 .env，至少修改 ADMIN_PASSWORD、JWT_SECRET、MYSQL_*
```

### 2. 启动

```bash
docker compose up -d --build
# 前端访问 http://<server-ip>:28318
# 管理后台 http://<server-ip>:28318/admin/login
```

### 3. 使用

1. 打开 `/settings`，输入 vivo 平台申请的 **AppID** 和 **AppKey**（仅保存在浏览器 `localStorage`，不会上传服务器持久化）
2. 回到首页，选择想体验的案例进入交互
3. 管理员可在 `/admin` 页面开关每个案例

## 切换到阿里云 RDS

将 `.env` 中 `DB_HOST` 改为 RDS 域名（如 `rm-xxx.mysql.rds.aliyuncs.com`），并在 `docker-compose.yml` 中注释 `mysql` 服务与对 `mysql` 的 `depends_on` 即可，无需改动后端代码。

## 本地开发

### Backend

```bash
cd backend
go env -w GOPROXY=https://goproxy.cn,direct
go mod tidy
go run .
```

### Frontend

```bash
cd frontend
npm config set registry https://registry.npmmirror.com
npm install
npm run dev
```

## 目录结构

```
.
├── docker-compose.yml
├── .env.example
├── backend/      # Go 后端
└── frontend/     # React 前端
```

## 网络环境（中国大陆）

- Go 模块代理：`GOPROXY=https://goproxy.cn,direct`（已写入 backend Dockerfile）
- npm 镜像：`https://registry.npmmirror.com`（已写入 frontend Dockerfile）
- alpine 软件源：`mirrors.aliyun.com`（已写入两端 Dockerfile）

## 安全说明

- AppID / AppKey 仅保存在浏览器 `localStorage`，每次请求通过 `X-Vivo-App-Id` / `X-Vivo-App-Key` Header 传给后端，后端不会落库
- 管理后台仅以单一密码作鉴权，**生产环境请务必修改 `ADMIN_PASSWORD` 与 `JWT_SECRET`**
- 仅前端 28318 暴露在外，backend / mysql 走 docker 内部网络