Struktura katalogów#

vCLU przechowuje wszystkie dane w jednym katalogu. Poniżej opis katalogów z podziałem na te, które edytujesz, i te, które system zarządza sam.

Drzewo katalogów#

data/
├── .vclu.json              ← Główne ustawienia (panel webowy)
│
├── clu/
│   ├── modules/            ← Twój kod automatyzacji (Lua)
│   │   ├── init.lua        ← Ładowany jako pierwszy
│   │   ├── lights.lua      ← Przykład: oświetlenie
│   │   └── scenes.lua      ← Przykład: sceny
│   │
│   ├── plugins/            ← Zainstalowane pluginy
│   │   ├── zigbee2mqtt/
│   │   ├── shelly/
│   │   └── ...
│   │
│   ├── om.lua              ← Pliki Grenton OM (nie edytuj)
│   ├── user.lua            ← Pliki Grenton OM (nie edytuj)
│   ├── main.lua            ← Identyfikacja CLU (nie edytuj)
│   ├── config.txt          ← Konfiguracja TFTP (nie edytuj)
│   ├── CONFIG.JSON         ← Konfiguracja modułów (nie edytuj)
│   │
│   ├── kv/                 ← Dane pluginów (nie edytuj)
│   ├── metrics/            ← Dane wykresów (nie edytuj)
│   ├── backups/            ← Automatyczne kopie zapasowe
│   └── imports/            ← Proxy zdalnych CLU (nie edytuj)

Katalogi, które Cię dotyczą#

modules/ - Twój kod#

Tu piszesz automatyzacje w Lua. Pliki ładowane są automatycznie przy starcie:

init.lua - zawsze pierwszy (konfiguracja MQTT, definicje obiektów)
Pozostałe pliki *.lua - w kolejności alfabetycznej

Edytujesz te pliki przez edytor webowy w panelu lub przez agenta AI (MCP).

plugins/ - zainstalowane pluginy#

Każdy plugin to osobny katalog. Pluginy instalujesz przez panel webowy (Ustawienia > Pluginy) - nie musisz ręcznie pobierać plików.

.vclu.json - ustawienia#

Główny plik konfiguracyjny. Edytowany automatycznie przez panel webowy. Ręczna edycja tylko w zaawansowanych scenariuszach (wymaga restartu).

Katalogi systemowe (nie ruszaj)#

Katalog	Co zawiera
`om.lua`, `user.lua`, `main.lua`	Pliki wygenerowane przez Grenton OM
`config.txt`, `CONFIG.JSON`	Konfiguracja dla Object Managera
`kv/`	Dane pluginów (stany urządzeń, cache)
`metrics/`	Dane do wykresów na dashboardzie
`backups/`	Kopie zapasowe tworzone automatycznie
`imports/`	Obiekty proxy z innych CLU

Zasada ogólna#

Edytuj przez panel webowy lub agenta AI. Nie modyfikuj plików systemowych ręcznie - możesz uszkodzić konfigurację.

Agent AI pracuje wyłącznie w katalogu modules/ - nie może modyfikować plików systemowych ani konfiguracji. To bezpieczne ograniczenie.