BLUN Code CLI

Co się zmieniło od 9.1.605

Poszczególne zmiany i ich stany publikacji znajdziesz w dzienniku zmian CLI.

Wymagania

• Windows lub macOS na x64 lub ARM64; dodatkowo Linux
• Node.js 24.15.0 lub nowszy z serii LTS-24
• Node.js, npm i Git Bash w systemie Windows
• Dostęp do internetu na potrzeby logowania, modeli AI i narzędzi zarządzanych
• folder roboczy dla twojego projektu

Node.js, npm i Git Bash w systemie Windows

Node.js uruchamia konsolę. npm instaluje i aktualizuje pakiet. Oficjalny instalator Node.js zawiera npm. Git for Windows dostarcza potrzebną Kingowi powłokę Git Bash; z Node.js nie jest instalowany Git Bash.

Przed pierwszą instalacją

1. Zainstaluj Node.js 24 LTS (co najmniej 24.15.0) za pomocą instalatora MSI dla Windows z nodejs.org/en/download. Pozostaw włączone npm i wpis PATH.

2. Zainstaluj Git for Windows z gitforwindows.org.

3. Zamknij całkowicie terminal i otwórz nowe okno wiersza polecenia.

4. Sprawdź node --version, npm --version oraz git --version, zanim zainstalujesz Kinga.

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

Git for Windows zawiera Git Bash. Kinga można uruchomić z wiersza polecenia lub PowerShell; dodatkowe okno Git Bash nie jest potrzebne.

Instalacja Node.js i npm: oficjalna dokumentacja npm.

Gdy nie można znaleźć node lub npm

Node.js/npm nie istnieje lub nie jest dostępny przez PATH. Otwórz najpierw ponownie terminal. Jeśli błąd pozostanie, napraw instalację Node.js z włączonym npm i wpisem PATH.

where.exe node i where.exe npm pokazują dostępne ścieżki; bez trafienia program nie został znaleziony przez PATH.

where.exe node
where.exe npm

Gdy PowerShell blokuje npm.ps1, użyj npm.cmd zamiast osłabiać zasady wykonywania.

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

Gdy nie można znaleźć Git Bash

Zainstaluj Git for Windows i otwórz ponownie terminal. Przy instalacji w innym katalogu ustaw BLUN_SHELL_PATH na bezwzględną ścieżkę zainstalowanego bash.exe.

Poniższy przykład dotyczy tylko wiersza polecenia i tej sesji terminala; dopasuj ścieżkę do swojej instalacji. Przed ustawieniem sprawdź, czy plik istnieje.

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

Sprawdzanie i aktualizowanie Node.js

Sprawdź najpierw zainstalowaną wersję:

node --version
npm --version

Do jednorazowej instalacji npm muszą już istnieć Node i npm. Ostrzeżenie EBADENGINE jest możliwe przy starszej wersji Node. Po pomyślnej instalacji wystarczy pierwsze uruchomienie poleceniem king lub blun; BLUN konfiguruje wtedy własne środowisko uruchomieniowe.

Ręczna droga zastępcza

Gdy automatyczne pobieranie lub sprawdzanie sum kontrolnych w systemach Windows lub macOS zawiedzie, zainstaluj ręcznie Node.js 24 LTS:

1. Otwórz oficjalną stronę pobierania

   Wejdź na nodejs.org/en/download i wybierz Node.js 24 LTS.

2. Uruchom odpowiedni instalator

   W systemie Windows użyj instalatora MSI. W systemie macOS użyj pakietu PKG. Wybierz x64 lub ARM64 odpowiednio do swojego komputera.

3. Otwórz całkowicie nowy terminal

   Już otwarte terminale często używają nadal starej ścieżki programu.

4. Sprawdź ponownie wersję

   node --version
   npm --version

Instalacja

1. Sprawdź wymagania

   node --version
   npm --version

   W systemach Windows i macOS BLUN może przy pierwszym starcie zastąpić starszą istniejącą wersję Node swoim prywatnym środowiskiem. Do instalacji npm Node i npm muszą być już wywoływalne. W systemie Linux przed startem potrzebujesz Node.js 24.15.0 lub nowszego.

   Node.js, npm i Git Bash w systemie Windows

2. Zainstaluj aktualną wersję stabilną

   npm install -g blun-king-cli@latest

3. Sprawdź instalację

   blun --version

4. Uruchom diagnostykę

   blun doctor

Start i logowanie

Profil, obszar roboczy i sesja

Profil wybiera oddzielną tożsamość Kinga i jej ustawienia. Obszar roboczy określa, które pliki projektu są otwarte. Sesja zawiera przebieg rozmowy i stan pracy. Nowa sesja nie jest więc ani nowym kontem, ani automatycznie izolowanym worktree Git.

king --profile mein-king

--profile należy do launchera king. Do izolowanego obszaru roboczego Git używasz blun workspace create <nazwa>; do kontynuowania rozmowy służy wybór sesji. Referencja terminala wyjaśnia te polecenia i ich wymagania.

Którego polecenia startowego użyć?

Logowanie po raz pierwszy

1. Rozpocznij logowanie

   blun login

2. Dokończ logowanie w przeglądarce

   Zaloguj się na swoje konto BLUN i wróć do konsoli.

3. Otwórz folder projektu i uruchom

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

Alternatywnie możesz w działającej konsoli wpisać /login. Nie musisz kopiować klucza API do pliku konfiguracyjnego.

Kontynuowanie sesji

Poleceniem /sessions otwierasz wybór sesji. Możesz też podać dokładny identyfikator, dokładny tytuł lub jednoznaczny początek identyfikatora. Przy kilku wynikach wybierasz żądaną sesję z listy.

