Локальная работа и безопасность
Для кого: Для тех, кто хочет понять, каких данных касается приложение. Задача: Чётко разделить чтение, запись SQLite и изменение исходных файлов. Тип: Понятие
dj-track-similarity работает с локальными файлами и локальным состоянием. Обычные сценарии не требуют загружать аудио или теги во внешний сервис.
Локальное состояние
Приложение может создавать и обновлять:
- набор файлов SQLite схемы v7: выбранный Core
.sqlite, обязательный*.artifacts.sqliteи необязательный*.evaluation.sqlite; - журналы выполнения в
logs/; - экспортированные M3U и CSV;
- отчёты Audio Doctor и Audio Dedup в JSON, XLSX и журналах;
- файлы состояния Audio Doctor;
- необязательные вспомогательные индексы ANN;
- метки, предсказания, очереди, контрольные точки и артефакты Rhythm Lab;
- файлы опубликованных классификаторов.
Эти данные могут раскрывать локальные пути, теги, оценки и ваши решения при прослушивании. Не добавляйте их в Git без осознанного решения.
Операции, не изменяющие аудио
| Сценарий | Что записывается |
|---|---|
| Scan | строки треков и метаданные SQLite |
| Refresh Tags | метаданные SQLite существующих треков |
| Анализ | строки Core и строки в обязательной базе Artifacts для эмбеддингов, Timeline SONARA и отпечатков |
| Поиск и SET | обычно ничего; при обратной связи Hybrid — строки оценки |
| Предпросмотр в браузере | только временный WAV при необходимости перекодирования |
| Сброс | только записи Core и Artifacts; необязательные Evaluation обрабатываются отдельно, если есть |
| Очистка базы | только записи базы данных; исходное аудио не затрагивается |
| Предварительная проверка переноса | ничего |
| Применение переноса | только сохранённые пути SQLite |
| Экспорт | новый файл M3U или CSV |
| Расчёт оценок классификаторов | оценки классификаторов SQLite |
| Отметка «нравится» | только состояние в SQLite |
Операции с исходными файлами
Только три сценария могут записать или удалить исходное аудио:
- MAEST genre tag apply записывает стандартное поле жанра для треков с сохранёнными жанрами MAEST.
- Audio Doctor apply исправляет файлы после предварительной проверки и точного подтверждения
APPLY REPAIR. - Audio Dedup apply удаляет безопасные дубликаты после точного подтверждения
APPLY DELETE.
Перенос не перемещает файлы
Применение переноса обновляет сохранённый tracks.file_path в Core после проверки существования целей и отсутствия конфликтов. Оно не перемещает, не копирует, не удаляет и не изменяет теги файлов.
Граница набора файлов
Core и обязательная база Artifacts связаны одним catalog_uuid. Сохраняйте их вместе при резервном копировании, копировании или обслуживании. *.evaluation.sqlite, если он есть, хранит необязательные данные оценки. Исполняемая часть v7 не мигрирует базы v5/v6 и не восстанавливает старые структуры sidecar.
Адрес сервера
dj-sim serve --host 127.0.0.1 доступен только локально. Используйте 0.0.0.0 или run_server.cmd lan лишь тогда, когда намеренно разрешаете подключения с других устройств локальной сети.