openpencil/packages/docs/ru/programmable/cli/inspecting.md

99 lines
2.7 KiB
Markdown
Raw Normal View History

---
title: Просмотр файлов
description: Просматривайте деревья узлов, ищите по имени или типу и изучайте свойства из терминала.
---
# Просмотр файлов
CLI позволяет исследовать файлы `.fig` без открытия редактора. Каждая команда также работает с запущенным приложением — просто опустите аргумент файла.
::: tip Установка
```sh
bun add -g @open-pencil/cli
# или
brew install open-pencil/tap/open-pencil
```
:::
## Информация о документе
Краткий обзор — количество страниц, общее число узлов, используемые шрифты, размер файла:
```sh
open-pencil info design.fig
```
## Дерево узлов
Вывод полной иерархии узлов:
```sh
open-pencil tree design.fig
```
```
[0] [page] "Getting started" (0:46566)
[0] [section] "" (0:46567)
[0] [frame] "Body" (0:46568)
[0] [frame] "Introduction" (0:46569)
[0] [frame] "Introduction Card" (0:46570)
[0] [frame] "Guidance" (0:46571)
```
## Поиск узлов
Поиск по типу:
```sh
open-pencil find design.fig --type TEXT
```
Поиск по имени:
```sh
open-pencil find design.fig --name "Button"
```
Оба флага можно комбинировать для более точных результатов.
## Свойства узла
Просмотр всех свойств конкретного узла по его ID:
```sh
open-pencil node design.fig --id 1:23
```
## Страницы
Список всех страниц в документе:
```sh
open-pencil pages design.fig
```
## Переменные
Список дизайн-переменных и их коллекций:
```sh
open-pencil variables design.fig
```
## Режим работы с приложением
Когда настольное приложение запущено, опустите аргумент файла — CLI подключится по RPC и будет работать с активным холстом:
```sh
open-pencil tree # просмотр текущего документа
open-pencil eval -c "..." # запрос к редактору
```
## JSON-вывод
Все команды поддерживают `--json` для машиночитаемого вывода — передавайте в `jq`, используйте в CI-скриптах или обрабатывайте другими инструментами:
```sh
open-pencil tree design.fig --json | jq '.[] | .name'
```