Konfigurácia

Elowen konfigurujte v Nastaveniach, osobné predvolené hodnoty nastavte v Účte a pre démona a webový proces použite premenné prostredia pri štarte.

Kde sú nastavenia uložené

Základné nastavenia, účty a históriu konverzácií ukladá Elowen do PostgreSQL. Pred spustením démona nastavte ELOWEN_DATABASE_URL na pripájaciu adresu zriadenej databázy. Predvolená adresa databázy neexistuje.

Súbory inštancie ležia v ELOWEN_INSTANCE_ROOT, čo je predvolene $HOME/.config/elowen. Adresár obsahuje plugin-secrets.key, prihlasovacie údaje poskytovateľov, údaje pluginov, plány, prílohy a veľké výsledky nástrojov. Protokoly sa predvolene ukladajú do jeho podadresára logs. Koreňový adresár inštancie je nezávislý od adresy databázy. Zálohujte kľúč aj súbory inštancie spoločne s databázou: bez kľúča nemožno prečítať šifrované tajné údaje pluginov.

Premenné prostredia pri štarte

Premenné prostredia nastavte pred spustením príslušného procesu. Predvolené hodnoty platia pre lokálnu inštaláciu. Inštalátor zapíše chránenú adresu databázy a pevné cesty inštancie do /etc/elowen/instance.env; nainštalované služby tento súbor načítavajú. Prihlasovacie údaje na pripojenie neuvádzajte v argumentoch príkazov ani v protokoloch.

Balíčkový spúšťač používa ELOWEN_WEB_PORT (predvolene 4500). Samotný webový server číta PORT a HOSTNAME. Démon a webové rozhranie sú samostatné procesy. Lokálnu inštaláciu nastavíte príkazom elowen setup a jej pripravenosť overíte príkazom elowen doctor.

Sekcie nastavení

Otvorte Nastavenia ako administrátor. Väčšina zmien sa ukladá automaticky; formuláre nastavení môžu ohlásiť konflikt, ak ako prvý uloží iný editor. Pred ďalším pokusom skontrolujte aktuálnu hodnotu.

Prihlasovacie údaje pluginov zadávate raz v Prístupoch, nie na stránke jednotlivých pluginov; osobné nastavenia a údaje pluginu zostávajú v jeho paneli v Účte. Kľúče poskytovateľov AI zostávajú u svojho poskytovateľa v <assistant name> AI.

Nastavte poskytovateľov AI

Nastavenia → <assistant name> AI obsahuje dve skupiny. Prepojené účty pripájajú službu prihlásenia alebo službu, ktorú pripojíte vloženým kľúčom, a držia jednu kartu na účet; Pridať účet ponúkne služby, ktoré Elowen pozná. Poskytovatelia AI obsahujú adresy, ktoré pridáte sami, pomocou Pridať poskytovateľa.

Pridať poskytovateľa sa opýta na Kompatibilné s OpenAI alebo Anthropic API, adresu API a kľúč. Adresa kompatibilná s OpenAI ponúka navyše typ API, možnosti kompatibility, teplotu od 0 do 2 a zoznam modelov. Ak teplotu nevyplníte, v požiadavkách sa neposiela. Názov poskytovateľa upravíte v jeho bočnom paneli; jeho ID sa raz odvodí z tohto názvu a už sa nemení. Účet pripojený vloženým kľúčom príde s vyplneným názvom, pevnou adresou a formátom API, takže zadávate iba kľúč.

Pri kompatibilných adresách skúša Elowen /models, keď to ide. Ak nezíska použiteľný katalóg, zadajte ID modelov sami. Automatická voľba API sa riadi natívnym formátom katalógu daného modelu, ak je známy. Inak prvé použitie na pozadí vyskúša Responses a potom Chat Completions, zatiaľ čo Vaša požiadavka začne hneď na predvolenom API. Úspešný výsledok sa zapamätá a ďalšia správa v konverzácii ho použije. Odmietnuté alebo dočasne neúspešné kontroly ponechajú predvolené nastavenie. Riadok Modely na karte Všeobecné daného poskytovateľa otvorí výber modelov a každý model tam ukazuje svoje efektívne API. Limity modelu ponúkajú vedľa položky Auto tlačidlo Resetovať API, ak má daný model zapamätanú detekciu. Explicitná voľba poskytovateľa alebo modelu má prednosť. Možnosti kompatibility zapínajte iba vtedy, ak ich adresa podporuje.

