基于 Windows Credential Provider 框架的摄像头人脸识别解锁系统。
在锁屏界面集成"人脸登录"磁贴，看一眼即可解锁 — 支持本地账户和微软在线账户 (MSA)。
特性
| 锁屏人脸解锁 | 双重活体检测 | ONNX 识别 |
|:---:|:---:|:---:|
| Windows 原生锁屏集成
无需额外操作 | EAR 眨眼 + facenox MiniFAS
防照片/视频/面具攻击 | SCRFD 检测 + InsightFace
ONNX 人脸识别 | | **多账户支持** | **安全存储** | **热配置** | | 本地 SAM + 微软在线
账户全兼容，每账号可录多张人脸 | DPAPI 机器范围加密
管道 DACL 访问控制 | 运行时修改识别参数
无需重启服务 |
无需额外操作 | EAR 眨眼 + facenox MiniFAS
防照片/视频/面具攻击 | SCRFD 检测 + InsightFace
ONNX 人脸识别 | | **多账户支持** | **安全存储** | **热配置** | | 本地 SAM + 微软在线
账户全兼容，每账号可录多张人脸 | DPAPI 机器范围加密
管道 DACL 访问控制 | 运行时修改识别参数
无需重启服务 |
系统架构
flowchart TB
subgraph LockScreen["Windows 锁屏界面"]
LogonUI["LogonUI.exe"]
CP["FaceLogin<br/>CredentialProvider.dll"]
end
subgraph Service["人脸认证服务"]
Svc["FaceLoginService.exe"]
end
subgraph Enrollment["注册控制台"]
Console["FaceLoginConsole.exe"]
end
subgraph Storage["数据存储"]
direction LR
UsersDB[("data/<br/>users.dat")] ~~~ Config[("data/<br/>config.json")] ~~~ Models[("models/<br/>ONNX + landmarks")] ~~~ Logs[("log/<br/>日志文件")]
end
LogonUI -->|"COM 接口"| CP
CP -->|"命名管道"| Svc
Svc -->|"凭据回传"| CP
Console -->|"RELOAD_DB / GET_LOGS"| Svc
Console --> Storage
Svc --> Storage
style LockScreen fill:#eff6ff,stroke:#3b82f6
style Service fill:#fefce8,stroke:#eab308
style Enrollment fill:#f0fdf4,stroke:#22c55e
style Storage fill:#fdf2f8,stroke:#ec4899
所有跨进程通信通过命名管道
\\.\pipe\FaceLoginPipe（DACL 保护）。
Star History
图表由独立项目 StarHistory 的 GitHub Actions 每日自动更新，数据与渲染完全自托管，不依赖第三方服务。
快速开始
第一步：安装
从 Releases 下载 FaceLoginSetup.exe，运行后选择安装目录，点击 安装。
第二步：录入人脸
以管理员身份运行 FaceLoginConsole.exe，按提示完成活体检测，输入密码，点击 保存并录入。
第三步：解锁
Win + L 锁屏后，注视摄像头，系统自动识别并解锁。
卸载
运行安装程序切换到 卸载 标签页，或手动执行 regsvr32 /u FaceLoginCredentialProvider.dll。
系统要求
| 要求 | 详情 |
|---|---|
| 操作系统 | Windows 10 21H2+ / Windows 11 (x64) |
| 摄像头 | USB 或内置，支持 1280×720 |
| 运行时 | WebView2（Windows 11 内置，Win10 自动安装） |
| 权限 | 管理员权限（安装和注册需要） |
| 磁盘空间 | ~250 MB（含模型文件 ~21 MB） |
安全设计
| 层面 | 措施 |
|---|---|
| 进程通信 | 命名管道 DACL：仅 SYSTEM + Administrators，拒绝远程 |
| 凭据存储 | DPAPI CRYPTPROTECT_LOCAL_MACHINE 机器范围加密 |
| 内存保护 | 密码使用后 SecureZeroMemory 即时擦除 |
| 活体检测 | EAR 眨眼 + facenox MiniFAS 双重验证 |
| 匹配安全 | 欧氏距离阈值 + 最佳/次佳匹配比双重校验 |
| 编译加固 | ASLR、DEP、CFG、64位高熵地址随机化 |
项目结构
FaceLogin/
├── common/ # 公共库（日志、IPC协议、DPAPI、账户身份、配置）
├── credential_provider/ # Windows 凭据提供程序 COM DLL
├── face_service/ # 人脸识别 Windows 服务
├── enrollment_app/ # 人脸录入控制台（WebView2 GUI）
├── installer/ # Go Wails 图形安装程序
├── scripts/ # 辅助脚本（模型下载、诊断工具，不随安装包发布）
└── assets/ # 图标资源
详细技术文档请参阅 DEVELOPMENT.md。
从源码构建
仅当需要自行编译时才需关注本节。
前置条件
- Visual Studio 2022（含 C++ 工作负载）
- vcpkg — dlib（图像工具库：matrix/rectangle/变换）、onnxruntime
- Go 1.25+ + Wails v2（仅安装程序）
- CMake 3.20+
C++ 组件
# vcpkg 依赖（识别/检测/地标全部用 ONNX，dlib 仅提供图像数据结构）
vcpkg install dlib[core] onnxruntime --triplet x64-windows
# 构建（FaceLoginConsole.exe 直接输出到 installer/FaceLoginSetup/resources/）
cmake -B build -S . -G "Visual Studio 17 2022" `
-DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"
cmake --build build --config Release
Go 安装程序
cd installer/FaceLoginSetup
# 将 FaceLoginService.exe / FaceLoginCredentialProvider.dll 复制到 resources/ 后编译
wails build -clean -platform windows/amd64
模型文件
| 文件 | 用途 | 下载 |
|---|---|---|
2d106det.onnx |
106点面部地标提取 | InsightFace |
det_500m.onnx |
SCRFD 人脸检测 | InsightFace |
w600k_mbf.onnx |
InsightFace 人脸识别 | InsightFace |
minifas_quantized.onnx |
静默反欺诈 | facenox/face-antispoof-onnx |
贡献
欢迎提交 Issue 和 Pull Request！
- 代码规范：C++20、
/W4警告级别 - 提交前请确保构建通过
- 重大改动请先创建 Issue 讨论
开源协议
MIT License © 2026 美国伐木工&EthanZer0
免责声明
本软件通过人脸识别辅助 Windows 登录，但 不能替代 密码。人脸识别为便捷方式，系统始终保留密码登录作为后备。请勿在安全要求极高的环境中单独依赖人脸识别。