CLI BLUN Code

Co se změnilo od 9.1.605

Jednotlivé změny a jejich stavy vydání najdeš v CLI changelogu.

Předpoklady

• Windows nebo macOS na x64 nebo ARM64; dále Linux
• Node.js 24.15.0 nebo novější z řady LTS-24
• Node.js, npm a Git Bash ve Windows
• Přístup k internetu pro přihlášení, modely AI a spravované nástroje
• pracovní složka pro tvůj projekt

Node.js, npm a Git Bash ve Windows

Node.js spouští konzoli. npm instaluje a aktualizuje balíček. Oficiální instalační program Node.js obsahuje npm. Git for Windows poskytuje shell Git Bash, který King potřebuje; s Node.js se Git Bash neinstaluje.

Před první instalací

1. Nainstaluj Node.js 24 LTS (alespoň 24.15.0) pomocí Windows MSI z nodejs.org/en/download. Ponech npm a položku PATH aktivované.

2. Nainstaluj Git for Windows z gitforwindows.org.

3. Terminál úplně zavři a otevři nový příkazový řádek.

4. Zkontroluj node --version, npm --version a git --version, než nainstaluješ King.

   node --version
   npm --version
   git --version

Git for Windows obsahuje Git Bash. Kinga můžeš spustit z příkazového řádku nebo PowerShellu; další okno Git Bash není nutné.

Instalace Node.js a npm: oficiální dokumentace npm.

Pokud se node nebo npm nenajde

Node.js/npm chybí nebo není dosažitelný přes PATH. Nejprve znovu otevři terminál. Pokud chyba přetrvává, oprav instalaci Node.js s aktivovaným npm a položkou PATH.

where.exe node a where.exe npm zobrazí dosažitelné cesty; bez nálezu se program přes PATH nenašel.

where.exe node
where.exe npm

Pokud PowerShell blokuje npm.ps1, použij npm.cmd místo uvolnění zásad spouštění.

npm.cmd --version
npm.cmd install -g blun-king-cli@latest

Pokud se Git Bash nenajde

Nainstaluj Git for Windows a znovu otevři terminál. Při instalaci do jiného adresáře nastav BLUN_SHELL_PATH na absolutní cestu nainstalovaného bash.exe.

Následující příklad platí pouze pro příkazový řádek a tuto relaci terminálu; přizpůsob cestu své instalaci. Před nastavením zkontroluj, zda soubor existuje.

dir "C:\Program Files\Git\bin\bash.exe"
set "BLUN_SHELL_PATH=C:\Program Files\Git\bin\bash.exe"

Zkontrolovat a aktuálně držet Node.js

Nejprve zkontroluj nainstalovanou verzi:

node --version
npm --version

Pro jednorázovou instalaci npm musí Node a npm již existovat. U starší verze Node je možné varování EBADENGINE. Po úspěšné instalaci stačí první spuštění příkazem king nebo blun; BLUN pak zřídí vlastní běhové prostředí.

Manuální náhradní cesta

Pokud automatické stažení nebo kontrola kontrolních součtů pod Windows nebo macOS selže, nainstaluj Node.js 24 LTS manuálně:

1. Otevřít oficiální stránku ke stažení

   Navštiv nodejs.org/en/download a zvol Node.js 24 LTS.

2. Spustit vhodný instalační program

   Ve Windows použij instalační program MSI. Na macOS použij balíček PKG. Zvol x64 nebo ARM64 podle svého počítače.

3. Úplně znovu otevřít terminál

   Již otevřené terminály často používají ještě starou cestu programu.

4. Verzi znovu zkontrolovat

   node --version
   npm --version

Instalace

1. Zkontrolovat předpoklady

   node --version
   npm --version

   Pod Windows a macOS může BLUN starší existující verzi Node při prvním spuštění nahradit svým soukromým běhovým prostředím. Pro instalaci npm musí být Node a npm již volatelné. Pod Linuxem potřebuješ před spuštěním Node.js 24.15.0 nebo novější.

   Node.js, npm a Git Bash ve Windows

2. Nainstalovat aktuální stabilní verzi

   npm install -g blun-king-cli@latest

3. Zkontrolovat instalaci

   blun --version

4. Provést diagnostiku

   blun doctor

Spuštění a přihlášení

Profil, pracovní prostor a relace

Profil volí oddělenou identitu King a její nastavení. Pracovní prostor určuje, které soubory projektu jsou otevřené. Relace obsahuje průběh konverzace a pracovní stav. Nová relace proto není ani novým účtem, ani automaticky izolovaným gitovým worktree.

king --profile mein-king

--profile patří k launcheru king. Pro izolovaný gitový pracovní prostor použiješ blun workspace create <název>; pro pokračování konverzace výběr relací. Terminálová reference vysvětluje tyto příkazy a jejich předpoklady.

Který spouštěcí příkaz máš použít?

Přihlásit se poprvé

1. Spustit přihlášení

   blun login

2. Dokončit přihlášení v prohlížeči

   Přihlas se svým účtem BLUN a poté se vrať ke konzoli.

