Многопочтовый режим
Несколько IMAP-аккаунтов с отдельным healthcheck по каждому ящику. Не игрушка «для одного inbox» — полноценный многоконтурный сценарий.
[INFO] // реальные особенности · без маркетингового глянца
22 реальные особенности LetterBot
Список составлен на основе реального кода, логов и поведения системы — не рекламных обещаний. Каждый пункт подтверждён наблюдаемым поведением.
[WARN] // многоаккаунтность и запуск
Инфраструктура запуска
IMAP healthcheck на старте
Отдельный mail_account_healthcheck и статусы по каждому аккаунту до первого письма. Разница между «бот молчит» и «канал жив».
Автобутстрап конфигов
Если config.ini или accounts.ini отсутствуют — система не падает молча, а показывает шаблон и Windows-команду. Первый запуск за 15 минут.
SQLite — локальный state
Хранилище data/mailbot.sqlite на диске пользователя. Реальный локальный state, а не обязательная зависимость от облачного backend.
Политика первого запуска
first_run_detected, bootstrap_window_hours, allow_prestart_emails=false. Бот не заспамит Telegram старыми письмами при старте.
Backoff для проблемных ящиков
next_retry_at, backoff_minutes, cooldown_reason. Управляемый backoff вместо бесконечного долбления сервера.
[INFO] // обработка писем
Ingestion и анализ
Дедупликация писем
duplicate_ingest_skipped. Почта — грязный транспорт, дубликаты там норма. Зрелая ingestion-логика обрабатывает каждое письмо ровно один раз.
Извлечение данных из вложений
Excel extraction: 1405 chars — текст из XLSX без Microsoft Office. PDF тоже извлекается. Содержимое вложений участвует в расчёте приоритета.
Сегментация тела письма
quoted_removed, signature_removed, disclaimer_removed, forwarded_removed. Смысловой main body — без шума.
[WARN] // приоритизация
Priority v2: объяснимый скоринг
Priority v2 с reason codes
priority_v2_computed — score, финальный приоритет и список причин: PRIO_AMOUNT_BASE, PRIO_DEADLINE_1D, PRIO_FREQ_SPIKE_3X. Не магия, а скоринг.
Shadow Priority Engine
Параллельный движок качества: shadow_accuracy, ShadowPriorityEngine. Система оценивает альтернативный контур решений для повышения качества.
Quality Gates
allow_auto_priority=false до выполнения условий качества. Система не включает автодействия, пока не уверена. «Не сделать» лучше «сделать плохо».
Контур обучения
corrections_total, quality_metrics_computed, preview_accept_rate. Ручные исправления → обучающий сигнал → адаптация. Контролируемый feedback loop.
[ERR] // надёжность
Graceful degradation и Telegram
DEGRADED_NO_LLM режим
Нет LLM — явный переход в DEGRADED_NO_LLM. Список: что отключено, что активно. Уведомление пользователю. Не притворяется зелёным.
Telegram — двусторонний UX
Постоянный telegram_inbound_polled/processed. Не просто отправка — полноценная двусторонняя операционная поверхность.
Снуз с памятью контекста
2 часа, завтра, следующая неделя. При возврате — полный контекст: тип письма, приоритет, действие, время получения. Не просто будильник.
[OK] // наблюдаемость
Observability и дайджесты
SLA доставки
notification_sla_degraded с причинами: delivery_rate_below_slo, latency_p90_exceeds_slo. Доставка сама — объект мониторинга.
Daily и Weekly дайджесты
Дедупликация по chat_id между аккаунтами. Один чат — один дайджест. Дублирования нет даже при нескольких ящиках.
Контур «отношений»
relationship_health_computed, trust_score_updated, insight_digest_built. Долгосрочная модель взаимодействий с контрагентами.
Doctor / диагностика
/doctor в web cockpit и CLI. Продукт умеет диагностировать сам себя и честно показывать состояние.
Локальный web cockpit
Read-only панель на localhost:8787: dashboard, archive, health, events, doctor, commitments. Не подключается к интернету.
Отслеживание обязательств
Детектирует «пришлю к пятнице», «подтвердите до понедельника». Ваши обязательства — в еженедельном дайджесте.
Проверьте каждую особенность в коде
Весь исходный код открыт на GitHub под лицензией AGPL-3.0. Ни один пункт из списка не надо принимать на веру.