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

Для кого: Пользователи, настраивающие пути, порты, сборки и каталоги создаваемых данных. Задача: Перечислить практические настройки текущего репозитория. Тип: Справочник

Переменные окружения

Переменная	Назначение
DJ_TRACK_SIMILARITY_FFMPEG	Полный путь к ffmpeg, если команда ffmpeg недоступна через PATH

Если переменная задана, но файл по пути отсутствует, запуск сервера завершается с понятной ошибкой.

Пути по умолчанию

Состояние	Путь по умолчанию или обычный путь
База по умолчанию для команд CLI, кроме сервера	dj-track-similarity.sqlite, если --db не указан
Начальная база serve	Не выбрана, если --db не указан
Пример базы проекта	.\data\library.sqlite
Предлагаемый путь интерактивного скрипта Windows	C:\db\volumes.sqlite
Журналы выполнения	logs/
Отчёты, состояние и резервные копии Audio Doctor	tools/audio-doctor/data/
Отчёты Audio Dedup	tools/audio-dedup/data/reports/
Метки Rhythm Lab	tools/rhythm-lab/data/rhythm_lab.sqlite
Артефакты Rhythm Lab	tools/rhythm-lab/artifacts/
Опубликованные классификаторы	models/classifiers/<artifact-prefix>/
Постоянные индексы ANN	.dj-track-similarity-indexes/ рядом с выбранной базой по умолчанию

Создаваемые локальные артефакты исключены из Git, если политика явно не требует обратного.

Активный журнал основного процесса — logs/dj-track-similarity.log. Если при запуске его первая записанная дата старше текущей, журналы проекта архивируются с суффиксом той даты, а приложение открывает новый активный файл. Сервер, работающий после полуночи, продолжает писать туда же до перезапуска.

Порты

Сервис	По умолчанию
Основное приложение и интерфейс	8765
Сервер разработки Vite	5173
Rhythm Lab	8777

До запуска ещё одного процесса проверьте, не занят ли фиксированный порт.

Команды сервера

Только локально:

dj-sim serve --host 127.0.0.1 --port 8765

Локальная сеть:

dj-sim serve --host 0.0.0.0 --port 8765

Скрипт Windows:

run_server.cmd

При запуске без аргументов скрипт показывает путь по умолчанию C:\db\volumes.sqlite, а затем запрашивает локальный режим или доступ из локальной сети. Подтверждённый путь передаётся только после завершения обоих запросов.

Для запуска без запросов выполните run_server.cmd local --db C:\db\volumes.sqlite или замените local на lan. Явные команды режима используют только переданные аргументы. Прямая команда dj-sim serve без --db по-прежнему не создаёт базу и ожидает выбора через API или диалог.

Команды сборки

Интерфейс:

cd frontend
npm install
npm run build

Документация:

cd docs\dj-track-similarity
npm install --no-package-lock
npm run vale:sync
npm run check

Маршрут /docs/ показывает понятное сообщение «Documentation is not built», если каталог docs/dj-track-similarity/site/ отсутствует.