Priority Mail Agent

ОСТОРОЖНО! Код на 70%-80% написан LLM.

Плагин для Thunderbird, который автоматически определяет и управляет приоритетами писем с помощью LLM (Large Language Model).

Возможности

• 🤖 Автоматическое определение приоритета писем с помощью OpenAI-совместимого API
• 🏷️ Использование существующих меток Thunderbird "Приоритет X" (10-95 с шагом 5)
• ⚡ Фоновая обработка всех писем в inbox с rate limiting (1 запрос в 5 минут)
• 📝 Настраиваемый системный промт для LLM
• 🔄 Функция "Отложить письмо" в контекстном меню (понижает приоритет)
• 🔧 Удобный интерфейс настроек

Установка

Предварительные требования

• Thunderbird 115.0 или выше
• Node.js 18+ и npm

Сборка плагина

1. Установите зависимости:

2. ОБЯЗАТЕЛЬНО соберите плагин:

Это создаст директорию

со всеми скомпилированными файлами.

3. Для разработки с автоматической пересборкой:

Установка в Thunderbird

Для разработки (временная установка)

1. Откройте Thunderbird
2. Откройте
   about:debugging#/runtime/this-thunderbird
   или Tools → Developer Tools → Debug Add-ons
3. Нажмите "Load Temporary Add-on"
4. Выберите файл
   manifest.json
   из директории
   dist/
   (не из корня!)

Постоянная установка

1. Создайте .xpi пакет:
   npm run package
2. Tools → Add-ons and Themes → шестеренка → Install Add-on From File
3. Выберите файл
   priority-mail-agent.xpi

Настройка

1. После установки откройте настройки плагина
2. Заполните обязательные поля:
   • LLM API URL: URL эндпоинта OpenAI-совместимого API
   • API Key: Ваш API ключ для аутентификации
   • System Prompt: Инструкции для LLM (по умолчанию уже заполнено)
3. Опционально укажите CORS Proxy URL если требуется

Создание меток приоритета

Перед использованием плагина создайте метки в Thunderbird:

1. Откройте Thunderbird → Settings → General → Tags
2. Создайте метки с названиями:
   Приоритет_10
   ,
   Приоритет_15
   ,
   Приоритет_20
   , и т.д. до
   Приоритет_95
3. Назначьте им разные цвета для визуального различия (Опционально)

Использование

Автоматическая обработка

Плагин автоматически:

• Загружает все письма из inbox при запуске
• Обрабатывает их по очереди (от старых к новым)
• Соблюдает rate limit: 1 запрос каждые 10 секунд
• Присваивает/обновляет метки приоритета на основе анализа LLM

Ручное управление

Используйте контекстное меню письма:

• Отложить письмо: Понижает приоритет письма на один шаг (например, с 50 до 45)
  • Также доступно через горячую клавишу: Ctrl + Alt + L

Технологии

• TypeScript - строгая типизация
• React 18 - UI настроек
• Vite - быстрая сборка
• Thunderbird WebExtension API - интеграция с почтовым клиентом

Разработка

Структура данных

Приоритеты: 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95

LLM Integration

Плагин использует OpenAI function calling (tools) для структурированного получения приоритетов:

Лицензия

Лицензия GitVerse 1.0