/sessions API-przebudowa

Dla ostatniej sesji bieżącego katalogu roboczego uruchamiasz Kinga w zwykłym terminalu poleceniem:

king --continue

Od 9.1.606 widok ładuje najpierw najnowsze wpisy historii. Domyślnie jest ich około 200; wiadomości i kroki narzędzi należące do siebie pozostają kompletne i mogą przekroczyć tę liczbę. Starsze strony osiągasz przez nawigację po historii. Zapisana historia rozmowy i kontekst modelu nie są skracane przez ten limit wyświetlania.

Docelowy rozmiar wyświetlania możesz ustawić przy interaktywnym starcie między 1 a 2000:

king --continue --history-limit 400

Otwieranie ostatnio wybranej sesji przy starcie

Jeśli regularnie wracasz do tej samej pracy, możesz dodać to ustawienie w istniejącym pliku ~/.blun/tui.toml. W systemie Windows plik znajduje się zwykle w %USERPROFILE%\.blun\tui.toml.

resume_last_selected = true

Umieść linię w górnej części pliku, przed sekcją taką jak [editor]. Pozostałe ustawienia pozostają zachowane. Wybór jest zapisywany odpowiednio do konta, agenta, katalogu roboczego i środowiska uruchomieniowego. Wyraźnie podana sesja ma pierwszeństwo. Jeśli zapisany wybór nie jest już dostępny, rozpoczyna się nowa sesja. Poleceniem false wyłączasz tę opcję startu ponownie.

Wybieranie profilu

/profile lub /profiles otwiera wybór profili. Podczas trwającej pracy lub przy oczekujących wiadomościach bieżący profil pozostaje aktywny; wybierz inny profil, gdy tylko sesja będzie gotowa.

System32 nie jest folderem projektu

Przed startem przejdź w wierszu polecenia do folderu użytkownika poleceniem cd /d "%USERPROFILE%". Alternatywnie przejdź do własnego istniejącego folderu projektu. W programie PowerShell wybierz folder użytkownika poleceniem Set-Location $HOME. Następnie uruchom king.

cd /d "%USERPROFILE%"
king

Wybór folderu roboczego (9.1.603)

Gdy w systemie Windows wybierzesz inny folder roboczy, otworzy się okno wyboru folderu. Możesz nadal wpisać ścieżkę ręcznie. Gdy anulujesz okno, wrócisz do wyboru folderu bez przejęcia żadnego.

Gdy okno wyboru folderu nie jest dostępne, konsola pyta o ścieżkę. Na innych systemach operacyjnych pozostaje wprowadzanie ścieżki.

Gdy przy starcie zostanie przejęty lub zapisany folder wewnątrz katalogu Windows, wybór folderu proponuje twój folder użytkownika. Ścieżki wpisane ręcznie są nadal sprawdzane jak dotychczas.

Codzienna praca

Ustalanie poziomu rozumowania i uprawnień

Od 9.1.609 Ctrl+L otwiera wybór nakładu myślenia bezpośrednio z pola wprowadzania. Twój dotychczasowy tekst pozostaje zachowany. Gdy King pracuje, zmiana jest odrzucana; otwórz wybór ponownie, gdy tylko sesja będzie gotowa. Dostępne poziomy zależą od aktywnego modelu.

Poziom rozumowania steruje tym, jak dokładnie model pracuje przed odpowiedzią. Wyższe poziomy mogą trwać wyraźnie dłużej.

blun --effort high --permission-mode manual

Wybór stylu wyjścia

Poleceniem /output-style otwierasz wybór. Dostępne są: Standardowy, Zwięzły, Proaktywny, Wyjaśniający i Uczący się. Wybór obowiązuje natychmiast dla bieżącej sesji i jest zapisywany jako standard dla późniejszych startów.

Podsumowywanie aktywnego kontekstu

BLUN Code monitoruje aktywny kontekst dla następnego żądania modelu, a nie po prostu cały zapisany przebieg. Skuteczna granica zależy od modelu, konta i budżetu podsumowania. Starsze części są podsumowywane w ograniczonych etapach; każdy etap rezerwuje miejsce na swoje podsumowanie.

W tym czasie w rozmowie pojawia się na przykład Verdichte ~941,2k Tokens … · 2/~10 · 90 %. 2/~10 pokazuje bieżącą i szacunkową liczbę etapów. 90 % to zmierzone wykorzystanie okna modelu dla bieżącego wywołania podsumowania. Gdy etap zawiedzie lub nie zmniejszy kontekstu, pierwotny kontekst pozostaje zachowany.

Już przy 75 procentach skutecznej granicy podsumowania małe, bezstratne podsumowanie odciąża starsze duże wyniki narzędzi i zakończone argumenty narzędzi. Przy oknie modelu wynoszącym 1 048 576 tokenów i pełnym podsumowaniu przy 256 000 tokenów punkt ten leży przy 192 000 tokenów. Ostatnich 20 wiadomości, zwykłe teksty użytkownika i zapisany surowy przebieg pozostają bez zmian.

Proaktywne podsumowywanie na granicy pracy

Użytkownicy nie muszą wpisywać polecenia. Gdy tylko aktywny kontekst osiągnie połowę automatycznej granicy pełnego podsumowania, King może po zakończonym fragmencie pracy wybrać CompactConversation. Narzędzie planuje istniejący, bezpieczny proces podsumowania na koniec bieżącego kroku narzędzia. Nie otwiera kolejnej pętli; gdy podsumowanie zawiedzie, pierwotny przebieg pozostaje bez zmian.

