cc-viewer 1.2.1 → 1.2.3

package/concepts/da/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Definition
+
+Stopper en kørende baggrundsopgave.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `task_id` | string | Nej | ID på baggrundsopgaven der skal stoppes |
+| `shell_id` | string | Nej | Forældet, brug `task_id` i stedet |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Afslutte langvarige opgaver der ikke længere er nødvendige
+- Annullere fejlagtigt startede baggrundsopgaver
+
+## Bemærkninger
+
+- Returnerer en succes- eller fejlstatus
+- Parameteren `shell_id` er forældet, brug `task_id`
+
+## Betydning i cc-viewer
+
+TaskStop-kald genererer ikke API-requests; det er en intern opgavestyringsoperation i Claude Code.

package/concepts/da/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Definition
+
+Opdaterer status, indhold eller afhængigheder for en opgave i opgavelisten.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `taskId` | string | Ja | ID på opgaven der skal opdateres |
+| `status` | enum | Nej | Ny status: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Nej | Ny titel |
+| `description` | string | Nej | Ny beskrivelse |
+| `activeForm` | string | Nej | Tekst i nutids-tillægsform vist under udførelse |
+| `owner` | string | Nej | Ny opgaveansvarlig (agent-navn) |
+| `metadata` | object | Nej | Metadata der skal flettes (sæt til null for at slette en nøgle) |
+| `addBlocks` | string[] | Nej | Liste over ID'er for opgaver blokeret af denne opgave |
+| `addBlockedBy` | string[] | Nej | Liste over ID'er for forudgående opgaver der blokerer denne opgave |
+
+## Statusflow
+
+```
+pending → in_progress → completed
+```
+
+`deleted` kan nås fra enhver status og fjerner opgaven permanent.
+
+## Brugsscenarier
+
+**Egnet til:**
+- Markere en opgave som `in_progress` når arbejdet påbegyndes
+- Markere en opgave som `completed` når arbejdet er afsluttet
+- Sætte afhængigheder mellem opgaver
+- Opdatere opgaveindhold når kravene ændres
+
+**Vigtige regler:**
+- Markér kun som `completed` når opgaven er fuldstændigt afsluttet
+- Ved fejl eller blokeringer, behold `in_progress`
+- Markér ikke som `completed` ved fejlende tests, ufuldstændig implementering eller uløste fejl
+
+## Bemærkninger
+
+- Før opdatering bør man hente opgavens seneste status via TaskGet for at undgå forældede data
+- Efter fuldførelse af en opgave, kald TaskList for at finde den næste tilgængelige opgave
+
+## Betydning i cc-viewer
+
+TaskUpdate er en intern opgavestyringsoperation og genererer ikke selvstændige API-requests.

package/concepts/da/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Definition
+
+Henter indholdet af en webside fra den angivne URL, konverterer HTML til markdown og behandler indholdet med en AI-model baseret på prompten.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `url` | string (URI) | Ja | Komplet URL der skal hentes |
+| `prompt` | string | Ja | Beskriver hvilken information der skal udtrækkes fra siden |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Hente indhold fra offentlige websider
+- Slå op i onlinedokumentation
+- Udtrække specifik information fra en webside
+
+**Ikke egnet til:**
+- URL'er der kræver autentificering (Google Docs, Confluence, Jira, GitHub osv.) — søg først efter et dedikeret MCP-værktøj
+- GitHub-URL'er — foretræk brug af `gh` CLI
+
+## Bemærkninger
+
+- URL'en skal være en komplet gyldig URL
+- HTTP opgraderes automatisk til HTTPS
+- Resultater kan blive opsummeret, hvis indholdet er for stort
+- Inkluderer en selvrensende 15-minutters cache
+- Når URL'en omdirigerer til en anden vært, returnerer værktøjet omdirigerings-URL'en, og der skal foretages en ny anmodning med den nye URL
+- Hvis et MCP-leveret web fetch-værktøj er tilgængeligt, foretræk det
+
+## Betydning i cc-viewer
+
+WebFetch-kald vises i requestloggen som `tool_use` / `tool_result` content block-par. `tool_result` indeholder det AI-behandlede resumé af webindholdet.

