Přehled pluginů

Soubory a nástroje pro repozitáře

Otevřete Nastavení → Pluginy a prohlédněte si vestavěný plugin files nebo ho nastavte. V chatu může Elowen jeho deseti nástroji číst, prohledávat, vypisovat a měnit soubory na místech, kam aktuální konverzace dosáhne, a kopírovat nebo přesouvat jeden soubor mezi dvěma Projekty. Plugin nemá vlastní stránku ani příkaz se lomítkem.

Nástroje

Nástroj	Co dělá
`Read`	Čte text, obrázky, PDF a Jupyter notebooky. Velké soubory lze číst po částech.
`Write`	Vytvoří soubor nebo nahradí celý jeho obsah.
`Edit`	Nahradí jeden přesný kus textu v souboru.
`ListDir`	Vypíše jeden adresář.
`Search`	Hledá text v obsahu souborů bez ohledu na velikost písmen.
`Grep`	Hledá pomocí regulárních výrazů a voleb, jako je rozlišování velikosti písmen nebo kontextové řádky.
`Glob`	Najde soubory podle vzoru názvu, nejnovější první.
`FileInfo`	Ukáže velikost, typ a čas poslední změny souboru nebo adresáře.
`GitStatus`	Ukáže větev Git, repozitář a krátký přehled změněných souborů.
`TransferFile`	Zkopíruje nebo přesune jeden soubor mezi dvěma dostupnými Projekty, včetně počítače.

Přístup k souborům a bezpečné úpravy

Nástroje pro soubory se řídí přístupem aktuální konverzace k Projektu a k cestám. Ve spravovaném Projektu je dostupný souborový systém sdíleného prostředí Projektu. Cesta mimo povolenou hranici je odmítnuta.

V Projektu typu Počítač pracují stejné nástroje se soubory přímo na tomto počítači. Absolutní cesty mimo složku, ve které běží jeho připojení, jsou povolené, pokud na ně dosáhne účet operačního systému tohoto počítače. Čtení opravňuje k pozdější úpravě jen na stejném počítači; jiný počítač ho nepřevezme. Pokud připojení spadne, nástroj ohlásí ztracené připojení a nikdy se nepřesune na soubory serveru. GitStatus tam není dostupný a dá to najevo.

Než soubor změníte pomocí Write nebo Edit, přečtěte ho. Nástroje úpravu odmítnou i tehdy, když se soubor od přečtení změnil. Příkaz v shellu, který soubor jen vypíše, tento požadavek nesplní; použijte Read.

Write nahradí celý soubor. Pro cílenou změnu použijte Edit; nahrazuje vždy jednu přesnou shodu. Úspěšné čtení velkého souboru lze stránkovat, ale kontrola přečtení před zápisem pokrývá celý soubor.

TransferFile určuje Projekt a cestu na obou stranách a přenáší vždy jeden soubor. Cíl se vytvoří, pokud přenos nenahrazuje verzi, kterou dostal; přesun odstraní zdroj až po zapsání cíle a zrušený nebo přerušený přenos se sám nikdy neopakuje. Stejně jako Write a Edit vyžaduje ve výchozím nastavení Vaše schválení.

Zapněte a nastavte plugin

Plugin je součástí instalace a v nové instalaci je zapnutý. Administrátoři jej mohou zapnout nebo vypnout v Nastavení → Pluginy. Nelze jej přidělovat jednotlivě. Jeho nastavení platí pro celou instanci a upravuje se v detailu pluginu v Nastavení → Pluginy.

Nastavení	Klíč	Výchozí	Rozsah	Účel
Limit čtení	`readCap`	100 kB	20–500 kB	Nejvyšší počet bajtů vrácených jedním čtením. Editor používá desetinné kB; uložené hodnoty zůstávají v bajtech.
Limit shod ve vyhledávání	`searchMaxMatches`	200	50–1 000	Výsledky vrácené nástrojem Search a výsledky na jedné stránce nástroje Grep.
Nejvyšší počet výsledků Glob	`globMax`	100	10–500	Soubory vrácené jedním hledáním Glob.
Stránky PDF na jedno čtení	`pdfMaxPages`	20	10–20	Nejvyšší počet stránek vyžádaných jedním čtením PDF.

