Преобразуйте повторяющуюся организацию папок Gmail в обзорный, детерминированный рабочий процесс.

Gmail Inbox Triage & Labeler — это локальная утилита на Python для фрилансеров, операторов, создателей и небольших команд, которые хотят организовать повторяющиеся письма с явными правилами и намеренным этапом проверки перед любыми изменениями ярлыков.

Рабочий процесс намеренно двухступенчатый:

PLAN -> REVIEW -> APPLY

Этап планирования читает Gmail и генерирует локальный CSV-план. Вы просматриваете предлагаемые действия. Только после этого этап применения запрашивает более широкое разрешение Gmail и добавляет утвержденные ярлыки SOFL.

ЧТО ЭТО ДЕЛАЕТ

- Читает сообщения Gmail через официальный Gmail API.

- Использует предоставляемый вами поисковой запрос Gmail.

- Разрешает идентификаторы ярлыков Gmail в названия ярлыков, чтобы ранее триажированные сообщения SOFL корректно распознавались.

- Применяет детерминированные правила JSON для повторяющихся категорий, таких как Финансы, Заказы, Работа и Маркетинг.

- Создает обзорный CSV-план перед изменением почтового ящика.

- Использует приоритеты правил и порог минимального балла.

- Отправляет несовпадающие или ниже порога сообщения в REVIEW.

- Создает отсутствующие ярлыки внутри защищенного пространства SOFL/.

- Повторно проверяет идентичность сообщения перед каждым изменением ярлыка.

- Использует идентификационный отпечаток SHA-256 на основе ID переписки, отправителя, темы и даты.

- Пропускает уже триажированные сообщения SOFL/ по умолчанию.

- Добавляет только отсутствующие ярлыки и никогда не дублирует существующий ярлык.

- Пишет JSON-отчет об применении с результатами LABELED, STALE и ERROR.

БЕЗОПАСНАЯ ГРАНИЦА

Продукт добавляет ярлыки только через конечную точку изменения сообщений Gmail.

Он не делает:

- удаление сообщений;

- перемещение в корзину;

- архивирование сообщений;

- отправку сообщений;

- пометку как прочитанные;

- изменение пометок звезды;

- удаление ярлыков;

- вызов внешнего сервиса AI.

ЧТО ВЫ ПОЛУЧИТЕ

- gmail_triage.py - основной адаптер Gmail API и CLI

- загрузчик для Windows

- загрузчик для macOS/Linux

- rules.json и rules.example.json

- руководство по схеме правил в JSON

- синтетический локальный демонстрационный набор данных

- оффлайн набор модульных тестов

- шаблон обзора в Excel

- 12-страничное руководство пользователя

- SECURITY.md

- SOURCES.md

- README

- Руководство START HERE

- CHANGELOG

- Коммерческая лицензия

БЕЗОПАСНЫЙ РАБОЧИЙ ПРОЦЕСС

1. Запустите check-config.

2. Запустите локальный демонстрационный режим без подключения Gmail.

3. Создайте небольшой план с консервативным запросом Gmail и ограничением.