Документация LogAgent

Начало работы

LogAgent работает на Windows, macOS и Linux. При первом запуске онбординг проведёт вас через настройку — выберите «Быстро» с разумными значениями по умолчанию или «Полностью», чтобы настроить всё.

Быстрый старт

• Установка — скачайте с logagent.app, запустите установщик и откройте приложение.
• Разрешения — доступ к accessibility/экрану для трекинга окон и, по желанию, камера для мониторинга здоровья.
• Трекинг стартует — LogAgent сразу начинает записывать активность локально.
• Настройте категории — назначьте приложениям уровни продуктивности.
• Разбор дня — открывайте «Разбор дня» по вечерам, чтобы подтверждать рабочие сегменты.

Настройка также охватывает

• Лицензионный ключ или бесплатный триал, привязанный к Hardware ID.
• Опциональный глобальный шорткат показать/скрыть и автозапуск.
• Разрешения на уведомления и камеру.
• Принятие Условий и Политики конфиденциальности.

Как работает трекинг

LogAgent записывает сигналы, нужные чтобы объяснить ваш день, и автоматически их классифицирует — всё на устройстве.

Методы захвата

• Трекинг окон — активное приложение, заголовок окна и процесс, постоянная выборка.
• Активность браузера — домены и заголовки страниц через веб-интеграцию ActivityWatch.
• Активность ввода — нажатия, клики, движение и скролл считаются как числа для метрик; сами клавиши никогда не логируются.
• Детекция AFK — простой отмечается после ~90 секунд без ввода; камера может заметить ваш уход раньше.

Уровни продуктивности

Авто-атрибуция

• Путь проекта в IDE — имя репозитория/воркспейса из VS Code или JetBrains.
• Шаблоны заголовков окон — правила вида «JIRA-*» → Проект X.
• Правила доменов — github.com/org/repo → конкретный проект.
• Временной перенос — контекст переносится из продуктивного приложения через чат на 10 минут.

Проекты, задачи и биллинг

Учитывайте время по проектам и задачам, назначайте клиентов, ставьте почасовые ставки и формируйте инвойсы.

Управление проектами

• Создание проектов — название, клиент, почасовая ставка, валюта и переключатель billable.
• Задачи — разбивайте проекты на задачи с оценкой часов.
• Правила атрибуции — сопоставляйте приложения, домены и заголовки окон для авто-назначения времени.
• Подсказки — новые проекты определяются по активности в IDE.

Биллинг и инвойсы

• Рабочие сегменты — генерируются из активности и подтверждаются в «Разборе дня».
• Округление времени — настраиваемое округление 15 или 30 минут.
• Инвойсы — формируются из подтверждённых сегментов с позициями.
• Экспорт — выгрузка в CSV для внешней бухгалтерии.

Здоровье и усталость

Оценка усталости 0–100 обновляется каждые несколько секунд и управляет умными перерывами.

Оценка собирается из 14 взвешенных сигналов — PERCLOS, угол шеи, усталость глаз, дефицит морганий, частота переключений, время на задаче, продуктивность, стресс (BPM), уровень активности и другие.

Функции здоровья по камере

• Осанка — угол шеи и наклон плеч через face mesh.
• Зрение — частота морганий, PERCLOS и микросны.
• Стресс — пульс через rPPG (бесконтактная фотоплетизмография).
• Присутствие — знает, когда вы отошли от стола.
• Всё локально — MediaPipe работает в браузере; видео не покидает устройство.

Умные перерывы

Перерывы планируются по сигналам, а не по слепому таймеру.

• Микроперерывы — несколько секунд, часто, для глаз и рук (20-20-20).
• Короткие перерывы — 5–10 минут каждые 45–60 минут, чтобы размяться и подвигаться.
• Длинные перерывы — более долгий отдых в течение дня.

Умное поведение

• По усталости — перерывы срабатывают раньше при высокой оценке усталости.
• С учётом AFK — таймеры на паузе, пока вы отошли; никаких напоминаний во время AFK.
• Снуз по типу — «Не показывать сегодня» гасит только это напоминание.
• Эффективность — измеряется продуктивность до и после перерыва.

Фокус и Shield

Активный фокус блокирует отвлечения и учитывает время сфокусированной работы.

Активный фокус

• Старт сессии — выберите длительность, название задачи и приложения фокуса.
• Белый список приложений — открытыми остаются только разрешённые; остальные сворачиваются.
• Плавающий виджет — таймер поверх окон с остатком времени.
• Нарушения — переключение в неразрешённое приложение логируется.
• Pomodoro — циклы 25/5 работа-отдых с авто-перерывами.

Глубокая работа и Shield

• Строгий режим — агрессивное сворачивание приложений вне белого списка.
• Правила Shield — блокировка конкретных приложений или доменов по шаблону.
• Расписания — правила активируются в выбранные дни и часы.
• Дневные лимиты — разрешить X минут, затем блок на день.

Аналитика и инсайты

Глубокий разбор паттернов работы — хитмапы, поведенческое профилирование и корреляции.

Виджеты дашборда

• Продуктивность и самочувствие — продуктивность и усталость по часам, с маркерами перерывов и «золотыми часами».
• План против факта — плановые сессии против реально учтённого времени.
• Недельный дайджест — 7-дневная сводка с экспортом.
• Умное планирование — рекомендации по «золотым часам» и усталости.

Корреляционные инсайты

• «Перерывы повысили продуктивность в среднем на ~18%».
• «Когда усталость выше 70%, продуктивность падает на ~32%».
• «Хорошая осанка коррелирует с более высокой продуктивностью».

Приватность и безопасность

Все данные остаются на устройстве; приватность — базовый принцип дизайна, а не довесок.

Что мы отслеживаем

• Имена приложений и заголовки окон — для категоризации, не содержимого.
• Домены — для классификации веб-активности.
• Счётчики ввода — нажатия и клики только как числа.
• Метрики камеры — углы осанки и частота морганий; видео не покидает устройство.

Что мы не отслеживаем

• Скриншоты или запись экрана
• Содержимое ввода (только счётчики)
• Содержимое файлов или буфера обмена
• Видео или фото с камеры
• Пароли, формы или сообщения

Хранение

• 100% локально — база SQLite на вашей машине.
• Без облака по умолчанию — только опциональная синхронизация со сквозным шифрованием.
• Авто-очистка — сырые события подчищаются через 90 дней; агрегаты остаются.
• Экспорт в любой момент — выгрузка всех данных в CSV/JSON.

Горячие клавиши

Сочетания настраиваются в «Настройках».

Решение проблем

Трекинг не записывает

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

Камера не работает

Убедитесь, что разрешение на камеру выдано и устройство не занято другим приложением; камера работает только при фокусе окна.

Высокая нагрузка на CPU или батарею

Снизьте фоновый FPS камеры или отключите функции здоровья по камере; сам трекинг активности лёгкий.