Radzenie sobie z krótkim przeciążeniem serwera

Przy wyraźnie oznaczonym jako powtarzalne przeciążeniu serwera (HTTP 429 z x-should-retry: true) BLUN King czeka zgodnie z Retry-After i wysyła to samo żądanie co najwyżej dwa razy ponownie. Błędy uwierzytelniania, limitu i inne niepowtarzalne kończą się nadal natychmiast. Gdy serwer po ograniczonych próbach pozostaje przeciążony, użytkownik nadal otrzymuje wyraźny komunikat o błędzie.

Wznawianie delegowanej pracy po przerwie u dostawcy

Gdy delegowany pojedynczy agent lub członek roju agentów straci połączenie z dostawcą, otrzyma pustą odpowiedź dostawcy, przerwie swój strumień z powodu braku aktywności lub serwer zgłosi HTTP 408/500/502/503/504, BLUN King kontynuuje tego samego agenta na podstawie jego trwałego przebiegu. Przy pojedynczych agentach oraz przy przerwach roju poza HTTP 429 pierwsza kontynuacja czeka dwie sekundy, a druga pięć; potem pierwotny błąd pozostaje widoczny. HTTP 429 zachowuje w roju swoją odrębną, dłuższą regułę przeciążenia. Błędy uwierzytelniania, płatności lub limitów, polityk, kontekstu, narzędzi i kodu oraz ręczne przerwania nie wyzwalają automatycznej kontynuacji. Każda próba kontynuacji używa istniejącego ID agenta, aby już ukończona praca nie była powtarzana.

Przenoszenie dużych wyników narzędzi na dysk

Przy wynikach narzędzi opartych na tekście, zawierających więcej niż 12 000 znaków, BLUN King zapisuje pełną treść w prywatnym folderze sesji tool-results. W późniejszych żądaniach modelu pozostają pierwsze 1 000 i ostatnie 1 000 znaków, dokładna liczba pominiętych znaków oraz output_path. Mieszane wyniki multimedialne i już skrócone wyniki pozostają bez zmian. Późniejsze mikropodsumowanie zachowuje ścieżkę.

Wersja 9.1.104 pozwala poleceniom powłoki w tle działać do regularnego końca nawet przy bardzo dużych danych wyjściowych. King zapisuje w sposób ciągły do 16 MiB w prywatnym dzienniku zadań, odrzuca dane przekraczające ten rozmiar i zgłasza rzeczywisty kod wyjścia zamiast kończyć proces z powodu ilości danych wyjściowych. Małe dane wyjściowe, zadania w tle, limity czasu i ręczne przerwania pozostają bez zmian.

Read output_path

Przykład: wynik wyszukiwania zawierający 30 000 znaków pozostaje w pełni dostępny w pliku lokalnym. Model widzi początek oraz końcowy wynik lub błąd od razu; agent czyta przez ścieżkę tylko potrzebne fragmenty, zamiast przy każdym kroku modelu wysyłać ponownie wszystkie 30 000 znaków.

Równoległe pakiety wyników narzędzi

Od wersji 9.1.99 King traktuje bezpośrednio następujące po sobie wyniki czysto tekstowe dodatkowo jako pakiet. Gdy pakiet przekracza łącznie 12 000 znaków, mimo że każdy pojedynczy wynik jest mniejszy, King przenosi na dysk tyle największych wyników od 3 000 znaków, ile potrzeba do zejścia poniżej granicy. W kontekście modelu pozostają czytelne odnośniki; surowy przebieg sesji i multimedia pozostają bez zmian. Zdarzenie telemetryczne tool_result_batch_offloaded zgłasza tylko liczbę i rozmiary znaków, nie treści ani ścieżki.

Przenoszenie dużych wiadomości użytkownika

Gdy prawdziwa wiadomość użytkownika zawiera więcej niż 200 000 znaków tekstu, BLUN King zapisuje pełny tekst w prywatnym folderze conversation-history. W kontekście modelu pozostają pierwsze pięć i ostatnie pięć linii, dane o rozmiarze oraz output_path. Poleceniem Read i output_path agent czyta tylko potrzebne strony. Obrazy, audio i inne składniki nietekstowe pozostają dołączone. Widoczny zapis i zapisany surowy przebieg zawierają nadal pełną oryginalną wiadomość. Wiadomości zawierające dokładnie 200 000 znaków pozostają w pełni w kontekście; przy błędzie zapisu obowiązuje to samo.

Ograniczanie dużych wyszukiwań Grep

W trybie wyjścia content Grep kończy ripgrep po offset plus head_limit plus jednej pełnej linii podglądu. Dodatkowa linia służy tylko do rozpoznania kolejnej strony. Przy head_limit=250 i offset=0 wczytywanych jest co najwyżej 251 pełnych linii wyników. Przy head_limit=0, dla count_matches oraz dla sortowanych według czasu zmiany files_with_matches King nadal wczytuje pełny wynik.

Precyzyjne dalsze czytanie dużych plików

Duże pliki są nadal czytane stronicowo. Gdy Read osiągnie swoją wewnętrzną granicę 1 000 linii, a plik zawiera kolejne linie, wynik podaje dokładny następny line_offset. Przykład: odczyt od linii 2001 jest kontynuowany z line_offset=3001. Na końcu pliku oraz przy celowo mniejszym fragmencie odczytu nie pojawia się żadna wskazówka. Dzięki temu agent nie wyciąga wniosków z niekompletnego fragmentu i nie czyta pliku ponownie od pierwszej linii.

Korzystanie z wątków rozmowy