U podporovaných poskytovateľov nájdete na karte Pokročilé položku Režim kódu. Platí pre všetky modely daného poskytovateľa. Model získa plochu na spúšťanie JavaScriptu, z ktorej volá nástroje; vnorené volania naďalej podliehajú bežným oprávneniam a schváleniam.

Po uložení sa kľúč API do prehliadača už nikdy neposiela. Prehliadač ukazuje iba to, či je kľúč uložený.

Podporované prepojenia OAuth sú Anthropic, OpenAI Codex, GitHub Copilot, Kimi, xAI (Grok), Meta (Muse) a OpenRouter. Spustíte ich alebo odpojíte na kartách poskytovateľov. Niektorí poskytovatelia vyžadujú autorizáciu na samostatnej stránke alebo vloženie kódu späť do Elowen. Prepojené účty ukazujú svoje obdobia čerpania, keď ich poskytovateľ hlási: Anthropic, OpenAI Codex, Kimi, xAI, Meta a OpenRouter. GitHub Copilot čerpanie nezobrazuje. Účty pripojené vloženým kľúčom, ktoré hlásia čerpanie plánu — Command, MiniMax a Opencode Go — ukazujú svoje obdobia v časti Čerpanie účtov.

Spravujte modely

Otvorte Nastavenia → Modely a spravujte katalóg pracovného priestoru.

Vidíte, ktoré modely jednotliví poskytovatelia ponúkajú a koľko ich je, a katalóg môžete hľadať podľa poskytovateľa, ID modelu alebo názvu na spustenie. Vyberte model a nastavte jeho limity: okno kontextu, najvyšší výstup, či prijíma obrázky, ceny za milión tokenov a zmenu veľkosti prichádzajúcich obrázkov. Prepisy platia pre presnú dvojicu provider/model. Pri uplatnení limitu výstupu necháva Elowen miesto pre prompt. Predvolený najvyšší výstup je 8 192 tokenov, ak poskytovateľ alebo administrátor nezadá inú hodnotu.

Tento katalóg určuje, čo pracovný priestor ponúka. Používateľ môže zvoliť iba ponúkaný model, ktorý má jeho účet pridelený.

Nastavte predvoľby AI na úrovni účtu

Používatelia spravujú osobné predvolené hodnoty v Účte. Účet → Modely obsahuje predvolený model chatu, podporovanú úroveň uvažovania, záložný model pre obrázky, model a prah na skrátenie kontextu, YOLO, správanie pri behoch bez dohľadu a pravidlá oprávnení; Účet → Osobnosť obsahuje štýl komunikácie a osobné pokyny; Účet → Pamäť obsahuje nastavenia pamäte. Žiadna z nich nemení katalóg poskytovateľov pracovného priestoru.

Automatické skracovanie kontextu je predvolene zapnuté na 80 % okna kontextu modelu. Prah špecifický pre model môže prepísať predvolenú hodnotu účtu. Ak nie je zvolený model na skrátenie kontextu, každý poskytovateľ použije model chatu, vrátane ChatGPT OAuth. Nedostupný alebo odvolaný osobný model na skrátenie kontextu tiež použije model chatu.

Model pre obrázky je iba zálohou pre ťahy s obrázkami, keď pri aktuálnom modeli nie je známe, že obrázky podporuje. Ďalšie ťahy iba s textom používajú bežný model.

Nastavte limity behu

V časti Nastavenia → <assistant name> AI určujú ovládacie prvky behu limity pre výstup nástrojov, čakanie na odpovede, vybavovanie z pamäte, súbežné relácie kanálov, príkazy shellu a delegovaný kontext. Démon pri ukladaní obmedzí hodnoty na povolený rozsah. Hodnoty veľkosti v editore sú približné tokeny, počítané štyrmi znakmi na token.

