Cosmic-light

Что такое Cosmic-light?

Cosmic-light — центр управления Windows в стиле «Dynamic Island», который объединяет статусы для быстрого просмотра, медиа-управление, визуализацию погоды, события календаря и интерфейс AI-чата в едином UI на экране. Интерфейс разворачивается из элемента «острова», расположенного на рабочем столе, и отображает релевантную информацию именно тогда, когда она нужна.

Проект построен как локальное-first приложение: использует локальное хранилище для контекста бесед и шифрует API-ключи, добавленные для AI-функций. Также включает Python-скрипты system-bridge для доступа к данным, таким как медиа и погода.

Ключевые функции

• Dynamic Island UI (внизу или по центру): Размещает остров на экране и интеллектуально разворачивает его при взаимодействии.
• Домашний вид для быстрого просмотра: Показывает время, дату и статус активного окна.
• Управление медиа и интеграция со Spotify/системным аудио: Обеспечивает play/pause/next/previous, регулировку громкости, визуализатор аудио в реальном времени и метаданные трека (включая обложку альбома и прогресс).
• Умные иконки медиа: Определяет источник ввода (например, Spotify, YouTube, Chrome) и устройство вывода (например, наушники, колонки).
• Визуализация погоды в реальном времени: Рендерит эффекты частиц (дождь, снег, облака, звёзды) и отображает статистику вроде температуры, ветра, влажности и вероятности осадков, с предупреждениями о сильной погоде в стиле алертов.
• Умный календарь с синхронизацией Google Calendar: Использует секретный iCal-адрес для синхронизации событий, автоматически разворачивает остров за 5 минут до начала события и включает интерактивный месячный вид.
• AI-чат (local first): Встроенный чат-интерфейс с «Gemini Mode» (Google Gemini) и «Perplexity Mode» (веб-поиск с цитатами/источниками). История бесед хранится локально.
• Шифрованные API-ключи: Шифрует API-ключи, добавленные в настройках, для повышения безопасности.

Как использовать Cosmic-light

1. Установите предпосылки: Используйте Node.js v20+ и Python v3.10+.
2. Настройте проект:
   • Клонируйте репозиторий.
   • Установите зависимости фронтенда с npm install.
   • Установите зависимости бэкенда с pip install -r requirements.txt.
3. Запустите локально: Запустите приложение с npm run dev.
4. Откройте и настройте:
   • Кликните по Dynamic Island, чтобы развернуть его.
   • Используйте Settings (иконка шестерёнки) для настройки AI API keys (Gemini и/или Perplexity) и синхронизации Google Calendar.
5. (Опционально) Соберите установщик: Для автономного Windows .exe выполните npm run build; установщик окажется в директории release/.

Сценарии использования

• Управление медиа с рабочего стола: Управляйте воспроизведением и громкостью с острова, просматривая метаданные трека и визуализатор аудио в реальном времени, без переключения на отдельное окно медиа.
• Контекст для быстрого просмотра при многозадачности: Быстро проверяйте время/дату и активное приложение из домашнего вида острова.
• Осведомлённость о погоде с визуальными подсказками: Следите за изменяющейся погодой через анимированные частицы и читайте ключевую статистику вроде ветра и влажности, включая предупреждения о сильной погоде.
• Напоминания о встречах: Синхронизируйте приватный Google Calendar через секретный iCal-адрес приложения и полагайтесь на автоматическое развертывание острова за 5 минут до событий.
• Помощь в ответах/поисках в UI рабочего стола: Используйте режимы чата Gemini или Perplexity с острова; храните API-ключи в настройках и ведите историю бесед локально.

FAQ

• Что нужно для запуска Cosmic-light? Для приложения требуется Node.js v20 или выше, а для скриптов system bridge — Python v3.10 или выше.

• Как включить функции AI-чата? Откройте настройки приложения и добавьте ваш Gemini API Key и/или Perplexity API Key. Проект указывает, что хотя бы один из них должен быть включён.

• Как работает синхронизация Google Calendar? В настройках Google Calendar сгенерируйте или скопируйте «iCal secret address» (в формате iCal) и вставьте этот URL в Settings > Google Calendar приложения.

• Где хранятся данные? Проект использует подход local-first: история бесед хранится локально, а API-ключи из настроек шифруются.

• Можно ли разместить остров иначе? Да. В настройках есть опции позиционирования острова внизу или по центру экрана, а также выбор монитора для отображения.

Альтернативы

• Фреймворки виджетов на уровне ОС: Вместо расширяющегося UI в стиле Dynamic Island используйте системы десктопных виджетов/лаунчеров, агрегирующие виджеты (погода, календарь, медиа) на экране; рабочие процессы отличаются, поскольку поведение расширения и представление в виде «острова» могут отсутствовать.
• Приложения для управления медиа: Специализированные инструменты управления медиа обеспечивают воспроизведение и контроль громкости плюс визуализации, но могут не включать такую же комбинацию погоды/календаря/AI.
• Интеграции календаря и погоды для десктопа: Отдельные интеграции календаря и погоды фокусируются на этих источниках данных; они обычно не объединяют AI-чат и шаблон расширения Dynamic Island в один центр управления.
• Локальные приложения-чатботы: Общие чат-клиенты или локальные AI-фронтенды могут заменить AI-панель острова, но вы потеряете интегрированный контекст UI календаря/медиа/погоды острова.