[INFO] // прямые ответы · 37 вопросов · без воды

Часто задаваемые вопросы

Каждый ответ начинается с прямого ответа — в первом предложении. Доказательство — сразу после. Не нашли свой вопрос? Напишите на mss777@mail.ru

Что такое LetterBot?

LetterBot — это бесплатный локальный оператор почты для Windows. Подключается к вашим IMAP-ящикам, анализирует входящие письма, определяет приоритет и предложенное действие, отправляет короткое уведомление в Telegram. Всё работает на вашем компьютере — без серверов LetterBot.

Это ещё один почтовый клиент?

Нет. LetterBot не заменяет ваш почтовый клиент. Он добавляет поверх него слой умного triage: отбирает только то, что требует действия, и сигнализирует в Telegram. Ваш inbox остаётся как есть — LetterBot работает в IMAP read-only режиме.

Чем LetterBot отличается от Superhuman и Gmail AI?

Superhuman и Gmail AI — облачные сервисы: ваша почта обрабатывается на их серверах. LetterBot обрабатывает всё локально. Кроме того: LetterBot бесплатен, open source, использует Telegram как рабочий интерфейс и не требует OpenAI. Такого сочетания нигде больше нет при нулевой стоимости.

LetterBot — это продакшн-готовый продукт?

Да, для личного и малого бизнеса. Внутри — health checks, retry/backoff, SLA-метрики, graceful degradation, event model и observability cockpit. Не подходит для enterprise (SAML/SSO, compliance-сертификации, централизованного управления).

Письма уходят в облако?

По умолчанию — нет. LetterBot читает письма через IMAP с вашего почтового сервера, обрабатывает их локально и хранит метаданные в SQLite на вашем диске. Никаких серверов LetterBot не существует — некуда передавать данные.

Нужен ли OpenAI или ChatGPT?

Нет. OpenAI не поддерживается. По умолчанию LetterBot работает в детерминированном режиме без внешних AI. Опциональные провайдеры — GigaChat (Сбер) и Cloudflare Workers AI. Их подключение необязательно и не меняет базовую полезность.

Если я включу LLM — что именно отправляется?

Только текст тела письма (минимальный контекст для классификации). Содержимое вложений, полный raw email, адресная книга и история — не передаются. Вы сами контролируете, какой провайдер обрабатывает этот запрос по своей политике приватности.

Что хранится в локальной SQLite?

Метаданные: отправитель, тема, дата, тип письма, приоритет, источник приоритета, извлечённые сущности, состояние снуза, аналитика. Полные тела писем и содержимое вложений обрабатываются в памяти и не сохраняются.

Есть ли телеметрия?

Нет. Нулевая телеметрия. Единственные внешние соединения: ваш IMAP-сервер, Telegram Bot API и выбранный LLM-провайдер (если настроен). Проверить можно в исходном коде на GitHub.

Как удалить все данные LetterBot?

Удалите файл data/mailbot.sqlite или весь каталог проекта. Никаких облачных бэкапов, никаких запросов на удаление аккаунта — всё на вашей машине.

Какие почтовые провайдеры поддерживаются?

Любой IMAP-совместимый ящик: Яндекс.Почта (imap.yandex.ru), Mail.ru (imap.mail.ru), Gmail (imap.gmail.com с паролем приложения), корпоративный Exchange/Office 365, Outlook, FastMail, ProtonMail Bridge и любой другой IMAP-сервер.

Можно подключить несколько ящиков?

Да. Неограниченное количество IMAP-аккаунтов. Каждый маршрутизируется в отдельный Telegram-чат — рабочая почта в один чат, личная в другой, серверные алерты в отдельный канал. Дайджесты не дублируются между аккаунтами.

LetterBot модифицирует или удаляет письма?

Нет. LetterBot подключается в IMAP read-only режиме. Он никогда не удаляет, не перемещает, не помечает и не изменяет ни одного письма. Ваш inbox остаётся в точности как был.

Подходит ли для старого компьютера?

Да — это один из лучших сценариев. Протестировано на Intel Celeron N4020 (2 ядра, 1.1 ГГц) с 3 ГБ RAM. Старый ноутбук или запасной десктоп — отличный выделенный локальный почтовый ассистент.

Есть ли локальный web-интерфейс?

Да. Read-only observability cockpit на http://127.0.0.1:8787. Доступные маршруты: дашборд, архив писем, трейс AI-решений с кодами причин, состояние системы, SLA-метрики доставки (p90 latency, delivery rate, error rate), аналитика отправителей. Не подключается к интернету.

LetterBot читает PDF и Excel?

Да. Извлекает текст из PDF и Excel (.xlsx) без Microsoft Office. Содержимое вложений участвует в расчёте приоритета — счёт в PDF может автоматически получить Срочный приоритет.

Что происходит при отключении интернета?

LetterBot не может синхронизировать IMAP и доставлять Telegram-уведомления без интернета. Но он не падает — автоматически повторяет попытку при следующем опросе. Все локальные данные сохраняются.

Что происходит при недоступности LLM?

LetterBot автоматически переходит в DEGRADED_NO_LLM режим и продолжает отправлять базовые уведомления на основе детерминированного анализа. Вы получаете Telegram-уведомление о деградации. При восстановлении LLM — нормальный режим возобновляется автоматически.

Работает ли на Raspberry Pi или Linux?