Medzi bežné predvolené limity patrí 100 riadkov výstupu nástroja, 41 000 znakov výstupu, 120 000 bajtov vložených priamo pri jednom výsledku a celkový rozpočet 200 000 bajtov na ťah. Elowen povolí tri po sebe nasledujúce zlyhania automatického skrátenia kontextu a čaká na odpoveď na otázku až šesť hodín. Odmietnuté alebo neúspešné zhrnutie kontextu sa predvolene odošle až dvakrát znova (Opakovanie zhrnutia kontextu, 0 až 5), kým namiesto neho prebehne vstavané zhrnutie. Na začiatku ťahu vybaví až 10 spomienok so zdieľaným rozpočtom 20 000 bajtov (UTF-8) a celkovo udrží až 32 živých relácií kanálov; tá najdlhšie nepoužitá sa uvoľní a jej história zostáva v databáze.

Lokálny časový limit shellu je predvolene 30 sekúnd. Zhrnutie kontextu kroku nasleduje po každých 20 volaniach nástrojov a automatická údržba pamäte povolí dve operácie na beh. Záznamy udalostí a IP adries pôvodu sa predvolene uchovávajú 30 dní.

Režim plánovania predvolene navrhuje až troch agentov na prieskum iba na čítanie a troch agentov na návrh. Plánovanie: agenti na prieskum a Plánovanie: agenti na návrh prijímajú hodnoty 0 až 5. Automatickú kontrolu skillov ladia Maximum zmien skillov za výmenu (predvolene 1, rozsah 0 až 6), Kontrola skillov po každých N volaniach nástrojov (predvolene 100, rozsah 1 až 200) a Najmenej volaní nástrojov pre kontrolu skillov (predvolene 1, rozsah 1 až 200).

Predvolená hodnota kontroly skillov platí iba vtedy, keď nie je uložený žiadny explicitný interval; Vaša uložená hodnota zostáva v platnosti. Kontrola pracuje s dokončeným kontextom konverzácie na tom istom modeli a účte poskytovateľa. Môže sa vynechať, ak trasa poskytovateľa nie je overená alebo nie je dostupná kapacita, alebo ak účet OAuth vyčerpal aspoň 90 % týždenného limitu či jeho limit nie je známy. Vynechaná práca si ponechá počítadlo pre neskoršiu vhodnú výmenu. Nastavenie rozpočtu zápisu na 0 automatické učenie vypne.

Automatická údržba pamäte má tu ďalšie dva limity: Slučovanie spomienok: hodiny od posledného prechodu (1–168, predvolene 24) určuje, ako dlho musí účet zostať bez prechodu údržby, kým môže ďalší začať sám, a Slučovanie spomienok: konverzácie od posledného prechodu (1–50, predvolene 5) určuje, koľko ďalších konverzácií účtu musí od posledného prechodu obsahovať dokončenú výmenu. Prechod zjednocuje spomienky naprieč konverzáciami, takže kratší interval alebo menej konverzácií znamená viac prechodov a vyššie náklady; zmeny platia pre ďalšiu kontrolu bez reštartu. Používatelia zapínajú funkciu pre svoj účet v Účte → Pamäť (pozrite Pamäť), kde Spustiť teraz ignoruje oba limity.

Tá istá sekcia ovláda automatické odkladanie nástrojov, spúšťanie sub-agentov, zachytávanie požiadaviek na poskytovateľov, uchovávanie udalostí a uchovávanie pamäte. Odkladanie nástrojov je predvolene zapnuté s prahom 10 nástrojov; nad ním zostávajú plne načítané iba základné nástroje (Bash, Read, Edit, Grep a Write). Spúšťač sub-agentov je predvolene zapnutý a veľkosť svojho fondu určuje sám. Zachytávanie požiadaviek na poskytovateľov je predvolene zapnuté; jeho vypnutie zastaví nové záznamy, ale existujúce ponechá.

Nastavte pamäť

