Об этом проекте

Это инструмент мониторинга электроэнергии для пользователей общежитий Нанкинского университета, который решает проблему того, что остаток электроэнергии можно просматривать только через приложение или сайт и его трудно отслеживать в динамике. Проект предоставляет Python-скрипт для автоматического входа в систему пополнения электроэнергии Нанкинского университета, поддерживает два способа проверки: традиционную капчу (OCR ddddocr) и слайдер-проверку (AI-распознавание captcha-recognizer), а также умеет автоматически определять текущий тип проверки и выполнять несколько раундов повторных попыток. Собранный остаток электроэнергии сохраняется в файлы JSON и CSV, одновременно генерируется график изменения остатка электроэнергии за историю. Проект уже интегрирован с GitHub Actions: можно настроить NJU_USERNAME и NJU_PASSWORD в Secrets репозитория и запускать его автоматически по расписанию без локального развертывания. Рабочий процесс поддерживает отправку email-уведомлений при падении остатка ниже порога, пороги можно настроить в config_workflow.json, например обычное уведомление — 200 кВт·ч, важное — 10 кВт·ч, экстренное — 5 кВт·ч. Для локального запуска требуются Python 3.9+, браузер Chrome и ChromeDriver, запуск мониторинга или веб-панели визуализации можно выполнить одним щелчком через пакетный файл. Веб-панель предоставляет интерактивную кривую остатка электроэнергии и таблицу данных с возможностью масштабирования, перетаскивания и просмотра при наведении, адаптирована для настольных и мобильных устройств. Проект также включает вспомогательные инструменты для тестирования окружения, отладки структуры страницы и проверки распознавания капчи, а также содержит инструкции по устранению распространённых проблем, таких как совместимость PIL, соответствие версии ChromeDriver и сбои распознавания OCR.