openpencil/packages/docs/de/programmable/cli/inspecting.md
Danila Poyarkov b9753aa016
docs: sync translations with documentation changes since v0.15.1 (#886)
Eleven translated pages changed in English since the last release without
matching updates: system requirements, the Lint tab, AI chat diff tools,
collaboration with agents, design JSX imports and export fidelity,
Storybook and live-app export, lint fixes, page navigation, and Checking
Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections
the abridged translations lacked where a change landed, use each
language's UI labels, and point the export page at documents list.
2026-10-04 16:38:35 +00:00

2.1 KiB
Raw Blame History

title description
Dateien untersuchen Dokumentbaum, Objekte, Seiten und Variablen über die CLI lesen.

Dateien untersuchen

Die CLI liest .fig-Dateien, ohne den Editor zu öffnen. Läuft die Desktop-App, kann der Dateiname entfallen; die CLI verwendet dann RPC für das geöffnete Dokument.

::: tip Installation

npm install -g @open-pencil/cli
# oder
bun add -g @open-pencil/cli

:::

Dokumentinformationen

openpencil info design.fig

Zeigt Seiten, Objektanzahl, verwendete Schriften und Dateigröße.

Dokumentbaum und Suche

openpencil tree design.fig
openpencil find design.fig --type TEXT
openpencil find design.fig --name "Button"

XPath-Abfragen

openpencil query design.fig "//FRAME"
openpencil query design.fig "//TEXT[@fontSize >= 24]"
openpencil query design.fig "//*[@visible = false]"

Attributnamen wie fontSize, layoutMode und strokeWeight entsprechen der API und bleiben unverändert.

Objekte, Seiten und Variablen

openpencil node design.fig --id 1:23
openpencil pages design.fig
openpencil variables design.fig

Geöffnetes Dokument

openpencil documents list
openpencil tree --document-id tab-123 --page-id 0:1

Für automatisierte Abläufe zuerst openpencil documents list --json aufrufen und anschließend --document-id und --page-id ausdrücklich übergeben. Dokumente öffnen, speichern, wechseln und schließen, Rückgängig machen, Einstellungen ändern und beliebige Editor-Werkzeuge aufrufen: siehe Controlling the App.

Qualitätsprüfung

openpencil lint design.fig
openpencil lint design.pen --preset strict
openpencil lint design.fig --rule color-contrast
openpencil lint design.fig --fix -o fixed.fig

Alle Befehle unterstützen --json; jede Meldung enthält ihre fix- und suggestions-Angaben als Daten. --fix wendet die sicheren Korrekturen an – Farben werden an die passende Farbvariable gebunden und die Geometrie auf ganze Pixel gerundet – und schreibt das Ergebnis in die mit -o angegebene .fig-Datei.