Ir para o conteúdo principal

Por que QZX

Dê ao seu agente
um ponto de partida claro.

O QZX reúne diagnósticos comuns em comandos documentados e resultados claros. O mesmo relatório ajuda você e a automação que trabalha ao seu lado.

Ver QZX em ação Ler o contrato de resultados
Gratuito e de código abertoSuporte a Windows, Linux e macOS conforme o comandoSaída humana e JSON

Quando uma tarefa se repete

Reaproveite a inspeção. Mantenha o contexto.

Este esquema mostra como o trabalho muda quando uma operação do QZX atende à tarefa. É uma comparação conceitual do fluxo.

Antes

Reconstruir a inspeção

  1. Escolher o comando

    Identificar as ferramentas e os parâmetros disponíveis no ambiente.

  2. Interpretar as saídas

    Reunir os dados retornados por cada verificação.

  3. Preparar o contexto

    Organizar as observações antes de decidir o próximo passo.

Com QZX

Partir de uma operação documentada

qzx diagnoseProject . --json
  1. Solicitar um diagnóstico

    Usar o comando compatível com a tarefa.

  2. Ler a evidência

    Revisar tecnologias, dependências, pontos de atenção e verificações ainda não executadas.

  3. Decidir o próximo passo

    Compartilhar o mesmo resultado com uma pessoa ou um agente.

Exemplo capturado de um projeto de teste

Tecnologia
Python
Pacotes únicos
1
Pontos de atenção
1
Ver trecho JSON 
{
    "success": true,
    "details": {
        "technologies": [
            "Python"
        ],
        "dependencies": {
            "unique_declared_package_count": 1,
            "unique_packages": [
                "httpx"
            ]
        },
        "version_control": {
            "status": "not_repository"
        },
        "file_scan": {
            "scanned_file_count": 3,
            "scan_complete": true
        },
        "summary": {
            "issue_count": 1,
            "verification": {
                "release_readiness": "not_assessed"
            }
        },
        "validation": {
            "tests": {
                "status": "configured_not_run"
            },
            "lint": {
                "status": "configured_not_run"
            }
        }
    }
}

O que essa interface oferece

Menos trabalho repetido em torno de cada tarefa.

Um vocabulário compartilhado e resultados que você pode inspecionar.

Uma operação documentada

Nos sistemas compatíveis, reutilize o mesmo nome de comando e modelo de argumentos. O catálogo explica os parâmetros e os requisitos de cada operação.

Explorar os comandos

Legível para você. Estruturado para seu agente.

A saída legível para pessoas é o padrão. Adicione --json quando um programa ou agente precisar dos dados estruturados do mesmo resultado.

Ler o contrato de resultados

Evidência para decidir

O estado de execução e os pontos de atenção ficam em campos distintos. Você pode reconhecer uma verificação concluída cujo resultado ainda precisa de atenção.

Ver exemplos reais

Onde se encaixa

Escolha a ferramenta conforme o trabalho.

O QZX convive com APIs e comandos nativos. Use-o quando atender à operação e sua interface comum trouxer clareza.

Quando ajuda

  • Você precisa de um diagnóstico documentado que funcione nos seus sistemas compatíveis.
  • Você quer entregar ao agente um resultado estruturado com contexto útil.
  • Você prefere revisar a evidência antes de executar scripts ou alterar arquivos.

O que você ainda precisa verificar

  • Disponibilidade, dependências e diferenças entre plataformas na referência do comando.
  • Quais verificações foram realmente executadas: descobrir um teste não comprova que ele passou.
  • Permissões, backups e prévias das operações que alteram estado. O QZX usa suas permissões; a interface comum não isola a execução.

Para recursos específicos de uma plataforma, streaming ou uma integração tipada mais rigorosa, escolha a API ou ferramenta nativa adequada.

Ver compatibilidade Revisar segurança

Comece com uma tarefa concreta

Veja o resultado antes de incorporá-lo ao seu fluxo.

Explore as capturas e experimente um comando somente leitura no seu próprio ambiente.

Ver QZX em ação Instalar QZX
De onde vêm estes resultados

Capturas de 2026-10-08, com QZX 0.2.2.0.15, CPython 3.13.13 e Windows 11 10.0.26200.

Estes números pertencem aos exemplos capturados. Os comandos que você copia são executados no seu terminal, e os resultados dependem do ambiente.

Ver todos os comandos Ver compatibilidade