# FaceRecognition

**Repository Path**: r1Way/face-recognition

## Basic Information

- **Project Name**: FaceRecognition
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FaceRecog

当前仓库只保留两部分：

1. `ai_service.py`
2. `backend_app.py` 及其依赖的 `backend/`

## 项目说明

### `ai_service.py`

这是人脸识别服务本体，基于 FastAPI 提供 HTTP 接口。

主要接口：

1. `POST /api/v1/infer`
2. `GET /api/v1/health`

它负责：

1. 接收图片上传
2. 调用 InsightFace 检测人脸
3. 返回人脸框和 embedding
4. 过滤过小的人脸目标

### `backend_app.py`

这是后端测试入口，对应的是一个“伪后端”脚本，不是正式的后端 HTTP 服务。

它的作用是：

1. 扫描测试图片目录
2. 逐张调用 `ai_service.py` 的推理接口
3. 通过 `backend/` 下的逻辑模拟后端侧的人脸入库、聚类和结果汇总
4. 生成本地测试结果

请注意：

1. `backend_app.py` 不是线上后端
2. `backend_app.py` 不提供 Web API
3. 它主要用于本地联调、验证识别流程和模拟后端处理逻辑

## 目录结构

```text
FaceRecog/
├─ ai_service.py
├─ backend_app.py
├─ README.md
└─ backend/
   ├─ __init__.py
   ├─ ai_client.py
   ├─ config.py
   ├─ db.py
   ├─ main.py
   ├─ repositories.py
   ├─ services.py
   ├─ smoke_test.py
   └─ utils.py
```

## 运行方式

先启动人脸识别服务：

```bash
python ai_service.py
```

再运行伪后端测试脚本：

```bash
python backend_app.py
```

也可以直接运行：

```bash
python -m backend.main
```

## `backend/` 模块说明

1. `backend/main.py`: 伪后端主流程
2. `backend/ai_client.py`: 调用 `ai_service.py` 的 HTTP 客户端
3. `backend/services.py`: 识别结果持久化与匹配逻辑
4. `backend/repositories.py`: 数据读写封装
5. `backend/db.py`: 本地 SQLite 初始化与运行态重置
6. `backend/config.py`: 配置项
7. `backend/utils.py`: 通用工具函数
8. `backend/smoke_test.py`: 健康检查脚本

## 备注

1. 当前仓库不包含依赖清单，`requirements.txt` 需自行生成。
2. 当前仓库不保留历史测试数据、模型目录和其他非核心文件。