Introdução ao HagiTask
Para quem é este guia: Usuários, mantenedores e colaboradores que desejam conhecer o ecossistema HagiTask.
Pré-requisitos: Nenhum. Para instalar ou executar tarefas, tenha o aplicativo HagiCode e seu serviço de backend disponíveis.
O que é o HagiTask
O HagiTask é o modelo de pacotes de tarefas e tarefas predefinidas do HagiCode. Um pacote reúne a identidade da tarefa, o painel de frontend, os prompts de backend, os modelos, os textos da interface e a apresentação na loja em um único diretório verificável. Assim, o aplicativo pode descobrir, instalar, gerenciar e executar tarefas.
O pacote não é o aplicativo em si nem substitui a configuração de execução do aplicativo. O aplicativo carrega as tarefas e executa as funcionalidades declaradas por elas; o pacote apenas fornece recursos organizados em um formato definido.
Papéis no ecossistema
| Componente | Responsabilidade |
|---|---|
| HagiTask | Mantém o Schema compartilhado e os pacotes de predefinições integradas distribuídos com o produto; é a fonte de referência para o formato dos pacotes. |
| Predefinições integradas | Tarefas prontas fornecidas com o aplicativo ou o ambiente de execução, como normal-session e research-investigation. |
| Community Packages | Mantém os dados de origem das tarefas da comunidade em data/<taskId>/. |
| HagiTask Site | Gera o catálogo, os JSONs de detalhes e os arquivos ZIP a partir dos pacotes da comunidade e os publica na Community Gallery. |
| Aplicativo HagiCode | Exibe tarefas, instala pacotes, salva o estado de ativação e executa tarefas. |
As predefinições integradas e as tarefas da comunidade usam o mesmo Schema de pacote, mas têm origens e ciclos de vida diferentes: as predefinições são mantidas no repositório HagiTask; as tarefas da comunidade, no repositório Community Packages. O /index.json, os documentos de detalhes e os ZIPs do site são artefatos gerados, não arquivos de origem editados diretamente por colaboradores.
Gerenciar pacotes não é o mesmo que gerenciar fontes
Instalar um ZIP da Gallery copia o pacote para o diretório de dados do aplicativo e registra sua versão, origem e estado de ativação. Já o gerenciamento de fontes do servidor configura diretórios acessíveis ao servidor para que o ambiente de execução descubra tarefas neles; ele não envia uma pasta local do navegador como pacote instalável.
Para entender essa distinção e as fontes baseadas em pastas, leia Como usar o HagiTask. Para começar a instalar, consulte Como instalar o HagiTask; para criar ou publicar tarefas, leia Como contribuir com a comunidade.
Responsabilidades pelas fontes de referência
- A documentação mantém as explicações e os guias operacionais para usuários e colaboradores.
- O HagiTask mantém o Schema compartilhado e as predefinições integradas.
- O Community Packages mantém os dados de origem dos pacotes da comunidade.
- O HagiTask Site publica o catálogo, os detalhes e os arquivos gerados a partir dos pacotes.
Próximo passo: Como instalar o HagiTask.