train_utility/.agents/PROJECT_ISSUES.md

Исправленные проблемы проекта YOLO Train TUI

Дата исправления и повторной проверки: 2026-07-17

Итог

Все 11 ранее зафиксированных дефектов исправлены и покрыты регрессионными проверками.

ID	Приоритет	Статус	Исправление
BUG-001	Критический	Исправлено	subprocess_runner.main() возвращает код, а SystemExit создаётся только снаружи обрабатывающего блока
BUG-002	Высокий	Исправлено	Перед каждым запуском prepare_run() сбрасывает состояние остановки
BUG-003	Высокий	Исправлено	Родитель отправляет кооперативный сигнал; принудительный kill() используется только после таймаута
BUG-004	Высокий	Исправлено	Запрос, сделанный до готовности subprocess, сохраняется и доставляется после маркера READY
BUG-005	Высокий	Исправлено	Detection-style авторазбиение запрещено для classify в UI и конфигурации
BUG-006	Средний	Исправлено	.yaml/.yml разбираются через yaml.safe_load(), поле names валидируется
BUG-007	Средний	Исправлено	Датасет с одним изображением отклоняется с понятной ошибкой
BUG-008	Средний	Исправлено	Изображения и метки ищутся рекурсивно с сохранением вложенных путей
BUG-009	Средний	Исправлено	Каждый результат создаётся в уникальном .yolo-tui/splits/<id> без перезаписи пользовательского split/
BUG-010	Низкий	Исправлено	Traceback выводится в журнал TUI; абсолютный путь другого пользователя удалён
BUG-011	Низкий	Исправлено	Явно указанный отсутствующий или некорректный файл классов вызывает точную ошибку без fallback

Жизненный цикл обучения

• Дочерний процесс устанавливает обработчики остановки и только затем печатает __YOLO_TUI_READY__.
• Если пользователь нажал «Остановить» раньше, родитель запоминает запрос и отправляет его после получения маркера готовности.
• Дочерний TrainingRunner устанавливает trainer.stop = True; Ultralytics останавливается между пакетами данных, затем выполняет штатную финализацию и завершающие callbacks.
• Если процесс не завершился за 30 секунд, используется принудительный fallback.
• После завершения ссылка на subprocess и таймер очищаются; перед следующим запуском флаг остановки сбрасывается.

Работа с датасетами

• Текущий splitter предназначен для задач detect, segment, pose и obb со структурой images/ + labels/.
• Для classify требуется готовый каталог с train/val и подкаталогами классов; несовместимый переключатель в UI отключён.
• Поддерживаются classes.txt, .yaml и .yml; YAML может хранить names как список или словарь с последовательными ID от 0.
• Явный путь к классам считается обязательным и не заменяется автопоиском при опечатке или ошибке формата.
• Split требует минимум два изображения и рекурсивно обрабатывает вложенные каталоги.
• Файлы каждого запуска создаются эксклюзивно в отдельном управляемом каталоге.

Проверка

Выполнены команды:

uv run pytest -q
uv run python -m compileall -q src tests
git diff --check

Результат: 38 passed; ошибок компиляции и форматирования diff нет.

Регрессионные тесты проверяют:

1. успешный и ошибочный коды subprocess_runner.main();
2. сброс остановки между запусками;
3. кооперативный сигнал вместо немедленного terminate();
4. доставку раннего запроса после готовности subprocess;
5. запрет авторазбиения для classify;
6. пользовательские YAML-файлы классов и ошибочный явный путь;
7. датасеты из одного и двух изображений;
8. вложенные изображения и метки;
9. сохранность пользовательского каталога split/ и уникальность результатов.