cc-viewer 1.2.0 → 1.2.2

package/concepts/pl/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Definicja
+
+Uruchamia sub-agenta (SubAgent) do autonomicznego przetwarzania złożonych wieloetapowych zadań. Sub-agent to niezależny podproces z własnym zestawem narzędzi i kontekstem.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `prompt` | string | Tak | Opis zadania do wykonania przez sub-agenta |
+| `description` | string | Tak | Krótkie podsumowanie w 3-5 słowach |
+| `subagent_type` | string | Tak | Typ sub-agenta, określa dostępny zestaw narzędzi |
+| `model` | enum | Nie | Określenie modelu (sonnet / opus / haiku), domyślnie dziedziczony od rodzica |
+| `max_turns` | integer | Nie | Maksymalna liczba tur agentowych |
+| `run_in_background` | boolean | Nie | Czy uruchomić w tle, zadanie w tle zwraca ścieżkę output_file |
+| `resume` | string | Nie | ID agenta do wznowienia, kontynuacja od ostatniego wykonania |
+| `isolation` | enum | Nie | Tryb izolacji, `worktree` tworzy tymczasowy git worktree |
+
+## Typy sub-agentów
+
+| Typ | Przeznaczenie | Dostępne narzędzia |
+|------|------|----------|
+| `Bash` | Wykonywanie poleceń, operacje git | Bash |
+| `general-purpose` | Ogólne wieloetapowe zadania | Wszystkie narzędzia |
+| `Explore` | Szybka eksploracja bazy kodu | Wszystkie narzędzia oprócz Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Projektowanie planu wdrożenia | Wszystkie narzędzia oprócz Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Pytania i odpowiedzi dotyczące przewodnika Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Konfiguracja paska statusu | Read, Edit |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Złożone zadania wymagające wieloetapowego autonomicznego wykonania
+- Eksploracja bazy kodu i dogłębne badania (typ Explore)
+- Praca równoległa wymagająca izolowanego środowiska
+- Długotrwałe zadania wymagające uruchomienia w tle
+
+**Nieodpowiednie zastosowanie:**
+- Odczyt określonej ścieżki pliku — bezpośrednio użyj Read lub Glob
+- Wyszukiwanie w 2-3 znanych plikach — bezpośrednio użyj Read
+- Wyszukiwanie definicji klasy — bezpośrednio użyj Glob
+
+## Uwagi
+
+- Po zakończeniu sub-agent zwraca pojedynczą wiadomość, jego wyniki nie są widoczne dla użytkownika — główny agent musi je przekazać
+- Można równolegle uruchamiać wiele wywołań Task w jednej wiadomości dla zwiększenia wydajności
+- Postęp zadań w tle sprawdza się za pomocą narzędzia TaskOutput
+- Typ Explore jest wolniejszy niż bezpośrednie wywołanie Glob/Grep, używaj tylko gdy proste wyszukiwanie nie wystarcza
+
+## Znaczenie w cc-viewer
+
+Wywołanie Task generuje łańcuch żądań SubAgent, widoczny na liście żądań jako niezależna sekwencja podzapytań oddzielona od MainAgent. Żądania SubAgent zazwyczaj mają uproszczony system prompt i mniej definicji narzędzi, co wyraźnie odróżnia je od MainAgent.