Otvorte Nastavenia → Modely a nastavte modely pracovného priestoru pre embedding a zaraďovanie. Model pre embedding umožňuje sémantické vyhľadávanie; bez neho pamäť naďalej funguje s hľadaním podľa kľúčových slov. Model pre zaraďovanie priraďuje spomienky do kategórií. Oba používajú adresu a kľúč API zvoleného poskytovateľa. Prepojené účty OAuth nemožno pre embedding použiť, s výnimkou OpenRouter, ktorého údaje účtu zahŕňajú adresu pre embedding.

Po zmene modelu pre embedding index prebudujte: Údržba pamäte na stránke Pamäť ponúka Znovu vytvoriť index spomienok a po zmene modelu pre zaraďovanie alebo kategórií pamäte ponúka Znova usporiadať spomienky s voľbou Znova usporiadať všetky spomienky. Tieto operácie bežia na pozadí. Hľadanie v dokumentácii do tejto prestavby nepatrí: indexuje sa samo na pozadí s nastaveným modelom pre embedding a dovtedy odpovedá podľa kľúčových slov.

Nastavte automatické uchovávanie pamäte

Nastavenia uchovávania nájdete v bloku Retencia pamäte v časti Nastavenia → <assistant name> AI (Upraviť uchovávanie). Uchovávanie je predvolene zapnuté, so štrnásťdňovou ochrannou lehotou, spodnou hranicou vitality 10 a denným prechodom. Predvolené polčasy sú 1, 3, 7, 14, 21, 30, 45, 60, 90 a 180 dní pre dôležitosť 1–10, obmedzené na 0,1–365 dní; spodná hranica vitality je obmedzená na 1–90 a ochranná lehota na 0–365 dní. Nula sa pri polčase ani pri hranici neprijíma a žiadna úroveň dôležitosti nie je vyhradená: spomienky pod hranicou vitality sa môžu dostať do koša na každej úrovni. Denný prechod presunie v každých 24 hodinách najviac toľko spomienok na účet, koľko dovoľuje denný limit koša: predvolene 5, nastaviteľný od 1 do 200. Hlavný vypínač ho pozastaví.

Spravujte pluginy

Pre pluginy nainštalované v tejto inštancii použite Nastavenia → Pluginy, pre register, z ktorého inštalujete, Nastavenia → Dostupné pluginy. Podľa konkrétneho pluginu ho môžete zapnúť alebo vypnúť, prezrieť jeho schopnosti a stav, upraviť jeho nastavenia, nainštalovať alebo aktualizovať, odinštalovať pluginy z trhoviska alebo obnoviť vstavané pluginy. Zapnutie alebo vypnutie pluginu vyžiada reštart démona; bežiace ťahy môžu aktiváciu oddialiť.

Nastavenia pluginu sa overujú podľa jeho manifestu. Úspešná zmena sa uloží skôr, než Elowen reštartuje démona, aby ju načítal, a stránka môže počas čakania na reštart zobrazovať Uložené, čaká sa na aktiváciu. Kľúče, tokeny a heslá sa zadávajú v časti Nastavenia → Prístupy: každý zapnutý plugin, ktorý ich potrebuje, má jeden riadok so svojím stavom, explicitná akcia Uložiť hodnotu nastaví alebo nahradí a uložené tajné údaje sa do prehliadača nikdy nevracajú.

Niektoré pluginy ponúkajú aj osobné nastavenia v Účte. Tie patria aktuálnemu účtu a znovu nenačítavajú register pluginov inštancie.

Pridelenie pluginov a oprávnenia nástrojov sú oddelené veci. Administrátor môže účtu prideliť strážené nástroje, API trasy, rozhranie a dodané skilly pluginu, ktorý možno prideľovať. Oprávnenia nástrojov účtu môžu nástroje ďalej obmedziť. Fragmenty promptov, platformové prompty, lomítkové príkazy a háčiky pridelenie pluginu nestráži.

Systém, aktualizácie a údaje

