mutt/README.md

39 lines
3.3 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.

# 📬 Проект Mutt: Email-to-AI Pipeline (NotebookLM)
## 🎯 Назначение проекта
Проект предназначен для автоматизированного сбора, фильтрации и преобразования электронной переписки в формат, пригодный для глубокого анализа искусственным интеллектом в **NotebookLM**.
Основная цель: поддерживать актуальный «цифровой слепок» всей важной переписки (госуслуги, суды, ЖКХ) в виде единого PDF-файла, который AI использует как базу знаний.
## ⚙️ Как это работает
Процесс разбит на две основные стадии:
1. **Экспорт (`export_emails.py`):**
* Подключается к Gmail через IMAP.
* Сканирует почту начиная с заданной даты (`SINCE_DATE`).
* Фильтрует письма по списку доменов (`DOMAINS`).
* Конвертирует каждое письмо и все его вложения (картинки, документы, PDF) в индивидуальные PDF-файлы.
2. **Консолидация (`consolidate_to_mega_pdf.py`):**
* Собирает все индивидуальные PDF из папки `exported_emails/all/`.
* Сортирует их хронологически по именам файлов.
* Склеивает их в один монолитный файл `ALL_EMAILS_CONSOLIDATED.pdf`.
## 🤖 Автоматизация
Запуск настроен через системный планировщик **Cron**.
Каждый день в **04:00 утра** выполняется последовательность команд:
```bash
0 4 * * * /usr/bin/python3 export_emails.py && /usr/bin/python3 consolidate_to_mega_pdf.py
```
Это гарантирует, что к началу рабочего дня у вас всегда есть свежий сводный файл.
## 🛠 Настройки
* **Креденциалы (Gmail IMAP):** Берутся из файла `~/.muttrc` (параметры `imap_user` и `imap_pass`).
* **Фильтры доменов и Дата:** Настраиваются в начале скрипта `export_emails.py` (переменные `DOMAINS` и `SINCE_DATE`).
* **Уведомления (Telegram):** Токен бота и ID чата прописаны в `consolidate_to_mega_pdf.py`. Используется прокси `localhost:10808`.
## 🏁 Итоговый результат
По завершении работы в корне проекта обновляется файл **`ALL_EMAILS_CONSOLIDATED.pdf`**.
Этот файл необходимо загрузить в Google Drive (в папку, которая является источником для NotebookLM).
Сразу после обновления файла бот **@lkmthreeseven_bot** отправляет уведомление в Telegram с отчетом о количестве обработанных писем.
---
*by MatrixHasYou & Gemini CLI | 2026-04-29*