3. Otevřít složku projektu a spustit

   cd "C:\Pfad\zu\deinem\Projekt"
   king

Alternativně můžeš v běžící konzoli zadat /login. Nemusíš kopírovat žádný klíč API do konfiguračního souboru.

Pokračovat v relaci

Pomocí /sessions otevřeš výběr relací. Můžeš také zadat přesný identifikátor, přesný název nebo jednoznačný začátek identifikátoru. Při více nálezech vyber požadovanou relaci ze seznamu.

/sessions API-přestavba

Pro poslední relaci aktuálního pracovního adresáře spustíš Kinga v běžném terminálu příkazem:

king --continue

Od 9.1.606 načítá zobrazení nejprve nejnovější položky průběhu. Ve výchozím nastavení je jich přibližně 200; související zprávy a kroky nástrojů zůstávají úplné a mohou tento počet přesáhnout. Přes navigaci průběhu dosáhneš starších stránek. Uložený průběh konverzace a kontext modelu nejsou tímto limitem zobrazení zkráceny.

Cílovou velikost zobrazení můžeš při interaktivním spuštění nastavit mezi 1 a 2000:

king --continue --history-limit 400

Při spuštění otevřít naposledy vybranou relaci

Pokud se pravidelně vracíš ke stejné práci, můžeš toto nastavení doplnit do existujícího souboru ~/.blun/tui.toml. Ve Windows se soubor obvykle nachází v %USERPROFILE%\.blun\tui.toml.

resume_last_selected = true

Umísti řádek v horní části souboru před oddíl, jako je [editor]. Ostatní nastavení zůstávají zachována. Výběr se uloží příslušně k účtu, agentovi, pracovnímu adresáři a běhovému prostředí. Výslovně zadaná relace má přednost. Pokud uložený výběr již není k dispozici, začne nová relace. Pomocí false tuto možnost spuštění opět vypneš.

Vybrat profily

/profile nebo /profiles otevře výběr profilu. Během běžící práce nebo při čekajících zprávách zůstává aktuální profil aktivní; zvol druhý profil, jakmile je relace připravená.

System32 není složka projektu

Před spuštěním přejdi v příkazovém řádku pomocí cd /d "%USERPROFILE%" do své uživatelské složky. Alternativně přejdi do vlastní existující složky projektu. V PowerShellu zvol svou uživatelskou složku pomocí Set-Location $HOME. Poté spusť king.

cd /d "%USERPROFILE%"
king

Vybrat pracovní adresář (9.1.603)

Pokud ve Windows zvolíš jiný pracovní adresář, otevře se dialog výběru složky. Cestu můžeš i nadále zadat ručně. Pokud dialog zrušíš, vrátíš se k výběru složky, aniž by se složka převzala.

Pokud není k dispozici žádný dialog složky, vyžádá konzole cestu. Na jiných operačních systémech zůstává zadání cesty.

Pokud se při spuštění převezme nebo uloží složka uvnitř adresáře Windows, navrhne výběr složky tvou uživatelskou složku. Ručně zadané cesty se i nadále kontrolují jako dosud.

Každodenní práce

Nastavit úroveň přemýšlení a povolení

Ctrl+L otevírá od 9.1.609 výběr úrovně přemýšlení přímo ze vstupního pole. Tvůj dosavadní vstupní text zůstává zachován. Zatímco King pracuje, je změna odmítnuta; otevři výběr znovu, jakmile je relace připravená. Dostupné úrovně závisí na aktivním modelu.

Úroveň přemýšlení řídí, jak důkladně model pracuje před odpovědí. Vyšší úrovně mohou trvat výrazně déle.

blun --effort high --permission-mode manual

Zvolit styl výstupu

Pomocí /output-style otevřeš výběr. K dispozici jsou Standard, Stručný, Proaktivní, Vysvětlující a Učící se. Výběr platí okamžitě pro běžící relaci a uloží se jako standard pro pozdější spuštění.

Zhustit aktivní kontext

BLUN Code sleduje aktivní kontext pro další požadavek modelu, nikoli pouze celý uložený průběh. Účinná hranice závisí na modelu, účtu a rozpočtu zhuštění. Starší části se shrnují v omezených stupních; každý stupeň si rezervuje místo pro své shrnutí.

Mezitím se v konverzaci zobrazí například Verdichte ~941,2k Tokens … · 2/~10 · 90 %. 2/~10 ukazuje běžící a odhadovaný celkový počet stupňů. 90 % je naměřené využití okna modelu pro aktuální volání zhuštění. Pokud stupeň selže nebo kontext nezmenší, zůstává původní kontext zachován.

Již při 75 procentech účinné hranice zhuštění odlehčí malé bezztrátové zhuštění starší velké výsledky nástrojů a dokončené argumenty nástrojů. Při okně modelu 1 048 576 tokenů a plném zhuštění při 256 000 tokenech leží tento bod na 192 000 tokenech. Posledních 20 zpráv, běžné texty uživatelů a uložený surový průběh zůstávají beze změny.

Proaktivně zhustit na pracovní hranici