Agenci w tle

Agenci w tle pojawiają się z zadaniem i statusem w widoku agentów. Możesz otworzyć ich dane wyjściowe, wysłać pytanie lub zatrzymać agenta. Hooki i wbudowana diagnostyka serwera językowego sprawdzają zmienione pliki po zapisie i edycji.

Wersja 9.1.105 dodaje TaskUpdate dla działających agentów w tle. King przekazuje dodatkowe instrukcje przy następnym bezpiecznym kroku modelu temu samemu aktywnemu agentowi, bez zatrzymywania go lub uruchamiania kolejnego agenta. Nieznane i już zakończone zadania, zadania powłoki oraz agenci, którzy nie przyjmują już aktualizacji, są nadal odrzucani.

Wersja 9.1.106 pozwala profilom agentów wykluczać narzędzia po nazwie. King stosuje te wykluczenia dopiero po złożeniu narzędzi stale wczytanych, dynamicznie doładowanych i MCP. Standardowe profile coder, explore i plan nie mogą przez Telegram odpowiadać ani reagować, edytować wiadomości ani pobierać załączników; główny agent pozostaje bez zmian.

Wersja 9.1.107 pokazuje błędy dostawcy w zrozumiałym języku klienta; wewnętrzne kody błędów i komunikaty pomocy technicznej nie są przy tym wyświetlane. /help oferuje listę poleceń sterowaną klawiszami strzałek, a prawą strzałką lub Enterem otwiera szczegółowy opis wybranego polecenia.

Wersja 9.1.108 usuwa identyczne, wielokrotnie wstrzykiwane wskazówki systemowe z projekcji modelu. Dla każdego rodzaju wskazówki pozostaje widoczna najnowsza dokładna kopia. Zmienione wskazówki, zwykłe wiadomości użytkownika, wywołania narzędzi, treści mieszane i zapisany surowy przebieg sesji pozostają bez zmian. Dzięki temu dane wysyłane do dostawcy w długich sesjach są mniejsze, bez ograniczania zapisanego przebiegu, eksportów ani wznawiań.

Ładowanie narzędzi i skilli na żądanie

Od wersji 9.1.595 King ponownie ładuje opcjonalne schematy narzędzi celowo przez ToolSearch zamiast wysyłać pełny katalog przy każdym żądaniu. Zachowana selekcja jest ograniczona; narzędzia pozostają możliwe do znalezienia, nawet gdy ich schemat nie jest akurat wysyłany. Normalne kontrole uprawnień nadal obowiązują. Duże katalogi skilli są udostępniane w zwarty sposób i stronicowo.

Przy krótkich powitaniach King może użyć ograniczonego fragmentu najnowszego dialogu. Instrukcje systemowe pozostają zachowane; przy zleceniu roboczym zachowany przebieg pracy jest ponownie uwzględniany. Nie usuwa to zapisanych wiadomości. Powitanie nie ma zatem stałej ceny tokenowej: kontekst systemowy, narzędzia, powtórzenia i weryfikacja odpowiedzi nadal przyczyniają się do zużycia.

/context pokazuje szacunkowy rozmiar kontekstu następnego żądania i obowiązującą dla niego granicę. /context-doctor względnie /tokens uzupełnia widok o dostępne dane diagnostyczne; /usage pokazuje widok zużycia i limitów. Wartości szacunkowe, zsumowane zużycie sesji i faktycznie rozliczone tokeny to różne wielkości.

Duże katalogi narzędzi są w razie potrzeby udostępniane przez wyszukiwanie narzędzi. Od 9.1.615 budżet narzędzi zależy od zgłoszonego okna kontekstu dostawcy. Znalezione narzędzia pozostają dostępne w następnym kroku; ich pełne opisy nie muszą być wysyłane przy każdym zleceniu.

/context doctor: rozróżnia zapisany przebieg, szacunkową liczbę tokenów i liczbę bajtów serializowanego żądania. Pokazuje zarejestrowane udziały reguł AGENTS, plików Mistake, Memory, skilli i definicji narzędzi. Brakujące dane o pochodzeniu nie oznaczają zerowej liczby bajtów.

Bajty żądania, szacunkowe liczby tokenów, zsumowane zużycie sesji i rozliczone tokeny to różne wielkości. Widok zużycia uwzględnia także weryfikację odpowiedzi. /usage cost z kosztami dziennymi lub miesięcznymi nie należy do tej wersji. Niższe koszty lub szybsze odpowiedzi w trybie na żywo nie są potwierdzone.

Każda próba HTTP otrzymuje nowy x-request-id, o ile wywołujący nie poda własnego. Podane identyfikatory pozostają bez zmian i nie są rejestrowane jako dowolny obcy tekst. Identyfikator służy do przyporządkowania pomiarów klienta i serwera; nie jest kluczem rozliczeniowym.

Sterowanie sesją w wersji 9.1.604

/queue: pokazuje lub zmienia, jak ta sesja przetwarza przychodzące wiadomości. Tryby nazywają się steer, followup, collect i interrupt; reset lub default usuwa ustawienie właściwe sesji.

Bez ustawienia specyficznego dla sesji King używa steer z 500 milisekundami czasu grupowania i maksymalnym rozmiarem partii 20 wiadomości. /queue pokazuje obowiązujące wartości; /queue reset usuwa tylko ustawienie specyficzne dla sesji.

steer przekazuje nowe dane wejściowe przy następnym odpowiednim punkcie przekazania; jeśli to niemożliwe, czekają na następny przebieg. followup czeka do końca bieżącego przebiegu. collect grupuje dane wejściowe; interrupt przerywa bieżący przebieg dla nowych danych wejściowych.

