# FaceSeeker_Demo

**Repository Path**: zhux3/FaceSeeker_Demo

## Basic Information

- **Project Name**: FaceSeeker_Demo
- **Description**: FaceSeeker (慧眼寻人)
一款专注于人脸识别批量查找照片的实用工具， 本地AI人脸识别工具、支持多核批量处理、数据缓存加速等。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FaceSeeker 慧眼寻人 - 程序发布说明

## 📋 程序概述

**FaceSeeker（慧眼寻人）** 是一款基于 AI 的人脸检测与识别桌面应用程序。它使用先进的深度学习模型来快速在大量照片中搜索和匹配目标人脸。

## 🚀 功能亮点

- 识别准确率高，不同角度、光线、表情下也能精准匹配

- 批量高速处理，支持扫描多个目标文件夹以及子文件夹

- 数据缓存加速，二次搜索无需重复检测，实现极速处理

![程序界面](./Screenshot_1770208023.png)

- **当前版本**: v1.8
- **发布日期**: 2026-02-08
- **开发语言**: C# 10.0 / .NET 10.0
- **支持平台**: Windows 7.0+
---


## 🖥️ 系统要求

### 推荐配置
- **操作系统**: Windows 10/11 (64位)
- **处理器**: Intel Core i5/i7 或 AMD Ryzen 5/7（多核处理器可提升并发搜索性能）
- **内存**: 8 GB RAM 或更高
- **存储空间**: 1 GB 可用空间（用于数据库存储）
- **显卡**: 无要求，使用CPU计算

---

## ✨ 核心功能

### 1. 智能人脸检测
- 支持大分辨率特写照片检测
- 支持检测图片中的多张人脸

### 2. 高效人脸识别
- 基于 SFace 深度学习模型（OpenCV）
- 余弦相似度匹配算法 相似度阈值（默认 0.363）

### 3. 数据库缓存加速
- SQLite 数据库存储人脸特征数据
- 二次搜索速度显著提升
- 数据库文件保存于：我的文档\FaceSeeker_data.db

### 4. 并发处理
- 支持多线程并行搜索
- 根据 CPU 核心数自动优化任务数量
- 可手动开启/关闭并发模式（复选框控制）
- 异常图片自动记录，不影响整体进度

### 5. 批量导出功能
- 导出匹配结果到 Excel
- 批量复制匹配图片
- 支持保留/不保留原文件夹结构

### 6. 图片浏览与预览
- 内置图片浏览器，支持快捷键操作
- 支持图片旋转（顺时针/逆时针 90°）
- 支持缩放（放大/缩小/重置）
- 支持图片翻页浏览

---

## 📦 安装说明

### 解压运行
1. 下载 FaceSeeker_v1.7.zip 压缩包
2. 解压到任意文件夹
3. 运行 `FaceSeeker.exe`
4. 程序会自动创建必要的数据库文件

---

## 🚀 使用指南

### 快速开始

#### 1. 加载源图（目标人脸）
- **方式一**: 双击左侧图片框，选择包含目标人脸的图片
- **方式二**: 直接将图片拖拽到左侧图片框
- **方式三**: 将图片复制到剪贴板，激活程序后自动加载
- 源图有多个人脸时，鼠标滚轮切换人脸

#### 2. 添加搜索文件夹
- **方式一**: 双击文件夹列表区域，选择要搜索的文件夹
- **方式二**: 将文件夹拖拽到文件夹列表区域
- 可以添加多个文件夹
- 支持自动处理子文件夹

#### 3. 开始搜索
- 点击"开始"按钮
- 程序会显示进度和估计剩余时间
- 匹配结果会显示在右侧列表中

#### 4. 查看结果
- 双击列表项打开图片浏览器
- 使用快捷键浏览、旋转、复制图片
- 可以导出匹配结果或图片文件

### 高级功能

#### 切换显示模式
- **大图标**: 查看人脸缩略图
- **详细信息**: 查看文件名、大小、相似度等信息
- 快捷键: 数字键 `1-5` 切换不同视图

#### 导出功能
- 导出 Excel 列表：工具栏导出按钮
- 导出图片文件：支持保留原文件夹结构

---

## ⌨️ 快捷键指南

### 主界面快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl + A` | 全选列表项 |
| `Ctrl + C` | 复制选中项信息 |
| `Ctrl + E` | 在资源管理器中打开文件位置 |
| `Delete` | 移除选中列表项 |
| `数字键 1` | 大图标视图 |
| `数字键 2` | 小图标视图 |
| `数字键 3` | 列表视图 |
| `数字键 4` | 详细信息视图 |
| `数字键 5` | 平铺视图 |

### 文件夹列表快捷键

| 快捷键 | 功能 |
|--------|------|
| `Delete` | 删除选中的文件夹路径 |

### 图片浏览器快捷键

