Respostas sobre depuração de Bash: códigos de saída, argumentos e linters

A opção -x faz o Bash imprimir cada comando, com os argumentos expandidos, logo antes de executá-lo, para que você veja exatamente onde o script falhou. Inicie-o com bash -x script.sh no WSL ou em um sistema Linux que você administra. A flag -eu interrompe a execução no primeiro erro ou variável não definida. No Pageferry, o cartão Shell agrupa esse rastreamento com o código de saída real.

Um linter de Bash é um programa separado que analisa seu script sem executá-lo e aponta erros prováveis, como uma variável sem aspas. Escolha seu próprio linter, instale-o no WSL ou no seu sistema Linux e peça ao agente para executá-lo com Shell. O cartão exibe as mensagens e o código de saída. Um linter não substitui uma execução de teste.

Os argumentos são os valores após o nome do script, por exemplo bash script.sh um dois. O script os lê como $1, $2 e assim por diante. $# contém a contagem, e "$@" contém todos eles como palavras separadas. Para adicionar flags e argumentos obrigatórios, verifique $# no início, imprima uma linha de uso no erro padrão e saia com código 2. Evite passar segredos como argumentos de linha de comando: outros usuários os veem na lista de processos.

Um código de saída 127 significa que o comando não foi encontrado, geralmente devido a um erro de digitação, um programa não instalado ou um PATH que não o inclui. O shell imprime uma mensagem, e o Pageferry mostra a mesma mensagem e o número no cartão Shell. Um script Bash que executa aplicativos com flags deve verificar o código de saída de cada aplicativo que inicia.

Um código 126 significa que o arquivo foi encontrado, mas não pode ser executado, geralmente porque falta a permissão de execução ou não é um programa. No seu próprio script, chmod +x script.sh adiciona a permissão, após o que ./script.sh pode iniciá-lo por meio da linha shebang. Se tiver dúvidas, execute bash script.sh primeiro e leia o código de saída no cartão.

Sim, codedguru.com é o site oficial do Pageferry. O botão de download fornece o programa de instalação original de cerca de 34 MB. Você pode comparar sua soma de verificação SHA-256 com o manifesto publicado antes de executá-lo. O SmartScreen do Windows pode avisar porque o instalador ainda não é assinado digitalmente. Perguntas sobre o aplicativo são enviadas pelo botão Send feedback dentro dele.

Sim, por meio do WSL no seu próprio PC ou via SSH para um sistema Linux que você administra. O Pageferry é um aplicativo para Windows 10 e 11, então você conversa no Windows, as ferramentas de arquivo funcionam na pasta de trabalho do chat e Shell executa comandos no ambiente que você escolher. Use apenas máquinas que você tem permissão para administrar e teste em uma cópia primeiro.

Não. O agente executa os comandos e mostra a saída real, mas um script ainda pode estar errado e um modelo pode interpretar mal o problema. Leia cada diff, execute o script com valores de teste e verifique o código de saída você mesmo. O Pageferry coloca os fatos em um cartão; a decisão de aceitar uma alteração fica com você, e uma edição rejeitada não altera nada.

Ask first é um modo no qual o agente pode agir, mas pausa antes de cada ação que altera algo, como escrever um arquivo. Para uma edição, você vê o diff e aceita ou rejeita. Plan only escreve um plano e não executa nada: nenhum comando e nenhuma alteração de arquivo. Você alterna o modo para executar o plano. Auto-run age imediatamente.

Sim, a ferramenta de tarefa inicia subagentes em paralelo. Dentro de um script Bash, você pode iniciar trabalhos concorrentes em segundo plano com & e usar wait. A agregação de códigos de saída é então sua responsabilidade: aguarde cada ID de processo e colete seu status você mesmo, porque $? contém apenas o status do último comando. Teste esse script em sua própria máquina.

Sim, com um modelo em nuvem, o prompt, incluindo o texto dos arquivos lidos pelo agente, vai para esse provedor. Com um modelo local, nada sai da máquina. Em ambos os casos, chats, pastas de trabalho e chaves de API permanecem no PC, e segredos na saída da ferramenta são mascarados antes de chegarem ao modelo. Você escolhe o endpoint, então escolha-o pensando no seu script.

Não, o instalador ainda não é assinado digitalmente, então o SmartScreen do Windows pode avisar quando você o executa. Compare a soma de verificação SHA-256 do arquivo baixado com o manifesto publicado e, em seguida, escolha Executar mesmo assim em Mais informações. No Windows, certutil -hashfile com o caminho do arquivo e SHA256 imprime o valor para comparação.

34 MB é o tamanho do programa de instalação que o botão de download fornece. Um .exe portátil único de cerca de 25 MB também existe, mas o botão não o fornece. Ambos são construídos para Windows 10 e 11, e a versão atual é 2.9.26. Após a instalação, o aplicativo mostra um botão Atualizar quando uma nova versão está pronta.

Não é necessária nenhuma conta para executar o aplicativo. Se você precisa de uma conexão com a rede depende do modelo: um provedor de IA em nuvem precisa dela, um modelo local não precisa, e busca na web, verificações de atualização e o controle de chats de um navegador de telefone são recursos de rede opcionais. O controle pelo telefone usa uma conexão de saída e pode ser desativado.