package/concepts/pl/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Definicja
+
+Tworzy strukturalny wpis na liście zadań, służący do śledzenia postępu, organizacji złożonych zadań i prezentowania użytkownikowi postępu prac.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `subject` | string | Tak | Krótki tytuł zadania w trybie rozkazującym (np. "Fix authentication bug") |
+| `description` | string | Tak | Szczegółowy opis, zawierający kontekst i kryteria akceptacji |
+| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania (np. "Fixing authentication bug") |
+| `metadata` | object | Nie | Dowolne metadane dołączone do zadania |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Złożone wieloetapowe zadania (ponad 3 kroki)
+- Użytkownik podał wiele elementów do wykonania
+- Śledzenie pracy w trybie planowania
+- Użytkownik wyraźnie poprosił o użycie listy todo
+
+**Nieodpowiednie zastosowanie:**
+- Pojedyncze proste zadanie
+- Proste operacje w mniej niż 3 krokach
+- Czysta rozmowa lub zapytanie informacyjne
+
+## Uwagi
+
+- Wszystkie nowo utworzone zadania mają początkowy status `pending`
+- `subject` używa trybu rozkazującego ("Run tests"), `activeForm` używa czasu teraźniejszego ciągłego ("Running tests")
+- Po utworzeniu zadania można ustawić zależności (blocks/blockedBy) za pomocą TaskUpdate
+- Przed utworzeniem należy wywołać TaskList, aby sprawdzić, czy nie ma duplikatów
+
+## Znaczenie w cc-viewer
+
+TaskCreate to wewnętrzna operacja zarządzania zadaniami Claude Code, nie generuje niezależnego żądania API. Jednak w Chat Mode można zobaczyć blok tool_use, w którym model wywołuje to narzędzie.

package/concepts/pl/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Definicja
+
+Pobiera pełne szczegóły zadania na podstawie jego ID.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `taskId` | string | Tak | ID zadania do pobrania |
+
+## Zwracana zawartość
+
+- `subject` — tytuł zadania
+- `description` — szczegółowe wymagania i kontekst
+- `status` — status: `pending`, `in_progress` lub `completed`
+- `blocks` — lista zadań zablokowanych przez to zadanie
+- `blockedBy` — lista zadań poprzedzających, które blokują to zadanie
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Pobranie pełnego opisu i kontekstu zadania przed rozpoczęciem pracy
+- Zrozumienie zależności zadania
+- Pobranie pełnych wymagań po przydzieleniu zadania
+
+## Uwagi
+
+- Po pobraniu zadania należy sprawdzić, czy lista `blockedBy` jest pusta, zanim rozpocznie się pracę
+- Użyj TaskList, aby zobaczyć podsumowanie wszystkich zadań
+
+## Znaczenie w cc-viewer
+
+TaskGet to wewnętrzna operacja zarządzania zadaniami, nie generuje niezależnego żądania API.

package/concepts/pl/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Definicja
+
+Wyświetla listę wszystkich zadań na liście zadań, umożliwiając przegląd ogólnego postępu i dostępnej pracy.
+
+## Parametry
+
+Brak parametrów.
+
+## Zwracana zawartość
+
+Podsumowanie każdego zadania:
+- `id` — identyfikator zadania
+- `subject` — krótki opis
+- `status` — status: `pending`, `in_progress` lub `completed`
+- `owner` — odpowiedzialny (ID agenta), puste oznacza nieprzydzielone
+- `blockedBy` — lista ID nieukończonych zadań blokujących to zadanie
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Sprawdzanie dostępnych zadań (status pending, brak owner, niezablokowane)
+- Sprawdzanie ogólnego postępu projektu
+- Wyszukiwanie zablokowanych zadań
+- Wyszukiwanie następnego zadania po ukończeniu bieżącego
+
+## Uwagi
+
+- Preferuj przetwarzanie zadań w kolejności ID (najniższe ID najpierw), ponieważ wcześniejsze zadania zazwyczaj dostarczają kontekst dla późniejszych
+- Zadania z `blockedBy` nie mogą być podjęte przed usunięciem zależności
+- Użyj TaskGet, aby uzyskać pełne szczegóły konkretnego zadania
+
+## Znaczenie w cc-viewer
+
+TaskList to wewnętrzna operacja zarządzania zadaniami, nie generuje niezależnego żądania API.

