expand CLI docs and add cache cleanup guide

This commit is contained in:
Andrew Pimenov 2026-07-06 10:13:24 +03:00
parent 942c2d19e4
commit 8c8b1eb12a

View file

@ -35,11 +35,42 @@ python -m venv .venv
вход на странице Яндекса, токен сохраняется в `.token` (локально, в `.gitignore`). вход на странице Яндекса, токен сохраняется в `.token` (локально, в `.gitignore`).
2. **`fetch`** — скачивает список лайкнутых треков и их метаданные (жанр альбома, доступность 2. **`fetch`** — скачивает список лайкнутых треков и их метаданные (жанр альбома, доступность
текста) в `cache/tracks.json`. Повторный запуск докачивает только новые треки. текста) в `cache/tracks.json`. Повторный запуск докачивает только новые треки.
**Ничего не меняет в аккаунте.**
3. **`report`** — определяет жанр (крупная группа) и язык (RU/иностранный) каждого трека, 3. **`report`** — определяет жанр (крупная группа) и язык (RU/иностранный) каждого трека,
считает распределение по будущим плейлистам и сохраняет `out/report.csv` для проверки. считает распределение по будущим плейлистам и сохраняет `out/report.csv` для проверки.
**Ничего не меняет в аккаунте.** **Ничего не меняет в аккаунте.**
4. **`apply --yes`** — создаёт недостающие плейлисты и добавляет в них треки. Уже добавленные 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
```
## Как определяется жанр и язык ## Как определяется жанр и язык