Skip to content

FAQ

Jump to bottom
mrSaT13 edited this page Mar 24, 2026 · 1 revision

❓ Частые вопросы (FAQ)

🔐 Подключение и сервер

❓ Почему не подключается к Navidrome?

Возможные причины:

  1. Неверный URL (проверьте http:// vs https://)
  2. Порт не открыт в брандмауэре
  3. Неправильные логин/пароль
  4. В Navidrome не включён Subsonic API

Решение:

# Проверьте доступность сервера:
curl -I http://ваш-сервер:4533

# Включите Subsonic API в Navidrome:
# Файл navidrome.toml:
SubsonicAPI.Enabled = true

❓ Можно ли использовать с Airsonic-Advanced?

✅ Да! KumaFlow совместим с любым сервером, поддерживающим Subsonic API 1.16.0+:

  • Navidrome ✅ | Subsonic ✅ | Airsonic-Advanced ✅ | Libresonic ✅

🤖 ML и рекомендации

❓ Сколько треков нужно для обучения?

🎯 Минимум: 10 лайкнутых треков
💡 Рекомендовано: 50+ треков для точных рекомендаций
⏱️ Время обучения: 2-5 минут после лайков

❓ Почему рекомендации не меняются?

Возможные причины:

  • Слишком мало данных (лайкните ещё треков)
  • Включён режим «Только локальная библиотека»
  • Модель требует сброса (редко)

Что делать:

  1. Лайкните 5-10 новых треков разных жанров
  2. Подождите 5 минут
  3. Проверьте Настройки → ИИ → Статистика

❓ Как работает Vibe Similarity?

1. Берётся референсный трек
2. Извлекаются 6 аудио-признаков (BPM, Energy, Danceability...)
3. Вычисляется «усреднённый вайб»
4. Ищутся треки с близкими значениями
5. Результаты фильтруются по бан-листу и истории
6. Оркестратор сортирует для плавных переходов

📚 Аудиокниги

❓ Почему книги не появляются в рекомендациях?

🚫 Это преднамеренное поведение. Аудиокниги:

  • Не влияют на ML-модель
  • Не попадают в Auto-DJ и Vibe Similarity
  • Не учитываются в статистике музыкальных предпочтений

Цель: не «загрязнять» музыкальные рекомендации книгами.

❓ Как синхронизировать прогресс чтения?

✅ Прогресс автосохраняется каждые 30 секунд на сервер Audiobookshelf.
🔁 При переключении устройств прогресс подтягивается автоматически.

🎨 Интерфейс и производительность

❓ Почему приложение тормозит?

Возможные решения:

1. Отключите анимации:
   Настройки → Внешний вид → ✅ Упрощённый режим

2. Очистите кэш:
   Настройки → Приватность → «Очистить кэш»

3. Обновите графические драйверы

4. Запустите с флагом (для старых ПК):
   kumaflow.exe --disable-gpu

❓ Как добавить свою тему?

  1. Создайте файл my-theme.css в папке тем: 
    %APPDATA%\kumaflow\themes\  (Windows)
~/Library/Application Support/kumaflow/themes/  (macOS)
~/.config/kumaflow/themes/  (Linux)
  2. Используйте CSS-переменные: 
    :root {
  --background-primary: #121212;
  --accent-color: #00ff9d;
}
  3. Перезапустите приложение или выберите тему в настройках.

🔧 Технические вопросы

❓ Где хранятся настройки?

Конфигурация:
• Windows: %APPDATA%\kumaflow\config.json
• macOS: ~/Library/Application Support/kumaflow/config.json
• Linux: ~/.config/kumaflow/config.json

ML-модель и кэш: в подпапке /data внутри указанной директории

❓ Как сделать бэкап?

1. Закройте KumaFlow
2. Скопируйте всю папку конфигурации
3. Для восстановления — замените папку после установки

💡 Альтернатива: Настройки → Приватность → Экспорт настроек

❓ Почему не работает автообновление?

Возможные причины:

  • Брандмауэр блокирует запросы к GitHub Releases
  • Антивирус блокирует загрузку .exe
  • Нестабильное интернет-соединение

Решение:

  1. Проверьте доступ к api.github.com
  2. Отключите временно антивирус для теста
  3. Скачайте обновление вручную из Releases

🙋 Не нашли ответ?

  • 🔍 Поищите в Issues
  • 💬 Спросите в Discussions
  • 🐛 Откройте новый Issue с меткой question

Мы стараемся отвечать в течение 48 часов! 🚀

Clone this wiki locally