# Книги: каталог, рекомендации и скачивание ## Что было и что стало Каталог Полины существовал отдельно: `polina-library.json` (181 книга, 45 серий, статусы «прочитано / доступно / ждём перевод / ждём выхода»), а книжный бот про него не знал и умел только искать ссылки. Скачивания не было вообще — только ссылки на страницы. Теперь бот работает с каталогом и умеет качать книги в библиотеку. ## Команды бота | Команда | Что делает | |---|---| | `/полина` | каталог: сколько прочитано, что доступно, что ждёт перевода/выхода | | `/похожие <книга>` | та же серия, следующий том, другие серии автора | | `/скачать <книга>` | скачивает fb2/epub в библиотеку | | `/find <книга>` | ищет везде (ЛитРес, OpenLibrary, archive.org, Флибуста, libgen) | | `/wanted` (`/дальше`) | что можно читать дальше | | `/lib <запрос>` | что уже есть в библиотеке | Работают и без слэша: «скачай …», «похожие …», «найди …». ### Пример ``` /похожие Мара и Морок 📚 Похожее на «Мара и Морок» — Лия Арден ✅ Прочитано в серии «Мара и Морок / Смерть и Тень»: • Мара и Морок • Мара и Морок. Особенная Тень • Мара и Морок. 500 лет назад • Мара и Морок. Графический роман. Том 1 ➡️ Следующая: Морана и Тень. Плетущая (🇷🇺 есть на русском) /скачать Морана и Тень. Плетущая ``` ## Как работает скачивание ``` /скачать «название» ├─ Флибуста-зеркало (flibusta.site / .club) │ поиск → страница книги → /b/{id}/fb2 или /epub │ ПРОВЕРКА: название должно совпасть, иначе пропуск ├─ libgen.li (резерв) │ поиск → ads.php → get.php?md5=…&key=… → файл ▼ /opt/books/ingest (папка автоимпорта Calibre-Web) ▼ Calibre-Web-Automated импортирует за 1–2 минуты ▼ Книга в библиотеке (books.buryans.ru), можно читать/скачать ``` Проверка названия обязательна: без неё Флибуста на запрос «Морана и Тень. Плетущая» отдала «Донбасский лабиринт». ## Полка Полины Создана полка **«Полина»** (user_id 3, `p.parshkova95@gmail.com`). На ней уже три книги: | Книга | Источник | |---|---| | Царство Проклятых | libgen | | Плетущая (Морана и Тень) | libgen | | Обсидиановый огонь | libgen | Как добавить ещё: `/скачать <следующая книга из /полина>`, после импорта книга попадает в библиотеку; на полку добавляется скриптом `ops/books/add_to_shelf.py`. ## Технические детали - Контейнер `book-bot` пересобран, добавлен монтаж `/opt/books/ingest:/ingest`. - Переменные: `CATALOG_JSON=/app/catalog/polina-library.json`, `INGEST_DIR=/ingest`, `VPN_PROXY=http://192.168.1.161:7890`. - Скачивание идёт через VPN-прокси (CT161), прямого интернета у CT нет. - Статусы берутся из `series[].personal_status` и `series[].next`: `available_unread`, `waiting_ru`, `waiting_release`, `other_line_available`. ## Ловушки 1. **Флибуста без проверки названия** отдаёт случайную книгу — обязательна сверка заголовка (`title_matches`). 2. **`order` — зарезервированное слово** в SQLite: `insert into book_shelf_link (book_id,"order",shelf,…)`. 3. **`calibredb remove` в контейнере молчит** — удаление делать через `metadata.db` + удаление папки книги. 4. **CWA импортирует сам** — файл из `/ingest` исчезает, это нормально. ## Следующее - `/полина` → кнопка «скачать всё доступное» (пакетно). - Отправка книги на Kindle/OPDS-ссылкой в Matrix. - Автоуведомление, когда выходит переведённая книга из «ждём перевода».