Limity a chování

Read zobrazí ve výchozím nastavení 2 000 řádků. Pro stránkování textového souboru použijte offset a limit. Každá textová stránka, i s výslovně zadaným limit, musí splnit nastavený limit čtení i živý limit vloženého výstupu, včetně čísel řádků a oznámení o stránkování. Příliš velké stránky jsou odmítnuty a neopravňují k Write ani Edit; vyžádejte menší stránku. Posuny řádků nemohou rozdělit dlouhý řádek: použijte cílený strukturovaný filtr nebo omezený výřez přes Bash. Úspěšná malá stránka přesto spočítá hash celého souboru pro pozdější kontroly změn.
Nestránkované čtení je odmítnuto, pokud jeho odhadovaná cena v tokenech přesáhne 25 000. PDF do 10 stránek může rozsah stránek vynechat; větší PDF ho potřebuje. Použijte rozsahy jako 3, 1-5 nebo 1,3,5. Naskenované stránky se vrací jako obrázky, nejvýše pět na volání.
Podporované obrázky jsou JPG, PNG, GIF, WebP a BMP. Elowen každý obrázek zmenší tak, aby se vešel do 2 000 × 2 000 pixelů, a vrátí ho jako přílohu. Když zmenšení selže, originál se odešle beze změny jen tehdy, jde-li o JPG, PNG, GIF nebo WebP do 3,75 MB; jinak se obrázek vynechá a výsledek to uvede.
Write, Edit a TransferFile mohou měnit soubory; ostatní nástroje jsou jen pro čtení a lze je použít v režimu Plánování.
Search a Grep vyžadují ripgrep. Search ignoruje velikost písmen; Grep rozlišuje velikost písmen, pokud nezadáte jinak. Nastavte multiline: true pro shody přes více řádků. Search přeskakuje .git, node_modules, dist, web-dist, .next a .turbo. Grep se zadaným typem spustí hledání přímo v jednom provedení. Jen běžný návratový kód ripgrepu 2 spustí vyhledání seznamu typů, které vysvětlí neznámý typ; u známého typu zůstává původní chyba hledání. Výsledky bez shod zůstávají prázdné a chybějící programy, signály, časové limity ani chyby přenosu toto vyhledání nespustí.
Search má časový limit pět sekund. Výsledky Search a stránky Grep omezuje searchMaxMatches; pro pokračování výpisu Grep použijte offset. Řádky se shodou jsou omezeny na 500 sloupců. Každá stránka Grep pojme nejvýše stejný počet výsledků a její obsahový režim ukazuje řádky se shodou.
Glob vrací ve výchozím nastavení nejvýše 100 souborů a zastaví se po projití 10 000 souborů. Na hostiteli přeskakuje nečitelné podadresáře a výslovně uvede, že jsou výsledky neúplné. Nečitelný kořen hledání nebo jiná chyba souborového systému hledání ukončí chybou. Výpis adresáře ve spravovaném Projektu je omezen na 1 000 položek. GitStatus ukáže nejvýše 120 položek změněných souborů.
Úprava souboru většího než 1 GB je odmítnuta. Čtení vybraných souborů zařízení a typů souborů, které plugin neumí zobrazit, je odmítnuto.
Podpora PDF vyžaduje nástroje Poppler (pdfinfo, pdftotext a pdftoppm) na počítači nebo v prostředí, kde soubor leží, s časovým limitem 30 sekund na každý příkaz převodníku. Na spárovaném počítači nainstalujte Poppler příkazem winget install --id oschwartz10612.Poppler -e ve Windows, brew install poppler v macOS nebo apt install poppler-utils / dnf install poppler-utils v Linuxu. Potom na tomto počítači spusťte v novém terminálu elowen tools install pdf. Pokud je Poppler mimo PATH, předejte --bin <directory>. Tím se nainstalované programy ověří a zapamatují. Naskenované stránky se vrací jako obrázky, nejvýše pět na volání. PDF opravňuje k nahrazení jen tehdy, když byl zobrazen celý dokument.

Viz Pluginy pro životní cyklus pluginů a Sandbox a prostředí pro přístup k souborům ve spravovaném Projektu.