/queue collect debounce:500ms batch:10

Dozwolone są debounce:0ms do debounce:60s oraz batch:1 do batch:100. batch ogranicza rozmiar grupy bez usuwania nadmiarowych wiadomości. Nie ma opcji cap: ani drop:. Reguła kolejki i widok zużycia pozostają przy wznawianiu tej samej sesji. Zwykłe nowe wiadomości kanału nie wyzwalają już automatycznie po 30 sekundach przerwania.

/session [ID|tytuł]: otwiera wybór sesji lub wybiera sesję na podstawie jej dokładnego identyfikatora, dokładnego tytułu lub jednoznacznego prefiksu identyfikatora. Przy wielu trafieniach otwiera się wybór.

/question: otwiera ponownie oczekujące pytania. Zwinięcie nie odpowiada na pytanie ani go nie odrzuca.

/usage: pokazuje zużycie i dostępne limity. off, tokens i full zapisują tryb wyświetlania dla tej sesji. reset usuwa to ustawienie; inherit, clear i default są równoważne.

/settings: otwiera ustawienia, w tym lokalne opcje wyświetlania.

Wersja 9.1.605

/context map pokazuje dostępny podział na bajty ostatnio zarejestrowanego żądania. /context list, /context detail i /context doctor otwierają szczegółowy raport. Rozróżnia on pliki instrukcji, Memory, skille, definicje narzędzi i przyporządkowane teksty przebiegu. Brakujące wartości pomiarów pozostają oznaczone jako niedostępne; nie są liczone jako zero.

king --message "Sprawdź otwarte testy" przekazuje interaktywnej konsoli pierwszą wiadomość. Jest ona przetwarzana po potwierdzeniu przy starcie i wyborze sesji przez normalne kontrole wiadomości i kolejkę. Jej treść nie jest interpretowana jako polecenie slash ani powłoki. Potwierdzenie przy starcie i kontrole uprawnień nie są przy tym pomijane.

/abort przerywa bieżący proces bez odrzucania oczekujących danych wejściowych. /stop dodatkowo odrzuca oczekujące dane wejściowe. /exit nadal kończy konsolę. Są to lokalne polecenia konsoli, a nie dodatkowe polecenia zdalne Telegrama.

Dodatkowa linia agenta/sesji na dole znika. Wybór sesji i diagnostyka pozostają dostępne przez istniejące polecenia.

Rozróżnianie bieżącego kontekstu od zapisanej historii

Długa zapisana historia nie musi w całości zmieścić się w pojedynczym żądaniu do modelu. King może zagęścić aktywny kontekst roboczy i udostępnić starsze wyniki narzędzi za pomocą zweryfikowanych odwołań. Kompletne oryginały pozostają zachowane do celowego doczytania.

Od 9.1.617 podgląd dużych wyników narzędzi uwzględnia również dostępne okno kontekstu. Przy ponownym ładowaniu tej samej sesji niezmienione instrukcje pluginów nie są zawsze dodawane ponownie. Poleceniem /context doctor sprawdzasz zarejestrowane żądanie; /context map pokazuje jego dostępny podział bajtów.

Dla plików instrukcji takich jak AGENTS.md w konsoli Kinga obowiązuje od 9.1.614: pozostają kompletne, dopóki pozwala na to limit żądań. Większe pliki nie zatrzymują zlecenia tylko ze względu na ich rozmiar. Wcześniejsze ogólne skracanie z 9.1.613 nie opisuje już obecnej drogi konsoli.

Zadania i dane wyjściowe pozostają widoczne

Listę zadań można rozwinąć skrótem Ctrl+T. Długie dane wyjściowe narzędzi są w przebiegu pokazywane w skrócie i można je rozwinąć skrótem Ctrl+O. Wiersz wprowadzania, wskaźnik aktywności i oba paski statusu należą do konsoli. /tasks otwiera zadania w tle; /copy kopiuje ostatnią dostępną odpowiedź. Referencja poleceń zawiera wszystkie wbudowane polecenia oraz przegląd skrótów klawiszowych i narzędzi agenta.

Monitorowanie długich przebiegów

Od wersji 9.1.40 konsola zgłasza przebieg, gdy przez 20 minut nie nadeszło żadne nowe narzędzie. Pasek statusu pokazuje czas działania, ostatnio użyte narzędzie i liczbę powtórzonych błędów. Pięć kolejnych nieudanych wywołań tego samego narzędzia z tymi samymi argumentami kończy przebieg wyraźnym komunikatem o błędzie zamiast niezauważonego dalszego działania.

Skills, Pluginy i MCP

Skills to wielokrotnie używalne instrukcje robocze. Pluginy mogą dodatkowo udostępniać narzędzia, Skills i własne polecenia. MCP łączy konsolę ze skonfigurowanymi serwerami narzędzi.

Korzystanie z istniejących Skills

Opisz swoje zlecenie konkretnie, aby King mógł znaleźć odpowiednie instrukcje. Dla konkretnej instrukcji wpisujesz w polu wprowadzania / i wybierasz oferowanego Skill. Wbudowane Skills pojawiają się pod swoją nazwą; własne zwykle jako /skill:<nazwa>. Sugestie Twojej instalacji pokazują faktycznie dostępne nazwy.

/skill:angebot-pruefen sprawdź ofertę w folderze projektu

Ten przykład działa po utworzeniu własnego Skill o nazwie angebot-pruefen. Jeśli w grę wchodzi kilka instrukcji, możesz najpierw poprosić Kinga o porównanie i rekomendację.

