Почтовый клиент — руководство пользователя

Что такое модуль «Email»

Модуль — встроенный почтовый клиент YoBench, объединяющий IMAP/SMTP и EWS (Exchange / Office 365) в одном интерфейсе. Несколько аккаунтов, папки, поиск, массовые действия и фоновая синхронизация — без необходимости держать отдельный Mail.app, Outlook или вкладку браузера.

Что вы получаете:

IMAP/SMTP для Gmail, Яндекса, собственных серверов — полный MIME через библиотеку ImapFlow + nodemailer.
EWS для Exchange и Office 365 — структурированные данные через ews-javascript-api, lazy-load вложений.
Rich-text композер — форматирование, ссылки, списки, инлайн-картинки и подписи, вложения через drag-and-drop.
Черновики — автосохранение во время написания. Продолжите неотправленное сообщение из папки Drafts с любого устройства, где подключён тот же аккаунт.
Undo send — настраиваемое окно после отправки, в течение которого письмо ещё можно отозвать до того, как оно покинет outbox.
Автодополнение контактов — поля to / cc / bcc подсказывают адреса из истории отправленных и полученных писем.
AI summarize и smart-reply — суммаризация длинной переписки в один клик и AI-черновики ответов через ваш AI-провайдер.
Бейдж непрочитанного на доке — суммарный счётчик на иконке приложения (macOS dock / Windows taskbar).
Несколько аккаунтов одновременно — каждый со своим состоянием синхронизации по папкам.
Папки с метаданными special_use, счётчиком непрочитанных, uid_validity.
Поиск — по теме, отправителю и preview через LIKE-запрос в БД.
Массовые действия — пометить прочитанным/непрочитанным, поднять флажок, переместить в папку, удалить — для произвольного набора писем.
Вложения — метаданные в БД, контент на диске; для EWS — загрузка по требованию.
Фоновый воркер — email-sync-worker с собственным WAL-подключением к БД, 30-минутным тайм-аутом и автоперезапуском при крэше.
Шифрование — пароли и OAuth-токены сохраняются зашифрованными.

Параметры аккаунта

При создании указываете:

Имя и email — отображаемые в списке аккаунтов.
Имя пользователя и Пароль — учётные данные.
Протокол — imap (по умолчанию) или ews.
Цвет — для визуальной идентификации в UI.

IMAP-параметры

IMAP host / port — для входящей.
SMTP host / port — для исходящей.
Use TLS — флаг шифрования.

EWS-параметры

EWS URL — адрес Exchange-сервиса.
Domain — домен Active Directory (опционально).
Auth type — password или oauth2.
OAuth provider — outlook или google.
OAuth tokens — access/refresh, обновляются автоматически.

Пароли и токены шифруются перед записью в БД.

Глобальные настройки

В Настройки → Email:

Включить почту (emailEnabled) — главный выключатель модуля.
Интервал синхронизации (минуты) (emailPollMinutes) — по умолчанию 15.
Параллельность (emailSyncConcurrency) — сколько аккаунтов опрашивается одновременно (по умолчанию 3).

Возможности UI

Sidebar аккаунтов — список аккаунтов с цветовыми метками и счётчиками непрочитанных.
Список папок — с особыми ярлыками (special_use: Inbox, Sent, Drafts, Trash, Junk, Archive).
Список писем — с темой, отправителем, preview, датой, флажками is_read, is_flagged, is_answered. Группировка по thread_id для цепочек.
Просмотрщик письма — HTML-рендер, список вложений, действия Reply / Reply All / Forward / Delete.
Композер — поля to / cc / bcc, тема, вложения, подпись.

Отправка

IMAP-аккаунты — отправка через nodemailer SMTP.
EWS-аккаунты — встроенный SendMail API.
В обоих случаях исходящее письмо сохраняется в папку Sent автоматически (с пустым provider_id для отслеживания локального origin).

Rich-text композер

Композер поддерживает заголовки, жирный / курсив, списки, ссылки, инлайн-картинки и подписи. Перетащите файл в редактор, чтобы прикрепить его; вставьте картинку из буфера обмена — она встроится в текст. Переключение между rich-text и plain-text — один тогл.

Черновики и undo send

Каждый композер автоматически сохраняет черновик по мере набора. В папке Drafts перечислены все неотправленные письма — кликните, чтобы продолжить редактирование. При отправке письмо удерживается в локальном outbox в течение настроенного окна Undo send (по умолчанию 5 секунд); клик Undo в этом окне возвращает композер с сохранёнными вложениями и адресатами.

Автодополнение контактов

Начните вводить адрес в to / cc / bcc — выпадающий список предложит адреса из писем, которые вы уже отправляли или получали. Недавно использованные адреса всплывают наверх.

AI summarize и smart-reply

В просмотрщике сообщения для длинной переписки появляется кнопка AI summary: один клик — и AI-провайдер возвращает краткий дайджест с ключевыми вопросами и решениями. Smart-reply генерирует два-три варианта ответа (acknowledge / commit / decline) на выбор — каждый черновик попадает в композер, где его можно отредактировать и отправить.

Обе функции используют провайдера из AI Chat. Если провайдер не настроен — кнопки неактивны.

Флоу использования

1. Подключите аккаунт

Откройте модуль Email в левом меню.
Нажмите Добавить аккаунт.
Выберите протокол (IMAP или EWS).
Заполните параметры.
Для EWS с OAuth — пройдите OAuth-флоу провайдера (Outlook / Google).
Сохраните. Первая синхронизация запустится автоматически.

2. Включите автосинхронизацию

В настройках включите Включить почту, задайте интервал и параллельность. Воркер начнёт опрашивать аккаунты в фоне.

3. Работайте с почтой

Читайте письма — клик по строке открывает просмотрщик.
Отвечайте или пересылайте через тулбар письма.
Помечайте флагом или прочитанным.
Перемещайте в папки или удаляйте.
Поиск — по строке темы, отправителя или preview.

4. Массовые действия

Выделите несколько писем чекбоксами → выберите действие в шапке списка (mark read / unread / flag / move / delete). Действия применяются и в локальной БД, и на сервере.

5. Управляйте аккаунтами

Изменить — поменять учётные данные или OAuth-токены.
Синхронизировать сейчас — принудительно опросить аккаунт.
Удалить — удаляет аккаунт и его локальную копию писем.

Что дальше

Подключите Календарь для отображения встреч из Exchange-аккаунтов.
Используйте AI-чат с RAG-контекстом для написания шаблонных ответов.
Для уведомлений модуль использует общие каналы YoBench (Telegram, email-исходящий).

Помощь и обратная связь

Хотели бы PGP, шифрование S/MIME или собственные правила автофильтрации? Напишите нам через форму обратной связи.