Todas as ferramentas

file_list

Ficheiros e Finder · macOS · Windows

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Lista arquivos e pastas em um diretório local. O padrão é o diretório inicial do usuário. Retorna nome, caminho, tipo (arquivo/diretório), tamanho e data de modificação de cada item. Classificado: primeiro os diretórios e depois os arquivos, ambos em ordem alfabética.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglêsmacOS
{
  "properties": {
    "path": {
      "description": "Absolute path to the directory. Defaults to the home directory (~) if omitted.",
      "type": "string"
    },
    "show_hidden": {
      "description": "Include hidden files (starting with '.'). Default false.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para file_list. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "path": "/Users/demo/Documents"
}

Windows

Finalidade

Lista arquivos e pastas em um diretório local. O padrão é o diretório inicial do usuário. Retorna nome, caminho, tipo (arquivo/diretório), tamanho e hora de modificação de cada item. O caminho deve estar dentro de uma pasta permitida (diretório inicial por padrão).

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglêsWindows
{
  "properties": {
    "path": {
      "description": "Absolute path to the directory. Defaults to the home directory (~) if omitted.",
      "type": "string"
    },
    "show_hidden": {
      "description": "Include hidden files (dotfiles). Default false.",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para file_list. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "path": "C:\\Users\\demo\\Documents"
}