Dodawanie własnej instrukcji

Utwórz w projekcie na przykład .agents/skills/angebot-pruefen/SKILL.md. Plik Skill zawiera nazwę, opis zakresu zastosowania i właściwe kroki robocze:

---
name: angebot-pruefen
description: sprawdzanie ofert pod kątem zakresu świadczeń, terminów i otwartych pytań.
---

Przeczytaj całą ofertę.
Sprawdź zakres świadczeń, terminy, wyłączenia i otwarte pytania.
Przy każdym ustaleniu podaj odpowiednie miejsce w dokumencie.
Pokaż wynik, zanim zmienisz pliki.

Skills projektu są również wyszukiwane w .blun/skills. Dla instrukcji obejmujących kilka Twoich projektów istnieją ~/.agents/skills i ~/.blun/skills. W systemie Windows ~ oznacza Twój folder użytkownika. Po dodaniu uruchom ponownie Kinga lub przeładuj sesję poleceniem /reload, gdy tylko będzie gotowa, i sprawdź sugestie ukośnika.

Dla wyraźnie wybranego folderu Skills możesz uruchomić Kinga tak:

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

Ta opcja zastępuje automatyczne wyszukiwanie w folderach Skills użytkownika i projektu dla tego startu. Możesz ją powtórzyć dla kilku folderów. Skill z GitHuba musi znajdować się w takim folderze ze swoją strukturą folderów i ważnym plikiem SKILL.md.

Instalowanie i zarządzanie pluginami

/plugins otwiera zarządzanie pluginami. Możesz tam przeglądać marketplace i sprawdzać istniejące pluginy. Dostępne są również polecenia list, info, install, enable, disable i remove.

/plugins list

Do instalacji wpisujesz /plugins install <źródło> lub wybierasz wpis z katalogu. Sprawdź źródło i wyświetlane informacje oraz potwierdź oferowaną instalację. Wyłączony plugin pozostaje zainstalowany; remove usuwa go po potwierdzeniu. Plugin może oferować własne polecenia ukośnikowe, na przykład /<plugin>:<polecenie>.

Sprawdzanie połączeń narzędzi

Poleceniem /mcp otwierasz widok MCP. Zarządzanie pluginami pokazuje również serwery MCP pluginu. Zainstalowana instrukcja nie zastępuje logowania do połączonej usługi. Sprawdź w danym widoku, czy połączenie jest aktywne, zanim uzależnisz od niego zlecenie.

Cele, powtarzalna praca i podagenci

Opracowanie celu aż do wyniku

/goal zapisuje konkretny cel. Opisz pożądany wynik, dozwolone zmiany i to, po czym można poznać wykonanie.

/goal Sprawdź otwarte testy, usuń przyczyny w projekcie i pokaż wyniki kontroli.

Poleceniem /goal status sprawdzasz stan. /goal pause wstrzymuje cel, /goal resume go wznawia, a /goal cancel kończy i usuwa. /goal edit <cel> zmienia zlecenie; /goal replace <cel> wyraźnie zastępuje aktywny cel.

Poleceniem /goal next <cel> zapisujesz zlecenie kontynuacyjne. /goal next manage otwiera zarządzanie tymi celami kontynuacyjnymi. Nowe zlecenie lub kontynuacja celu rozpoczyna się dopiero, gdy sesja będzie gotowa.

Powtarzanie zadania

/loop powtarza prompt w wybranym odstępie. Zawsze podawaj, co ma być sprawdzane i przy jakim wyniku King ma Cię poinformować.

/loop 10m Sprawdź istniejące wyniki testów i zgłaszaj tylko nowe błędy.

/loop status, /loop pause, /loop resume i /loop stop sterują powtarzaniem. Wstrzymanie powtarzania i przerwanie trwającej pracy to osobne działania: dla bieżącej pracy istnieją /abort i /stop.

Zadawanie pytania obok głównego zlecenia

/btw <pytanie> uruchamia pytanie poboczne w odgałęzionej rozmowie. /swarm <zadanie> rozdziela wyraźnie zlecone zadanie na kilku agentów. Poleceniem /tasks widzisz zadania w tle i ich wyniki.

Dla wciąż otwartego planu dostępne są również /premortem, /idea, /chancenradar i /curiosity. Ich różnice, ograniczenia i polecenia sterujące znajdziesz w referencji poleceń.

Zlecenia jednorazowe bez interfejsu interaktywnego

Przełącznikiem -p przekazujesz pojedyncze zlecenie ze zwykłego terminala. King wyświetla wynik i kończy wywołanie. Nadaje się to na przykład do streszczenia w skrypcie.

king -p "Krótko streść README tego projektu."

Dla programów możesz wybrać --output-format json lub --output-format stream-json. Bez tej opcji wyświetlany jest tekst.

king -p "Krótko streść README tego projektu." --output-format json

Interaktywny komunikat startowy --message i wyświetlanie historii --history-limit należą do startu interaktywnego i nie można ich łączyć z -p.

Weryfikacja odpowiedzi w wersji 9.1.600

Weryfikacja odpowiedzi pozostaje ograniczona w czasie: ogólni weryfikatorzy mają 30 sekund. Po sygnale startowym zaufanego komponentu hosta dla natywnej kontroli języka na każdą zewnętrzną próbę kontroli udostępniane jest jednorazowo do 90 sekund na pierwszy tekst merytoryczny. Tekst merytoryczny w dozwolonej długości wyjścia oraz uporządkowane przejścia do zwolnienia i kontroli dowodu resetują czas oczekiwania każdorazowo do 30 sekund.

