EthanZer0/FaceLogin

简体中文 · 한국어 · English

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

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 保护）。

图表由独立项目 StarHistory 的 GitHub Actions 每日自动更新，数据与渲染完全自托管，不依赖第三方服务。

从 Releases 下载 FaceLoginSetup.exe，运行后选择安装目录，点击 安装。

以管理员身份运行 FaceLoginConsole.exe；新安装默认不启用活体检测（none），如在设置中启用了眨眼或反欺诈活体，请按提示完成检查，然后输入密码并点击 保存并录入。

Win + L 锁屏后，选择“人脸登录”磁贴并注视摄像头。普通解锁需要随后产生一次键盘按键或鼠标按键输入才开始识别；鼠标移动本身不会触发识别。识别状态会通过安全桌面上的中央浮层显示。冷启动默认自动开始识别，也可以在设置中改为等待按键或鼠标按键。

姿态不符合要求时，界面会提示调整左右转头、抬头/低头或左右倾斜；回到合法范围后继续识别。

运行安装程序切换到 卸载 标签页，或直接运行安装目录中的 Uninstall.exe。卸载程序会停止并删除服务、注销凭据提供程序、删除安装目录及 FaceLogin 数据；请在卸载前备份需要保留的人脸数据。

FaceLogin/
├── common/                 # 公共库（日志、IPC协议、DPAPI、账户身份、配置）
├── credential_provider/    # Windows 凭据提供程序 COM DLL
├── face_service/           # 人脸识别 Windows 服务
├── enrollment_app/         # 人脸录入控制台（WebView2 GUI）
├── installer/              # Go Wails 图形安装程序
├── locales/                # 独立语言包（zh-CN / ko-KR / en-US）
├── scripts/                # 构建脚本与语言包一致性检查
└── assets/                 # 图标资源

详细技术文档请参阅 DEVELOPMENT.md。

仅当需要自行编译时才需关注本节。

• Visual Studio 2022（含 C++ 工作负载）
• vcpkg — dlib（图像工具库：matrix/rectangle/变换）、onnxruntime
• Go 1.25+ + Wails v2（仅安装程序）
• CMake 3.20+

# 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

cd installer/FaceLoginSetup
# 先将 C++ 产物和模型同步到 resources/，再构建完整安装器
.\build-installer.ps1

build-installer.ps1 会先单独构建不内嵌安装资源的轻量 Uninstall.exe，复制到 resources/，再构建完整的 FaceLoginSetup.exe。如只需调试前端或 Go 代码，也可以直接使用 Wails 命令，但发布安装包应使用该脚本。

欢迎提交 Issue 和 Pull Request！

• 代码规范：C++20、/W4 警告级别
• 提交前请确保构建通过
• 重大改动请先创建 Issue 讨论

MIT License © 2026 美国伐木工&EthanZer0

本软件通过人脸识别辅助 Windows 登录，但 不能替代 密码。人脸识别为便捷方式，系统始终保留密码登录作为后备。请勿在安全要求极高的环境中单独依赖人脸识别。