Генератор family_digest.py собирает контент (книги Calibre, медиа только с файлами, фото Immich, документы Paperless) и человеческие анонсы из ops/product/WHATS-NEW.md. Если нового нет — молчит. Таймер hub-digest.timer: ежедневно 12:00. Команда бота: !новости / !дайджест / !что нового (обработчик учитывает, что бот разбирает команду по первому слову). Ловушки: pct exec с длинным python -c ломается на кавычках (запрос вынесен в calibre_query.py внутри CT); медиа без файлов не считается новым.
74 lines
3.1 KiB
Markdown
74 lines
3.1 KiB
Markdown
# Дайджест «Что нового»
|
||
|
||
## Зачем
|
||
|
||
Системный шум (диски, контейнеры, проценты) нужен только администратору.
|
||
Остальным — **что появилось полезного** и **как этим пользоваться**.
|
||
|
||
## Правила
|
||
|
||
| Правило | Значение |
|
||
|---|---|
|
||
| Когда | **каждый день в 12:00** |
|
||
| Если нового нет | **не отправляется вообще** |
|
||
| Что считается новым | книги, фильмы/сериалы **с файлами**, фото, документы, новые функции |
|
||
| Куда | личный чат владельца в Matrix |
|
||
| Проверить вручную | `!новости`, `!дайджест`, `!что нового` |
|
||
|
||
## Откуда берётся
|
||
|
||
| Источник | Как |
|
||
|---|---|
|
||
| Книги | `metadata.db` Calibre: книги, добавленные за период |
|
||
| Медиа | Radarr/Sonarr: только записи **с файлами** (мониторинг без файла — не контент) |
|
||
| Фото | Immich: число новых снимков |
|
||
| Документы | Paperless: новые документы |
|
||
| Новые функции | `ops/product/WHATS-NEW.md` — человеческие анонсы |
|
||
|
||
## Формат
|
||
|
||
```
|
||
📰 Что нового в Buryans Hub
|
||
21.10.2026
|
||
|
||
📚 Книги (3):
|
||
• Обсидиановый огонь
|
||
• Плетущая
|
||
• Царство Проклятых
|
||
|
||
🆕 Новые возможности
|
||
• Книжный бот советует и скачивает
|
||
/полина, /похожие, /скачать
|
||
```
|
||
|
||
## Как добавить анонс
|
||
|
||
В `ops/product/WHATS-NEW.md`:
|
||
|
||
```markdown
|
||
## 2026-10-21 — Название возможности
|
||
|
||
Что появилось и как этим пользоваться (2–4 строки).
|
||
```
|
||
|
||
Дайджест сам подхватит запись за нужный период.
|
||
|
||
## Технически
|
||
|
||
| Компонент | Где |
|
||
|---|---|
|
||
| Генератор | `/opt/hub-core/family_digest.py` |
|
||
| Запрос книг | `/root/calibre_query.py` внутри CT111 |
|
||
| Таймер | `hub-digest.timer`, `OnCalendar=*-*-* 12:00:00` |
|
||
| Служба | `hub-digest.service` (oneshot) |
|
||
| Команда бота | `!новости` / `!дайджест` / `!что нового` |
|
||
|
||
## Ловушки
|
||
|
||
1. **`pct exec … python3 -c` с длинным кодом** ломается на кавычках —
|
||
поэтому запрос книг вынесен в отдельный файл внутри CT.
|
||
2. **Команды бота односложные**: `!что нового` разбирается как
|
||
команда `что` + аргумент `нового`. Обработчик это учитывает.
|
||
3. **Медиа без файлов** не считается новым — иначе дайджест каждый день
|
||
сообщал бы о списке «добавлено в мониторинг».
|