Niezależnie od tego na każdą zewnętrzną próbę kontroli obowiązuje łączna granica 120 sekund; dozwolone są co najwyżej dwie próby zewnętrzne. Przed przyjęciem zwolnienia faktycznie upływający czas jest ponownie sprawdzany, także przy opóźnionych wywołaniach timera. Spóźniony postęp nie może odnowić wygasłego terminu. Sygnały przerwania są nadal respektowane. Powiązanie z dokładnym tekstem odpowiedzi, czasowa ważność dowodu zwolnienia i autoryzacja są nadal sprawdzane.

Wersja 9.1.604 zawiera AgentSpine 0.73.0 i Translate Native 6.155.0; protokół Guard pozostaje na 6.20.0. Dzięki temu nie jest potwierdzone usunięcie błędów HTTP-502 w trybie na żywo. Stan publikacji i znane ograniczenia znajdują się w dzienniku zmian.

Obrazy, wideo i dźwięk

BLUN Code CLI zna osiem zarządzanych narzędzi multimedialnych. Po pomyślnym logowaniu i gdy usługa multimedialna jest dostępna, nie musisz wpisywać adresu serwera ani identyfikatora modelu. Opisz pożądany wynik; konsola wybiera odpowiednie narzędzie.

Co widzisz przy długich zleceniach

• processing: zlecenie nadal działa.
• failed: zlecenie jest zakończone i nie zostanie dokończone.
• ready: wynik można pobrać.

Konfigurowanie Telegrama

Do Telegrama potrzebujesz własnego bota i uruchomienia BLUN Kinga poleceniem king. Połączenie obowiązuje dalej; nie trzeba go powtarzać przy każdym starcie.

1. Utwórz bota w Telegramie

   Otwórz wyłącznie zweryfikowany @BotFather, wyślij /newbot i postępuj zgodnie z krokami dla nazwy i nazwy użytkownika. Nazwa użytkownika musi kończyć się na bot. BotFather pokazuje następnie token podobny do 123456789:AA.... Oficjalny przewodnik Telegrama opisuje ten sam przebieg.

2. Zapisz token w profilu kanału Telegram

   Otwórz plik dla swojego systemu operacyjnego i zastąp symbol zastępczy pełnym tokenem BotFather:

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

   BLUN_TELEGRAM_BOT_TOKEN=123456789:AA...

   Token zawiera dwukropek. Nie pisz cudzysłowów ani spacji wokół wartości.

3. Uruchom konsolę z Telegramem

   Zakończ wcześniej starszą konsolę używającą tego samego bota. Dla każdego tokena bota może działać tylko jeden odbiorca Telegrama.

   king

4. Poproś o kod parowania

   Otwórz swojego nowego bota w Telegramie i wyślij mu dowolną wiadomość bezpośrednią. Bot odpowiada sześciocyfrowym kodem parowania. Kod obowiązuje jedną godzinę.

5. Potwierdź kod lokalnie

   Wpisz wyświetlony kod dokładnie w konsoli BLUN, która ma zostać połączona z botem:

   /telegram:access pair CODE

   Nigdy nie potwierdzaj próśb parowania na polecenie wiadomości Telegram. Zgoda należy wyłącznie do twojej lokalnej konsoli.

6. Sprawdź połączenie

   Telegram potwierdza połączenie. Wyślij następnie nową wiadomość do bota. Musi pojawić się w działającej sesji BLUN; odpowiedź musi dotrzeć w tym samym czacie Telegrama.

Interfejs Telegrama może różnić się w zależności od urządzenia i wersji aplikacji. Decydujące są zweryfikowany nadawca @BotFather, polecenie /newbot i lokalne zapisanie tokena.

Zarządzanie dostępem

Polecenia bota /start, /help i /status działają tylko w czacie prywatnym. Tekst, obrazy i pliki do 50 MB są przekazywane dalej.

Do zdalnego sterowania wyślij /befehle. Obsługiwane są /loop, /goal, /idea, /chancenradar, /curiosity, /scout, /reload i /memory. Referencja Telegrama podaje formy i granice. Pozostałe lokalne polecenia slash nie są przez to automatycznie dostępne w Telegramie.

Wiadomości przy kontynuowaniu sesji

Jeśli przy kontynuowaniu nadejdzie wiadomość Telegram, gdy King już pracuje, od 9.1.618 pozostaje ona w kolejce i zostanie dostarczona później. To nie jest dodatkowe zlecenie natychmiastowego przerwania. Wybraną regułę kolejki można sprawdzić poleceniem /queue.

Gdy połączenie nie działa

• Brak kodu parowania: sprawdź token, uruchom poleceniem king zamiast blun i napisz do bota wiadomość bezpośrednią.
• Parowanie pozostaje otwarte: wykonaj /telegram:access pair CODE w połączonej lokalnej konsoli. Po ponad godzinie poproś nową wiadomością o nowy kod.
• 409 Conflict: druga konsola lub stary proces Telegrama używa tego samego tokena. Pozostaw dokładnie jedną konsolę Kinga z tym botem.
• Wiadomości nie docierają: konsola Kinga musi nadal działać. Sprawdź poleceniem /status w prywatnym czacie bota, czy konto jest połączone.
• Token przypadkowo opublikowany: wycofaj go natychmiast u @BotFather, utwórz nowy token i zastąp wartość w pliku .env.

Memory i Mistakes

Przy pierwszym zalogowanym starcie konsola pyta osobno o osobiste Memory i o przekazywanie oczyszczonych danych o błędach.

