ZkFingerAgent 3.1

Исправление главной проблемы 3.0: программа показывала «Готов» на сканере, которого нет в USB, и ждала палец десять секунд впустую.

Что исправлено

• Сканер определяется по-настоящему. Наличие устройства теперь берётся у Windows через cfgmgr32, а не у ZKFPM_GetDeviceCount: SDK составляет список устройств при инициализации и на вынутом сканере продолжает отвечать «устройство на месте». Отсюда и брались «Готов» на пустом USB и код −8 вместо −13.
• Мгновенная реакция на подключение и отключение. Добавлена подписка на события устройств (RegisterDeviceNotification): без неё DBT_DEVICEARRIVAL для USB-устройств окнам не приходит вообще — Windows рассылает его только для дисков и флешек. Плюс независимый сторож: раз в секунду сверяется слепок шины USB, опрос стоит меньше миллисекунды.
• Переоткрытие устройства при возврате в USB. Вставили сканер обратно — программа сама закрывает старый дескриптор, заново инициализирует SDK и открывает устройство. Перезапуск не нужен.
• Отключение во время сканирования замечается за 0,4 секунды: захват прерывается с внятным «сканер отключён», а не висит до конца таймаута.
• /api/fingerprint/scan отвечает 503 сразу, если сканера нет в USB. Раньше страница честно ждала весь таймаут и получала «палец не приложен».

Что нового

• Полное удаление программы. Кнопка в Настройках → Защита стирает exe, скрытый agent.config.json, копию в C:\ProgramData\ZkFingerAgent и запись автозапуска — на компьютере не остаётся ничего. Драйвер сканера и ZKFinger SDK не трогаются: их ставил отдельный установщик и они нужны другим программам.
• Если exe удалили снаружи, пока программа работала, она замечает это и убирает свои данные сама.
• Ключ командной строки --uninstall для того же самого без интерфейса.

Установка

Скачайте ZkFingerAgent.exe ниже и запустите. При первом запуске программа предложит поставить драйвер и SDK — установщик встроен внутрь.

Проверено на ZK4500 (USB\VID_1B55&PID_0840), ZKFinger SDK 5.3.0.33, Windows 10/11.

ZkFingerAgent 3.0

Локальный агент ZKTeco для веб-приложений. Один файл, ничего доустанавливать не нужно: драйвер и ZKFinger SDK ставятся прямо из программы.

Что нового в 3.0

• Защита паролем — настройки и выход из программы закрыты паролем.
• Запрет удаления файлов — агент восстанавливает свои файлы при попытке удаления.
• Отказоустойчивый конфиг — скрытый файл рядом с программой плюс копия в C:\ProgramData; при удалении любой из копий настройки восстанавливаются.
• Новая иконка — отпечаток с бейджем проверки.

Установка

1. Скачайте ZkFingerAgent.exe ниже.
2. Запустите — при первом запуске программа предложит поставить драйвер и SDK.
3. Укажите в настройках адрес страницы входа.

Проверено на ZK4500 (USB\VID_1B55&PID_0840), ZKFinger SDK 5.3.0.33, Windows 10/11.

ZkFingerAgent 2.0

Первый публичный выпуск.

Установка

1. Скачайте ZkFingerAgent.exe ниже — один файл, распаковывать ничего не нужно.
2. Запустите. Установщик ZKFinger SDK встроен внутрь: кнопка «Установить SDK» → «Установить».
3. Переподключите сканер к USB после установки драйвера — Windows опознала его ещё со старым драйвером.
4. В «Настройках» укажите адрес страницы входа вашего сайта.

Что внутри

• HTTP-агент на localhost:8088, слушает IPv4 и IPv6
• Работа со сканером через libzkfp.dll (ctypes)
• Встроенный установщик ZKFinger SDK 5.3.0.33
• Диагностика: различает отсутствие SDK, отключённый сканер и сломанный драйвер
• Инструменты обхода блокировки браузером (Private / Local Network Access)
• Регистрация эталона из трёх захватов, живое изображение отпечатка
• Работа в трее, автозапуск с Windows, одна копия на компьютер

Требования

Windows 10 или 11 (x64), сканер ZKTeco ZK4500 / ZK9500 / ZK6500 / SLK20R или совместимый.

---

Установщик ZKFinger SDK принадлежит ZKTeco Inc. и включён в сборку для удобства установки.