Uživatelé nemusí zadávat žádný příkaz. Jakmile aktivní kontext dosáhne poloviny automatické hranice plného zhuštění, může King po dokončeném pracovním úseku zvolit CompactConversation. Nástroj naplánuje stávající bezpečný proces zhuštění na konec aktuálního kroku nástroje. Neotevírá další tah; pokud zhuštění selže, zůstává původní průběh beze změny.

Překonat krátké přetížení serveru

Při výslovně označeném opakovatelném přetížení serveru (HTTP 429 s x-should-retry: true) čeká BLUN King podle Retry-After a odešle stejný požadavek nejvýše dvakrát znovu. Chyby ověření, kontingentu a jiné neopakovatelné chyby i nadále okamžitě přeruší běh. Pokud server zůstane přetížený i po omezených pokusech, dostane uživatel i nadále jasné hlášení chyby.

Pokračovat v delegované práci po přerušení poskytovatele

Pokud delegovaný jednotlivý agent nebo člen roje agentů ztratí připojení k poskytovateli, obdrží prázdnou odpověď poskytovatele, přeruší svůj stream kvůli nečinnosti nebo server hlásí HTTP 408/500/502/503/504, pokračuje BLUN King se stejným agentem podle jeho trvalého průběhu. U jednotlivých agentů a při přerušeních roje mimo HTTP 429 čeká první pokračování dvě sekundy a druhé pět sekund; poté zůstává viditelná původní chyba. HTTP 429 si v roji zachovává svá oddělená, delší pravidla přetížení. Chyby ověření, plateb nebo kontingentu, zásad, kontextu, nástrojů a kódu ani manuální přerušení nespouštějí automatické pokračování. Každý pokus o pokračování používá stávající ID agenta, aby se již dokončená práce neopakovala.

Odložit velké výsledky nástrojů

U textových výsledků nástrojů s více než 12 000 znaky uloží BLUN King celý obsah do soukromé složky relace tool-results. V pozdějších požadavcích modelu zůstávají prvních 1 000 a posledních 1 000 znaků, přesný počet vynechaných znaků a output_path. Smíšené mediální výsledky a již zkrácené výsledky zůstávají beze změny. Pozdější mikrozhuštění cestu uchová.

Verze 9.1.104 nechává příkazy shellu na popředí běžet i při velmi velkých výstupech až do řádného konce. King zapisuje průběžně až 16 MiB do soukromého protokolu úlohy, výstupy nad tento rámec zahazuje a hlásí skutečný exit code, místo aby proces kvůli množství výstupu ukončil. Malé výstupy, úlohy na pozadí, časové hranice a manuální přerušení zůstávají beze změny.

Read output_path

Příklad: Výsledek hledání s 30 000 znaky zůstává úplně dostupný v lokálním souboru. Model vidí začátek a závěrečný výsledek nebo chybu okamžitě; agent čte přes cestu pouze potřebné úseky, místo aby při každém kroku modelu posílal znovu všech 30 000 znaků.

Paralelní dávky výsledků nástrojů

Od verze 9.1.99 považuje King přímo navazující čistě textové výsledky navíc za dávku. Pokud dávka celkově překročí 12 000 znaků, i když je každý jednotlivý výsledek menší, odloží King tolik největších výsledků od 3 000 znaků, kolik je nutné k podkročení hranice. V kontextu modelu zůstávají čitelné odkazy; surový průběh relace a média zůstávají beze změny. Telemetrická událost tool_result_batch_offloaded hlásí pouze počet a velikosti znaků, nikoli obsahy nebo cesty.

Odložit velké zprávy uživatelů

Pokud skutečná zpráva uživatele obsahuje více než 200 000 textových znaků, uloží BLUN King celý text do soukromé složky conversation-history. V kontextu modelu zůstávají první a poslední řádky, údaje o velikosti a output_path. Pomocí Read a output_path čte agent pouze potřebné stránky. Obrázky, zvuk a jiné netextové součásti zůstávají připojené. Viditelný přepis a uložený surový průběh obsahují i nadále úplnou původní zprávu. Zprávy s přesně 200 000 znaky zůstávají v kontextu úplné; při chybě zápisu platí totéž.

Omezit velká vyhledávání Grep

Ve výstupním režimu content ukončí Grep ripgrep po offset plus head_limit plus jednom úplném řádku náhledu. Další řádek slouží pouze k rozpoznání další stránky. Při head_limit=250 a offset=0 se načte nejvýše 251 úplných řádků výsledků. Při head_limit=0, pro count_matches a pro files_with_matches řazené podle času změny čte King i nadále úplný výsledek.

Přesně pokračovat ve čtení velkých souborů

Velké soubory se i nadále čtou po stránkách. Pokud Read dosáhne své interní hranice 1 000 řádků a soubor obsahuje další řádky, uvede výsledek přesný další line_offset. Příklad: Čtení od řádku 2001 pokračuje pomocí line_offset=3001. Na konci souboru a při vědomě menším úseku čtení se žádný pokyn nezobrazí. Agent tak nevyvozuje závěry z neúplného úseku a nečte soubor znovu od prvního řádku.

Používat vlákna konverzace

Agenti na pozadí

