sistema · Referência do comando
qzx listProcesses
O que faz
Lista os processos em execução com uso real de CPU por amostragem.
Maturidade do comando: Alpha
Disponível para uso real e feedback enquanto a interface e o comportamento ainda podem evoluir. Esta é a avaliação atual do checkout de desenvolvimento. Cada tag de release imutável futuro preservará a avaliação exata incluída nessa versão. Disponível no PyPI 0.2.2.0.15. A documentação corresponde ao checkout alpha 0.2.2.0.15.
Comportamento e proteções integradas
Inspeciona sem alterar o estado
Execução direta para esta operação
Funciona sem invocar programas nativos
Funciona sem usar a rede
Projetado para funcionar sem elevação
Esta classificação de segurança foi revisada por Claude Opus 5.5 (Anthropic) em relação ao digest de implementação sha256:58478fcdbdbcce78b8e761988b1c996b7e540fedca13b51c2ee70ed4ffea327b em 2026-10-08.
Sintaxe exata
qzx listProcesses [filter_str] [sort_by] [limit] --jsonParâmetros
Deslize ou use a barra horizontal para ver todas as colunas.
| Nome | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| filter_str | str | Não | Não declarado | Texto opcional para filtrar nomes de processos |
| sort_by | str | Não | "cpu" | Campo usado para ordenar os resultados (pid, cpu, memory ou name) |
| limit | int | Não | 25 | Número máximo de processos a retornar (padrão 25; 0 ou null retorna todos) |
Exemplos de entrada
qzx listProcessesListar os 25 processos que mais usam CPU neste momento
qzx listProcesses pythonListar processos cujo nome contenha "python"
qzx listProcesses null memory 10Listar os 10 processos com maior uso de memória
qzx listProcesses null pid 0Listar todos os processos em execução ordenados por PID
Para obter o payload estruturado completo, adicione --json: qzx listProcesses [filter_str] [sort_by] [limit] --json
Exemplo de saída representativa
Este JSON ilustrativo deriva do contrato de resultado respaldado pela implementação atual. Mostra o que o comando pode retornar sem afirmar que seja uma execução gravada; os valores variam conforme entradas, máquina, permissões e ferramentas opcionais.
Comando do exemplo: qzx listProcesses --json
{
"success": true,
"message": "Lists running processes with real CPU usage sampled over 0.5 s (similar to 'ps'/'top'). In this illustrative example, the command completed successfully.",
"meta": {
"command": "listProcesses",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"collection_method": "Example value",
"cpu_percent_scale": "Example value",
"cpu_sample_seconds": [
{
"name": "example",
"status": "ok"
}
],
"displayed_processes": [
{
"name": "example",
"status": "ok"
}
],
"filter": "Example value",
"limit": null,
"os_type": "Windows",
"processes": [
{
"pid": 4210,
"name": "python",
"cpu_percent": 4.2,
"memory_readable": "82.4 MiB"
}
],
"sort_by": "Example value",
"total_processes": 3
}Ver o contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"collection_method": [],
"cpu_percent_scale": {
"type": "string"
},
"cpu_sample_seconds": [],
"displayed_processes": [],
"error": {
"type": "string"
},
"filter": [],
"limit": {
"type": "null"
},
"os_type": [],
"processes": [],
"sort_by": [],
"total_processes": []
},
"additionalProperties": true
}Erros e limites
O contrato público exige success=false e uma message descritiva em caso de falha. Este catálogo ainda não declara uma taxonomia de erros específica para cada comando; revise o resultado e não infira códigos inexistentes.
O QZX está em alpha. Dependências opcionais, permissões e recursos do host podem alterar o resultado.
Fluxo de evidência: pronta para captura automática determinística.
Evidência e procedência
- Implementação
- src/qzx/commands/system/list_processes.py
- Canal de documentação
- Documentação de desenvolvimento 0.2.2.0.15 · main · sha256:b91acee86268edb7cb018a94e089ff8e95835eda3f2cf08b39796c0ab9654693
- Disponibilidade
- 0.2.2.0.15 ou anterior
Continue explorando
Comandos relacionados
Estes comandos também pertencem à categoria sistema. Compare-os para escolher a operação que melhor resolve sua tarefa.
qzx listDiskDevicesObtém o nome ou modelo de um disco ou de todos os discos.qzx listStartupProgramsLista programas configurados para serem executados na inicialização do sistema ou da sessão.qzx listCommandsLista os comandos disponíveis organizados por categoria.qzx listSystemServicesLista os serviços do sistema operacional e seu estado de execução.