Платформы и интеграции

Эта глава поможет вам понять различия функций opencode-notify на разных операционных системах, освоить настройки для конкретных платформ и заставить ваш терминал работать с максимальной эффективностью.

Путь обучения

1. Особенности платформы macOS

Полное понимание расширенных функций на macOS, включая интеллектуальное определение фокуса, фокус при клике на уведомление и настройку пользовательских звуков.

• Определение фокуса: автоматическое определение, является ли терминал активным окном
• Фокус при клике: автоматическое переключение на терминал после клика на уведомление
• Пользовательские звуки: настройка уникальных звуков для разных событий
• Поддержка 37+ терминалов: включая Ghostty, iTerm2, интегрированный терминал VS Code и др.

2. Особенности платформы Windows

Освоение основ уведомлений и методов настройки на платформе Windows.

• Нативные уведомления: использование Центра уведомлений Windows 10/11
• Разрешения на уведомления: обеспечение разрешения OpenCode на отправку уведомлений
• Базовая настройка: расположение файлов конфигурации в среде Windows
• Ограничения: функция определения фокуса временно не поддерживается на Windows

3. Особенности платформы Linux

Понимание механизма уведомлений и установки зависимостей на платформе Linux.

• Интеграция libnotify: отправка уведомлений через notify-send
• Поддержка рабочих окружений: GNOME, KDE Plasma, XFCE и другие основные окружения
• Установка зависимостей: команды установки для разных дистрибутивов
• Ограничения: функция определения фокуса временно не поддерживается на Linux

4. Поддерживаемые терминалы

Просмотр всех 37+ поддерживаемых эмуляторов терминалов, понимание механизма автоматического определения.

• Определение терминала: как автоматически определить ваш тип терминала
• Список терминалов: полный список поддерживаемых терминалов
• Ручная настройка: как вручную указать тип терминала при неудачном автоматическом определении
• Специальные терминалы: обработка интегрированного терминала VS Code, удалённых SSH-сессий

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

Перед изучением этой главы убедитесь, что вы выполнили

• ✅ Быстрый старт: установка opencode-notify завершена
• ✅ Как это работает: понимание четырёх типов уведомлений и механизма интеллектуальной фильтрации

Рекомендации по выбору платформы

Выберите соответствующую главу в зависимости от вашей операционной системы:

Операционная система	Рекомендуемый порядок изучения	Основные функции
macOS	1. Особенности платформы macOS → 4. Поддерживаемые терминалы	Определение фокуса, фокус при клике, пользовательские звуки
Windows	2. Особенности платформы Windows → 4. Поддерживаемые терминалы	Нативные уведомления, базовая настройка
Linux	3. Особенности платформы Linux → 4. Поддерживаемые терминалы	Интеграция libnotify, установка зависимостей

Общие рекомендации

Независимо от того, какую платформу вы используете, урок 4 «Поддерживаемые терминалы» заслуживает изучения — он поможет вам понять механизм определения терминала и решить проблемы с настройкой.

Таблица сравнения функций

Функция	macOS	Windows	Linux
Нативные уведомления	✅	✅	✅
Определение фокуса терминала	✅	❌	❌
Фокус при клике на уведомление	✅	❌	❌
Пользовательские звуки	✅	✅	✅ (частично)
Период тишины	✅	✅	✅
Проверка родительской сессии	✅	✅	✅
Поддержка 37+ терминалов	✅	✅	✅
Автоматическое определение терминала	✅	✅	✅

Следующие шаги

После завершения этой главы вы поймёте различия функций на разных платформах и методы настройки.

Рекомендуется продолжить изучение:

Расширенная настройка

Изучение всех параметров файла конфигурации, освоение расширенных методов настройки.

• Полный справочник по настройке: подробное описание всех параметров конфигурации
• Подробное объяснение периода тишины: как настроить и принцип работы
• Принцип определения терминала: внутренний механизм автоматического определения
• Расширенное использование: методы настройки и лучшие практики

Устранение неполадок

При возникновении проблем ознакомьтесь с решениями распространённых неисправностей.

• Уведомления не отображаются: проблемы с разрешениями и системными настройками
• Не работает определение фокуса: настройка терминала и механизм определения
• Ошибки конфигурации: формат файла конфигурации и описание полей
• Проблемы со звуками: настройка звуков и совместимость с системой

Рекомендации по пути обучения

Если вы только начинаете использовать, рекомендуется изучать в порядке Главы о платформах → Расширенная настройка → Устранение неполадок. Если у вас возникла конкретная проблема, вы можете сразу перейти к главе «Устранение неполадок».