package/concepts/da/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Definition
+
+Udfører en søgemaskineforespørgsel og returnerer søgeresultater til at hente aktuel information.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `query` | string | Ja | Søgeforespørgsel (mindst 2 tegn) |
+| `allowed_domains` | string[] | Nej | Inkluder kun resultater fra disse domæner |
+| `blocked_domains` | string[] | Nej | Ekskluder resultater fra disse domæner |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Hente aktuel information ud over modellens videns-cutoff-dato
+- Søge efter aktuelle begivenheder og nyeste data
+- Søge efter den nyeste tekniske dokumentation
+
+## Bemærkninger
+
+- Søgeresultater returneres i markdown-hyperlinkformat
+- Efter brug skal der tilføjes en "Sources:"-sektion i slutningen af svaret med relevante URL'er
+- Understøtter domænefiltrering (inklusion/eksklusion)
+- Brug det aktuelle år i søgeforespørgsler
+- Kun tilgængelig i USA
+
+## Betydning i cc-viewer
+
+WebSearch-kald vises i requestloggen som `tool_use` / `tool_result` content block-par. `tool_result` indeholder listen over søgeresultater.

package/concepts/da/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Definition
+
+Skriver indhold til det lokale filsystem. Hvis filen allerede eksisterer, overskrives den.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `file_path` | string | Ja | Absolut sti til filen (skal være absolut) |
+| `content` | string | Ja | Indhold der skal skrives |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Oprette nye filer
+- Når filindholdet skal omskrives fuldstændigt
+
+**Ikke egnet til:**
+- Ændre delvist indhold i en fil — brug Edit
+- Opret ikke proaktivt dokumentationsfiler (*.md) eller README, medmindre brugeren udtrykkeligt beder om det
+
+## Bemærkninger
+
+- Hvis målfilen allerede eksisterer, skal den først læses via Read, ellers fejler operationen
+- Overskriver alt eksisterende filindhold
+- Foretræk Edit til redigering af eksisterende filer, Write er kun til oprettelse af nye filer eller fuldstændig omskrivning
+
+## Betydning i cc-viewer
+
+Write-kald vises i requestloggen som `tool_use` content block, hvis `input.content` indeholder det komplette skrevne indhold.

package/concepts/da/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## Definition
+
+Udfører Python-kode i Jupyter-kernen for den aktuelle notebook-fil.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `code` | string | Ja | Python-kode der skal udføres |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Udføre kode i et Jupyter notebook-miljø
+- Teste kodestykker
+- Dataanalyse og beregninger
+
+**Ikke egnet til:**
+- Kodeudførelse i ikke-Jupyter-miljøer — brug Bash
+- Ændre filer — brug Edit eller Write
+
+## Bemærkninger
+
+- Dette er et MCP-værktøj (Model Context Protocol), leveret af IDE-integrationen
+- Kode udføres i den aktuelle Jupyter-kerne, tilstanden bevares mellem kald
+- Medmindre brugeren udtrykkeligt beder om det, undgå at deklarere variabler eller ændre kernens tilstand
+- Tilstanden går tabt efter genstart af kernen
+
+## Betydning i cc-viewer
+
+executeCode er et MCP-værktøj, der vises i requestloggens `tools`-array med navnet `mcp__ide__executeCode`. Dets kald og returneringer følger standard `tool_use` / `tool_result`-mønsteret. Tilføjelse/fjernelse af MCP-værktøjer medfører ændringer i tools-arrayet, som kan udløse cache-genopbygning.

package/concepts/da/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Definition
+
+Henter sprogdiagnostikinformation fra VS Code, herunder syntaksfejl, typefejl, lint-advarsler osv.
+
+## Parametre
+
+| Parameter | Type | Påkrævet | Beskrivelse |
+|------|------|------|------|
+| `uri` | string | Nej | Fil-URI. Hvis ikke angivet, hentes diagnostikinformation for alle filer |
+
+## Brugsscenarier
+
+**Egnet til:**
+- Kontrollere kodens semantiske problemer som syntaks, typer, lint
+- Verificere om der er introduceret nye fejl efter koderediger
+- Erstatte Bash-kommandoer til kontrol af kodekvalitet
+
+**Ikke egnet til:**
+- Køre tests — brug Bash
+- Kontrollere runtime-fejl — brug Bash til at udføre koden
+
+## Bemærkninger
+
+- Dette er et MCP-værktøj (Model Context Protocol), leveret af IDE-integrationen
+- Kun tilgængeligt i VS Code / IDE-miljøer
+- Foretræk dette værktøj frem for Bash-kommandoer til kontrol af kodeproblemer
+
+## Betydning i cc-viewer
+
+getDiagnostics er et MCP-værktøj, der vises i requestloggens `tools`-array med navnet `mcp__ide__getDiagnostics`. Dets kald og returneringer følger standard `tool_use` / `tool_result`-mønsteret. Tilføjelse/fjernelse af MCP-værktøjer medfører ændringer i tools-arrayet, som kan udløse cache-genopbygning.

