# ai detection

**Repository Path**: leng-wya/ai-detection

## Basic Information

- **Project Name**: ai detection
- **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-07-14
- **Last Updated**: 2026-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 源鉴 (SourceGuard)

> 多模态AIGC内容核验与风险预警系统

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-green.svg)](https://fastapi.tiangolo.com/)
[![Flutter](https://img.shields.io/badge/Flutter-3.38+-blue.svg)](https://flutter.dev/)

## 项目简介

源鉴是一个基于深度学习的多模态AIGC内容检测系统，主要功能包括：

- 🔍 **AI生成内容检测** - 识别文本和图像是否由AI生成
- 🛡️ **篡改检测** - 检测图像是否经过编辑或篡改
- 📊 **风险评估** - 提供详细的风险分析报告
- 🔄 **实时处理** - 异步任务处理和实时状态推送
- 📱 **移动端优先** - 原生Android应用体验

## 系统架构

```
源鉴系统
├── backend-api/          # FastAPI 后端服务
│   ├── 用户认证
│   ├── 任务管理
│   ├── 异步处理
│   └── 报告生成
├── flutter-app/          # Flutter 移动应用
│   ├── 任务提交
│   ├── 实时跟踪
│   └── 报告查看
├── web-admin/            # Vue 管理后台
│   ├── 用户管理
│   ├── 人工复核
│   └── 系统监控
└── detector/             # AI检测模型
    ├── 来源分类
    ├── 篡改检测
    └── 风险评估
```

## 技术栈

### 后端 (FastAPI)
- **框架**: FastAPI 0.115+
- **数据库**: MySQL 8.0 + SQLAlchemy 2.x
- **缓存**: Redis (Microsoft Garnet)
- **对象存储**: MinIO
- **任务队列**: Huey
- **认证**: JWT + Argon2id
- **实时推送**: Server-Sent Events

### 移动端 (Flutter)
- **框架**: Flutter 3.38+
- **状态管理**: Riverpod
- **路由**: go_router
- **网络**: Dio
- **本地存储**: Drift + Secure Storage

### 管理端 (Vue)
- **框架**: Vue 3 + Vite
- **UI库**: Ant Design Vue (Vben Admin)
- **状态管理**: Pinia
- **路由**: Vue Router

### AI模型
- **框架**: PyTorch
- **检测模型**: 多任务图像取证
- **OCR**: PaddleOCR
- **大模型**: 千问系列

## 快速开始

### 环境要求

- Python 3.11+
- Node.js 22+
- Flutter 3.38+
- MySQL 8.0+
- Redis/Garnet
- MinIO

### 1. 克隆项目

```bash
git clone https://gitee.com/leng-wya/ai-detection.git
cd ai-detection
```

### 2. 后端服务

```bash
cd backend-api

# 安装依赖
conda env create -f ../configs/conda-env.yml
conda activate sourceguard-api

# 配置环境变量
cp .env.example .env
# 编辑 .env 配置数据库等信息

# 初始化数据库
.\init-db.bat

# 启动服务
.\start-dev.bat

# 启动Worker (新终端)
.\start-worker.bat
```

访问 http://localhost:8000/docs 查看API文档

### 3. 移动应用

```bash
cd flutter-app

# 安装依赖
flutter pub get

# 运行应用 (需要Android设备或模拟器)
flutter run
```

### 4. 管理后台

```bash
cd web-admin

# 安装依赖
corepack pnpm install

# 启动开发服务器
corepack pnpm dev
```

访问 http://localhost:5173

## 项目结构

```
ai-detection/
├── backend-api/              # 后端API服务
│   ├── src/sourceguard_api/  # 源代码
│   │   ├── api/              # API路由
│   │   ├── core/             # 核心功能
│   │   ├── models/           # 数据模型
│   │   ├── schemas/          # Pydantic schemas
│   │   ├── services/         # 业务逻辑
│   │   └── tasks/            # 异步任务
│   ├── alembic/              # 数据库迁移
│   ├── scripts/              # 工具脚本
│   └── tests/                # 测试
├── flutter-app/              # Flutter移动应用
│   ├── lib/
│   │   ├── features/         # 功能模块
│   │   ├── shared/           # 共享组件
│   │   └── core/             # 核心功能
│   └── test/                 # 测试
├── web-admin/                # Vue管理后台
│   ├── apps/web-antd/        # Ant Design版本
│   └── packages/             # 共享包
├── docs/                     # 文档
├── configs/                  # 配置文件
├── openapi/                  # API契约
└── scripts/                  # 脚本工具
```

## 核心功能

### 1. 用户认证
- ✅ 邮箱注册和验证
- ✅ JWT令牌认证
- ✅ 会话管理
- ✅ 密码重置

### 2. 内容检测
- ✅ 文本核验
- ✅ 图片核验 (1-9张)
- ✅ 分片上传
- ✅ 异步处理

### 3. 任务管理
- ✅ 任务创建
- ✅ 状态跟踪
- ✅ 实时推送 (SSE)
- ✅ 取消/重试/重新核验

### 4. 报告查询
- ✅ 风险报告
- ✅ 详细分析
- ✅ 历史记录

## 开发状态

### 后端API ✅
- [x] 核心基础设施
- [x] 用户认证系统
- [x] 多图片上传
- [x] 异步任务系统
- [x] 报告查询
- [x] 用户信息管理
- [ ] AI模型集成
- [ ] 人工复核
- [ ] 数据删除

### 移动应用 🚧
- [x] 项目骨架
- [x] 导航结构
- [ ] 登录注册
- [ ] 任务提交
- [ ] 实时状态
- [ ] 报告查看

### 管理后台 🚧
- [x] 基础框架
- [ ] 用户管理
- [ ] 任务监控
- [ ] 人工复核
- [ ] 系统配置

### AI模型 📝
- [ ] 数据准备
- [ ] 模型训练
- [ ] 模型集成
- [ ] 性能优化

## 文档

- [需求文档](docs/)
- [API文档](backend-api/README.md)
- [移动端文档](flutter-app/README.md)
- [管理端文档](web-admin/README.md)
- [数据库设计](docs/05-核心业务实体与MySQL数据模型.md)
- [OpenAPI规范](openapi/sourceguard-v1.yaml)

## 测试

### 后端测试
```bash
cd backend-api
pytest tests/ -v
```

### 移动端测试
```bash
cd flutter-app
flutter test
```

### 管理端测试
```bash
cd web-admin
pnpm test
```

## 质量保证

- ✅ **类型检查**: Mypy strict模式
- ✅ **代码规范**: Ruff + Very Good Analysis
- ✅ **单元测试**: pytest + flutter_test
- ✅ **API契约**: OpenAPI 3.0规范
- ✅ **安全**: Argon2id + JWT + 审计日志

## 贡献指南

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 联系方式

- 项目地址: https://gitee.com/leng-wya/ai-detection
- 问题反馈: https://gitee.com/leng-wya/ai-detection/issues

## 致谢

- FastAPI - 现代化的Python Web框架
- Flutter - 跨平台移动开发框架
- Vue Vben Admin - 优秀的后台管理框架
- 千问 - 国产大语言模型
- PaddleOCR - 开源OCR工具

---

**注意**: 本项目目前处于开发阶段，部分功能尚未完成。不建议在生产环境使用。