Перейти к основному содержанию

Расширение AI Guard

AI Guard — это предустановленное расширение для обнаружения изображений Klipper в FLYOS-FAST v1.4.0, которое может периодически считывать изображение с камеры и пытаться распознать такие аномалии печати, как спагетти и образование нитей.

Тестовая функция, чрезвычайно высокий риск сбоя печати

AI Guard непрерывно получает изображения с камеры и выполняет локальный вывод AI, что заметно увеличивает нагрузку на CPU, память и хранилище. Как только нагрузка на систему становится слишком высокой, с очень высокой вероятностью возникают нарушения планирования Klipper, прерывание связи с MCU или прямой сбой задачи печати.

  • Не включайте во время официальной печати, длительной печати, печати без присмотра или печати важных моделей.
  • Используйте только в кратковременных тестах, которые можно остановить в любой момент, и постоянно следите за нагрузкой на систему и журналами Klipper.
  • Обнаружение AI может давать ложные срабатывания или пропуски, оно не может заменить ручной мониторинг и не может служить механизмом безопасности принтера.

Версия и состояние по умолчанию​

  • Доступно только в FLYOS-FAST v1.4.0.
  • В системе предустановлены расширение fly_ai_guard, файлы моделей и пример fly-ai.cfg.
  • По умолчанию в printer.cfg не загружается fly-ai.cfg, поэтому AI Guard по умолчанию не работает.

Подготовка перед включением​

  1. Сначала убедитесь, что адрес снимка с камеры возвращает корректное изображение.
  2. Убедитесь, что принтер в данный момент не выполняет задание печати.
  3. Сделайте резервные копии printer.cfg и fly-ai.cfg.
  4. Используйте top, чтобы зафиксировать нагрузку на систему до включения AI Guard, это будет базовым значением для сравнения.

Справочная конфигурация​

Пример файла в образе находится по адресу:

/usr/share/printer_data/config/fly-ai.cfg

При использовании GoCam можно ориентироваться на:

[fly_ai_guard]
camera: http://127.0.0.1:8080/snapshot
cpu_affinity: 0,1,2
spaghetti_threshold: 0.5
stringing_threshold: 0.5
interval_time: 10.0
discover_count: 1
print_only: True
pause_on_discover: False
discover_gcode:
    M118 AI检测触发
ПараметрЗначение по умолчанию в образе v1.4.0Описание
camerahttp://127.0.0.1/webcam/?action=snapshotАдрес снимка с камеры для AI Guard; при использовании GoCam измените на http://127.0.0.1:8080/snapshot
cpu_affinity0,1,2Номера ядер CPU, разрешенных для рабочего процесса ИИ
spaghetti_threshold0.5Порог уверенности для обнаружения «спагетти»
stringing_threshold0.5Порог уверенности для обнаружения «паутины» (нитей)
interval_time10.0Интервал между двумя проверками, в секундах
discover_count1Сколько последовательных срабатываний требуется для запуска события аномалии
print_onlyTrueПри значении True детекция выполняется только в состоянии печати
pause_on_discoverFalseПриостанавливать ли печать после достижения количества срабатываний
discover_gcodeM118 AI检测触发G-code, выполняемый при достижении условия срабатывания
Сохраняйте консервативные параметры
  • При первом тестировании оставьте pause_on_discover: False, чтобы избежать немедленной паузы печати из-за ложного срабатывания.
  • Не сокращайте сильно interval_time для увеличения скорости реакции: чем чаще проверки, тем выше нагрузка на систему.
  • Не снижайте пороги детекции и не включайте автоматическую паузу только по результатам одного теста.

Включение расширения​

Добавьте в printer.cfg:

[include fly-ai.cfg]

Сохраните и перезапустите Klipper. Во время первого теста не начинайте печать; сначала запустите через SSH:

top

Одновременно просматривайте журнал Klipper:

tail -f /usr/share/printer_data/logs/klippy.log

Если появляется постоянная высокая нагрузка, нарушения планировщика Klipper, потеря связи с MCU, сбои получения кадров с камеры или повторные перезапуски AI worker, немедленно отключите AI Guard.

Отключение расширения​

Удалите или закомментируйте в printer.cfg:

[include fly-ai.cfg]

Затем перезапустите Klipper. Изменение только pause_on_discover не отключает ИИ-анализ; чтобы остановить потребление ресурсов, необходимо полностью прекратить загрузку всего блока конфигурации [fly_ai_guard].

Известные ограничения​

  • Это тестовая функция версии v1.4.0; точность распознавания и долгосрочная стабильность ещё не проверены.
  • Нагрузка на推理 будет суммироваться с KlipperScreen, камерой, лапс-таймом, удалённым агентом и другими плагинами.
  • Отсутствие сигнала камеры, неверный адрес снимка или тайм-аут сетевого получения изображения повлияют на обнаружение.
  • В текущем примере автоматическая пауза не включена по умолчанию; после включения она всё ещё может прерывать нормальную печать из-за ложных срабатываний.
  • При слишком высокой системной нагрузке сам AI Guard и управление печатью могут перестать работать.
Loading...