Agenti na pozadí se zobrazují s úkolem a stavem v zobrazení agentů. Můžeš otevřít výstup, poslat zpětnou otázku nebo agenta zastavit. Hooky a připojená diagnostika jazykového serveru kontrolují změněné soubory po zápisech a úpravách.

Verze 9.1.105 doplňuje TaskUpdate pro běžící agenty na pozadí. King předá další pokyny při příštím bezpečném kroku modelu stejnému aktivnímu agentovi, aniž by ho zastavil nebo spustil dalšího agenta. Neznámé a již dokončené úlohy, úlohy shellu a agenti, kteří aktualizaci již nepřijímají, jsou beze změny odmítnuti.

Verze 9.1.106 umožňuje profilům agentů vyloučit nástroje jménem. King použije tato vyloučení teprve poté, co sestaví trvale načtené, dynamicky načtené a nástroje MCP. Standardní profily coder, explore a plan nemohou přes Telegram odpovídat ani reagovat, upravovat zprávy nebo stahovat přílohy; hlavní agent zůstává beze změny. Delegovaní agenti tak neposílají zprávy mimo hlavního agenta a jejich požadavky modelu obsahují méně schémat nástrojů. Nenalezené, jménem zadané nástroje se viditelně hlásí.

Verze 9.1.107 zobrazuje chyby poskytovatele srozumitelným jazykem pro zákazníky; interní kódy chyb a pokyny podpory se přitom nezobrazují. /help nabízí seznam příkazů ovladatelný šipkami a pravou šipkou nebo klávesou Enter otevře podrobný popis vybraného příkazu.

Verze 9.1.108 odstraňuje identické, opakovaně vkládané systémové pokyny z projekce modelu. Pro každý druh pokynu zůstává viditelná nejnovější přesná kopie. Změněné pokyny, běžné zprávy uživatelů, volání nástrojů, smíšené obsahy a uložený surový průběh relace zůstávají beze změny. Data odesílaná poskytovateli se tak v dlouhých relacích zmenšují, aniž by se zkrátil uložený průběh, exporty nebo pokračování.

Načítat nástroje a dovednosti podle potřeby

Od 9.1.595 načítá King volitelná schémata nástrojů cíleně přes ToolSearch, místo aby u každého požadavku posílal celý katalog. Uložený výběr je omezený; nástroje zůstávají vyhledatelné, i když jejich schéma právě není odesláno. Běžné kontroly oprávnění platí i nadále. Velké katalogy dovedností se poskytují kompaktně a po stránkách.

Při krátkých pozdravech může King použít omezený úsek nejnovějšího dialogu. Systémové pokyny zůstávají zachovány; pro pracovní úkol se uložený pracovní průběh opět zohlední. Žádné uložené zprávy se tím nemažou. Pozdrav proto nemá pevnou cenu tokenů: systémový kontext, nástroje, opakování a kontrola odpovědí se i nadále podílejí na spotřebě.

/context zobrazuje odhadovanou velikost kontextu dalšího požadavku a platnou hranici. /context-doctor respektive /tokens doplňuje zobrazení o dostupná diagnostická data; /usage zobrazuje pohled na spotřebu a kontingent. Odhadované hodnoty, sečtená spotřeba relace a skutečně vyúčtované tokeny jsou různé veličiny.

Velké katalogy nástrojů se podle potřeby zpřístupňují přes vyhledávání nástrojů. Od 9.1.615 se rozpočet nástrojů řídí hlášeným kontextovým oknem poskytovatele. Nalezené nástroje zůstávají v dalším kroku dostupné; jejich úplné popisy nemusí být odesílány u každého úkolu.

/context doctor: Rozlišuje uložený průběh, odhadované počty tokenů a počet bajtů serializovaného požadavku. Zobrazuje zachycené příspěvky pravidel AGENTS, souborů Mistake, paměti, dovedností a definic nástrojů. Chybějící údaje o původu neznamenají nula bajtů.

Bajty požadavku, odhadované počty tokenů, sečtená spotřeba relace a vyúčtované tokeny jsou různé veličiny. Zobrazení spotřeby zohledňuje také kontrolu odpovědí. /usage cost s denními nebo měsíčními náklady nepatří k této verzi. Nižší náklady nebo rychlejší odpovědi v živém provozu nejsou doloženy.

Každý pokus HTTP obdrží novou x-request-id, pokud volající žádnou neurčí. Zadané identifikátory zůstávají beze změny a neprotokolují se jako libovolný cizí text. Identifikátor slouží k přiřazení měření klienta a serveru; není klíčem k vyúčtování.

Řízení relace v 9.1.604

/queue: Zobrazí nebo změní, jak tato relace zpracovává příchozí zprávy. Režimy se jmenují steer, followup, collect a interrupt; reset nebo default odstraní nastavení specifické pro relaci.

Bez změny specifické pro relaci používá King steer s 500 milisekundami čekání na dávku a maximální velikostí dávky 20 zpráv. /queue zobrazí účinné hodnoty; /queue reset odstraní pouze nastavení specifické pro relaci.