Sekcia Systém hlási stav služieb, ponúka ovládacie prvky reštartu a ukazuje dostupnosť aktualizácií. Automatické aktualizácie sú predvolene vypnuté; ich zapnutím sa inštancia prihlási na automatickú kontrolu aktualizácií, ktorá približne raz za hodinu hľadá nové vydanie a do niekoľkých minút zareaguje, keď vydavateľ požiada všetky prihlásené inštancie o aktualizáciu. Aktualizácia pripraví stiahnutie, zatiaľ čo služby ďalej bežia, potom na chvíľu zastaví dotknuté služby, uplatní zmeny a znova ich spustí kvôli kontrole štartu. Ak tieto kontroly zlyhajú, obnova sa pokúsi vrátiť predchádzajúcu sadu; neúspešná obnova môže vyžadovať zásah operátora. Stav aktualizácie a obnovu opisuje Produkcia a aktualizácie.

Vzhľady v časti Nastavenia → Systém určujú, medzi ktorými vstavanými a vlastnými návrhmi môžu účty prepínať v hornej lište; pri menej ako dvoch povolených je prepínač skrytý a všetci vidia návrh nastavený pre túto inštaláciu. Vlastné vzhľady umožňujú administrátorovi pridať vzhľad zadaním ID, zobrazovaného názvu, vstavaného vzhľadu ako základu a tabuľky tokenov CSS, ktorá smie prepisovať iba verejné tokeny návrhu; pri pridaní sa overí a odmietnutý vzhľad ohlási token alebo riadok na opravu. Pridanie alebo odobratie vlastného vzhľadu sa prejaví hneď, na každej otvorenej stránke. Tabuľka tokenov môže prepísať farby chatu, tiene a rodinu bezpätového alebo neproporcionálneho písma vstavaného návrhu. Tiene prijímajú none alebo čiarkami oddelený zoznam tieňov, každý s voliteľným inset, dvoma až štyrmi dĺžkami a farbou.

Ak chcete použiť písmo, ktoré v zariadení čitateľa nie je nainštalované, otvorte Vlastné vzhľady, zadajte jeho Rodinu písma, vyberte Súbor WOFF2 a zvoľte Nahrať písmo. Rovnakú rodinu použite v tabuľke tokenov vzhľadu, napríklad --font-sans: "Manrope", sans-serif;. Každý vzhľad drží jeden súbor bežného variabilného písma do 2 MiB. Inštancia ho poskytuje každému čitateľovi, aj na prihlasovacej stránke. Odobrať písmo tento súbor odstráni; zmazaním vzhľadu sa odstráni aj jeho písmo. Adresy zdrojov a @font-face v tabuľke tokenov nepoužívajte: pravidlo načítania generuje inštancia.

Uchovávanie konverzácií je predvolene zapnuté pre konverzácie nečinné 10 dní. Aktívne relácie, delegovaná práca a platformové relácie sú pred týmto čistením chránené. Sekcia Údaje ponúka protokoly a diagnostiku požiadaviek na poskytovateľov. Vypnutie zachytávania diagnostiky zastaví nové záznamy, ale existujúce nezmäže.

Zálohujte Elowen

Elowen nemá vstavaný príkaz na zálohovanie ani obnovu. Zálohujte databázu PostgreSQL vrátane schém pluginov a celý koreňový adresár inštancie. Počas vytvárania oboch častí zastavte zapisovateľov inštancie, aby databáza aj súbory opisovali rovnaký stav. Zachovajte plugin-secrets.key, prihlasovacie údaje poskytovateľov, údaje pluginov, plány a prílohy a tiež protokoly uložené mimo koreňového adresára inštancie.

Použite zálohovacie nástroje PostgreSQL s chránenými prihlasovacími údajmi. Napríklad po nastavení služby libpq s názvom elowen-backup na priame pripojenie k databáze tejto inštancie:

PGSERVICE=elowen-backup pg_dump --format=custom --file="/backup/elowen-$(date +%Y%m%d).dump"

Potrebné roly PostgreSQL a konfiguráciu prístupu uchovávajte spolu s postupom obnovy a obnovu databázy aj súborov inštancie spoločne vyskúšajte v izolovanej inštalácii. Démon pri štarte uplatňuje migrácie základnej schémy; procesy runnera a pracovníkov na pozadí nemigrujú. Obnova iba databázy vynechá súbory inštancie a kľúč potrebný na dešifrovanie tajných údajov pluginov.

Ďalší: Používatelia a prístup