EthanZer0/FaceLogin

基于 Windows Credential Provider 框架的摄像头人脸识别解锁系统。
在锁屏界面集成“人脸登录”磁贴，看一眼即可解锁 — 支持本地账户和微软在线账户 (MSA)。

## 特性 ## 系统架构 ``` flowchart TB subgraph LockScreen["Windows 锁屏界面"] LogonUI["LogonUI.exe"] CP["FaceLogin
CredentialProvider.dll"] end subgraph Service["人脸认证服务"] Svc["FaceLoginService.exe"] end subgraph Enrollment["注册控制台"] Console["FaceLoginConsole.exe"] end subgraph Storage["数据存储"] direction LR UsersDB[("data/
users.dat")] ~~~ Config[("data/
config.json")] ~~~ Models[("models/
ONNX + landmarks")] ~~~ Logs[("log/
日志文件")] 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 ``` ## 快速开始 ### 第一步：安装 从 [Releases](https://github.com/EthanZer0/FaceLogin/releases) 下载 `FaceLoginSetup.exe`，运行后选择安装目录，点击 **安装**。 ### 第二步：录入人脸 以管理员身份运行 `FaceLoginConsole.exe`，按提示完成活体检测，输入密码，点击 **保存并录入**。 ### 第三步：解锁 `Win + L` 锁屏后，注视摄像头，系统自动识别并解锁。 ### 卸载 运行安装程序切换到 **卸载** 标签页，或手动执行 `regsvr32 /u FaceLoginCredentialProvider.dll`。 ## 系统要求 | 要求 | 详情 | |---|---| | 操作系统 | Windows 10 21H2+ / Windows 11 (x64) | | 摄像头 | USB 或内置，支持 1280×720 | | 运行时 | WebView2（Windows 11 内置，Win10 自动安装） | | 权限 | 管理员权限（安装和注册需要） | | 磁盘空间 | ~200 MB（含模型文件 ~28 MB） | ## 安全设计 | 层面 | 措施 | |---|---| | 进程通信 | 命名管道 DACL：仅 SYSTEM + Administrators，拒绝远程 | | 凭据存储 | DPAPI `CRYPTPROTECT_LOCAL_MACHINE` 机器范围加密 | | 内存保护 | 密码使用后 `SecureZeroMemory` 即时擦除 | | 活体检测 | EAR 眨眼 + MiniFASNetV2 双重验证 | | 匹配安全 | 欧氏距离阈值 + 最佳/次佳匹配比双重校验 | | 编译加固 | 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](DEVELOPMENT.md)。 ## 从源码构建 ### 前置条件 - **Visual Studio 2022**（含 C++ 工作负载） - **vcpkg** — dlib（仅用于 68 点地标）、onnxruntime - **Go 1.21+** + **Wails v2**（仅安装程序） - **CMake 3.20+** ### C++ 组件 ``` # vcpkg 依赖（dlib 仅用于 shape predictor 地标，识别/检测用 ONNX） vcpkg install dlib[core] onnxruntime --triplet x64-windows # 构建 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 # 将 C++ 产物和模型放入 resources/ 后编译 wails build -clean -platform windows/amd64 ``` ### 模型文件 | 文件 | 用途 | 下载 | |---|---|---| | `shape_predictor_68_face_landmarks.dat` | 面部地标提取 | `scripts/download_models.ps1` | | `det_500m.onnx` | SCRFD 人脸检测 | [InsightFace](https://github.com/deepinsight/insightface) | | `w600k_mbf.onnx` | InsightFace 人脸识别 | [InsightFace](https://github.com/deepinsight/insightface) | | `OULU_Protocol_2_model_0_0.onnx` | 静默反欺诈 | [MiniFASNet](https://github.com/minivision-ai/Silent-Face-Anti-Spoofing) | ## 开源协议 [MIT License](LICENSE) © 2026 美国伐木工&EthanZer0 ## 免责声明 本软件通过人脸识别辅助 Windows 登录，但 **不能替代** 密码。人脸识别为便捷方式，系统始终保留密码登录作为后备。请勿在安全要求极高的环境中单独依赖人脸识别。 ## Star 历史 [](https://www.star-history.com/?repos=EthanZer0%2FFaceLogin&type=timeline&legend=top-left)

标签：Bash脚本, C++, Credential Provider, ONNX, 人脸识别, 数据擦除, 日志审计, 活体检测, 生物识别