steer předá nové vstupy při příštím vhodném předávacím bodě; pokud to není možné, čekají na příští průběh. followup čeká do konce běžícího průběhu. collect sdružuje vstupy do dávky; interrupt přeruší běžící průběh kvůli novým vstupům.

/queue collect debounce:500ms batch:10

Přípustné jsou debounce:0ms až debounce:60s a batch:1 až batch:100. batch omezuje velikost dávky, aniž by mazal přebytečné zprávy. Neexistuje žádná volba cap: ani drop:. Pravidlo fronty a zobrazení spotřeby zůstávají při pokračování stejné relace zachovány. Běžné nové zprávy kanálu nespouštějí po 30 sekundách automaticky přerušení.

/session [ID|Název]: Otevře výběr relací nebo vybere relaci podle přesného identifikátoru, přesného názvu nebo jednoznačné předpony identifikátoru. Při více nálezech se otevře výběr.

/question: Znovu otevře čekající doplňující dotazy. Sbalení dotaz nezodpoví ani nezahodí.

/usage: Zobrazí spotřebu a dostupné kontingenty. off, tokens a full uloží režim zobrazení pro tuto relaci. reset odstraní toto nastavení; inherit, clear a default jsou rovnocenné.

/settings: Otevře nastavení včetně místních možností zobrazení.

9.1.605

/context map zobrazí dostupné rozdělení bajtů posledního zachyceného požadavku. /context list, /context detail a /context doctor otevřou podrobnou zprávu. Rozlišuje soubory pokynů, paměť, dovednosti, definice nástrojů a přiřazené texty průběhu. Chybějící naměřené hodnoty zůstávají označené jako nedostupné; nepočítají se jako nula.

king --message "Zkontroluj otevřené testy" předá interaktivní konzoli první zprávu. Zpracuje se po souhlasu při spuštění a výběru relace přes běžné kontroly zpráv a frontu. Její obsah se neinterpretuje jako slash ani shell příkaz. Souhlas při spuštění a kontroly oprávnění se tím nepřeskakují.

/abort přeruší běžící proces, aniž by zahodil čekající vstupy. /stop navíc čekající vstupy zahodí. /exit i nadále ukončí konzoli. Jde o místní konzolové příkazy, nikoli další dálkové příkazy Telegramu.

Další řádek agenta/relace ve spodní části odpadá. Výběr relací a diagnostika zůstávají dostupné přes stávající příkazy.

Rozlišovat aktuální kontext a uložený průběh

Dlouhý uložený průběh nemusí stát úplně v jediném požadavku modelu. King může zhustit aktivní pracovní kontext a poskytovat starší výstupy nástrojů přes prověřené odkazy. Úplné originály zůstávají zachovány pro cílené dočtení.

Náhled velkých výstupů nástrojů zohledňuje od 9.1.617 také dostupné kontextové okno. Při opětovném načtení stejné relace se nezměněné pokyny pluginů nedoplňují stále znovu. Pomocí /context doctor zkontroluješ zachycený požadavek; /context map zobrazí jeho dostupné rozdělení bajtů.

Pro soubory pokynů jako AGENTS.md platí v konzoli King od 9.1.614: Zůstávají úplné, dokud to hranice požadavku umožňuje. Větší soubory nezastaví úkol jen kvůli své velikosti. Dřívější paušální zkrácení z 9.1.613 tak již nepopisuje aktuální cestu konzole.

Držet úkoly a výstupy viditelné

Příliš dlouhý seznam úkolů lze rozbalit pomocí Ctrl+T. Dlouhé výstupy nástrojů se v průběhu zobrazují zkráceně a lze je rozšířit pomocí Ctrl+O. Vstup, indikátor aktivity a dva stavové řádky patří ke konzoli. /tasks otevře úlohy na pozadí; /copy zkopíruje poslední dostupnou odpověď. Reference příkazů obsahuje všechny integrované příkazy a také přehled klávesových zkratek a nástrojů agenta.

Sledovat dlouhé tahy

Od verze 9.1.40 hlásí konzole tah, když 20 minut nepřišel žádný nový výsledek nástroje. Stavový řádek zobrazí dobu běhu, naposledy použitý nástroj a počet opakovaných chyb. Pět po sobě následujících neúspěšných volání stejného nástroje se stejnými argumenty ukončí tah jasným hlášením chyby, místo aby nepozorovaně pokračoval.

Dovednosti, pluginy a MCP

Dovednosti jsou opakovaně použitelné pracovní návody. Pluginy mohou navíc poskytovat nástroje, dovednosti a vlastní příkazy. MCP spojuje konzoli s nakonfigurovanými servery nástrojů.

Používat existující dovednosti

Popiš svůj úkol konkrétně, aby King mohl najít vhodné návody. Pro určitý návod zadáš do vstupního pole / a zvolíš nabízenou dovednost. Integrované dovednosti se zobrazují pod svým názvem; vlastní dovednosti obvykle jako /skill:<název>. Návrhy tvé instalace zobrazí skutečně dostupné názvy.

/skill:angebot-pruefen zkontroluj nabídku ve složce projektu

