Решение проблем¶

Принцип Fluxion — Zero Silence: ни одна функция не деградирует молча. Если что-то недоступно, вы увидите баннер с причиной, а кнопка «Состояние» внизу справа откроет диагностику с рецептом починки и кнопками «Перепроверить» / «Исправить».

Диагностика в приложении¶

Кнопка «Состояние» показывает состояние каждой подсистемы:

Проверка	Что значит
Движок	Встроенный движок загружается
Модель	Файл модели на месте и читается
Docker (опционально)	Нужен только для расширенного веб-поиска
Веб-поиск	Встроенный работает всегда; расширенный — если включён SearXNG и он отвечает
Индекс проекта (RAG)	В индексе есть чанки

Кейсы¶

Модель не найдена¶

Диагностика: «GGUF не найден: <путь>».

Нажмите «Исправить» — мастер скачает модель из каталога с прогресс-баром и докачкой при обрыве.
Либо откройте страницу «Модели» и скачайте/импортируйте GGUF, затем «Перепроверить».
Свой файл модели (GGUF): «Модели» → «Импорт с диска…».

Веб-поиск не находит ничего¶

По умолчанию работает встроенный поиск через DuckDuckGo: ему нужен только интернет. Проверьте подключение и повторите запрос.

Расширенный поиск (SearXNG) не включается¶

Расширенный поиск включается вручную: меню Правка → «Расширенный веб-поиск (SearXNG в Docker)». Ему нужен Docker Desktop.

Docker Desktop не установлен — установите его с docker.com или кнопкой «Установить автоматически» в мастере настройки (winget).
Docker Desktop установлен, но не запущен — при включении расширенного поиска Fluxion запустит его сам и дождётся движка; после первой установки Docker может потребоваться перезагрузка (WSL2).
Пока SearXNG не отвечает, запросы выполняет встроенный поиск — функция не пропадает.

Docker установлен, но «демон не запущен»¶

Это важно только для расширенного поиска. Нажмите «Исправить» — Fluxion запустит Docker Desktop и дождётся движка. Если Docker после установки требует перезагрузку (WSL2) — перезагрузите компьютер и нажмите «Перепроверить».

Агент и git¶

Кнопка «Git: …» в «⚙ Настройки чата» на странице «Чат» управляет git-инструментами агента:

«Git: репозиторий» — агент может вызывать git_status / git_diff / git_commit и делает снимок рабочей папки перед первой правкой файлов (незакоммиченные изменения не трогаются, правки можно откатить).
«Git: нет репозитория» — кнопка предложит инициализировать репозиторий (git init + первый коммит) или работать без git (инструменты отключаются, «поиск репозитория» прекращается).
«Git: выключен» — кнопка предлагает включить инструменты обратно.

Индекс пуст (RAG)¶

Диагностика: «индекс пуст». Чат отвечает, но без контекста проекта.

Откройте страницу «Проект», выберите папку и нажмите «Проиндексировать».
Первая индексация скачивает модель эмбеддингов — это может занять время.

«Движок не подключён»¶

Нет скачанной модели: откройте Модели → «Скачать и выбрать модели…» (Ctrl+M) и скачайте модель. При запуске из исходников запускайте программу штатно: python -m desktop_browser или fluxion-desktop.bat.

Обучение (QLoRA)¶

«Окружение обучения не найдено»¶

Нажмите «Установить окружение обучения» на странице «Обучение»: программа проверит Python 3.12 и развернёт venv (несколько ГБ: torch, unsloth, peft, trl).

Python 3.12 не найден — программа предложит установить его автоматически через winget (для текущего пользователя, без прав администратора, нужен интернет) или установите Python 3.11/3.12 вручную и повторите.
Окружение докачивается из интернета; CUDA-стек занимает несколько ГБ.

«PyTorch без поддержки CUDA» / «Unsloth cannot find any torch accelerator»¶

В окружении стоит PyTorch без поддержки видеокарты (так ставили версии до 0.12.3). Нажмите «Переустановить окружение» на странице «Обучение» под строкой «Окружение обучения: готово»: окружение удалится и поставится заново со сборкой PyTorch для CUDA. Если после переустановки программа пишет, что PyTorch не видит видеокарту, обновите драйвер NVIDIA и перезагрузите компьютер.

Обученная модель не появилась в списке моделей¶

Флажок «Собрать готовую модель для чата (GGUF)» в «Дополнительных настройках» требует сборки llama.cpp: переменная окружения LLAMA_CPP_DIR должна указывать на её папку (под флажком программа подсказывает, найдена ли она). Без неё обучение заканчивается адаптером LoRA и объединённой моделью, а готовая модель не собирается. Задайте LLAMA_CPP_DIR и запустите обучение снова — модель появится в списке «Модель» в чате (подробнее — руководство по дообучению).

Приложение упало¶

После сбоя программа пишет лог %LOCALAPPDATA%\Fluxion\data\logs\crash-<дата>-<время>.log (в портативной версии — data\logs рядом с программой) и показывает окно с кнопками «Копировать отчёт», «Отправить по email» и «Открыть папку логов». Сама программа ничего не отправляет.

Не нашли свой случай? См. FAQ или Инструкцию: у каждой страницы есть раздел «Если не получается».