# Xino 模型中转平台

**Repository Path**: testing_xino/xino-model-transfer-platform

## Basic Information

- **Project Name**: Xino 模型中转平台
- **Description**: 一个多模型、多渠道路由的模型中转平台
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: https://ai.xinopay.xyz
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Xino Model Transfer Platform

一个多模型、多渠道路由的模型中转平台开源示例，包含：
- Go 后端网关与后台管理接口
- Vue 3 PC 用户端与管理后台
- UniApp H5 移动端

这个仓库是脱敏后的开源版：
- 不包含原私有仓库历史
- 不包含真实数据库、Redis、渠道密钥、短信、微信、支付配置
- 不包含生产部署脚本、日志和运行产物
- 所有公开地址与凭据均已替换为示例值

## 预览
### 用户前端预览 1
![Frontend preview 1](./assets/screenshots/chat-preview.png)

### 用户前端预览 2
![Frontend preview 2](./assets/screenshots/admin-preview.png)

### 后台管理预览 1
![Admin preview 1](./assets/screenshots/ScreenShot_2026-04-08_084010_170.png)

### 后台管理预览 2
![Admin preview 2](./assets/screenshots/ScreenShot_2026-04-08_084054_993.png)

## 核心能力
- 模型管理、分类管理、渠道管理
- 模型绑定渠道、分类绑定渠道、默认渠道回退
- 用户聊天、多轮会话、历史会话
- OpenAI 兼容接口：`/v1/models`、`/v1/chat/completions`
- 图片生成、音频转写、语音合成、视频生成接口扩展
- 计费、余额、赠送金、套餐额度
- API Token
- 微信公众号扫码关注登录
- H5 移动端模型浏览、聊天、钱包、个人中心

## 路由规则
渠道路由优先级：
1. 模型绑定渠道
2. 分类绑定渠道
3. 默认渠道

支持：
- 优先级排序
- 重试
- 熔断
- 健康探测
- 切换日志

## 试用规则
- 开启 `supports_trial` 的模型
- 每个用户、每个模型默认可免费成功调用 `3` 次
- 试用次数用完后，再进入套餐额度或余额计费逻辑

## 项目结构
- `backend`：Go 后端
- `backend/sql/init.sql`：数据库初始化脚本，仅包含结构，不包含任何数据
- `frontend`：Vue 3 PC 前端
- `mobile`：UniApp H5 移动端
- `assets/screenshots`：README 预览图

## 环境要求
- Go 1.22+
- Node.js 18+
- MySQL 8+
- Redis 6+

## 快速开始
### 1. 初始化数据库
导入：
- `backend/sql/init.sql`

### 2. 启动后端
复制配置示例：
- `backend/configs/config.example.yaml`

也可以直接通过环境变量提供：
- `MYSQL_HOST`
- `MYSQL_PORT`
- `MYSQL_USER`
- `MYSQL_PASSWORD`
- `MYSQL_DATABASE`
- `REDIS_ADDR`
- `REDIS_PASSWORD`
- `REDIS_DB`

启动命令：
```bash
cd backend
go run ./cmd/server
```

### 3. 启动 PC 前端
```bash
cd frontend
npm install
npm run dev
```

### 4. 构建移动端 H5
```bash
cd mobile
npm install
npm run build:h5
```

## 需要你自行补齐的生产配置
- MySQL / Redis
- 上游模型渠道与 API Key
- 短信服务商参数
- 微信公众号参数
- 支付参数
- 系统初始化配置数据

## 安全提示
如果你要基于这个仓库继续公开分发，请再次检查：
- 配置文件
- 环境变量
- API Key / Secret
- 微信 `AppSecret` / Token / AESKey
- 支付私钥
- 日志与构建产物

## 许可证
当前仓库未附带正式开源许可证。发布前请根据你的目标补充，例如：
- MIT
- Apache-2.0
- GPL-3.0