Tento příklad funguje poté, co vytvoříš vlastní dovednost s názvem angebot-pruefen. Pokud přichází v úvahu více návodů, můžeš Kinga nejprve požádat o srovnání a doporučení.

Přidat vlastní návod

V projektu vytvoř například .agents/skills/angebot-pruefen/SKILL.md. Soubor dovednosti obsahuje název, popis oblasti použití a samotné pracovní kroky:

---
name: angebot-pruefen
description: Kontrolovat nabídky z hlediska rozsahu plnění, termínů a otevřených otázek.
---

Přečti si kompletní nabídku.
Zkontroluj rozsah plnění, termíny, vyloučení a otevřené otázky.
U každého zjištění uveď příslušné místo v dokumentu.
Zobraz výsledek, než změníš soubory.

Projektové dovednosti se hledají také v .blun/skills. Pro návody přesahující tvé projekty existují ~/.agents/skills a ~/.blun/skills. Ve Windows znamená ~ tvou uživatelskou složku. Po přidání Kinga restartuj nebo relaci znovu načti pomocí /reload, jakmile bude připravená, a zkontroluj slash návrhy.

Pro výslovně zvolenou složku dovedností můžeš Kinga spustit takto:

king --skills-dir "./meine-skills"

Tato volba nahrazuje automatické hledání ve složkách dovedností uživatele a projektu pro toto spuštění. Můžeš ji opakovat pro více složek. Dovednost z GitHubu musí ležet v takové složce se svou strukturou složek a platným souborem SKILL.md.

Instalovat a spravovat pluginy

/plugins otevře správu pluginů. Tam si můžeš prohlédnout tržiště a zkontrolovat existující pluginy. K dispozici jsou také příkazy list, info, install, enable, disable a remove.

/plugins list

Pro instalaci zadáš /plugins install <zdroj> nebo zvolíš položku katalogu. Zkontroluj zdroj a zobrazené údaje a potvrď nabízenou instalaci. Deaktivovaný plugin zůstává nainstalovaný; remove ho po potvrzení odstraní. Plugin může nabízet vlastní slash příkazy, například /<plugin>:<příkaz>.

Zkontrolovat spojení nástrojů

Pomocí /mcp otevřeš zobrazení MCP. Správa pluginů zobrazuje také servery MCP pluginu. Nainstalovaný návod nenahrazuje přihlášení k připojené službě. Zkontroluj v příslušném zobrazení, zda je spojení aktivní, než na něm založíš úkol.

Cíle, opakovaná práce a vedlejší agenti

Zpracovat cíl až do výsledku

/goal uloží konkrétní cíl. Popiš požadovaný výsledek, přípustné změny a podle čeho poznáš hotovo.

/goal Zkontroluj otevřené testy, odstraň příčiny v projektu a zobraz výsledky kontrol.

Pomocí /goal status zkontroluješ stav. /goal pause cíl pozastaví, /goal resume ho obnoví a /goal cancel ho ukončí a odstraní. /goal edit <cíl> změní úkol; /goal replace <cíl> výslovně nahradí aktivní cíl.

Pomocí /goal next <cíl> si poznamenáš navazující úkol. /goal next manage otevře správu těchto navazujících cílů. Nový úkol nebo pokračování cíle začne teprve, když je relace připravená.

Opakovat úkol

/loop opakuje prompt ve zvoleném intervalu. Vždy uveď, co se má zkontrolovat a při jakém výsledku tě má King informovat.

/loop 10m Zkontroluj existující výsledky testů a nahlas pouze nové chyby.

/loop status, /loop pause, /loop resume a /loop stop řídí opakování. Pozastavení opakování a přerušení právě běžící práce jsou oddělené akce: Pro aktuální práci existují /abort a /stop.

Položit otázku vedle hlavního úkolu

/btw <otázka> spustí vedlejší otázku v odbočené konverzaci. /swarm <úkol> rozdělí výslovně zadaný úkol na více agentů. Pomocí /tasks vidíš úlohy na pozadí a jejich výsledky.

Pro dosud otevřený plán jsou k dispozici také /premortem, /idea, /chancenradar a /curiosity. Jejich rozdíly, hranice a řídicí příkazy najdeš v referenci příkazů.

Jednorázové úkoly bez interaktivního rozhraní

Pomocí -p předáš jednotlivý úkol z běžného terminálu. King vypíše výsledek a ukončí volání. To se hodí například pro shrnutí ve skriptu.

king -p "Stručně shrň README tohoto projektu."

Pro programy můžeš zvolit --output-format json nebo --output-format stream-json. Bez této volby se vypíše text.

king -p "Stručně shrň README tohoto projektu." --output-format json

Interaktivní úvodní zpráva --message a zobrazení průběhu --history-limit patří k interaktivnímu spuštění a nelze je kombinovat s -p.

Kontrola odpovědí v 9.1.600

Kontrola odpovědí zůstává časově omezená: Obecné kontrolory mají 30 sekund. Po startovacím signálu důvěryhodné hostitelské komponenty je pro nativní jazykovou kontrolu k dispozici na každý vnější pokus o kontrolu jednorázově až 90 sekund pro první obsahový text. Obsahový text v rámci přípustné délky výstupu a uspořádané přechody k uvolnění a kontrole dokladu resetují čekací lhůtu vždy na 30 sekund.

