Como instalar o HagiTask

Para quem é este guia: Usuários que desejam instalar tarefas da comunidade e usá-las no HagiCode.

Pré-requisitos:

• Acesso ao aplicativo HagiCode em uso e ao serviço de backend.
• Uma versão do aplicativo compatível com o gerenciamento de tarefas da comunidade do HagiTask e com a Community Gallery.
• Os agentes, skills ou dependências de CLI exigidos pela tarefa já estão disponíveis; consulte os requisitos nos detalhes da tarefa.

Instalar pela Community Gallery

O fluxo atualmente aceito usa a Community Gallery do HagiTask Site para obter os detalhes da tarefa e o arquivo ZIP e, em seguida, instala o pacote pelo recurso de instalação de tarefas da comunidade do aplicativo:

1. Encontre a tarefa na Gallery pelo nome, categoria ou tags.
2. Abra os detalhes e confira a versão, o publicador, a compatibilidade e o tamanho do download.
3. Selecione a opção de instalar. O aplicativo baixa o ZIP de packageUrl e verifica o ID da tarefa, a versão e o SHA-256.
4. Após a validação, o aplicativo grava o pacote no diretório local de dados do HagiTask e atualiza o catálogo de tarefas.

Os pontos de acesso da Gallery para descoberta, detalhes e arquivos são, respectivamente, /index.json, /tasks/<taskId>.json e /packages/<taskId>.zip. A instalação usa o arquivo; não é necessário analisar o conteúdo da página do site.

Usar um arquivo ZIP

Se você já obteve o ZIP pelo fluxo aceito da Gallery, pode selecionar a instalação de um arquivo local na interface de gerenciamento de tarefas da comunidade do aplicativo. O arquivo deve conter o diretório completo do pacote de tarefas; o ID, a versão e o resumo de conteúdo devem corresponder à solicitação de instalação.

O envio de uma pasta local pelo navegador não faz parte do fluxo atual de instalação da Community Gallery. A configuração de fontes de pastas no servidor tem outra finalidade; veja Como usar o HagiTask.

Verificar a instalação

Após a instalação, confirme na interface de gerenciamento de tarefas da comunidade que:

• A tarefa exibe o taskId, a versão e o publicador corretos.
• A tarefa está ativada ou pode ser ativada manualmente.
• Os avisos de dependência e compatibilidade não indicam requisitos pendentes.
• A tarefa continua presente após atualizar o catálogo e seu painel pode ser aberto.

O registro de instalação armazena a origem, a versão, o resumo do arquivo e o estado de ativação. Tarefas integradas são exibidas apenas para consulta e não podem ser desinstaladas como pacotes da comunidade.

Solução de problemas

Não é possível acessar a Gallery

Confirme que o endereço da Gallery configurado no aplicativo está disponível e usa HTTPS. Verifique também a rede, os tempos limite e o estado do site. Se a primeira consulta ao catálogo falhar, o aplicativo não criará um catálogo vazio fictício; se houver um cache válido, poderá exibir temporariamente o catálogo anterior.

A tarefa não aparece ou os detalhes são inválidos

Use o taskId canônico informado nos detalhes, não um apelido de exibição. agentsmd e portytail são apenas apelidos legíveis para claude-md-update e ponytail, não IDs de tarefas instaláveis.

Falha na verificação de integridade ou versão

Baixe novamente o arquivo da Gallery; não altere manualmente o ZIP nem os arquivos gerados do catálogo. Se o problema persistir, peça ao mantenedor do pacote que verifique os dados de origem e o número da versão no Community Packages.

A tarefa não funciona após a instalação

Confira os requisitos de agentes, skills e CLI nos detalhes da tarefa; confirme que ela está ativada no aplicativo e atualize o catálogo. Se o conteúdo do pacote for inválido, consulte o guia de contribuição da comunidade para entender o Schema e o processo de validação.

Próximo passo: Como usar o HagiTask.