Přeskočit obsah

Generování doplňku pomocí AI

Pro generování doplňku pomocí AI je připravený hotový prompt ke stažení v souboru addons/ESP_IDE_ADDON_MANUAL_PROMPT.md.

Podrobnou strukturu souboru popisuje stránka Formát souboru .newblk.

Pokud AI vytváří doplněk pro displej, musí znát i pravidla pro grafický návrhář: registraci ESPIDE_DISPLAY_TARGETS, proměnné display, buffer, fbuf a display.show(). Jsou popsána na stránce Displeje a grafický návrhář a jsou součástí aktualizovaného hotového promptu.

Pokud nechceš generovat doplněk od nuly, ale převádíš existující Arduino knihovnu, použij samostatný návod Převod Arduino knihovny do .newblk pomocí AI.

Jak postupovat

  1. Sepiš zadání doplňku: název, účel, cílový hardware a bloky, které má obsahovat.
  2. Stáhni si prompt ze souboru addons/ESP_IDE_ADDON_MANUAL_PROMPT.md.
  3. Doplň placeholdery a nech AI vygenerovat jeden soubor .newblk.
  4. Zkontroluj výsledek v textu i v ESP IDE.
  5. Nahraj doplněk přes Správce doplňků a klikni na Uložit změny.

Co si připravit před generováním

  • název doplňku a krátký popis účelu
  • cílovou desku nebo rodinu desek
  • seznam bloků, které má doplněk obsahovat
  • které bloky jen čtou hodnoty a které generují kód
  • jestli doplněk potřebuje tlačítko, upload nebo jiné callbacky
  • jestli má mít výchozí piny podle procesoru
  • zda jde o doplněk pro displej, jeho rozlišení a případné další podporované panely
  • zda ovladač poskytuje framebuffer, display.show(), buffer a fbuf

Co musí být ve výstupu

  • právě jeden delimiter <!toolbox!>
  • JavaScript část s definicí Blockly.Blocks[...]
  • Python generátory Blockly.Python[...]
  • případně demoWorkspace.registerButtonCallback(...)
  • XML toolbox fragment bez <xml> wrapperu
  • metadata hlavička je doporučená, ale není povinná

Typické chyby

  • delimiter <!toolbox!> je v souboru víckrát
  • blok je v XML, ale v JS pro něj není definice
  • blok generuje kód, ale chybí Blockly.Python[...]
  • tlačítko v toolboxu má callbackKey, ale není zaregistrovaný callback
  • AI vygeneruje příliš obecný nebo nekompatibilní kód, který je potřeba ručně upravit

Kdy je prompt vhodný

  • když chceš vytvořit nový doplněk bez ručního psaní celé struktury
  • když AI nemá přímý přístup ke zdrojovým souborům projektu
  • když potřebuješ rovnou připravit i metadata, pin defaults nebo upload tlačítko

Pozor

  • Delimiter nesmí být v souboru víckrát.
  • Pokud AI vygeneruje blok, musí mít odpovídající generator.
  • Po nahrání doplňku vždy klikni na Uložit změny.