Официально — только Windows 10/11. Технически возможно на Linux/Pi при наличии Python 3.10+. Пользователи сообщают об успехе на Pi 4 с 4 ГБ RAM. Поддержки нет — но можно открыть issue на GitHub.

Как работает приоритизация?

Детерминированный движок Priority v2: анализирует историю отправителя, тип письма (INVOICE, CONTRACT, SECURITY_ALERT…), ключевые слова дедлайна, тип вложения и частотные аномалии. Результат: Срочно / Важно / Низкий. Каждое решение содержит код причины — например PRIO_INVOICE или PRIO_DEADLINE_1D. Не чёрный ящик.

LetterBot учится на моих исправлениях?

Да. Когда вы нажимаете кнопку приоритета в Telegram, переопределяя решение системы, это записывается как сигнал коррекции. Со временем система адаптируется — какие отправители для вас срочные, каких вы регулярно понижаете. Контролируемый feedback loop, не магическое самообучение.

Как работает снуз с памятью?

Нажмите кнопку снуза (2 часа, завтра, следующая неделя) в Telegram. В назначенное время LetterBot вернёт письмо с полным контекстом: оригинальный отправитель, тема, тип письма, предложенное действие, время получения. Это не просто напоминание — контекст решения восстанавливается полностью.

Какие типы писем распознаёт LetterBot?

INVOICE (счёт), CONTRACT (договор), SECURITY_ALERT (уведомление безопасности), PRICE_LIST (прайс), NEWSLETTER, NOTIFICATION и другие. Классификация определяет базовый уровень приоритета и предложенное действие в Telegram-уведомлении.

Что такое отслеживание обязательств?

LetterBot обнаруживает фразы-обязательства в письмах: «пришлю к пятнице», «подтвердите до понедельника», «позвоню завтра». Они отслеживаются и выводятся в еженедельном дайджесте — кто что обещал, включая ваши исходящие обязательства.

Как выглядит Telegram-уведомление?

Одно письмо — одно сообщение. Структура: приоритет + тип письма · отправитель · тема · 2–3 строки саммари · предложенное действие · заметка о вложении (если есть) · кнопки приоритета · кнопки снуза. Нажатие кнопки приоритета обновляет хранимый приоритет и тренирует модель.

Что такое еженедельный дайджест?

Сводка каждый понедельник: всего обработанных писем, обнаруженные счета (с суммами), договоры на проверку, просроченные обязательства, silent-partner risks (контакты, переставшие отвечать) и ожидающие ответа письма. Дедупликация по chat_id — если у вас несколько ящиков в одном чате, дайджест приходит один раз.

Что такое ежедневный дайджест?

Ежедневная сводка в настроенное время: ключевые события за день, письма, требующие внимания, и статус обязательств. Дедупликация между аккаунтами — один чат получает один дайджест, даже если к нему привязано несколько ящиков.

Как установить LetterBot?

4 шага: 1. Скачать ZIP с GitHub Releases 2. Распаковать в удобное место 3. Заполнить accounts.ini — IMAP-данные и токен Telegram-бота 4. Запустить letterbot.bat — Python не нужен — dist включает runtime. Около 10–15 минут.

Нужно ли устанавливать Python?

Нет. One-folder Windows release включает Python runtime в дистрибутиве. Просто распакуйте и запустите letterbot.bat.

Как создать Telegram-бота?

Напишите @BotFather в Telegram, команда /newbot, следуйте инструкциям. Скопируйте токен в accounts.ini. Затем напишите вашему боту любое сообщение и получите chat_id через https://api.telegram.org/bot[TOKEN]/getUpdates.

Что такое 2-file config mode?

Вся конфигурация разделена на два INI-файла: settings.ini — общие параметры системы (интервал опроса, настройки дайджеста, параметры приоритизации), accounts.ini — секреты и аккаунты (IMAP-данные, токены). Проще разделять общие настройки и секреты.

Что делать, если конфиг не найден?

Система не падает молча. Автобутстрап определяет, каких файлов не хватает, и выводит список с точными командами для создания из шаблона. Порог первого запуска — минимальный.

Как диагностировать проблемы?

Три уровня диагностики: лог запуска с явными статусами, doctor в CLI и /doctor в локальном web cockpit (127.0.0.1:8787/doctor). Показывает состояние всех систем, конфигурацию, здоровье ящиков и качество решений.

Нужна ли подписка?

Нет. LetterBot бесплатен навсегда. AGPL-3.0 open source. Без freemium, без платных планов, без триала. Разработка поддерживается добровольными донатами через Boosty — без коммерческих целей.

LetterBot когда-нибудь станет платным?

Нет. LetterBot задуман как постоянно бесплатное open source ПО. Разработка финансируется добровольными донатами. AGPL-3.0 лицензия гарантирует, что исходный код всегда будет открытым.

Что такое AGPL-3.0?

GNU Affero General Public License версии 3. Вы можете читать, модифицировать и распространять код. Условие: модифицированные версии, оказывающие услуги по сети, обязаны публиковать исходный код. Подробности — на сайте GNU.

Как поддержать проект?

Добровольный донат через Boosty. Или звезда на GitHub. Или сообщение об ошибке в Issues. Или рекомендация коллегам. Всё это помогает проекту развиваться.

Не нашли ответ?

Напишите на mss777@mail.ru или в Telegram-канал