dir

Показывает дерево каталогов с глубиной, масками, фильтрами, сортировкой, метаданными и итогами.

ФайлыВерсия 1.2.4Стабильная
lil-terminal

Обзор

Используйте dir, когда плоского просмотра из cd недостаточно: задавайте глубину, маски, фильтры файлов и каталогов, группировку, сортировку и итоги без системных ls и find.

Осмысленный просмотр структуры каталога

Глубина, маски и сортировка превращают большое дерево в конкретный вопрос: что здесь есть, где это находится и какие элементы действительно важны?

Синтаксис

lil-terminal
dir [depth] [path] [mask] [options]

Справочник

dir | dir 1

показать дерево текущего каталога глубиной в один уровень

dir 0 [path]

показать плоский список

dir <depth> [path]

показать дерево до выбранной глубины

dir -R [path]

показать рекурсивное дерево

dir [path] <mask>

показать совпавшие файлы и только необходимые для них родительские каталоги

-F | -f

только каталоги | только файлы

-p

показать полные пути

-G | -g

сначала каталоги | сначала файлы

-sum

показать итоги по каталогам, файлам, ссылкам и размеру

-a | -A

сортировать по имени по возрастанию | убыванию

-e | -E

сортировать по расширению по возрастанию | убыванию

-d | -D

сортировать по времени изменения по возрастанию | убыванию

-s | -S

сортировать по размеру по возрастанию | убыванию

-u

показать владельца в файловой системе

Колонки и сортировка

Все параметры начинаются с -. В каждой паре сортировки строчный флаг задаёт порядок по возрастанию, а соответствующий прописной — по убыванию. -d/-D одновременно показывает время изменения, -s/-S — размер, а -u добавляет владельца в файловой системе. Метаданные выводятся непосредственно перед именем или веткой дерева и остаются компактно слева; всё оставшееся место получает имя или путь.

Фильтры и маски

-F ограничивает вывод каталогами, а -f — обычными файлами; символические ссылки остаются отдельным типом элементов. Маска вроде "*.php" фильтрует файлы, сохраняя родительские каталоги, необходимые для понимания расположения совпадений. -p разворачивает отображаемые имена в полные пути lil-terminal.

Ограничения

Глубина ограничена 20, один запуск — 5000 элементами; символические ссылки на каталоги рекурсивно не обходятся.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Показать дерево до выбранной глубины

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install dir
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install dir -m
Точная публичная версия

Установить именно эту опубликованную версию.

install dir -v 1.2.4
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade dir
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install dir -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Показать дерево до выбранной глубины
cd \sandbox | dir 2 . -G -a
archives
config
  .env.example
  app.ini
  app.json
data
  sample.csv
  sample.txt
  users.json
Показать полные пути
dir 0 \sandbox -p
/sandbox/archives
/sandbox/config
/sandbox/data
/sandbox/feed.xml
/sandbox/images
Показать совпавшие файлы и только необходимые для них родительские каталоги
dir 3 \sandbox "*.php" -G
src
  Calculator.php
  index.php
scripts
  task.py
Только каталоги | только файлы
dir 2 \sandbox -F
archives
config
data
db
images
logs
public
scripts
tmp
workspace
Сортировать по расширению по возрастанию | убыванию
dir 2 \sandbox -f -e
README.txt
feed.xml
new.txt
test.txt
Сортировать по времени изменения по возрастанию | убыванию
dir 2 \sandbox -d
2026-08-04 23:20:34    archives
2026-08-08 23:20:40    config
2026-08-08 20:18:28    new.txt
Сортировать по размеру по возрастанию | убыванию
dir 2 \sandbox -S
 39 KB    123.jpg.tar
37.4 KB    123.jpg
1.3 KB    feed.xml
Показать владельца в файловой системе
dir 1 \sandbox -u
www-data    archives
www-data    config
www-data    feed.xml
Показать итоги по каталогам, файлам, ссылкам и размеру
dir 2 \sandbox -sum
archives
config
data
...

Каталоги  10
Файлы  18
Ссылки  0
Размер  44.2 KB
Только каталоги | только файлы
dir 2 \sandbox -F -f
Конфликтующие фильтры

Файл из примера: sandbox/README.txt

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

lil-terminal documentation sandbox

This directory is part of the server tree: website_e36e9fed/sandbox/.
It is never included in generated lil-terminal downloads and direct HTTP access is blocked.
The documentation renderer reads only explicitly allow-listed files from here and
uses them to show real, reproducible command examples.

The fixtures are intentionally small and contain no secrets. They cover PHP, HTML,
CSS, JavaScript, JSON, INI, SQL, Python, shell, XML/SVG, CSV, plain text, logs,
images, .lil workflows, archives and temporary work paths.

During module review, examples may be refined together with the command. Keep paths
stable whenever possible because public documentation links refer to them.

Связанная документация

Как защищены файловые операции? →Почему ограничены большие файлы и объём вывода? →

Текущая публичная версия

v1.2.42026-08-13

Более читаемые метаданные

Увеличивает интервал перед колонкой имени и аккуратно выравнивает размеры, сохраняя стандартные единицы B, KB, MB, GB и TB.

# История версий