package/concepts/pl/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Definicja
+
+Pobiera wynik działającego lub zakończonego zadania w tle. Dotyczy powłok w tle, asynchronicznych agentów i sesji zdalnych.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `task_id` | string | Tak | ID zadania |
+| `block` | boolean | Tak | Czy blokować do zakończenia zadania, domyślnie `true` |
+| `timeout` | number | Tak | Maksymalny czas oczekiwania (milisekundy), domyślnie 30000, maks. 600000 |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Sprawdzanie postępu agenta w tle uruchomionego przez Task (`run_in_background: true`)
+- Pobieranie wyników poleceń Bash uruchomionych w tle
+- Oczekiwanie na zakończenie zadania asynchronicznego i pobranie wyniku
+
+**Nieodpowiednie zastosowanie:**
+- Zadania na pierwszym planie — zadania na pierwszym planie zwracają wynik bezpośrednio, to narzędzie nie jest potrzebne
+
+## Uwagi
+
+- `block: true` blokuje do zakończenia zadania lub upływu limitu czasu
+- `block: false` służy do nieblokującego sprawdzenia bieżącego stanu
+- ID zadania można znaleźć za pomocą polecenia `/tasks`
+- Dotyczy wszystkich typów zadań: powłoki w tle, asynchroniczne agenty, sesje zdalne
+
+## Znaczenie w cc-viewer
+
+Wywołanie TaskOutput samo w sobie nie generuje żądania API — jest to wewnętrzna operacja zarządzania zadaniami Claude Code i nie pojawia się w logach żądań.

package/concepts/pl/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Definicja
+
+Zatrzymuje działające zadanie w tle.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `task_id` | string | Nie | ID zadania w tle do zatrzymania |
+| `shell_id` | string | Nie | Przestarzały, użyj `task_id` zamiast tego |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Zakończenie długo działającego zadania, które nie jest już potrzebne
+- Anulowanie błędnie uruchomionego zadania w tle
+
+## Uwagi
+
+- Zwraca status powodzenia lub niepowodzenia
+- Parametr `shell_id` jest przestarzały, należy używać `task_id`
+
+## Znaczenie w cc-viewer
+
+Wywołanie TaskStop samo w sobie nie generuje żądania API — jest to wewnętrzna operacja zarządzania zadaniami Claude Code.

package/concepts/pl/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Definicja
+
+Aktualizuje status, zawartość lub zależności zadania na liście zadań.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `taskId` | string | Tak | ID zadania do aktualizacji |
+| `status` | enum | Nie | Nowy status: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Nie | Nowy tytuł |
+| `description` | string | Nie | Nowy opis |
+| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania |
+| `owner` | string | Nie | Nowy odpowiedzialny za zadanie (nazwa agenta) |
+| `metadata` | object | Nie | Metadane do scalenia (ustawienie na null usuwa klucz) |
+| `addBlocks` | string[] | Nie | Lista ID zadań zablokowanych przez to zadanie |
+| `addBlockedBy` | string[] | Nie | Lista ID zadań poprzedzających, które blokują to zadanie |
+
+## Przepływ statusów
+
+```
+pending → in_progress → completed
+```
+
+`deleted` może być ustawiony z dowolnego statusu, trwale usuwa zadanie.
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Oznaczanie zadania jako `in_progress` przy rozpoczęciu pracy
+- Oznaczanie zadania jako `completed` po zakończeniu pracy
+- Ustawianie zależności między zadaniami
+- Aktualizacja zawartości zadania przy zmianie wymagań
+
+**Ważne zasady:**
+- Oznaczaj jako `completed` tylko po pełnym ukończeniu zadania
+- W przypadku błędów lub blokad zachowaj status `in_progress`
+- Nie oznaczaj jako `completed` gdy testy nie przechodzą, implementacja jest niepełna lub wystąpiły nierozwiązane błędy
+
+## Uwagi
+
+- Przed aktualizacją należy pobrać najnowszy stan zadania przez TaskGet, aby uniknąć przestarzałych danych
+- Po ukończeniu zadania wywołaj TaskList, aby znaleźć następne dostępne zadanie
+
+## Znaczenie w cc-viewer
+
+TaskUpdate to wewnętrzna operacja zarządzania zadaniami, nie generuje niezależnego żądania API.