package/concepts/da/Tools.md

@@ -0,0 +1,73 @@
+# Oversigt over Claude Code-værktøjer
+
+Claude Code giver modellen et sæt indbyggede værktøjer via Anthropic API'ens tool_use-mekanisme. `tools`-arrayet i hver MainAgent-request indeholder de komplette JSON Schema-definitioner for disse værktøjer, og modellen kalder dem via `tool_use` content blocks i svaret.
+
+Nedenfor er det kategoriserede indeks over alle værktøjer.
+
+## Agent-system
+
+| Værktøj | Formål |
+|------|------|
+| [Task](Tool-Task.md) | Start en sub-agent (SubAgent) til at håndtere komplekse flertrinsopgaver |
+| [TaskOutput](Tool-TaskOutput.md) | Hent output fra en baggrundsopgave |
+| [TaskStop](Tool-TaskStop.md) | Stop en kørende baggrundsopgave |
+| [TaskCreate](Tool-TaskCreate.md) | Opret en struktureret opgavelistepost |
+| [TaskGet](Tool-TaskGet.md) | Hent opgavedetaljer |
+| [TaskUpdate](Tool-TaskUpdate.md) | Opdater opgavestatus, afhængigheder osv. |
+| [TaskList](Tool-TaskList.md) | List alle opgaver |
+
+## Filoperationer
+
+| Værktøj | Formål |
+|------|------|
+| [Read](Tool-Read.md) | Læs filindhold (understøtter tekst, billeder, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | Rediger fil via præcis strengerstatning |
+| [Write](Tool-Write.md) | Skriv eller overskriv en fil |
+| [NotebookEdit](Tool-NotebookEdit.md) | Rediger Jupyter notebook-celler |
+
+## Søgning
+
+| Værktøj | Formål |
+|------|------|
+| [Glob](Tool-Glob.md) | Søg filer efter filnavnsmønster |
+| [Grep](Tool-Grep.md) | Søg i filindhold baseret på ripgrep |
+
+## Terminal
+
+| Værktøj | Formål |
+|------|------|
+| [Bash](Tool-Bash.md) | Udfør shell-kommandoer |
+
+## Web
+
+| Værktøj | Formål |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | Hent webindhold og behandl det med AI |
+| [WebSearch](Tool-WebSearch.md) | Søgemaskineforespørgsel |
+
+## Planlægning og interaktion
+
+| Værktøj | Formål |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Gå ind i planlægningstilstand for at designe en implementeringsplan |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Forlad planlægningstilstand og indsend planen til brugerens godkendelse |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Stil spørgsmål til brugeren for at få afklaring eller beslutninger |
+
+## Udvidelser
+
+| Værktøj | Formål |
+|------|------|
+| [Skill](Tool-Skill.md) | Udfør en skill (slash command) |
+
+## IDE-integration
+
+| Værktøj | Formål |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | Hent sprogdiagnostik fra VS Code |
+| [executeCode](Tool-executeCode.md) | Udfør kode i Jupyter-kernen |
+
+## Betydning i cc-viewer
+
+Værktøjskald er en af de mest centrale observerbare data i Claude Codes requestlogs. `tools`-arrayet i hver MainAgent-request definerer det tilgængelige værktøjssæt for modellen, mens `tool_use` / `tool_result` content blocks i svaret registrerer de faktiske værktøjskald og returneringer. cc-viewer analyserer disse data for at rekonstruere den komplette værktøjskaldskæde i Chat Mode.
+
+Ændringer i værktøjsdefinitioner (f.eks. tilføjelse/fjernelse af værktøjer pga. tilslutning/frakobling af MCP-server) udløser cache-genopbygning, se [CacheRebuild](CacheRebuild.md).

package/concepts/da/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Kontekstforurening i Translate API
+
+## Baggrund
+
+CC-Viewer inkluderer en indbygget oversættelsesfunktion (`POST /api/translate`) drevet af Anthropic Messages API. I den tidlige implementering genbrugte oversættelsesanmodninger cachede autentificeringsoplysninger fra Claude Code-sessionen — herunder både `x-api-key` og `authorization` headers. Dette forårsagede et subtilt men alvorligt problem: oversættelsesresultater returnerede ofte irrelevant indhold.
+
+## Grundårsag
+
+### Fundamental forskel mellem to autentificeringsmetoder
+
+Anthropic API understøtter to autentificeringsmetoder:
+
+| Metode | Header | Typisk kilde | Karakteristika |
+|--------|--------|--------------|----------------|
+| API-nøgle | `x-api-key: sk-ant-...` | Miljøvariabel / Console | Tilstandsløs, hver anmodning er uafhængig |
+| OAuth-token | `authorization: Bearer sessionToken` | Claude Code abonnementslogin | Sessionsbundet, serveren opretholder konteksttilknytning |
+
+Den afgørende forskel: **API-nøgler er tilstandsløse** — hver anmodning er fuldstændig uafhængig; mens **OAuth-sessionstokens er tilstandsbaserede** — Anthropic-serveren tilknytter anmodninger med samme token til den samme sessionskontekst.
+
+### Forureningskæde
+
+Når Claude Code bruger OAuth-abonnementslogin, ser autentificeringsflowet sådan ud:
+
+```
+Claude Code hovedsamtale ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                      ↑
+CC-Viewer oversættelsesanmodning ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Da oversættelsesanmodninger genbrugte det samme sessionstoken, kan Anthropic-serveren tilknytte oversættelsesanmodninger til Claude Codes hovedsamtalekontekst. Dette medfører:
+
+1. **Oversættelsesresultater påvirket af hovedsamtalens kontekst**: Oversættelsesanmodningens systemprompt er "du er en oversætter", men serverkonteksten indeholder stadig Claude Codes samtalehistorik, som potentielt kan forstyrre modellen
+2. **Hovedsamtalen forstyrret af oversættelsesanmodninger**: Indhold fra oversættelsesanmodninger (UI-tekstfragmenter) kan blive injiceret i hovedsamtalens kontekst, hvilket får Claude Codes svar til at afvige
+3. **Uforudsigelig adfærd**: Da kontekstforurening er serverside-adfærd, kan klienten ikke opdage eller kontrollere det
+
+## Erfaringer
+
+- **OAuth-sessionstokens er ikke "bare en anden API-nøgle"** — de bærer serverside-tilstand, og genbrug af dem betyder deling af kontekst
+- **Interne servicekald bør bruge uafhængig, tilstandsløs autentificering** for at undgå tilknytning til brugersessioner
+
+## Referencer
+
+- [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/de/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (Inkrementeller Request-Body-Vergleich)
+
+## Hintergrund
+
+Der MainAgent von Claude Code verwendet einen Vollkontext-Sendemechanismus – jede Anfrage enthält den vollständigen Gesprächsverlauf, System-Prompt, Tool-Definitionen usw. Das bedeutet, dass der Request-Body im Laufe des Gesprächs immer größer wird und es schwierig ist, im Roh-Body schnell zu erkennen, „was in dieser Runde tatsächlich neu hinzugekommen ist".
+
+Body Diff JSON löst genau dieses Problem: Es vergleicht automatisch die Bodies zweier aufeinanderfolgender MainAgent-Anfragen, extrahiert die inkrementellen Teile und zeigt auf einen Blick, welche Inhalte in dieser Anfrage tatsächlich neu sind.
+
+## Funktionsweise
+
+1. **Erkennung aufeinanderfolgender MainAgent-Anfragen**: Die aktuelle Anfrage muss vom Typ MainAgent sein, und es muss eine vorherige MainAgent-Anfrage existieren
+2. **Feldweiser Vergleich**: Alle Top-Level-Felder des Request-Body werden durchlaufen, interne Attribute mit `_`-Präfix werden übersprungen
+3. **Intelligente Differenzextraktion**:
+   - Neue Felder: werden direkt angezeigt
+   - Gelöschte Felder: werden nicht angezeigt (beeinträchtigen normalerweise nicht das Verständnis)
+   - Geänderte Felder: zeigen den aktuellen Wert
+   - `messages`-Array wird speziell behandelt: Es werden nur neue Nachrichten angezeigt (da im normalen Gespräch Nachrichten angehängt werden und die Präfix-Nachrichten unverändert bleiben)
+4. **Erkennung einer Verkleinerung des Request-Body**: Wenn der aktuelle Request-Body kleiner ist als der vorherige, deutet dies auf eine Kontextkürzung oder Sitzungszurücksetzung hin – in diesem Fall wird ein Hinweis statt eines Diffs angezeigt
+
+## Typische Szenarien
+
+In einer normalen Gesprächsrunde enthält Body Diff JSON normalerweise nur:
+- `messages`: 1–2 neue Nachrichten (Benutzereingabe + Antwort des Assistenten aus der vorherigen Runde)
+
+Wenn im Diff Änderungen an Feldern wie `system`, `tools`, `model` usw. erscheinen, bedeutet dies, dass sich die Konfiguration in dieser Runde geändert hat – was oft auch der Grund für einen Cache-Rebuild ist.
+
+## Verwendung
+
+- Body Diff JSON wird im Detailbereich der MainAgent-Anfrage angezeigt
+- Klicken Sie auf den Titel zum Auf-/Zuklappen
+- Unterstützt JSON- und Text-Ansichtsmodi sowie Ein-Klick-Kopieren
+- Unter **CC-Viewer → Globale Einstellungen** (oben links) können Sie „Body Diff JSON standardmäßig aufklappen" einstellen

package/concepts/de/CacheRebuild.md

@@ -0,0 +1,40 @@
+# Cache Rebuild (Cache-Neuaufbau)
+
+## Hintergrund
+
+Der Prompt-Caching-Mechanismus von Anthropic verkettet system → tools → messages (bis zum Cache-Breakpoint) in der Anfrage sequenziell zu einem Cache-Schlüssel. Wenn der Cache-Schlüssel mit der vorherigen Anfrage exakt übereinstimmt, gibt die API `cache_read_input_tokens` zurück (Cache-Treffer); wenn sich der Cache-Schlüssel ändert, erstellt die API den Cache neu und gibt eine große Anzahl von `cache_creation_input_tokens` zurück – das ist der Cache-Neuaufbau.
+
+Ein Cache-Neuaufbau bedeutet zusätzliche Token-Kosten (Cache Creation ist teurer als Cache Read), daher hat die Identifizierung der Neuaufbau-Ursachen direkten Wert für die Kostenoptimierung.
+
+## Klassifizierung der Cache-Neuaufbau-Ursachen
+
+cc-viewer vergleicht die Bodies zweier aufeinanderfolgender MainAgent-Anfragen und bestimmt präzise die Ursache des Cache-Neuaufbaus:
+
+| reason | Bedeutung | Erkennungsmethode |
+|--------|-----------|-------------------|
+| `ttl` | Cache abgelaufen | Mehr als 5 Minuten seit der letzten MainAgent-Anfrage |
+| `system_change` | System-Prompt geändert | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Tool-Definitionen geändert | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Modellwechsel | `prev.model !== curr.model` |
+| `msg_truncated` | Nachrichtenstapel gekürzt | Die aktuelle Anfrage hat weniger Messages als die vorherige, typischerweise ausgelöst durch Kontextfenster-Überlauf |
+| `msg_modified` | Verlaufsnachrichten geändert | Präfix-Nachrichten stimmen nicht überein (beim normalen Anhängen sollte das Präfix identisch sein) |
+| `key_change` | Unbekannte Schlüsseländerung | Fallback, wenn keine der obigen Bedingungen zutrifft |
+
+## Prioritätsreihenfolge
+
+1. Zuerst wird das Zeitintervall geprüft – über 5 Minuten wird direkt als `ttl` eingestuft, ohne Body-Vergleich
+2. Dann werden nacheinander model, system, tools, messages geprüft
+3. Eine Anfrage kann mehrere Ursachen gleichzeitig auslösen (z.B. Modellwechsel + System-Prompt-Änderung), wobei das `reasons`-Array alle Treffer enthält und der Tooltip sie zeilenweise anzeigt
+
+## Häufige Szenarien
+
+- **`ttl`**: Der Benutzer pausiert länger als 5 Minuten und setzt dann fort – der Cache läuft natürlich ab
+- **`system_change`**: Claude Code hat den System-Prompt aktualisiert (z.B. neue CLAUDE.md geladen, Project Instructions geändert)
+- **`tools_change`**: MCP-Server-Verbindung/-Trennung führt zu Änderungen in der verfügbaren Tool-Liste
+- **`model_change`**: Der Benutzer wechselt das Modell über den `/model`-Befehl
+- **`msg_truncated`**: Ein zu langes Gespräch löst die Kontextfenster-Verwaltung aus, Claude Code kürzt frühere Nachrichten
+- **`msg_modified`**: Claude Code hat Verlaufsnachrichten bearbeitet (z.B. `/compact` ersetzt Originalnachrichten durch komprimierte Zusammenfassungen)
+
+## Anzeige in cc-viewer
+
+In der Anfrageliste zeigen Anfragen mit Cache-Neuaufbau einen roten Punkt-Indikator in der Cache-Zeile. Beim Überfahren mit der Maus erscheint ein Tooltip mit der konkreten Beschreibung der Neuaufbau-Ursache (unterstützt 18 Sprachen).

package/concepts/de/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Definition
+
+MainAgent ist die Hauptanfragekette von Claude Code im Nicht-Agent-Team-Modus. Jede Interaktion eines Benutzers mit Claude Code erzeugt eine Reihe von API-Anfragen, wobei die MainAgent-Anfragen die Kern-Gesprächskette bilden – sie tragen den vollständigen System-Prompt, Tool-Definitionen und Nachrichtenverlauf.
+
+## Erkennung
+
+In cc-viewer wird MainAgent durch `req.mainAgent === true` identifiziert und von `interceptor.js` beim Abfangen der Anfrage automatisch markiert.
+
+Erkennungsbedingungen (alle müssen erfüllt sein):
+- Der Request-Body enthält das `system`-Feld (System-Prompt)
+- Der Request-Body enthält das `tools`-Array (Tool-Definitionen)
+- Der System-Prompt enthält den charakteristischen Text "Claude Code"
+
+## Unterschied zu SubAgent
+
+| Merkmal | MainAgent | SubAgent |
+|---------|-----------|----------|
+| System-Prompt | Vollständiger Claude Code Haupt-Prompt | Kompakter aufgabenspezifischer Prompt |
+| tools-Array | Enthält alle verfügbaren Tools | Enthält normalerweise nur die wenigen für die Aufgabe benötigten Tools |
+| Nachrichtenverlauf | Akkumuliert den vollständigen Gesprächskontext | Enthält nur aufgabenbezogene Nachrichten |
+| Cache-Verhalten | Hat Prompt Caching (5 Minuten TTL) | Normalerweise kein Cache oder kleinerer Cache |
+
+## Bedeutung in cc-viewer
+
+- **Cache-Tracking**: Der Prompt-Caching-Status von MainAgent-Anfragen wirkt sich direkt auf die Kosten aus. Durch Überwachung des Verhältnisses von `cache_creation_input_tokens` zu `cache_read_input_tokens` kann die Cache-Trefferquote bestimmt werden
+- **Cache-Miss-Analyse**: Wenn MainAgent-Anfragen viele Cache Creations (statt Cache Reads) aufweisen, bedeutet dies, dass der Cache verloren ging und neu aufgebaut wurde – cc-viewer markiert diese Anfragen mit einem roten Punkt-Indikator
+- **Hauptketten-Analyse**: Die MainAgent-Anfragesequenz spiegelt den vollständigen Interaktionsprozess zwischen Benutzer und Claude Code wider und ist die Kerndatenquelle für die Analyse des Sitzungsverhaltens
+- **Sitzungsrekonstruktion**: cc-viewer rekonstruiert die Gesprächsansicht (Chat Mode) anhand des Nachrichtenverlaufs der MainAgent-Anfragen

package/concepts/de/Tool-AskUserQuestion.md

@@ -0,0 +1,54 @@
+# AskUserQuestion
+
+## Definition
+
+Stellt dem Benutzer während der Ausführung Fragen, um Klärungen zu erhalten, Annahmen zu überprüfen oder Entscheidungen anzufordern.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `questions` | array | Ja | Fragenliste (1–4 Fragen) |
+| `answers` | object | Nein | Vom Benutzer gesammelte Antworten |
+| `annotations` | object | Nein | Anmerkungen zu jeder Frage (z.B. Hinweise zur Vorschauauswahl) |
+| `metadata` | object | Nein | Metadaten für Tracking und Analyse |
+
+Jedes `question`-Objekt:
+
+| Feld | Typ | Erforderlich | Beschreibung |
+|------|-----|--------------|--------------|
+| `question` | string | Ja | Vollständiger Fragetext, sollte mit einem Fragezeichen enden |
+| `header` | string | Ja | Kurzes Label (max. 12 Zeichen), wird als Label-Chip angezeigt |
+| `options` | array | Ja | 2–4 Optionen |
+| `multiSelect` | boolean | Ja | Ob Mehrfachauswahl erlaubt ist |
+
+Jedes `option`-Objekt:
+
+| Feld | Typ | Erforderlich | Beschreibung |
+|------|-----|--------------|--------------|
+| `label` | string | Ja | Anzeigetext der Option (1–5 Wörter) |
+| `description` | string | Ja | Beschreibung der Option |
+| `markdown` | string | Nein | Vorschauinhalt (für visuellen Vergleich von ASCII-Layouts, Code-Snippets usw.) |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Sammeln von Benutzerpräferenzen oder Anforderungen
+- Klärung mehrdeutiger Anweisungen
+- Einholen von Entscheidungen während der Implementierung
+- Bereitstellung von Richtungsoptionen für den Benutzer
+
+**Nicht geeignet für:**
+- Fragen wie „Ist der Plan in Ordnung?" – dafür sollte ExitPlanMode verwendet werden
+
+## Hinweise
+
+- Der Benutzer kann immer "Other" wählen, um eine benutzerdefinierte Eingabe zu machen
+- Die empfohlene Option steht an erster Stelle mit "(Recommended)" am Ende des Labels
+- `markdown`-Vorschau wird nur bei Einzelauswahl-Fragen unterstützt
+- Optionen mit `markdown` wechseln zu einem nebeneinander angeordneten Layout
+- Im Planungsmodus wird es verwendet, um Anforderungen vor der Festlegung des Plans zu klären
+
+## Bedeutung in cc-viewer
+
+AskUserQuestion-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block mit Fragen- und Optionsdefinitionen. Die Antworten des Benutzers erscheinen im Nachrichtenverlauf nachfolgender Anfragen.

package/concepts/de/Tool-Bash.md

@@ -0,0 +1,47 @@
+# Bash
+
+## Definition
+
+Führt Shell-Befehle aus, mit optionaler Timeout-Einstellung. Das Arbeitsverzeichnis bleibt zwischen Befehlen bestehen, der Shell-Zustand (Umgebungsvariablen usw.) jedoch nicht.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `command` | string | Ja | Der auszuführende Bash-Befehl |
+| `description` | string | Nein | Kurze Beschreibung des Befehls |
+| `timeout` | number | Nein | Timeout in Millisekunden, maximal 600000, Standard 120000 |
+| `run_in_background` | boolean | Nein | Ob im Hintergrund ausgeführt werden soll |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Git-Operationen (commit, push, branch usw.)
+- npm/yarn und andere Paketverwaltungsbefehle
+- Docker-Operationen
+- Kompilierungs- und Build-Befehle
+- Verzeichnisinhalte auflisten (`ls`)
+- Andere Systembefehle, die Shell-Ausführung erfordern
+
+**Nicht geeignet für:**
+- Dateien lesen – dafür Read verwenden
+- Dateinamen suchen – dafür Glob verwenden
+- Dateiinhalte suchen – dafür Grep verwenden
+- Dateien bearbeiten – dafür Edit verwenden
+- Dateien schreiben – dafür Write verwenden
+- Informationen an den Benutzer ausgeben – direkt im Antworttext ausgeben
+- Lang laufende Prozesse (Dev-Server, Watch-Modus) – der Benutzer sollte diese manuell starten
+
+## Hinweise
+
+- Pfade mit Leerzeichen müssen in doppelte Anführungszeichen eingeschlossen werden
+- Ausgaben über 30.000 Zeichen werden abgeschnitten
+- Im Hintergrund laufende Befehle liefern Ergebnisse über TaskOutput
+- Verwenden Sie möglichst absolute Pfade und vermeiden Sie `cd`
+- Unabhängige Befehle können parallel in mehreren Bash-Aufrufen ausgeführt werden
+- Abhängige Befehle werden mit `&&` verkettet
+- Die Shell-Umgebung wird aus dem Benutzerprofil (bash oder zsh) initialisiert
+
+## Bedeutung in cc-viewer
+
+Bash-Aufrufe erscheinen im Anfrage-Log als `tool_use` (enthält den Befehl) und `tool_result` (enthält die Ausgabe) Content-Block-Paare. Die Befehlsausgabe kann zur Analyse des Modellverhaltens verwendet werden.

package/concepts/de/Tool-Edit.md

@@ -0,0 +1,38 @@
+# Edit
+
+## Definition
+
+Bearbeitet Dateien durch exakte Zeichenkettenersetzung. Ersetzt `old_string` in der Datei durch `new_string`.
+
+## Parameter
+
+| Parameter | Typ | Erforderlich | Beschreibung |
+|-----------|-----|--------------|--------------|
+| `file_path` | string | Ja | Absoluter Pfad der zu ändernden Datei |
+| `old_string` | string | Ja | Der zu ersetzende Originaltext |
+| `new_string` | string | Ja | Der neue Ersetzungstext (muss sich von old_string unterscheiden) |
+| `replace_all` | boolean | Nein | Ob alle Vorkommen ersetzt werden sollen, Standard `false` |
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Ändern bestimmter Codeabschnitte in vorhandenen Dateien
+- Bugfixes, Logik-Updates
+- Variablen umbenennen (mit `replace_all: true`)
+- Jedes Szenario, das präzise Dateiänderungen erfordert
+
+**Nicht geeignet für:**
+- Neue Dateien erstellen – dafür Write verwenden
+- Umfangreiche Neuschreibungen – möglicherweise Write zum Überschreiben der gesamten Datei erforderlich
+
+## Hinweise
+
+- Vor der Verwendung muss die Datei über Read gelesen worden sein, sonst tritt ein Fehler auf
+- `old_string` muss in der Datei eindeutig sein, sonst schlägt die Bearbeitung fehl. Bei Nicht-Eindeutigkeit mehr Kontext angeben oder `replace_all` verwenden
+- Beim Bearbeiten von Text muss die ursprüngliche Einrückung (Tab/Leerzeichen) beibehalten werden; das Zeilennummernpräfix der Read-Ausgabe nicht einschließen
+- Vorhandene Dateien bearbeiten hat Vorrang vor dem Erstellen neuer Dateien
+- `new_string` muss sich von `old_string` unterscheiden
+
+## Bedeutung in cc-viewer
+
+Edit-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block, dessen `input` `old_string` und `new_string` enthält und zur Nachverfolgung der Dateiänderungen des Modells verwendet werden kann.

package/concepts/de/Tool-EnterPlanMode.md

@@ -0,0 +1,43 @@
+# EnterPlanMode
+
+## Definition
+
+Schaltet Claude Code in den Planungsmodus um, um vor der Implementierung die Codebasis zu erkunden und einen Plan zu entwerfen.
+
+## Parameter
+
+Keine Parameter.
+
+## Anwendungsfälle
+
+**Geeignet für:**
+- Neue Feature-Implementierung – erfordert Architekturentscheidungen
+- Mehrere mögliche Ansätze – Benutzerauswahl erforderlich
+- Codeänderungen beeinflussen bestehendes Verhalten oder Struktur
+- Änderungen an mehreren Dateien – möglicherweise 2–3 oder mehr Dateien betroffen
+- Unklare Anforderungen – erst erkunden, dann Umfang verstehen
+- Benutzerpräferenzen sind wichtig – die Implementierung kann mehrere sinnvolle Richtungen haben
+
+**Nicht geeignet für:**
+- Einzeilige oder wenige Zeilen umfassende Korrekturen (Tippfehler, offensichtliche Bugs)
+- Der Benutzer hat sehr spezifische Anweisungen gegeben
+- Reine Recherche-/Erkundungsaufgaben – dafür Task (Explore-Typ) verwenden
+
+## Verhalten im Planungsmodus
+
+Nach dem Eintritt in den Planungsmodus wird Claude Code:
+1. Mit Glob, Grep, Read Tools die Codebasis eingehend erkunden
+2. Bestehende Muster und Architektur verstehen
+3. Einen Implementierungsplan entwerfen
+4. Den Plan dem Benutzer zur Genehmigung vorlegen
+5. Bei Bedarf AskUserQuestion zur Klärung verwenden
+6. Nach Fertigstellung des Plans über ExitPlanMode den Modus verlassen
+
+## Hinweise
+
+- Dieses Tool erfordert die Zustimmung des Benutzers zum Eintritt in den Planungsmodus
+- Im Zweifelsfall lieber planen – frühzeitige Abstimmung ist besser als Nacharbeit
+
+## Bedeutung in cc-viewer
+
+EnterPlanMode-Aufrufe erscheinen im Anfrage-Log als `tool_use` Content Block. Die Anfragesequenz nach dem Eintritt in den Planungsmodus besteht typischerweise hauptsächlich aus explorativen Tool-Aufrufen (Glob, Grep, Read), bis ExitPlanMode aufgerufen wird.