Yandex Tracker Helper Extension

Расширение VS Code для учёта рабочего времени по задачам Яндекс.Трекера с автоматической отправкой затраченного времени.

Возможности

• ⏱️ Таймер задач с автоматическим сохранением состояния
• 📋 Просмотр назначенных задач из Яндекс.Трекера
• 📤 Отправка накопленного времени в Яндекс.Трекер
• 🌿 Привязка задач к Git-веткам
• 💾 Состояние таймера сохраняется при перезапуске VS Code

Установка

Установите из VS Code Marketplace или соберите из исходников:

# Установка из .vsix файла
code --install-extension vscode-yandex-tracker-1.0.0.vsix

Quick Start

1. Получите OAuth-токен Яндекс.Трекера:

   • Перейдите на Yandex OAuth
   • Создайте новое OAuth-приложение
   • Скопируйте OAuth-токен

2. Получите ID организации:

   • Откройте настройки вашей организации в Яндекс.Трекере
   • Найдите ID организации

3. Настройте расширение:

   • Выполните команду Tracker: Set OAuth2.0 Token (Ctrl+Shift+P)
   • Введите ваш OAuth-токен
   • Установите trackerHelper.orgId в настройках VS Code (Файл → Параметры → Настройки)

4. Начните работу:

   • Откройте панель Tracker Helper из Activity Bar (иконка с часами)
   • Нажмите кнопку обновления (🔄) для загрузки задач
   • Нажмите Play (▶️) на задаче для начала отслеживания времени

Команды

• Tracker: Set OAuth2.0 Token — установить OAuth-токен для API Яндекс.Трекера
• Tracker: Start timer — начать отслеживание времени для выбранной задачи
• Tracker: Stop timer — остановить текущий таймер
• Tracker: Refresh — загрузить задачи из Яндекс.Трекера
• Tracker: Assign Task with Branch — привязать текущую Git-ветку к задаче
• Tracker: Send Time — отправить накопленное время для выбранной задачи
• Tracker: Send All Time — отправить время по всем задачам
• Tracker: Clear All Data — очистить все сохранённые данные таймера

Настройки

• trackerHelper.orgId — ID организации в Яндекс.Трекере (обязательно)
• trackerHelper.orgIdHeader — заголовок ID организации (X-Cloud-Org-ID или X-Org-ID, по умолчанию: X-Cloud-Org-ID)

Эти параметры можно настроить в настройках VS Code (Файл → Параметры → Настройки) или в .vscode/settings.json:

{
  "trackerHelper.orgId": "your-organization-id",
  "trackerHelper.orgIdHeader": "X-Cloud-Org-ID"
}

Требования

• VS Code 1.105.1+
• OAuth-токен Яндекс.Трекера
• ID организации

Разработка

Требования

• Node.js 22.x
• Yarn
• VS Code 1.105.1+

Сборка

Расширение использует Rspack для сборки:

# Установка зависимостей
yarn install

# Продакшн-сборка
yarn compile

# Сборка для разработки
yarn compile:dev

# Режим наблюдения (для разработки)
yarn watch

Debugging

1. Откройте проект в VS Code
2. Нажмите F5 для запуска Extension Development Host
3. В новом окне откройте панель Tracker Helper для тестирования расширения

License

MIT License - see LICENSE for details.

Changelog

См. CHANGELOG.md для информации об изменениях в каждой версии.

Поддержка

Нашли ошибку или есть предложение? Создайте Issue.