# ai-tools-website

**Repository Path**: mqinglang/ai-tools-website

## Basic Information

- **Project Name**: ai-tools-website
- **Description**: 常用工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-13
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Tools Website

一个面向商业化运营的在线工具站，包含图片处理、视频处理、AI 文本工具、开发工具、证件照制作、账户中心和积分体系。

## 页面预览

### 首页

![首页预览](docs/images/readme-home.png)

### 使用帮助

![使用帮助预览](docs/images/readme-help.png)

### 工具登录拦截

![工具登录拦截预览](docs/images/readme-ai-login.png)

## 功能概览

- 图片工具：格式转换、压缩、裁剪、滤镜
- 视频工具：格式转换、压缩、转 GIF、裁剪
- AI 工具：标题生成、文案生成、文字润色
- 证件照：服务端人脸预检、抠图、换背景、换尺寸
- 开发工具：JSON、Base64、URL、二维码、时间戳、常用网站
- 账户体系：注册登录、头像、积分、账单、任务记录

## 运行环境

建议使用以下环境：

- Node.js 22
- npm 10+
- Docker 与 Docker Compose
- Python 3.10+

## 本地运行

### 1. 下载代码

```bash
git clone git@gitee.com:mqinglang/ai-tools-website.git
cd ai-tools-website
```

### 2. 安装 Node 依赖

```bash
npm install
```

### 3. 配置环境变量

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

默认 `.env` 已按本地 `standard` 模式准备好。  
如果要启用 AI 工具，请补充：

```env
MINIMAX_API_KEY=你的密钥
```

### 4. 安装证件照功能的 Python 依赖

```bash
python3 -m venv .venv
.venv/bin/pip install --upgrade pip
.venv/bin/pip install -r requirements-photo-id.txt
```

### 5. 启动 PostgreSQL 和 Redis

```bash
docker compose up -d postgres redis
```

### 6. 启动后端

```bash
npm run server
```

### 7. 启动前端

另开一个终端：

```bash
npm run dev -- --host 0.0.0.0
```

### 8. 访问项目

- 前端：`http://localhost:5173`
- 健康检查：`http://127.0.0.1:8787/api/health`

健康检查预期：

```json
{
  "status": "ok",
  "mode": "standard"
}
```

## Docker 运行

如果你希望更接近生产环境，可以直接启动整套容器：

```bash
docker compose up --build -d
```

启动后访问：

- 前端：`http://localhost:5173`
- 后端：`http://localhost:8787`
- 健康检查：`http://127.0.0.1:8787/api/health`

健康检查预期：

```json
{
  "status": "ok",
  "mode": "production"
}
```

查看日志：

```bash
docker compose logs -f api
docker compose logs -f worker
docker compose logs -f frontend
```

## 推荐测试顺序

1. 先按“本地运行”完成启动
2. 验证登录、账户中心、证件照、视频任务
3. 再执行 `docker compose up --build -d`
4. 按 Docker 方式复测主要功能

## 常用命令

```bash
npm run dev
npm run build
npm run server
npm run worker
docker compose up -d postgres redis
docker compose up --build -d
```

## 相关文档

- [测试文档](docs/测试文档.md)
- [本地测试环境说明](docs/本地测试环境说明.md)
- [生产架构方案](docs/生产架构方案.md)
- [上线前缺口清单](docs/上线前缺口清单.md)
- [支付系统生产化方案](docs/支付系统生产化方案.md)