| 快捷键 | 功能 |
|--------|------|
| `F1` | 显示帮助信息 |
| `Esc` | 关闭浏览窗口 |
| `↑` / `PageUp` | 上一张图片 |
| `↓` / `PageDown` | 下一张图片 |
| `←` | 逆时针旋转 90° |
| `→` | 顺时针旋转 90° |
| `+` | 放大图片 |
| `-` | 缩小图片 |
| `Ctrl + 0` / `Ctrl + NumPad0` | 重置图片大小 |
| `Ctrl + C` | 复制图片到剪贴板 |
| `Ctrl + E` | 在资源管理器中打开文件位置 |

---

## 📝 版本更新历史

### v1.7 (2026-02-07)
- ✨ 使用 AI 审阅和优化代码
- 🐛 文件夹列表 BUG 修复
- 🔒 运行中不允许关闭窗口
- ⚡ 数据库类改为异步锁，提升性能
- ⚡ 并发控制改为异步方法
- 🐛 修复 ImageList 内存未释放问题
- ✨ 源图支持 jpg, png, bmp 格式

### v1.6 (2026-02-03)
- ✨ 自动检查程序更新
- 🐛 解决导出图片 UI 会卡死问题
- ✨ 添加倒计时，估计剩余时间
- 💝 添加赞助二维码，打赏作者

### v1.5 (2026-01-25)
- ✨ 解决文件唯一值问题造成数据库插入失败（经百万模拟测试通过）
- ✨ 未加载源图时列表视图拖入图片文件，将显示图中所有人脸
- ✨ 程序激活未加载源图时自动从剪贴板取图片
- ✨ 源图存在多个人脸时，添加鼠标滚轮切换
- ✨ 列表视图添加快捷键 ctrl+e 浏览图片文件

### v1.4 (2026-01-20)
- ✨ 文件夹列表添加快捷键 delete 删除
- ✨ 列表视图添加快捷键，切换显示方式键盘上排数字 1-5
- ⚡ SQLite 不支持并发写，添加读写锁
- ✨ 其它图片无人脸，也入库标示，避免二次检测
- 📝 异常日志记录文件 errorLog.txt

### v1.3 (2026-01-19)
- ✨ 添加数据库缓存，加速二次搜索（保存到我的文档\FaceSeeker_data.db）
- 🐛 解决添加多个文件夹路径层级包含问题
- 🐛 解决列表视图移除条目图片 index 出错

### v1.2 (2026-01-18)
- ✨ 感谢腾飞群友假大空、清江之水的测试和建议
- ✨ 列表添加显示人脸匹配相似度
- 🐛 解决工作中列表排序异常问题

### v1.1 (2026-01-18)
- ✨ 改进大分辨率特写人物识别不到问题
- 🐛 修正异常图片没有报告进度，造成前端 UI 进度不完整
- ✨ 添加列表视图快捷键，ctrl+c 复制，ctrl+a 全选
- ✨ 添加列表视图排序功能
- ✨ 添加导出已选图片工具按钮
- ✨ 添加状态栏显示计时器，已选数量
- ✨ 浏览窗添加快捷键：up 上一张图片、down 下一张图片、left 逆时针旋转、right 顺时针旋转
- ✨ 浏览窗添加快捷键：+放大图片、-缩小图片、ctrl+c 复制图片、ctrl+e 浏览图片文件

---

## ⚠️ 已知问题与限制

1. **图片格式限制**
   - 源图支持：JPG、PNG、BMP
   - 搜索文件夹仅支持：JPG 格式

2. **数据库文件位置**
   - 数据库默认保存在用户文档文件夹
   - 如需迁移，请手动复制 `FaceSeeker_data.db` 文件

3. **内存使用**
   - 并发处理大量图片时，CPU占用90%以上
   - 长时间运行后建议重启程序释放内存

4. **首次搜索**
   - 首次搜索需要构建数据库，速度较慢
   - 后续搜索将显著加快

---

## 🛠️ 技术支持

### 反馈问题
- 项目 Issues: https://gitee.com/zhux3/FaceSeeker_Demo/issues
- 作者主页: https://gitee.com/zhux3

### 获取帮助
- 项目主页: https://gitee.com/zhux3/FaceSeeker_Demo
- 查看帮助文档: 按 F1 键或在程序中点击帮助按钮

### 更新日志
- 程序启动时自动检查更新
- 也可手动访问项目主页下载最新版本

---

## 📄 许可说明

本软件为免费软件，仅供个人学习研究使用。

**致谢**
- 人脸检测模型：YuNet
- 人脸识别模型：SFace (OpenCV)
- 感谢腾飞群友假大空、清江之水的测试和建议

##  💾 下载链接
- 百度网盘：<https://pan.baidu.com/s/1kEQsRtnBn5P2ZhYjTQ7g1w?pwd=f2t5>
---

*最后更新: 2026-02-08*