• Tak i Nie są zapisywane. Odmowa nie prowadzi do nowego pytania przy każdym starcie.
• Decyzje są niezależne. Zmiana w Mistakes nie nadpisuje Memory i odwrotnie.
• Bez wyraźnej zgody nic nie jest zapisywane w odpowiednią ścieżkę.

Świadome uzupełnianie Memory

blun memory remember "Uwzględniaj tę decyzję w przyszłości"

To wywołanie wymaga zgody zalogowanego konta i dostępnej osobistej usługi Memory. Notatki persony, lokalne metadane narzędzi i narzędzia pamięci dostarczane przez MCP to osobne drogi.

Lokalna pamięć narzędzi

King może zapisywać zakończone wywołania narzędzi jako lokalne metadane: nazwa narzędzia, czas, status i w przypadku narzędzi plikowych ewentualnie ścieżkę. Wpisy nie zawierają pełnych argumentów narzędzi, wyników, poleceń ani kluczy.

/memory tools status

Poleceniem /memory tools on względnie /memory tools off sterujesz zapisywaniem. /memory tools status pokazuje, czy jest aktywne. Ta funkcja jest oddzielona od pamięci osobistej i pełnego protokołu sesji.

Sprawdzanie stanu Mistakes

blun mistakes status

Referencja terminala wyjaśnia przesyłanie, powtarzanie, synchronizację, obserwację oraz uzasadnione usuwanie lub przywracanie. Do przeniesienia wymagany jest skonfigurowany cel i jego uwierzytelnienie.

Aktualizacje

Przy starcie konsola sprawdza, czy dostępna jest nowa wersja stabilna. Okno dialogowe oferuje trzy decyzje:

1. zaktualizuj teraz,
2. pomiń tym razem,
3. poczekaj do następnej wersji.

Aktualizację możesz też uruchomić wprost:

king update

Po pomyślnej aktualizacji BLUN pokazuje poprzednią i zainstalowaną wersję oraz najważniejsze zmiany. Gdy Telegram jest skonfigurowany, BLUN wysyła tę samą wskazówkę jednorazowo do udostępnionych czatów bezpośrednich. Grupy nie otrzymują automatycznej wskazówki o aktualizacji.

Przejdź do dziennika zmian

Diagnostyka

blun doctor

Windows: zamykanie okna i ponowne uruchamianie

Wersja 9.1.620 koryguje pełne zakończenie przy zamykaniu okna konsoli. Dzięki temu przy następnym starcie żadna pozostała instancja nie powinna już wywoływać komunikatu „już działa”. Regularne zakończenie z konsoli pozostaje poleceniem /exit.

Jeśli komunikat nadal się pojawia, najpierw sprawdź zainstalowaną wersję i czy dana konsola nadal działa. Aktywna sesja może mieć tylko jednego właściciela zapisu. Nie usuwaj żadnego pliku blokady, gdy powiązana konsola nadal pracuje.

Gdy pojawia się „Podsumowywanie wstrzymane”

Od 9.1.619 King liczy tylko bezpośrednio następujące po sobie błędy podsumowywania. Po udanym podsumowaniu wcześniejszy pojedynczy błąd nie jest już dodatkowym powodem blokady. Komunikat „Podsumowywanie wstrzymane” oznacza nieudane próby streszczenia; nie twierdzi już ogólnie, że Twój kontekst jest pełny. Sprawdź dokładny komunikat i diagnozę przed ponownym uruchomieniem sesji.

Odróżniaj błędy od czasów oczekiwania

Od wersji 9.1.596 automatyczne przerwanie na rzecz oczekujących wiadomości Telegram nie jest już zgłaszane jako naciśnięcie klawisza Escape. Prawdziwe ręczne przerwanie pozostaje od tego odrębne.

Wersja 9.1.597 rozpoznaje komunikaty o błędzie, które wprost wymieniają przekroczoną granicę kontekstu, także w odpowiedzi o błędzie bramy. Przed rozpoczęciem danych wyjściowych możliwa jest ograniczona nowa próba z mniejszym limitem wyjścia. Wiadomości i narzędzia nie są przy tym usuwane. Ogólny błąd połączenia lub awaria usługi nie są przez to usunięte.

Historyczny ustalenie w 9.1.597: Zgłaszany dolny limit liczby tokenów wejściowych mógł wywołać kolejną nieudaną próbę i niepotrzebne podsumowywanie. Ustalenie zostało odtworzone 17 września 2026. Późniejsze poprawki i ich poszczególne stany publikacji są udokumentowane w dzienniku zmian.

Długie czasy oczekiwania z Retry-After oraz pozostała pauza po wznowieniu sesji są uwzględniane. Ponowne uruchomienie nie jest sposobem na ominięcie wymaganego czasu oczekiwania.

Dzienniki do analizy błędów

Wywołania narzędzi i wyniki znajdują się w dzienniku sesji wire.jsonl. Do celowej diagnozy możesz użyć /export-debug-zip. Przed przekazaniem sprawdź zawartość pod kątem prywatnych danych. Świadomie prowadzony dziennik błędów, taki jak mistake.md, nie zastępuje tych dzienników zdarzeń.

Uczciwe granice

• AI może się mylić. Sprawdzaj ważne stwierdzenia, pliki i wykonane polecenia.
• Zarządzane narzędzia wymagają logowania i dostępnych usług BLUN.
• Zlecenia multimedialne nie pokazują jeszcze postępu procentowego. processing to stan, a nie informacja o czasie.
• Odpowiedź 200 lub zielona kontrola częściowa potwierdza tylko zmierzony fragment. Sprawdź drogę od pierwszego wprowadzenia użytkownika do wyniku.