Files
buryan-infra/ops/books/BOOKS.md
T
buryan-agent 1b6847822c Книги: бот знает каталог Полины, советует похожие и качает в библиотеку
Каталог polina-library.json (181 книга, 45 серий, статусы серий) теперь
используется ботом. Добавлены команды: /полина (что читать дальше, что ждёт
перевода или выхода), /похожие (та же серия, следующий том, другие серии
автора), /скачать (Флибуста-зеркало и libgen, с проверкой совпадения названия).

Скачанное кладётся в /opt/books/ingest — Calibre-Web-Automated импортирует
сам. Для Полины создана полка «Полина» и на неё добавлены три книги
(Царство Проклятых, Плетущая, Обсидиановый огонь).

Ловушки: без сверки названия Флибуста отдаёт случайную книгу; order —
зарезервированное слово в SQLite; calibredb remove в контейнере молчит,
удалять через metadata.db.
2026-10-21 11:48:40 +03:00

101 lines
5.0 KiB
Markdown

# Книги: каталог, рекомендации и скачивание
## Что было и что стало
Каталог Полины существовал отдельно: `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.
- Автоуведомление, когда выходит переведённая книга из «ждём перевода».