package/concepts/pl/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Definicja
+
+Pobiera zawartość strony internetowej pod podanym URL, konwertuje HTML na markdown i przetwarza zawartość za pomocą modelu AI zgodnie z promptem.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `url` | string (URI) | Tak | Pełny URL do pobrania |
+| `prompt` | string | Tak | Opis informacji do wyodrębnienia ze strony |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Pobieranie zawartości publicznych stron internetowych
+- Przeglądanie dokumentacji online
+- Wyodrębnianie określonych informacji ze stron internetowych
+
+**Nieodpowiednie zastosowanie:**
+- URL wymagające uwierzytelnienia (Google Docs, Confluence, Jira, GitHub itp.) — należy najpierw poszukać dedykowanego narzędzia MCP
+- URL GitHub — preferuj użycie `gh` CLI
+
+## Uwagi
+
+- URL musi być pełnym, prawidłowym URL
+- HTTP jest automatycznie aktualizowane do HTTPS
+- Zbyt duża zawartość może zostać podsumowana
+- Zawiera 15-minutowy samoczyszczący się cache
+- Gdy URL przekierowuje na inny host, narzędzie zwraca URL przekierowania — należy ponowić żądanie z nowym URL
+- Jeśli dostępne jest narzędzie web fetch dostarczane przez MCP, preferuj jego użycie
+
+## Znaczenie w cc-viewer
+
+Wywołania WebFetch w logach żądań pojawiają się jako pary bloków content `tool_use` / `tool_result`. `tool_result` zawiera podsumowanie zawartości strony przetworzone przez AI.

package/concepts/pl/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Definicja
+
+Wykonuje zapytanie do wyszukiwarki, zwracając wyniki wyszukiwania w celu uzyskania aktualnych informacji.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `query` | string | Tak | Zapytanie wyszukiwania (minimum 2 znaki) |
+| `allowed_domains` | string[] | Nie | Uwzględnij tylko wyniki z tych domen |
+| `blocked_domains` | string[] | Nie | Wyklucz wyniki z tych domen |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Uzyskiwanie najnowszych informacji wykraczających poza datę odcięcia wiedzy modelu
+- Wyszukiwanie bieżących wydarzeń i najnowszych danych
+- Wyszukiwanie najnowszej dokumentacji technicznej
+
+## Uwagi
+
+- Wyniki wyszukiwania są zwracane w formacie hiperłączy markdown
+- Po użyciu należy dołączyć sekcję "Sources:" na końcu odpowiedzi z listą odpowiednich URL
+- Obsługuje filtrowanie domen (uwzględnianie/wykluczanie)
+- W zapytaniach wyszukiwania należy używać bieżącego roku
+- Dostępne tylko w USA
+
+## Znaczenie w cc-viewer
+
+Wywołania WebSearch w logach żądań pojawiają się jako pary bloków content `tool_use` / `tool_result`. `tool_result` zawiera listę wyników wyszukiwania.

package/concepts/pl/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Definicja
+
+Zapisuje zawartość do lokalnego systemu plików. Jeśli plik już istnieje, nadpisuje go.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `file_path` | string | Tak | Bezwzględna ścieżka do pliku (musi być bezwzględna) |
+| `content` | string | Tak | Zawartość do zapisania |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Tworzenie nowych plików
+- Gdy wymagane jest całkowite przepisanie zawartości pliku
+
+**Nieodpowiednie zastosowanie:**
+- Modyfikacja lokalnej zawartości pliku — należy użyć Edit
+- Nie należy proaktywnie tworzyć plików dokumentacji (*.md) ani README, chyba że użytkownik wyraźnie o to prosi
+
+## Uwagi
+
+- Jeśli plik docelowy już istnieje, należy go najpierw odczytać za pomocą Read, w przeciwnym razie operacja się nie powiedzie
+- Nadpisuje całą zawartość istniejącego pliku
+- Preferuj Edit do edycji istniejących plików, Write służy tylko do tworzenia nowych plików lub całkowitego przepisywania
+
+## Znaczenie w cc-viewer
+
+Wywołanie Write w logach żądań pojawia się jako blok content `tool_use`, którego `input.content` zawiera pełną zapisaną zawartość.

