file_list

Файлы и Finder · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Перечисляет файлы и папки локального каталога, по умолчанию домашнего. Возвращает name, path, type (file/directory), size и дату изменения. Сначала каталоги, затем файлы; обе группы отсортированы по алфавиту.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "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"
}

Пример для документации

Пример документации для file_list. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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

Windows

Назначение

Перечисляет файлы и папки локального каталога. По умолчанию используется домашний каталог пользователя. Возвращает name, path, type (file/directory), size и время изменения для каждого элемента. Читает в любом месте этого PC, кроме расположений учетных и идентификационных данных (логины браузеров, ключи SSH и облачных сервисов, хранилища учетных данных Windows, профиль другого пользователя), которые никогда не читаются.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "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"
}

Пример для документации

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