Перейти к содержимому
Hagicode Docs
Блог

Установка HagiTask

Редактировать страницу

Для кого: Для пользователей, которые хотят установить задачи сообщества и использовать их в HagiCode.

Предварительные требования:

  • Доступ к используемому приложению HagiCode и серверной службе.
  • Версия приложения, поддерживающая управление задачами сообщества HagiTask и Community Gallery.
  • Необходимые задаче агенты, skills или инструменты CLI уже подготовлены; требования указаны в подробностях задачи.

Поддерживаемый сейчас процесс: найти сведения о задаче и ZIP-архив в Community Gallery на HagiTask Site, а затем воспользоваться функцией установки задач сообщества в приложении:

  1. Найдите задачу в Gallery по названию, категории или тегам.
  2. Откройте страницу задачи и проверьте версию, издателя, совместимость и размер установки.
  3. Выберите установку. Приложение получит ZIP по адресу packageUrl и проверит идентификатор задачи, версию и SHA-256.
  4. После успешной проверки приложение запишет пакет в локальный каталог данных HagiTask и обновит каталог задач.

Адреса Gallery для поиска, подробностей и архивов соответственно: /index.json, /tasks/<taskId>.json и /packages/<taskId>.zip. Для установки используется архив; разбирать содержимое веб-страницы не требуется.

Установка из архива

Если вы уже получили ZIP поддерживаемым способом через Gallery, выберите установку локального архива в интерфейсе управления задачами сообщества. Архив должен содержать полный каталог пакета задач; его ID, версия и хеш содержимого должны совпадать с данными запроса на установку.

Загрузка локальной папки через браузер не входит в текущий процесс установки из Community Gallery. Настройка источников в виде папок на сервере служит другой цели; подробности см. в разделе Использование HagiTask.

Проверка установки

После установки проверьте в интерфейсе управления задачами сообщества, что:

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

В записи об установке сохраняются источник, версия, хеш архива и состояние включения. Встроенные задачи показываются только для ознакомления: удалить их как пакеты сообщества нельзя.

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

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

Задача не находится или подробности некорректны

Используйте канонический taskId из подробностей задачи, а не отображаемый псевдоним. agentsmd и portytail — только понятные человеку псевдонимы для claude-md-update и ponytail, а не идентификаторы устанавливаемых задач.

Ошибка проверки целостности или версии

Загрузите архив из Gallery заново. Не изменяйте ZIP и созданные файлы каталога вручную. Если ошибка сохраняется, попросите сопровождающего пакета проверить исходные данные и номер версии в Community Packages.

Задача недоступна после установки

Проверьте требования к агентам, skills и CLI в подробностях задачи; убедитесь, что задача включена в приложении, и обновите каталог. Если содержимое пакета некорректно, обратитесь к руководству для участников сообщества, где описаны схема и процесс проверки.

Следующий шаг: Использование HagiTask.