package/concepts/pl/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## Definicja
+
+Wykonuje kod Python w jądrze Jupyter bieżącego pliku notebook.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `code` | string | Tak | Kod Python do wykonania |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Wykonywanie kodu w środowisku Jupyter notebook
+- Testowanie fragmentów kodu
+- Analiza danych i obliczenia
+
+**Nieodpowiednie zastosowanie:**
+- Wykonywanie kodu poza środowiskiem Jupyter — należy użyć Bash
+- Modyfikacja plików — należy użyć Edit lub Write
+
+## Uwagi
+
+- To jest narzędzie MCP (Model Context Protocol), dostarczane przez integrację z IDE
+- Kod jest wykonywany w bieżącym jądrze Jupyter, stan jest zachowywany między wywołaniami
+- O ile użytkownik wyraźnie nie poprosi, należy unikać deklarowania zmiennych lub modyfikowania stanu jądra
+- Po restarcie jądra stan zostaje utracony
+
+## Znaczenie w cc-viewer
+
+executeCode to narzędzie MCP, pojawiające się w tablicy `tools` logów żądań pod nazwą `mcp__ide__executeCode`. Jego wywołania i zwroty podlegają standardowemu wzorcowi `tool_use` / `tool_result`. Dodawanie/usuwanie narzędzi MCP powoduje zmianę tablicy tools, co może wyzwolić przebudowę cache.

package/concepts/pl/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Definicja
+
+Pobiera informacje diagnostyczne języka z VS Code, w tym błędy składni, błędy typów, ostrzeżenia lint itp.
+
+## Parametry
+
+| Parametr | Typ | Wymagany | Opis |
+|------|------|------|------|
+| `uri` | string | Nie | URI pliku. Jeśli nie podano, pobiera diagnostykę wszystkich plików |
+
+## Scenariusze użycia
+
+**Odpowiednie zastosowanie:**
+- Sprawdzanie problemów semantycznych kodu: składnia, typy, lint itp.
+- Weryfikacja po edycji kodu, czy nie wprowadzono nowych błędów
+- Zastępowanie poleceń Bash do sprawdzania jakości kodu
+
+**Nieodpowiednie zastosowanie:**
+- Uruchamianie testów — należy użyć Bash
+- Sprawdzanie błędów runtime — należy użyć Bash do wykonania kodu
+
+## Uwagi
+
+- To jest narzędzie MCP (Model Context Protocol), dostarczane przez integrację z IDE
+- Dostępne tylko w środowisku VS Code / IDE
+- Preferuj użycie tego narzędzia zamiast poleceń Bash do sprawdzania problemów z kodem
+
+## Znaczenie w cc-viewer
+
+getDiagnostics to narzędzie MCP, pojawiające się w tablicy `tools` logów żądań pod nazwą `mcp__ide__getDiagnostics`. Jego wywołania i zwroty podlegają standardowemu wzorcowi `tool_use` / `tool_result`. Dodawanie/usuwanie narzędzi MCP powoduje zmianę tablicy tools, co może wyzwolić przebudowę cache.

package/concepts/pl/Tools.md

