YouTrack Time Tracker

YouTrack Time Tracker — расширение для Visual Studio Code, которое помогает отслеживать рабочее время по задачам YouTrack прямо из редактора.
Расширение снижает количество переключений между браузером и IDE, упрощает списание времени и делает учёт более прозрачным.

Для кого это расширение

• Разработчики, которые ведут учёт времени в YouTrack.
• Команды и тимлиды, которым важно видеть прозрачную историю работы по задачам.
• Все, кто хочет списывать время в YouTrack, не покидая VS Code.

Основные возможности

• Таймер по задачам YouTrack

  • Запуск, пауза, возобновление и остановка таймера по ID задачи (например, PROJ-123).
  • Автоматическая запись затраченного времени в историю.

• Ручной ввод времени (мастер)

  • Пошаговый ввод:
    • ID задачи (с проверкой существования в YouTrack).
    • Выбор типа работы (по проекту или глобально, с кэшированием).
    • Ввод длительности в удобном формате (90, 1h, 30m, 1h 30m и т.п.).
    • Комментарий к записи.
  • Создание записи в локальной истории и отправка в YouTrack с пометкой как синхронизированной.

• История активности

  • Таблица всех записей времени.
  • Редактирование уже существующих записей.
  • Ручная синхронизация с YouTrack.
  • Экспорт в CSV и JSON.
  • Кнопка «Очистить историю» с подтверждением и полной очисткой локальных записей.

• Работа с задачами

  • Панель задач в боковой панели VS Code.
  • Быстрый старт таймера по задаче.
  • Создание Git-ветки из задачи по её идентификатору с использованием настраиваемых шаблонов.

• Система профилей

  • Создание и переключение между несколькими профилями настроек.
  • Каждый профиль хранит свои настройки подключения, таймера, фильтров и Git-интеграции.
  • API токены хранятся безопасно для каждого профиля отдельно.

• Шаблоны Git-веток

  • Настраиваемые шаблоны для автоматического создания имен Git-веток из ID задач.
  • Поддержка плейсхолдеров: {id}, {project}, {number}, {type}.
  • Автоматическое извлечение ID задачи из имени ветки для быстрого старта таймера.

• Интеграция с YouTrack

  • Списание времени по задачам с учётом типа работы.
  • Использование настраиваемого поля статуса задачи.
  • Отображение человеко-читаемых названий типов работ вместо внутренних ID.

Установка

1. Откройте Visual Studio Code.
2. Перейдите в раздел Extensions (Расширения).
3. Найдите YouTrack Time Tracker.
4. Нажмите Install (Установить).

Либо установите из VSIX-файла:

1. Скачайте файл youtrack-time-tracker-*.vsix.
2. В VS Code в разделе расширений выберите Install from VSIX….
3. Укажите скачанный файл.

Настройка

После установки нужно один раз настроить подключение к вашему серверу YouTrack.

1. Откройте командную палитру (Ctrl+Shift+P / Cmd+Shift+P).
2. Выполните команду «YouTrack Time Tracker: Настроить расширение».
3. Заполните ключевые параметры:

Обязательные параметры

• Адрес YouTrack
  URL вашего сервера YouTrack (например, https://youtrack.mycompany.com).

• Имя пользователя
  Ваш логин в YouTrack.

• API-ключ
  Персональный токен доступа, созданный в профиле YouTrack.

Полезные дополнительные параметры

• Интервал проверки
  Как часто расширение будет обновлять данные и выполнять фоновую проверку (в минутах).

• Автоостановка таймера
  Час (0–23), в который таймер будет автоматически остановлен (например, в конце рабочего дня).

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

• Поле статуса задачи
  Имя поля статуса в вашей схеме YouTrack, если вы хотите, чтобы расширение ориентировалось на конкретный статус.

• Тип работы по умолчанию
  Тип работы, который будет использоваться при списании времени, если вы не выбрали его вручную.

Дополнительные настройки (исключённые статусы, переименования статусов, длительность кеширования типов работ и т.п.) позволяют тонко подстроить расширение под процессы вашей команды.

Система профилей

Расширение поддерживает создание и переключение между несколькими профилями настроек. Это полезно, если вы работаете с разными проектами или серверами YouTrack.

Управление профилями

1. В окне настроек вверху находится селектор профилей.
2. Используйте кнопки для управления:
   • + Создать — создать новый профиль на основе текущего.
   • ✏️ Переименовать — изменить имя текущего профиля.
   • 🗑️ Удалить — удалить текущий профиль (нельзя удалить последний).

Что хранится в профиле

• Настройки подключения к YouTrack (URL, имя пользователя, API токен).
• Настройки таймера и синхронизации.
• Настройки фильтрации задач.
• Типы работ по умолчанию.
• Настройки Git-интеграции (шаблоны веток, тип ветки по умолчанию).

Миграция существующих настроек

При первом запуске расширения после обновления все существующие настройки автоматически мигрируют в профиль "Default". Это происходит один раз и не влияет на вашу работу.

Шаблоны Git-веток

Расширение позволяет настраивать шаблоны для автоматического создания имен Git-веток из ID задач YouTrack.

Доступные плейсхолдеры

• {id} — полный ID задачи (например, PROJ-123) — обязательный
• {project} — проект из ID (например, PROJ)
• {number} — номер задачи (например, 123)
• {type} — тип ветки из настройки (feature/fix/bug/hotfix)

Примеры шаблонов

• {id} → PROJ-123
• {type}/{id} → feature/PROJ-123
• {project}-{number} → PROJ-123
• {type}/{project}-{number} → feature/PROJ-123

Настройка шаблона

1. Откройте настройки расширения.
2. Перейдите на вкладку "Git".
3. Введите шаблон в поле "Шаблон Git ветки".
4. Выберите "Тип ветки по умолчанию" (feature/fix/bug/hotfix).
5. Шаблон валидируется в реальном времени — при ошибке появится сообщение.

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

При создании Git-ветки из задачи расширение автоматически:

1. Получает шаблон из текущего профиля.
2. Генерирует имя ветки по шаблону.
3. Создает и переключается на новую ветку.

Также расширение может автоматически определять задачу из текущей Git-ветки при запуске таймера, используя обратный парсинг шаблона.

Как пользоваться

Быстрый старт: отслеживание времени по задаче

1. Откройте командную палитру.
2. Выполните команду «YouTrack Time Tracker: Запустить таймер».
3. Введите ID задачи (например, PROJ-123).
4. В строке состояния VS Code появится таймер; при необходимости поставьте его на паузу или остановите.

Ручной ввод времени «задним числом»

1. Выполните команду «YouTrack Time Tracker: Ручной ввод времени».
2. Введите ID задачи — расширение проверит, что она существует в YouTrack.
3. Выберите тип работы.
4. Укажите длительность и комментарий.
5. Подтвердите — запись появится в истории и будет отправлена в YouTrack.

Работа с историей активности

1. Выполните команду «YouTrack Time Tracker: Просмотр истории активности».
2. В открывшемся окне вы можете:
   • просматривать все записи времени;
   • редактировать отдельные записи;
   • запускать ручную синхронизацию с YouTrack;
   • экспортировать данные в CSV или JSON;
   • полностью очистить локальную историю по кнопке «Очистить историю» (с подтверждением).

Обратная связь и исходный код

Если вы нашли проблему или хотите предложить улучшение, создайте issue в репозитории проекта (ссылка указывается на странице расширения в маркетплейсе).
Будем рады обратной связи и предложениям по развитию YouTrack Time Tracker.