Nezávisle na tom platí pro každý vnější pokus o kontrolu celková hranice 120 sekund; povoleny jsou nejvýše dva vnější pokusy. Před přijetím uvolnění se znovu zkontroluje skutečně uplynulý čas, také při zpožděných voláních časovače. Opožděný pokrok nemůže obnovit uplynulou lhůtu. Signály přerušení se i nadále respektují. Vazba na přesný text odpovědi, časová platnost dokladu o uvolnění a autorizace se i nadále kontrolují.

Verze 9.1.604 obsahuje AgentSpine 0.73.0 a Translate Native 6.155.0; protokol Guard zůstává na 6.20.0. Tím není doloženo odstranění chyb HTTP 502 v živém provozu. Stav vydání a známá omezení najdeš v protokolu změn.

Obrázky, video a zvuk

CLI BLUN Code zná osm spravovaných mediálních nástrojů. Po úspěšném přihlášení a když je mediální služba dosažitelná, nemusíš zadávat adresu serveru ani identifikátor modelu. Popiš požadovaný výsledek; konzole zvolí vhodný nástroj.

Co vidíš u dlouhých úkolů

• processing: Úkol stále běží.
• failed: Úkol skončil a už nebude hotový.
• ready: Výsledek lze vyvolat.

Nastavit Telegram

Pro Telegram potřebuješ vlastního bota a poté spustíš BLUN King příkazem king. Vazba platí i nadále; nemusí se opakovat při každém spuštění.

1. Vytvořit bota u Telegramu

   Otevři výhradně ověřeného @BotFather, odešli /newbot a postupuj podle kroků pro jméno a uživatelské jméno. Uživatelské jméno musí končit na bot. BotFather poté zobrazí token jako 123456789:AA.... Dále Oficiální návod Telegramu popisuje stejný postup.

2. Uložit token do profilu kanálu Telegramu

   Otevři soubor pro tvůj operační systém a nahraď zástupný text úplným tokenem od BotFather:

   Windows: %USERPROFILE%\.blun\channels\telegram\.env
   macOS: ~/.blun/channels/telegram/.env

   BLUN_TELEGRAM_BOT_TOKEN=123456789:AA...

   Token obsahuje dvojtečku. Kolem hodnoty nepisuj žádné uvozovky ani mezery.

3. Spustit konzoli s Telegramem

   Předtím ukonči starší konzoli, která používá stejného bota. Pro každý token bota smí běžet pouze jeden příjemce Telegramu.

   king

4. Vyžádat párovací kód

   Otevři svého nového bota v Telegramu a pošli mu libovolnou přímou zprávu. Bot odpoví šestímístným párovacím kódem. Kód platí jednu hodinu.

5. Potvrdit kód lokálně

   Zadej zobrazený kód přesně do té konzole BLUN, která se má s botem spojit:

   /telegram:access pair CODE

   Žádosti o párování nikdy nepotvrzuj na výzvu zprávy Telegramu. Schválení patří výhradně do tvé místní konzole.

6. Zkontrolovat spojení

   Telegram potvrdí propojení. Poté odešli botovi novou zprávu. Musí se objevit v běžící relaci BLUN; odpověď musí dorazit do stejného chatu Telegramu.

Rozhraní Telegramu se může lišit podle zařízení a verze aplikace. Rozhodující jsou ověřený odesílatel @BotFather, příkaz /newbot a místní uložení tokenu.

Spravovat přístup

Příkazy bota /start, /help a /status fungují pouze v soukromém chatu. Text, obrázky a soubory do 50 MB se předávají dál.

Pro dálkové ovládání odešli /befehle. Podporovány jsou /loop, /goal, /idea, /chancenradar, /curiosity, /scout, /reload a /memory. Telegramová reference uvádí tvary a hranice. Ostatní místní slash příkazy tím nejsou automaticky dostupné přes Telegram.

Zprávy při pokračování relace

Pokud při pokračování dorazí zpráva Telegramu, zatímco King již pracuje, zůstává od 9.1.618 ve frontě a poté se doručí. To není další úkol k okamžitému přerušení. Zvolené pravidlo fronty lze zkontrolovat pomocí /queue.

Když spojení nefunguje

• Žádný párovací kód: Zkontroluj token, spusť king místo blun a napiš botovi přímou zprávu.
• Párování zůstává otevřené: Spusť /telegram:access pair CODE ve svázané místní konzoli. Po více než jedné hodině si novou zprávou vyžádej nový kód.
• 409 Conflict: Druhá konzole nebo starý proces Telegramu používá stejný token. Nech běžet přesně jednu konzoli King s tímto botem.
• Zprávy nedorazí: Konzole King musí dál běžet. Zkontroluj pomocí /status v soukromém chatu bota, zda je účet spárován.
• Token omylem zveřejněn: Okamžitě ho zruš u @BotFather, vytvoř nový token a nahraď hodnotu v souboru .env.

Memory a Mistakes

