Files
buryan-infra/ops/digest/DIGEST.md
T
buryan-agent a931175a30 Дайджест «Что нового»: ежедневно в 12:00, только если что-то появилось
Генератор family_digest.py собирает контент (книги Calibre, медиа только с
файлами, фото Immich, документы Paperless) и человеческие анонсы из
ops/product/WHATS-NEW.md. Если нового нет — молчит.

Таймер hub-digest.timer: ежедневно 12:00. Команда бота: !новости / !дайджест /
!что нового (обработчик учитывает, что бот разбирает команду по первому слову).

Ловушки: pct exec с длинным python -c ломается на кавычках (запрос вынесен в
calibre_query.py внутри CT); медиа без файлов не считается новым.
2026-10-21 12:34:57 +03:00

74 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Дайджест «Что нового»
## Зачем
Системный шум (диски, контейнеры, проценты) нужен только администратору.
Остальным — **что появилось полезного** и **как этим пользоваться**.
## Правила
| Правило | Значение |
|---|---|
| Когда | **каждый день в 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. **Медиа без файлов** не считается новым — иначе дайджест каждый день
сообщал бы о списке «добавлено в мониторинг».