dir

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

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

Обзор

Если cd показывает только одну папку, то dir помогает разобраться в целом проекте. Например, dir 2 показывает дерево до двух уровней, dir .js отбирает файлы JavaScript, а dir -sum добавляет количество файлов, папок и общий размер. Это отдельный модуль: для простой навигации достаточно более лёгкой команды cd.

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

Используйте dir, когда ищете файл в подпапках или хотите понять, как организован проект. Маска ограничит вывод нужными именами, -F оставит каталоги, -f — файлы, а -p покажет полные пути. Рекурсивный обход ограничен по глубине и количеству записей; для подсчёта реального объёма вложенных данных предназначен disk -r.

Синтаксис

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 элементами; символические ссылки на каталоги рекурсивно не обходятся.

dir .js: показать файлы с расширением .js; Если реально существует каталог .js, он имеет приоритет над фильтром расширения.

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

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

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

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

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

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

Пакет Base

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

install dir
Пакет Minimum

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

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

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

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

Поручить 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
Конфликтующие фильтры
Dir · cd
cd \sandbox | dir .js
public/
  assets/
    app.js
Показать рекурсивное дерево
dir -R \sandbox\tmp
README.txt
current.txt
draft.txt
new.txt
Показать дерево текущего каталога глубиной в один уровень
dir 1 \sandbox
config/
data/
db/
images/
logs/
public/
scripts/
src/
tmp/
workspace/
README.txt
feed.xml
Сначала каталоги | сначала файлы
dir 2 \sandbox -g
README.txt
feed.xml
config/
data/
db/
images/
logs/
public/
scripts/
src/
tmp/
workspace/
Сортировать по имени по возрастанию | убыванию
dir 2 \sandbox\tmp -A
new.txt
draft.txt
current.txt
README.txt
Сортировать по расширению по возрастанию | убыванию
dir 2 \sandbox\config -E
page.htm
app.yml
app.xml
app.toml
app.properties
app.json
app.ini
app.conf
Сортировать по времени изменения по возрастанию | убыванию
dir 2 \sandbox\tmp -D
new.txt
draft.txt
current.txt
README.txt
Сортировать по размеру по возрастанию | убыванию
dir 2 \sandbox\tmp -s
new.txt
draft.txt
current.txt
README.txt
Показать плоский список
dir 0 \sandbox
sandbox/
├── config/
├── data/
├── public/
├── scripts/
├── src/
└── workspace/

Файл из примера: 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.52026-10-31

Фильтр по расширению

dir .js filters by extension without wildcard syntax, while an existing .js directory remains addressable.

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