diff --git a/README.md b/README.md index 185db1e..e2eb026 100644 --- a/README.md +++ b/README.md @@ -35,11 +35,42 @@ python -m venv .venv вход на странице Яндекса, токен сохраняется в `.token` (локально, в `.gitignore`). 2. **`fetch`** — скачивает список лайкнутых треков и их метаданные (жанр альбома, доступность текста) в `cache/tracks.json`. Повторный запуск докачивает только новые треки. + **Ничего не меняет в аккаунте.** 3. **`report`** — определяет жанр (крупная группа) и язык (RU/иностранный) каждого трека, считает распределение по будущим плейлистам и сохраняет `out/report.csv` для проверки. **Ничего не меняет в аккаунте.** 4. **`apply --yes`** — создаёт недостающие плейлисты и добавляет в них треки. Уже добавленные треки не дублируются при повторном запуске. Лайки не трогает, ничего не удаляет. + **Меняет аккаунт** (создаёт плейлисты и добавляет треки). + +## Полная очистка кэша + +Если требуется начать с чистого листа (переполучить все данные с нуля), удалите папку `cache/`: + +``` +Remove-Item -Recurse -Force cache +``` + +Кэш состоит из трёх файлов: +- `cache/tracks.json` — список лайкнутых треков и их метаданные; +- `cache/genre_catalog.json` — снимок дерева жанров Яндекса на момент последнего запуска; +- `cache/lyrics_lang.json` — определённые языки текстов для каждого трека. + +Удаление `cache/` заставит `fetch` и `report` переполучить всё с нуля при следующем запуске. + +Также можно удалить сгенерированный отчёт: + +``` +Remove-Item -Recurse -Force out +``` + +Это просто результаты анализа, их удаление не повлияет на следующий запуск `report`. + +**Важно:** файл `.token` (OAuth-токен) не входит в кэш и не удаляется при очистке `cache/`. Очистка кэша вас не разлогирует. Если нужна повторная авторизация, удалите `.token` отдельно: + +``` +Remove-Item .token +``` ## Как определяется жанр и язык