Интеллектуальный диагностический и самовосстанавливающийся инструмент для Windows
SuperDiagnosticTool — это интеллектуальная утилита диагностики системы, которая объединяет телеметрию оборудования в реальном времени с Google Gemini AI для анализа, диагностики и автоматического устранения проблем в Windows. Архитектура с приоритетом безопасности обеспечивает диагностику промышленного уровня для любой конфигурации Windows.
Скриншоты
Главный интерфейс с выбором режима сканирования и вводом описания проблемы
Ключевые возможности
Универсальная поддержка оборудования
- Динамическое масштабирование: Автоматически адаптируется к любой конфигурации CPU (от 1 до 128+ ядер)
- Аппаратно-независимая логика: Работает как на устаревших системах (Intel Pentium), так и на высокопроизводительных рабочих станциях (AMD Threadripper, Intel Xeon)
- Безопасные откаты: Корректная обработка неподдерживаемых функций (частота ЦП, обнаружение батареи, swap-память)
- Оптимизация для слабых ПК: Легковесное выполнение, предотвращающее зависания даже на устройствах с ограниченными ресурсами
Интеллектуальный анализ с помощью ИИ
- Интеграция Google Gemini: Продвинутый анализ системы и диагностика на основе ИИ
- Контекстно-зависимые рекомендации: Сопоставление сообщенных пользователем проблем с системной телеметрией
- Аудит безопасности: Поиск подозрительных процессов, утечек ресурсов и потенциального вредоносного ПО
- Проверка после исправления: Генерация отчетов о выполненных действиях с указанием того, что было исправлено, а что требует ручного вмешательства
Архитектура с приоритетом безопасности
Промышленная безопасность (85%)
Многоуровневая проверка
- Сопоставление с базой знаний: Проверка решений ИИ по 5 проверенным известным решениям с указанием успешности
- Симуляция в режиме Dry-Run: Предварительный просмотр всех изменений до их выполнения (службы, файлы, реестр)
- Многоуровневая проверка скриптов: Черный список, белый список и оценка риска (0-100)
- Точки восстановления системы: Автоматическое создание точки восстановления перед любыми изменениями
Расширенный мониторинг
- Снимки до и после выполнения: Полный захват состояния системы до и после изменений
- Обнаружение изменений: Автоматическое отслеживание всех модификаций (службы, реестр, автозагрузка)
- Генерация отката: Автоматически создаваемые скрипты для отмены изменений при необходимости
- Логирование выполнения: Полные журналы всех операций
Безопасность PowerShell
- Проверка прав администратора: Все скрипты исправления содержат проверку повышения прав
- Очистка переменных: Экранирование на основе регулярных выражений для предотвращения ошибок с сохранением переменных
$env:
- Проверки безопасности служб: Проверка существования служб перед операциями
- Выполнение в изолированной среде: Мониторинг среды с защитой по тайм-ауту
- Обработка ошибок: Полные блоки try-catch с механизмами защиты
Полное сканирование системы
- Показатели производительности: Загрузка ЦП (общая + по ядрам), распределение памяти, основные потребители ресурсов
- Сетевая информация: Активные интерфейсы, конфигурация DNS, уровень сигнала Wi-Fi, тесты связности
- Безопасность: Статус антивируса, профили брандмауэра, история обновлений Windows
- Состояние оборудования: SMART-статус дисков, информация о GPU, состояние батареи (ноутбуки)
- Системные службы: Программы автозагрузки, неработающие службы, критические журналы событий
- Аудит процессов: Выявление подозрительных процессов на основе использования ресурсов и местоположения
Человекоориентированная отчетность
- Профессиональные HTML-отчеты: Темные диагностические отчеты с визуальными метриками
- Завершенные действия в прошедшем времени: Отчеты используют теги
[FIXED], [CLEANED], [DISABLED] для отображения выполненных действий
- Раздел "Требует внимания": Четкое разделение автоматических исправлений и элементов, требующих вмешательства пользователя
- Архивирование по меткам времени: Все отчеты сохраняются в каталог
AI_Reports/ для отслеживания истории
Быстрый старт
Загрузка
Скачать SuperDiagnosticTool.exe — автономный исполняемый файл (Python не требуется)
Требования
Первый запуск
- Скачайте и запустите
SuperDiagnosticTool.exe
- При запросе введите ключ Google Gemini API
- Опишите проблему в системе
- Выберите режим сканирования (Quick/Deep/Complete)
- Просмотрите анализ ИИ и скрипт исправления
- Примените исправления или посмотрите подробный HTML-отчет
Установка (Для разработчиков)
Предварительные требования
- Python 3.8 или выше
- Менеджер пакетов pip
Установка зависимостей
pip install psutil google-generativeai rich
Запуск из исходного кода
python super_diagnose_v2.py
Использование
Настройка API-ключа
Вариант A: Интерактивный ввод (рекомендуется для новых пользователей)
- При первом запуске инструмент запросит ввод API-ключа
- Ключ сохраняется локально в
gemini.key для последующего использования
Вариант B: Переменная среды
set GEMINI_API_KEY=ваш_ключ_api_здесь
Вариант C: Ручной файл ключа
Создайте gemini.key в том же каталоге:
Режимы сканирования
| Режим | Сканирует | Случай использования |
|---|
Пример рабочего процесса
# 1. Запустите инструмент
SuperDiagnosticTool.exe
# 2. Опишите проблему
> Высокая загрузка ЦП и медленная работа
# 3. Выберите режим сканирования
> 3 (Complete System Scan)
# 4. Дождитесь анализа ИИ
[Сканирование системных слоёв...]
[Обработка логики телеметрии...]
# 5. Просмотрите скрипт исправления
[Отображен скрипт PowerShell]
> Выполнить? (y/n)
# 6. Просмотрите HTML-отчет
> Открыть подробный отчет? (y/n)
Технические детали
Архитектура кода
- Модульный дизайн с отдельными функциями для каждой категории диагностики
- Полная обработка ошибок с блоками try-except
- Аппаратно-независимые запросы с безопасными откатами
- Профессиональные докстринги и понятные имена переменных
Генерация скриптов PowerShell
- Проверка прав администратора перед выполнением
- Экранирование переменных на основе регулярных выражений для предотвращения синтаксических ошибок
- Переменные среды (
$env:TEMP, $env:PATH) корректно сохраняются
- Безопасное управление службами с проверкой существования
- Подавление ошибок с помощью
-ErrorAction SilentlyContinue
Интеграция с Gemini AI
- Структурированные промпты для согласованного разбора вывода
- Разделители секций (
[ANALYSIS_START], [FIX_START]) для надежного извлечения
- Контекстно-зависимый анализ на основе системной телеметрии
- Отчеты в прошедшем времени для завершенных действий по исправлению
Безопасность и конфиденциальность
- Без сбора данных: Весь анализ выполняется локально; только системная телеметрия отправляется в API Gemini
- Безопасность API-ключа: Ключи хранятся локально и никогда не передаются в систему контроля версий
- Прозрачность администратора: Пользователь должен явно одобрить все скрипты исправления
- Без разрушений: Никакого удаления файлов или изменения реестра без согласия пользователя
- Открытый исходный код: Полный исходный код доступен для аудита безопасности
См. SECURITY.md для подробной информации по безопасности.
Устранение неполадок
Ошибка "API Key Invalid"
- Проверьте, что ключ API корректен и активен
- Проверьте наличие скрытых символов или пробелов
- Убедитесь, что у ключа включен доступ к Gemini API
- Перегенерируйте ключ на https://makersuite.google.com/app/apikey
Ошибка "Not Running as Administrator"
- Щелкните правой кнопкой по исполняемому файлу и выберите "Запуск от имени администратора"
- Или разрешите запрос UAC при автоматическом повышении прав инструмента
Ошибка "Module Not Found" (версия Python)
pip install --upgrade psutil google-generativeai rich
Скрипт PowerShell не работает
- Убедитесь, что используется Windows PowerShell 5.1 или новее
- Проверьте, что политика выполнения разрешает выполнение скриптов
- Просмотрите скрипт в
AI_Reports/remediation.ps1 на предмет ошибок
Сборка из исходного кода
Автоматическая сборка (рекомендуется)
Проект использует GitHub Actions для автоматической сборки исполняемых файлов Windows при отправке тега версии:
- Отправьте изменения в ветку main
- Создайте и отправьте тег версии:
git tag -a v1.0.2 -m "Примечания к релизу" && git push origin v1.0.2
- GitHub Actions автоматически соберет .exe и создаст релиз
- Загрузите со страницы релизов
См. RELEASE_PROCESS.md для подробных инструкций.
Ручная сборка (для тестирования)
На Windows:
pip install pyinstaller
pip install -r requirements.txt
python build.py
Это создаст dist/SuperDiagnosticTool.exe со встроенной иконкой и зависимостями.
Примечание: Если вы видите предупреждение "Windows защитила ваш компьютер", прочитайте TRUST_GUIDE.md для быстрого исправления или постоянной регистрации приложения в белом списке.
Примечание: Сборка на Linux/Mac создаст бинарные файлы для этой платформы, а не .exe для Windows. Используйте GitHub Actions для официальных релизов Windows.
Структура файлов
SuperDiagnosticTool/
├── super_diagnose_v2.py # Основной диагностический скрипт
├── build.py # Скрипт сборки EXE
├── icon.ico # Иконка приложения
├── .github/workflows/ # Рабочие процессы GitHub Actions
│ └── release.yml # Автоматическая сборка и релиз
├── docs/
│ ├── icon.png # Иконка для README
│ └── screenshot_main.png # Скриншот главного интерфейса
├── src/ # Исходные модули
│ ├── safety/ # Модули безопасности и валидации
│ └── security/ # Функции безопасности
├── AI_Reports/ # Сгенерированные HTML-отчеты
├── README.md # Этот файл
├── RELEASE_PROCESS.md # Документация процесса релиза
├── LICENSE # Лицензия GPL-3.0
├── SECURITY.md # Документация по безопасности
└── .gitignore # Правила игнорирования Git
Отказ от ответственности
ВАЖНО: Предупреждение об изменении системы
Этот инструмент генерирует и выполняет скрипты PowerShell, которые изменяют системные службы, конфигурации и настройки. Хотя он разработан с принципами безопасности:
- Всегда проверяйте сгенерированный скрипт PowerShell перед выполнением
- Создайте резервную копию важных данных перед запуском автоматического исправления
- При возможности тестируйте на непродуктивных системах
- Понимайте, какие изменения вносятся в вашу систему
Автор не несет ответственности за любой ущерб системе, потерю данных или непредвиденные последствия, возникшие в результате использования этого инструмента. Используйте на свой страх и риск.
Вклад
Вклад приветствуется! Пожалуйста:
- Сделайте форк репозитория
- Создайте ветку для функции (
git checkout -b feature/improvement)
- Зафиксируйте изменения (
git commit -m 'Добавить улучшение')
- Отправьте ветку (
git push origin feature/improvement)
- Откройте запрос на слияние
Лицензия
Этот проект лицензирован под GNU General Public License v3.0 — подробности в файле LICENSE.
Copyright (C) 2026 GUETTAF HOUSSEM EDDINE
Автор
Knight
Студент электромеханики
Университет Аклы Моханда Ульхаджи, Буира, Алжир
Email: [email protected]
GitHub: @Guettaf-hossam
Благодарности
- Google Gemini AI за интеллектуальный анализ системы
- библиотека psutil для кроссплатформенного мониторинга системы
- библиотека Rich для красивого вывода в терминал
Версия 1.0 | Последнее обновление: январь 2026
Создано с преданностью дела Knight | Университет Аклы Моханда Ульхаджи
guettaf-hossam/superdiagnostictool
