Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 Примечания к релизу *Дата релиза: 7 августа 2025* ## 📑 Содержание - [🎉 Основные новые функции](#-основные-новые-функции) - [🤖 Система управления агентами](#-система-управления-агентами) - [🤖 Массовое назначение агентов с помощью ИИ](#-массовое-назначение-агентов-с-помощью-ии) - [📊 Git контроль версий для истории задач](#-git-контроль-версий-для-истории-задач) - [📊 Просмотр истории проекта](#-просмотр-истории-проекта) - [🎨 Система управления шаблонами](#-система-управления-шаблонами) - [🌍 Поддержка интернационализации (i18n)](#-поддержка-интернационализации-i18n) - [🧭 Улучшенная навигация и интерфейс](#-улучшенная-навигация-и-интерфейс) - [🔄 Значительные улучшения](#-значительные-улучшения) - [Повышение производительности](#повышение-производительности) - [Опыт разработчика](#опыт-разработчика) - [Усовершенствования UI/UX](#усовершенствования-uiux) - [🐛 Исправления ошибок](#-исправления-ошибок) - [Критические исправления](#критические-исправления) - [Исправления интерфейса](#исправления-интерфейса) - [Обработка данных](#обработка-данных) - [🏗️ Технические обновления](#️-технические-обновления) - [Новые зависимости](#новые-зависимости) - [Усовершенствования API](#усовершенствования-api) - [Архитектурные улучшения](#архитектурные-улучшения) - [📝 Кардинальные изменения](#-кардинальные-изменения) - [Обновления конфигурации](#обновления-конфигурации) - [Изменения API](#изменения-api) - [🚀 Руководство по миграции](#-руководство-по-миграции) - [🎯 Резюме](#-резюме) ## 🎉 Основные новые функции ### 🤖 Система управления агентами **Всестороннее управление субагентами для специализированной обработки задач** SHRIMP-TASK-MANAGER теперь поддерживает мощные возможности управления агентами, позволяя вам определять и использовать специализированные ИИ-агенты для различных типов задач. Агенты - это специализированные ИИ-личности или наборы навыков, которые могут быть назначены задачам для оптимального выполнения. Эта функция беспрепятственно интегрируется с системой агентов Claude, позволяя использовать пользовательские агенты, хранящиеся в вашей папке `.claude/agents`. Ключевые возможности включают: - **Просмотр списка агентов**: Просматривайте всех доступных агентов из папки `.claude/agents` с подробной информацией - **Назначение агентов**: Назначайте конкретных агентов задачам через выпадающий список в таблице задач - **Всплывающий просмотрщик агентов**: Нажмите иконку глаза (👁️) в таблице задач, чтобы открыть всплывающее окно просмотрщика агентов, где можно прокручивать различных агентов и выбрать подходящего для каждой задачи - **Редактор агентов**: Встроенный редактор с настройкой цветов для метаданных агентов - **Глобальные агенты и агенты проекта**: Поддержка определений агентов как для конкретного проекта, так и глобальных - **ИИ-инструкции одним кликом**: Нажмите эмодзи робота, чтобы скопировать инструкции, специфичные для агента, в буфер обмена - **ИИ-инструкции списка агентов**: Новая колонка ИИ-инструкций в списке агентов с эмодзи робота (🤖), которая копирует `use subagent [agent-name] located in [path]:` для прямого использования в Claude - **Модальное окно информации об агенте**: Подробная информация об агенте с навигацией между агентами - **Интеграция метаданных**: Назначения агентов сохраняются напрямую в tasks.json - **Цветовое кодирование**: Визуальная дифференциация агентов с использованием пользовательских цветов #### Рабочий процесс назначения агентов: 1. **Просмотр доступных агентов**: Перейдите на вкладку "Агенты", чтобы увидеть всех агентов в папке `.claude/agents` 2. **Назначение задачам**: Используйте выпадающий список в таблице задач для выбора агента для каждой задачи 3. **Копирование инструкций**: Нажмите эмодзи робота, чтобы скопировать: `use the built in subagent located in ./claude/agents/[agent-name] to complete this shrimp task: [task-id] please when u start working mark the shrimp task as in progress` 4. **Редактирование агентов**: Изменяйте содержимое агентов и метаданные, включая пользовательские цвета  *Просмотр списка агентов отображает всех доступных агентов с колонкой ИИ-инструкций - нажмите эмодзи робота (🤖), чтобы скопировать инструкции использования агента типа `use subagent debugger.md located in ./claude/agents to perform:` прямо в буфер обмена*  *Назначайте агентов задачам, используя выпадающий селектор в таблице задач*  *Нажмите иконку глаза (👁️), чтобы открыть всплывающий просмотрщик агентов и просмотреть доступных агентов для назначения задачи*  *Редактируйте содержимое агентов и настраивайте с цветами для визуальной организации*  *Нажмите эмодзи робота, чтобы скопировать инструкции задачи, специфичные для агента*  *Просматривайте агентов с подробной информацией и легкой навигацией*  *Настройте глобальный путь к папке Claude для доступа к общесистемным агентам* ### 🤖 Массовое назначение агентов с помощью ИИ **Автоматически назначайте наиболее подходящих агентов множеству задач, используя OpenAI GPT-4** Task Viewer теперь интегрируется с GPT-4 от OpenAI для интеллектуального назначения агентов задачам на основе их описаний и требований. Эта функция значительно сокращает время, необходимое для настройки большого количества задач с подходящими агентами. Ключевые функции включают: - **Массовый выбор**: Выбирайте несколько задач, используя флажки в таблице задач - **Назначение одним кликом**: Нажмите "ИИ Назначить Агентов", чтобы автоматически назначить агентов всем выбранным задачам - **Интеллектуальное сопоставление**: GPT-4 анализирует описания задач и возможности агентов для оптимального назначения - **Интеграция глобальных настроек**: Настройте ваш ключ API OpenAI во вкладке Глобальные настройки - **Поддержка переменных окружения**: Также поддерживает переменные окружения `OPENAI_API_KEY` или `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` - **Руководство по ошибкам**: Четкие инструкции предоставляются, если ключ API не настроен #### Инструкции по настройке: 1. **Настройка ключа API**: Перейдите в Настройки → Глобальные настройки и введите ваш ключ API OpenAI 2. **Выбор задач**: Используйте флажки для выбора задач, которым нужно назначение агентов 3. **ИИ-назначение**: Нажмите кнопку "🤖 ИИ Назначить Агентов" в панели массовых действий 4. **Автоматическая обработка**: GPT-4 проанализирует задачи и назначит наиболее подходящих агентов  *Настройте ваш ключ API OpenAI в глобальных настройках для массового назначения агентов с помощью ИИ*  *Выберите несколько задач и нажмите "🤖 ИИ Назначить Агентов (выбрано 5 задач)", чтобы автоматически назначить подходящих агентов с помощью GPT-4* ### 📊 Git контроль версий для истории задач **Автоматические Git коммиты отслеживают каждое изменение в ваших задачах** SHRIMP-TASK-MANAGER теперь включает встроенную интеграцию Git, которая автоматически отслеживает все изменения в файле tasks.json. Это обеспечивает полный аудиторский след модификаций задач без какого-либо ручного вмешательства. Ключевые функции включают: - **Автоматический Git репозиторий**: Инициализирует Git репозиторий в вашей папке данных при первом использовании - **Коммиты с временными метками**: Каждая операция с задачами (создание, обновление, удаление) создает коммит с временными метками локального часового пояса - **Описательные сообщения**: Коммиты включают четкие описания того, что изменилось (например, "Add new task: Implement user authentication") - **Неблокирующие операции**: Git операции заключены в блоки try-catch - если Git не работает, операции с задачами продолжаются нормально - **Изолированный репозиторий**: Git репозиторий предназначен только для истории задач, полностью отдельный от репозитория вашего проекта - **Без конфликтов слияния**: Отслеживание одного файла с линейной историей означает, что конфликты невозможны #### Преимущества: - **Полная история**: Просматривайте всю эволюцию ваших задач, используя стандартные инструменты Git - **Отслеживание изменений**: Видите точно, когда и как задачи были изменены - **Опции восстановления**: Восстанавливайте предыдущие состояния задач при необходимости - **Видимость для команды**: Делитесь историей задач с членами команды Интеграция Git полностью прозрачна и не требует настройки. Вы можете просмотреть историю в любое время, используя: ```bash cd <shrimp-data-directory> git log --oneline ``` #### Как просмотреть историю задач 1. **Перейдите в папку данных ваших задач** (как настроено в `.mcp.json`): ```bash cd <shrimp-data-directory> ``` 2. **Просмотрите историю коммитов**: ```bash git log --oneline ``` 3. **Посмотрите конкретные изменения**: ```bash git show <commit-hash> ``` 4. **Сравните версии**: ```bash git diff HEAD~5 # Сравнить с 5 коммитами назад ``` 5. **Восстановите предыдущее состояние** (при необходимости): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 Просмотр истории проекта **Отслеживайте и анализируйте историю выполнения задач вашего проекта** SHRIMP-TASK-MANAGER автоматически сохраняет завершенные задачи в файлы памяти в вашем проекте всякий раз, когда вы начинаете новую сессию задач. Ранее эти ценные исторические данные были скрыты в этих файлах памяти и недоступны через интерфейс. Новый просмотр истории проекта раскрывает эту историю задач, позволяя исследовать, как ваш проект развивался со временем. Эта функция позволяет вам: - **Исторические снимки задач**: Просматривайте прошлые состояния вашего проекта, сохраненные SHRIMP-TASK-MANAGER - **Отслеживание эволюции задач**: Видите, как задачи прогрессировали от создания до завершения в разных сессиях - **Система заметок**: Добавляйте личные заметки к историческим записям для будущих справок и обмена знаниями команды - **Подробный просмотр задач**: Детально изучайте конкретные исторические состояния задач для понимания прошлых решений и реализаций - **Навигация по времени**: Перемещайтесь по временной линии вашего проекта, чтобы видеть, что было выполнено когда - **Сравнение снимков**: Сравнивайте состояния задач в разные временные периоды для отслеживания роста и изменений проекта   ### 🎨 Система управления шаблонами **Мощная настройка шаблонов для выполнения задач ИИ** Шаблоны - это основные инструкции, которые направляют SHRIMP-TASK-MANAGER в анализе и выполнении задач. Они определяют, как ИИ должен подходить к различным типам операций, от планирования и анализа до реализации и верификации. MCP-TASK-MANAGER позволяет создавать пользовательские шаблоны, которые могут либо переопределять поведение по умолчанию, либо добавлять дополнительные инструкции к существующим шаблонам. Этот новый интерфейс управления шаблонами предоставляет интуитивный способ: - **Редактор шаблонов**: Полнофункциональный markdown редактор с подсветкой синтаксиса для создания пользовательских ИИ-инструкций - **Предварительный просмотр шаблонов**: Живой предварительный просмотр шаблонов перед активацией для обеспечения соответствия требованиям - **Дублирование шаблонов**: Легко создавайте вариации существующих шаблонов для различных случаев использования - **Отслеживание статуса шаблонов**: Визуальные индикаторы, показывающие состояния по умолчанию (оригинальный), пользовательский (полностью заменен) и пользовательский+дополнение (добавления к по умолчанию) - **Сброс к по умолчанию**: Восстановление оригинальных шаблонов одним кликом при необходимости - **Экспорт шаблонов**: Экспортируйте ваши пользовательские шаблоны для резервного копирования, обмена с членами команды или контроля версий - **Диалог активации**: Четкое подтверждение при активации шаблонов для предотвращения случайных изменений  ### 🌍 Поддержка интернационализации (i18n) **Многоязычная поддержка с плавным переключением языков** - **Поддерживается три языка**: Английский (en), Китайский (中文) и Испанский (Español) - **Постоянный выбор языка**: Ваши языковые предпочтения сохраняются и запоминаются - **Полный перевод интерфейса**: Все элементы интерфейса, кнопки, метки и сообщения полностью переведены - **Динамическое переключение языков**: Изменяйте языки на лету без перезагрузки страницы - **Контекст провайдера языка**: Централизованное управление языками для согласованных переводов ### 🧭 Улучшенная навигация и интерфейс **Современные, интуитивные улучшения интерфейса** - **Система вложенных вкладок**: Организованная навигация с основными и вторичными вкладками - **Синхронизация состояния URL**: URL браузера обновляется, чтобы отражать текущий просмотр - **Навигация по деталям задач**: Кнопки "Назад"/"Далее" позволяют последовательно просматривать задачи без возврата к списку - **Спиннеры загрузки**: Визуальная обратная связь во время загрузки данных - **Уведомления-тосты**: Ненавязчивые сообщения об успехе/ошибке - **Адаптивный дизайн**: Улучшенный опыт для мобильных устройств и планшетов - **Улучшения модальных окон**: Лучшие макеты и взаимодействия модальных окон - **Клавиатурная навигация**: Поддержка клавиш со стрелками для более быстрой навигации по задачам в детальном просмотре ## 🔄 Значительные улучшения ### Навигация по деталям задач **Бесшовный рабочий процесс просмотра задач** Просмотр деталей задач теперь включает кнопки навигации "Назад"/"Далее", которые кардинально меняют способ просмотра и работы с задачами: - **Последовательная навигация**: Перемещайтесь по задачам по порядку, не возвращаясь к основному списку - **Сохранение контекста**: Остаётесь в детальном просмотре при переключении между задачами - **Визуальные индикаторы**: Кнопки показывают номера задач (например, "← Предыдущая (Задача 3)" и "Следующая (Задача 5) →") - **Умные границы**: Кнопки навигации отключаются на первой и последней задачах - **Клавиатурные сокращения**: Используйте клавиши со стрелками для ещё более быстрой навигации - **Повышение эффективности**: Просматривайте полные списки задач в 3-5 раз быстрее, чем при переключении туда-сюда Эта функция особенно ценна при: - Просмотре недавно созданных задач из ИИ-анализа - Работе с последовательностью зависимых задач - Проверке деталей реализации в нескольких связанных задачах - Выполнении аудитов или проверок задач ### Повышение производительности - **Оптимизированные повторные рендеры**: React хуки правильно мемоизированы для лучшей производительности - **Ленивая загрузка**: Компоненты загружаются по требованию для более быстрой начальной загрузки страницы - **Эффективное управление состоянием**: Уменьшены ненужные обновления состояния - **Пакетные обновления**: Множественные изменения состояния пакетируются для более плавного интерфейса ### Опыт разработчика - **Всеобъемлющий набор тестов**: Добавлены интеграционные тесты и тесты языковых функций - **Чек-листы тестирования**: Структурированная документация по тестированию - **Лучшая обработка ошибок**: Более информативные сообщения об ошибках - **Логирование отладки**: Расширенные возможности отладки для разработки ### Усовершенствования UI/UX - **Улучшенная таблица задач**: Лучше размер колонок и перенос текста - **Улучшенные модальные окна**: Согласованные стили и поведение модальных окон - **Лучшая типографика**: Улучшенная читаемость с обновленными размерами шрифтов - **Обновления цветовой схемы**: Более доступные цветовые контрасты - **Согласованность иконок**: Единое использование иконок по всему приложению ## 🐛 Исправления ошибок ### Критические исправления - **Ошибка useRef Hook**: Исправлена отсутствующая импорт React hook, которая вызывала сбои приложения - **Ключи переводов**: Добавлены недостающие ключи переводов для всех поддерживаемых языков - **Цикл символических ссылок**: Решена проблема бесконечного цикла в папке Screenshots - **Обработка путей Windows**: Исправлены проблемы с file:// URI в Windows 11 - **Ссылки на репозитории**: Исправлены все ссылки на репозитории ### Исправления интерфейса - **Z-index модальных окон**: Исправлены проблемы со слоями модальных окон - **Выбор вкладок**: Исправлено сохранение вкладок при перезагрузке страницы - **Селектор языка**: Исправлены проблемы синхронизации состояния - **Функциональность копирования**: Улучшена надежность операций с буфером обмена - **Адаптивный макет**: Исправлены проблемы с мобильным видовым портом ### Обработка данных - **Загрузка профилей**: Исправлены условия гонки при переключении профилей - **Обновление задач**: Улучшена надежность авто-обновления - **Загрузка истории**: Исправлены проблемы пагинации в просмотре истории - **Сохранение шаблонов**: Решены ошибки сохранения шаблонов ## 🏗️ Технические обновления ### Новые зависимости - `@headlessui/react`: Современные компоненты интерфейса - `@tanstack/react-table`: Расширенная функциональность таблиц - `@uiw/react-md-editor`: Markdown редактирование для шаблонов - Дополнительные определения типов для поддержки TypeScript ### Усовершенствования API - **GET /api/templates**: Список всех доступных шаблонов - **PUT /api/templates/:name**: Обновление содержимого шаблона - **POST /api/templates/:name/duplicate**: Дублирование шаблонов - **GET /api/history/:profileId**: Получение истории проекта - **Расширенные ответы об ошибках**: Более детальные сообщения об ошибках API ### Архитектурные улучшения - **Модульность компонентов**: Лучшее разделение ответственности - **Пользовательские хуки**: Повторно используемая логика извлечена в хуки - **Контекст провайдеры**: Централизованное управление состоянием - **Утилиты**: Общие утилиты для общих операций ## 📝 Кардинальные изменения ### Обновления конфигурации - **Настройки языка**: Новый формат хранения языковых предпочтений - **Хранение шаблонов**: Шаблоны теперь хранятся в домашней папке пользователя - **Структура URL**: Обновленные шаблоны URL для лучшей навигации ### Изменения API - **Эндпоинты профилей**: Обновленные форматы ответов включают больше метаданных - **Эндпоинты задач**: Расширены дополнительными опциями фильтрации - **Эндпоинты шаблонов**: Новая структура эндпоинтов для управления шаблонами ## 🚀 Руководство по миграции ### С v2.1 на v3.0 1. **Выбор языка**: Ваш язык по умолчанию будет английский; выберите предпочитаемый язык из нового селектора 2. **Шаблоны**: Существующие пользовательские шаблоны будут сохранены, но могут потребовать повторной активации 3. **Кэш браузера**: Очистите кэш браузера для оптимальной производительности 4. **Данные профилей**: Все существующие профили продолжат работать без изменений ## 🎯 Резюме Версия 3.0 представляет собой значительный скачок для Task Viewer, превращая его из простого инструмента визуализации задач в комплексную платформу управления и настройки задач. С полной поддержкой интернационализации, мощным управлением шаблонами, автоматизацией на базе ИИ и возможностями отслеживания истории на основе Git, этот релиз предоставляет командам беспрецедентный контроль над их рабочими процессами разработки с помощью ИИ. Ключевые особенности этого релиза включают: - **Назначение агентов с помощью ИИ**: Используйте GPT-4 для автоматического назначения наиболее подходящих агентов задачам - **Контроль версий Git**: Автоматическое отслеживание всех изменений задач с коммитами с временными метками - **Многоязычная поддержка**: Полная интернационализация с английским, китайским и испанским языками - **Управление шаблонами**: Глубокая настройка поведения ИИ через редактирование шаблонов - **Просмотры истории**: Полная видимость эволюции проекта через Git коммиты и снимки памяти Добавление поддержки трех языков (английский, китайский, испанский) делает инструмент доступным для глобальной аудитории, в то время как система управления шаблонами позволяет глубокую настройку поведения ИИ. Интеграция Git обеспечивает постоянный аудиторский след всех модификаций задач, а функция массового назначения с помощью ИИ значительно ускоряет настройку задач. Этот релиз закладывает основу для будущих усовершенствований и позиционирует Task Viewer как важный инструмент в современном наборе инструментов для разработки с помощью ИИ.