@@ -0,0 +1,73 @@
+# Przegląd narzędzi Claude Code
+
+Claude Code udostępnia modelowi zestaw wbudowanych narzędzi poprzez mechanizm tool_use API Anthropic. Tablica `tools` w każdym żądaniu MainAgent zawiera pełne definicje JSON Schema tych narzędzi, a model wywołuje je w odpowiedzi poprzez bloki content `tool_use`.
+
+Poniżej znajduje się kategoryzowany indeks wszystkich narzędzi.
+
+## System agentów
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [Task](Tool-Task.md) | Uruchomienie sub-agenta (SubAgent) do obsługi złożonych wieloetapowych zadań |
+| [TaskOutput](Tool-TaskOutput.md) | Pobranie wyniku zadania w tle |
+| [TaskStop](Tool-TaskStop.md) | Zatrzymanie działającego zadania w tle |
+| [TaskCreate](Tool-TaskCreate.md) | Utworzenie wpisu na strukturalnej liście zadań |
+| [TaskGet](Tool-TaskGet.md) | Pobranie szczegółów zadania |
+| [TaskUpdate](Tool-TaskUpdate.md) | Aktualizacja statusu zadania, zależności itp. |
+| [TaskList](Tool-TaskList.md) | Wyświetlenie listy wszystkich zadań |
+
+## Operacje na plikach
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [Read](Tool-Read.md) | Odczyt zawartości pliku (obsługa tekstu, obrazów, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | Edycja pliku przez precyzyjne zastępowanie ciągów znaków |
+| [Write](Tool-Write.md) | Zapis lub nadpisanie pliku |
+| [NotebookEdit](Tool-NotebookEdit.md) | Edycja komórek Jupyter notebook |
+
+## Wyszukiwanie
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [Glob](Tool-Glob.md) | Wyszukiwanie plików według wzorca nazwy |
+| [Grep](Tool-Grep.md) | Wyszukiwanie zawartości plików oparte na ripgrep |
+
+## Terminal
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [Bash](Tool-Bash.md) | Wykonywanie poleceń shell |
+
+## Web
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | Pobieranie zawartości stron internetowych i przetwarzanie przez AI |
+| [WebSearch](Tool-WebSearch.md) | Zapytania do wyszukiwarki |
+
+## Planowanie i interakcja
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Wejście w tryb planowania, projektowanie planu wdrożenia |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Wyjście z trybu planowania i przesłanie planu do zatwierdzenia przez użytkownika |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Zadanie pytania użytkownikowi w celu uzyskania wyjaśnienia lub decyzji |
+
+## Rozszerzenia
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [Skill](Tool-Skill.md) | Wykonanie umiejętności (slash command) |
+
+## Integracja z IDE
+
+| Narzędzie | Przeznaczenie |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | Pobranie informacji diagnostycznych języka z VS Code |
+| [executeCode](Tool-executeCode.md) | Wykonanie kodu w jądrze Jupyter |
+
+## Znaczenie w cc-viewer
+
+Wywołania narzędzi to jedne z najważniejszych obserwowalnych danych w logach żądań Claude Code. Tablica `tools` każdego żądania MainAgent definiuje zestaw narzędzi dostępnych dla modelu, a bloki content `tool_use` / `tool_result` w odpowiedzi rejestrują faktyczne wywołania narzędzi i ich wyniki. cc-viewer parsuje te dane, aby w Chat Mode odtworzyć pełny łańcuch wywołań narzędzi.
+
+Zmiany w definicjach narzędzi (np. dodanie/usunięcie narzędzi spowodowane połączeniem/rozłączeniem serwera MCP) wyzwalają przebudowę cache, szczegóły w [CacheRebuild](CacheRebuild.md).

package/concepts/pl/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Zanieczyszczenie kontekstu w Translate API
+
+## Kontekst
+
+CC-Viewer zawiera wbudowaną funkcję tłumaczenia (`POST /api/translate`) opartą na Anthropic Messages API. We wczesnej implementacji żądania tłumaczenia ponownie wykorzystywały buforowane dane uwierzytelniające z sesji Claude Code — w tym zarówno nagłówki `x-api-key`, jak i `authorization`. Powodowało to subtelny, ale poważny problem: wyniki tłumaczeń często zwracały nieistotną treść.
+
+## Przyczyna źródłowa
+
+### Fundamentalna różnica między dwoma metodami uwierzytelniania
+
+Anthropic API obsługuje dwie metody uwierzytelniania:
+
+| Metoda | Nagłówek | Typowe źródło | Charakterystyka |
+|--------|----------|---------------|-----------------|
+| Klucz API | `x-api-key: sk-ant-...` | Zmienna środowiskowa / Console | Bezstanowy, każde żądanie jest niezależne |
+| Token OAuth | `authorization: Bearer sessionToken` | Logowanie subskrypcyjne Claude Code | Powiązany z sesją, serwer utrzymuje powiązanie kontekstu |
+
+Kluczowa różnica: **Klucze API są bezstanowe** — każde żądanie jest całkowicie niezależne; natomiast **tokeny sesji OAuth są stanowe** — serwer Anthropic wiąże żądania używające tego samego tokena z tym samym kontekstem sesji.
+
+### Łańcuch zanieczyszczenia
+
+Gdy Claude Code używa logowania subskrypcyjnego OAuth, przepływ uwierzytelniania wygląda następująco:
+
+```
+Główna rozmowa Claude Code ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                        ↑
+Żądanie tłumaczenia CC-Viewer ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Ponieważ żądania tłumaczenia ponownie wykorzystywały ten sam token sesji, serwer Anthropic może powiązać żądania tłumaczenia z kontekstem głównej rozmowy Claude Code. Powoduje to:
+
+1. **Wyniki tłumaczenia pod wpływem kontekstu głównej rozmowy**: Prompt systemowy żądania tłumaczenia to „jesteś tłumaczem", ale kontekst serwera nadal zawiera historię rozmów Claude Code, co może zakłócać działanie modelu
+2. **Główna rozmowa zakłócana przez żądania tłumaczenia**: Treść żądań tłumaczenia (fragmenty tekstu UI) może zostać wstrzyknięta do kontekstu głównej rozmowy, powodując odchylenia w odpowiedziach Claude Code
+3. **Nieprzewidywalne zachowanie**: Ponieważ zanieczyszczenie kontekstu jest zachowaniem po stronie serwera, klient nie może go wykryć ani kontrolować
+
+## Wnioski
+
+- **Tokeny sesji OAuth to nie „po prostu kolejny klucz API"** — niosą ze sobą stan po stronie serwera, a ich ponowne użycie oznacza współdzielenie kontekstu
+- **Wewnętrzne wywołania usług powinny używać niezależnego, bezstanowego uwierzytelniania**, aby uniknąć powiązania z sesjami użytkowników
+
+## Odnośniki
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/pt-BR/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (Comparação Incremental do Corpo da Requisição)
+
+## Contexto
+
+O MainAgent do Claude Code utiliza um mecanismo de envio de contexto completo — cada requisição carrega o histórico completo da conversa, system prompt, definições de ferramentas, etc. Isso significa que, conforme a conversa avança, o corpo da requisição se torna cada vez maior, e visualizar o Body bruto dificulta identificar rapidamente "o que foi adicionado nesta rodada".
+
+O Body Diff JSON foi criado exatamente para resolver esse problema: ele compara automaticamente os bodies de duas requisições MainAgent consecutivas, extraindo a parte incremental, permitindo que você veja claramente o conteúdo efetivamente adicionado nesta requisição.
+
+## Como Funciona
+
+1. **Identificar requisições MainAgent consecutivas**: A requisição atual deve ser do tipo MainAgent, e deve existir uma requisição MainAgent anterior
+2. **Comparação campo a campo**: Percorre todos os campos de nível superior do corpo da requisição, ignorando propriedades internas com prefixo `_`
+3. **Extração inteligente de diferenças**:
+   - Campos adicionados: exibidos diretamente
+   - Campos removidos: não exibidos (geralmente não afetam a compreensão)
+   - Campos alterados: exibe o valor atual
+   - Tratamento especial do array `messages`: exibe apenas as mensagens adicionadas (pois em conversa normal o modo é de adição, as mensagens de prefixo não mudam)
+4. **Detecção de redução do corpo**: Se o corpo da requisição atual for menor que o anterior, indica truncamento de contexto ou reset de sessão, e nesse caso uma mensagem informativa é exibida em vez do diff
+
+## Cenário Típico
+
+Em uma rodada normal de conversa, o Body Diff JSON geralmente contém apenas:
+- `messages`: 1~2 mensagens adicionadas (a entrada do usuário + a resposta do assistente da rodada anterior)
+
+Se você vir alterações em campos como `system`, `tools`, `model` no diff, significa que houve mudança de configuração nesta rodada, o que frequentemente também é a causa da reconstrução de cache.
+
+## Como Usar
+
+- O Body Diff JSON é exibido no painel de detalhes da requisição MainAgent
+- Clique no título para expandir/recolher
+- Suporta dois modos de visualização: JSON e Text, além de cópia com um clique
+- No canto superior esquerdo em **CC-Viewer → Configurações Globais**, é possível configurar "Expandir Body Diff JSON por padrão"

package/concepts/pt-BR/CacheRebuild.md

@@ -0,0 +1,40 @@
+# Cache Rebuild (Reconstrução de Cache)
+
+## Contexto
+
+O mecanismo de prompt caching da Anthropic concatena sequencialmente system → tools → messages (até o cache breakpoint) da requisição para formar a chave de cache. Quando a chave de cache é idêntica à da requisição anterior, a API retorna `cache_read_input_tokens` (acerto de cache); quando a chave de cache muda, a API recria o cache e retorna uma grande quantidade de `cache_creation_input_tokens`, ou seja, reconstrução de cache.
+
+A reconstrução de cache implica cobrança adicional de tokens (o preço de cache creation é maior que o de cache read), portanto identificar a causa da reconstrução tem valor direto para otimização de custos.
+
+## Classificação das Causas de Reconstrução de Cache
+
+O cc-viewer determina com precisão a causa da reconstrução de cache comparando os bodies de duas requisições MainAgent consecutivas:
+
+| reason | Significado | Método de Determinação |
+|--------|------|----------|
+| `ttl` | Cache expirado | Mais de 5 minutos desde a última requisição MainAgent |
+| `system_change` | Alteração do system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Alteração das definições de ferramentas | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Troca de modelo | `prev.model !== curr.model` |
+| `msg_truncated` | Pilha de mensagens truncada | O número de mensagens da requisição atual é menor que o da anterior, geralmente causado por truncamento devido ao estouro da janela de contexto |
+| `msg_modified` | Mensagens históricas modificadas | Conteúdo das mensagens de prefixo inconsistente (em adição normal, o prefixo deve ser idêntico) |
+| `key_change` | Alteração de chave desconhecida | Fallback quando nenhuma das condições acima é correspondida |
+
+## Prioridade de Determinação
+
+1. Primeiro verifica o intervalo de tempo — se ultrapassar 5 minutos, determina diretamente como `ttl`, sem comparação de body
+2. Em seguida verifica sequencialmente model, system, tools, messages
+3. Uma requisição pode corresponder a múltiplas causas simultaneamente (ex: troca de modelo + alteração de system prompt), nesse caso o array `reasons` contém todos os itens correspondentes, e o tooltip exibe em linhas separadas
+
+## Cenários Comuns
+
+- **`ttl`**: O usuário pausou a operação por mais de 5 minutos e depois continuou, o cache expirou naturalmente
+- **`system_change`**: O Claude Code atualizou o system prompt (ex: carregou novo CLAUDE.md, alteração nas project instructions)
+- **`tools_change`**: Conexão/desconexão de MCP server causou alteração na lista de ferramentas disponíveis
+- **`model_change`**: O usuário trocou o modelo através do comando `/model`
+- **`msg_truncated`**: Conversa muito longa acionou o gerenciamento da janela de contexto, o Claude Code truncou mensagens anteriores
+- **`msg_modified`**: O Claude Code editou mensagens históricas (ex: `/compact` substituiu mensagens originais por resumo compactado)
+
+## Exibição no cc-viewer
+
+Na lista de requisições, as requisições com reconstrução de cache exibem um indicador de ponto vermelho na linha de cache. Ao passar o mouse, um tooltip mostra a descrição específica da causa da reconstrução (suporte a 18 idiomas).