Возможности BirdLense Hub
English
Полный список фич. См. Changelog для деталей по версиям.
Ядро (всегда)
| Фича |
Описание |
| Live video |
Go2RTC, MJPEG overlay с детекциями |
| YOLO + ByteTrack |
Двухэтапная стратегия: binary detector + species classifier |
| EU-модель |
~491 вид (birds-525 + iNaturalist). US (NABirds) — резерв |
| Триггеры |
OpenCV, Frigate, MQTT, ESPHome |
| BirdNET |
Слияние аудио-детекций через MQTT |
| Frigate |
Bird Classification sub_label в слиянии |
| Timeline |
Визиты по дате, воспроизведение видео, спектрограммы |
| Overview |
Статистика, графики активности |
| Species |
Основной вход через таблицу Migration (/migration-calendar) + сводка по виду (/species/:id) |
| Погода |
OpenWeather, Home Assistant |
| Telegram |
Уведомления при детекции, превью best frame в фото |
| Кормушка |
Реле (MQTT/ESPHome) при детекции |
| MCP |
Model Context Protocol — опциональный сервер для внешних ИИ-ассистентов (MCP_SETUP.ru) |
Экспорт и аналитика
| Фича |
API / UI |
Версия |
| CSV/JSON |
GET /api/ui/timeline/export?format=csv\|json |
0.1.2 |
| eBird |
GET /api/ui/timeline/export?format=ebird |
0.1.4 |
| Сравнение с регионом |
GET /api/ui/region-comparison — ваши виды vs топ eBird региона (Overview) |
0.1.9 |
| PDF-отчёт |
GET /api/ui/report/pdf?month=YYYY-MM |
0.1.3 |
| Prometheus |
GET /metrics, GET /api/metrics |
0.1.3 |
| История метрик (UI) |
GET /api/ui/system/metrics/history — снимки в SQLite для графиков в хабе |
— |
| iNaturalist |
GET /api/ui/detections/:id/crop |
0.1.4 |
| Dataset export |
GET /api/ui/dataset/export — ZIP train/val + dataset_info.json |
0.1.5 |
UI
| Фича |
Описание |
| Timeline: дата + время суток |
DatePicker, фильтр: Утро, День, Вечер, Ночь (22–06) |
| Timeline: режим «На проверке» |
/timeline?review=1 — детекции с confidence < порога и ручная коррекция; legacy /unknowns редиректит сюда |
| Playback speed |
0.5x, 2x в видеоплеере |
| Виджет «Последняя птица» |
На Overview |
| PWA |
Install prompt, offline cache |
| Источник детекции |
YOLO / Frigate / BirdNET в карточках |
| Календарь миграций |
/migration-calendar — таблица визитов по виду и месяцу (Jan–Dec), интенсивность по данным |
| Xeno-canto |
Песни птиц на странице вида |
| Confidence по виду |
processor.species_confidence_overrides |
| Датасет для дообучения |
processor.save_dataset_crops, экспорт ZIP в Система → Управление хранилищем, коррекция вида перемещает файл |
| Скачать видео |
Кнопка в VideoDetails — только для Admin/Contributor (после ввода пароля) |
| Предыдущий/следующий ролик |
Тот же календарный день UTC: стрелки и счётчик на странице видео; GET /api/ui/videos/:id/neighbors |
| Система: ресурсы и посетители |
/system: графики CPU/RAM/диск/GPU (история на сервере + живой хвост, окно 6/24/48 ч), уникальные посетители за период; BIRDLENSE_SYSTEM_METRICS_* — CONFIGURATION |
Интеграции
| Фича |
Конфиг |
Описание |
| Webhook |
webhook.url |
POST при детекции (IFTTT, Zapier) |
| eBird |
ebird.country, ebird.state, ebird.location_name |
Экспорт чеклиста |
| Home Assistant |
mqtt.ha_discovery, mqtt.broker |
MQTT Autodiscovery — Last Species, Bird at Feeder и др. |
| Grafana |
Prometheus scrape |
Метрики для дашбордов |
Конфигурация (ключевые ключи)
| Секция |
Ключи |
processor |
species_confidence_overrides, min_confidence_to_process |
ui |
unknown_confidence_threshold |
webhook |
url |
ebird |
country, state, location_name |
secrets |
xeno_canto_api_key, ebird_api_key |
API (основные эндпоинты)
| Метод |
Путь |
Описание |
| GET |
/api/ui/health |
Health check |
| GET |
/api/ui/timeline |
Визиты за период |
| GET |
/api/ui/timeline/export |
CSV, JSON, eBird |
| GET |
/api/ui/unknowns |
Низкая confidence (params: start_time, end_time, limit) |
| GET |
/api/ui/region-comparison |
Сравнение видов с топом eBird региона (требует secrets.ebird_api_key) |
| PATCH |
/api/ui/detections/:id |
Исправить вид |
| GET |
/api/ui/detections/:id/crop |
Кадр для iNaturalist |
| GET |
/api/ui/videos/:id/download |
Скачать видео (Admin/Contributor) |
| GET |
/api/ui/videos/:id/neighbors |
ID предыдущего/следующего ролика за тот же день UTC, что и start_time |
| GET |
/api/ui/dataset/export |
ZIP датасета (train/val + dataset_info.json) |
| GET |
/api/ui/system/metrics |
Мгновенные CPU / RAM / диск / GPU |
| GET |
/api/ui/system/metrics/history |
Ряд метрик для UI (hours, max_points) |
| GET |
/api/ui/system/visitors |
Статистика посетителей (days) |
| GET |
/api/ui/migration-calendar |
Агрегация визитов по виду и месяцу для календаря миграций |
| GET |
/api/ui/report/pdf |
PDF-отчёт |
| GET |
/api/ui/species/:id/xeno-canto |
Записи Xeno-canto |
| GET |
/metrics |
Prometheus |
Полная спецификация: OpenAPI (YAML).
См. также: API, CONFIGURATION, GLOSSARY, ROADMAP.