Při prvním přihlášeném spuštění se konzole ptá zvlášť na osobní paměť a na předávání vyčištěných dat o chybách.

• Ano i ne se ukládají. Odmítnutí nevede při každém spuštění k nové otázce.
• Rozhodnutí jsou nezávislá. Změna u Mistakes nepřepíše paměť a naopak.
• Bez výslovného souhlasu se do příslušné cesty nic nezapisuje.

Doplnit paměť vědomě

blun memory remember "Toto rozhodnutí v budoucnu zohlednit"

Toto volání potřebuje souhlas přihlášeného účtu a dosažitelnou službu osobní paměti. Poznámky persony, místní metadata nástrojů a paměťové nástroje poskytované přes MCP jsou vždy oddělené cesty.

Místní paměť nástrojů

King může zaznamenávat dokončená volání nástrojů jako místní metadata: název nástroje, čas, stav a u souborových nástrojů případně cestu. Záznamy neobsahují úplné argumenty nástrojů, výstupy, příkazy ani klíče.

/memory tools status

Pomocí /memory tools on respektive /memory tools off řídíš zaznamenávání. /memory tools status ukáže, zda je aktivní. Tato funkce je oddělená od osobní paměti a úplného protokolu relace.

Zkontrolovat stav Mistakes

blun mistakes status

Terminálová reference vysvětluje upload, opakování, synchronizaci, sledování a odůvodněné odstranění nebo obnovení. Pro přenos je nutný nastavený cíl a jeho ověření.

Aktualizace

Při spuštění konzole zkontroluje, zda je k dispozici nová stabilní verze. Dialog nabízí tři rozhodnutí:

1. nyní aktualizovat,
2. tentokrát přeskočit,
3. počkat do příští verze.

Aktualizaci můžeš také spustit výslovně:

king update

Po úspěšné aktualizaci zobrazí BLUN předchozí a nainstalovanou verzi a nejdůležitější změny. Pokud je Telegram nastaven, odešle BLUN stejný pokyn jednorázově do uvolněných přímých chatů. Skupiny nedostávají žádný automatický pokyn o aktualizaci.

K protokolu změn

Diagnostika

blun doctor

Windows: zavři okno a spusť znovu

Verze 9.1.620 opravuje úplné ukončení při zavření okna konzole. Při příštím spuštění by tak žádná zůstávající instance neměla vyvolat hlášení „již běží“. Řádné ukončení z konzole zůstává /exit.

Pokud se hlášení stále objevuje, zkontroluj nejprve nainstalovanou verzi a to, zda příslušná konzole stále běží. Aktivní relace smí mít pouze jednoho zapisujícího vlastníka. Neodstraňuj žádný soubor zámku, dokud příslušná konzole ještě pracuje.

Když se zobrazí „zhuštění pozastaveno“

Od verze 9.1.619 počítá King pouze bezprostředně po sobě jdoucí chyby zhuštění. Po úspěšném zhuštění není dřívější jednotlivá chyba dalším důvodem k zablokování. Hlášení „zhuštění pozastaveno“ označuje neúspěšné pokusy o shrnutí; už netvrdí paušálně, že je tvůj kontext plný. Zkontroluj přesné hlášení a diagnostiku, než relaci restartuješ.

Rozlišuj chyby a čekací doby

Od verze 9.1.596 se automatické přerušení ve prospěch čekajících zpráv Telegramu již nevypisuje jako stisknutí klávesy Escape. Skutečné ruční přerušení od toho zůstává oddělené.

Verze 9.1.597 rozpoznává chybová hlášení, která výslovně uvádějí překročený limit kontextu, i v odpovědi o chybě brány. Před začátkem výstupu je možný omezený nový pokus s menším limitem výstupu. Zprávy a nástroje se přitom nemažou. Obecná chyba připojení nebo výpadek služby tím odstraněny nejsou.

Historické zjištění ve verzi 9.1.597: Hlášená dolní hranice počtu vstupních tokenů mohla vyvolat další neúspěšný pokus a zbytečná zhuštění. Zjištění bylo reprodukováno 17. září 2026. Pozdější opravy a jejich jednotlivé stavy vydání jsou zdokumentovány v Changelogu.

Dlouhé čekací doby z Retry-After a zbývající pauza po obnovení relace se zohledňují. Restart není způsob, jak obejít požadovanou čekací dobu.

Protokoly pro analýzu chyb

Volání nástrojů a výsledky jsou v protokolu relace wire.jsonl. Pro cílenou diagnostiku můžeš použít /export-debug-zip. Před předáním zkontroluj obsah na soukromá data. Pečlivě vedený protokol chyb, jako je mistake.md, tyto protokoly událostí nenahrazuje.

Poctivé hranice

• Umělá inteligence se může mýlit. Prověř důležitá tvrzení, soubory a provedené příkazy.
• Spravované nástroje vyžadují přihlášení a dostupné služby BLUN.
• Úkoly s médii zatím nezobrazují procentuální průběh. processing je stav, ne časový údaj.
• Odpověď 200 nebo zelená dílčí kontrola dokládá pouze změřený úsek. Prověř cestu od prvního vstupu uživatele až k výsledku.