cc-viewer 1.6.49 → 1.6.51

package/concepts/ar/ToolsFirst.md

@@ -0,0 +1,47 @@
+# لماذا تُدرج الأدوات أولاً؟
+
+في لوحة السياق بـ cc-viewer، **تظهر Tools قبل System Prompt والMessages**. يعكس هذا الترتيب بدقة **تسلسل بادئة KV-Cache في Anthropic API**.
+
+## تسلسل بادئة KV-Cache
+
+عندما تبني Anthropic API الـ KV-Cache، تقوم بتسلسل السياق في بادئة وفق هذا **الترتيب الثابت**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+هذا يعني أن **Tools تأتي قبل System Prompt في بداية بادئة الـ cache تماماً**.
+
+## لماذا تمتلك Tools وزناً أعلى في الـ Cache من System؟
+
+في مطابقة بادئة KV-Cache، **المحتوى الأسبق أكثر أهمية** — أي تغيير يُبطل كل ما يليه:
+
+1. **مطابقة البادئة تبدأ من البداية**: يقارن KV-Cache الطلب الحالي بالبادئة المخزنة token بـ token من البداية. فور اكتشاف عدم تطابق، يُبطَل كل المحتوى اللاحق.
+
+2. **تغيير Tools = إبطال كامل للـ cache**: بما أن Tools تأتي أولاً، فأي تغيير في تعريفات الأدوات (حتى إضافة أو حذف MCP tool واحدة) **يكسر البادئة من البداية تماماً**، مما يُبطل كل الـ System Prompt والMessages المخزنة.
+
+3. **تغيير System = إبطال cache الـ Messages**: يقع System Prompt في المنتصف، لذا تؤثر تغييراته فقط على جزء الـ Messages الذي يليه.
+
+4. **تغيير Messages = يؤثر فقط على الذيل**: Messages تأتي في النهاية، لذا إضافة رسائل جديدة تُبطل فقط جزءاً صغيراً في النهاية — يبقى cache الـ Tools والـ System سليماً.
+
+## التأثير العملي
+
+| نوع التغيير | تأثير الـ Cache | السيناريو النموذجي |
+|-------------|----------------|---------------------|
+| إضافة/حذف Tool | **إبطال كامل** | اتصال/انقطاع MCP server، تفعيل/تعطيل إضافة IDE |
+| تغيير System Prompt | فقدان cache الـ Messages | تعديل CLAUDE.md، حقن system reminder |
+| إضافة رسالة جديدة | زيادة طرفية فقط | تدفق المحادثة الطبيعي (الأكثر شيوعاً، الأقل تكلفة) |
+
+لهذا السبب يُعد `tools_change` في [CacheRebuild](CacheRebuild.md) أغلى أسباب إعادة البناء في الغالب — لأنه يكسر سلسلة البادئة من الأمام تماماً.
+
+## تصميم واجهة cc-viewer
+
+يرتب cc-viewer لوحة السياق لتتوافق مع تسلسل بادئة KV-Cache:
+
+- **الترتيب من الأعلى إلى الأسفل = ترتيب تسلسل بادئة الـ cache**
+- **التغييرات في الأعلى لها تأثير أكبر على معدل إصابة الـ cache**
+- بالاقتران مع لوحة [KV-Cache-Text](KVCacheContent.md)، يمكنك رؤية النص الكامل لبادئة الـ cache مباشرة

package/concepts/da/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Hvorfor vises Tools først?
+
+I cc-viewers kontekstpanel vises **Tools før System Prompt og Messages**. Denne rækkefølge afspejler præcist **Anthropic API's KV-Cache-præfikssekvens**.
+
+## KV-Cache-præfikssekvens
+
+Når Anthropic's API opbygger KV-Cache, sammensætter den konteksten til et præfiks i denne **faste rækkefølge**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Det betyder, at **Tools befinder sig før System Prompt helt i begyndelsen af cache-præfikset**.
+
+## Hvorfor har Tools større cache-vægt end System?
+
+Ved KV-Cache-præfiksmatchning er **tidligt indhold mere kritisk** — enhver ændring ugyldiggør alt efterfølgende indhold:
+
+1. **Præfiksmatchning starter fra begyndelsen**: KV-Cache sammenligner den aktuelle anmodning med det cachede præfiks token for token fra starten. I det øjeblik en uoverensstemmelse opdages, ugyldiggøres alt efterfølgende indhold.
+
+2. **Tools ændres = hele cache ugyldiggøres**: Da Tools kommer først, vil enhver ændring i værktøjsdefinitioner (selv tilføjelse eller fjernelse af et enkelt MCP-tool) **bryde præfikset helt fra starten** og ugyldiggøre al cachet System Prompt og Messages.
+
+3. **System ændres = Messages-cache ugyldiggøres**: System Prompt befinder sig i midten, så dens ændringer ugyldiggør kun den efterfølgende Messages-del.
+
+4. **Messages ændres = kun halen påvirkes**: Messages er i slutningen, så tilføjelse af nye beskeder ugyldiggør kun et lille afsluttende segment — Tools- og System-cache forbliver intakt.
+
+## Praktisk betydning
+
+| Ændringstype | Cache-påvirkning | Typisk scenarie |
+|--------------|-----------------|-----------------|
+| Tool tilføjet/fjernet | **Fuld ugyldiggørelse** | MCP server tilslut/frakobl, IDE-plugin til/fra |
+| System Prompt ændring | Messages-cache tabt | CLAUDE.md redigering, system reminder-injektion |
+| Ny besked tilføjet | Kun hale-tilvækst | Normal samtalegång (mest almindelig, billigst) |
+
+Det er derfor `tools_change` i [CacheRebuild](CacheRebuild.md) typisk er den dyreste genopbygningsårsag — det bryder præfikskæden helt forrest.
+
+## cc-viewers layoutdesign
+
+cc-viewer arrangerer kontekstpanelet så det matcher KV-Cache-præfikssekvensen:
+
+- **Rækkefølge fra top til bund = cache-præfiksets sammensætningsrækkefølge**
+- **Ændringer højere oppe har større indflydelse på cache-hitrate**
+- Kombineret med panelet [KV-Cache-Text](KVCacheContent.md) kan du se den fulde cache-præfikstekst direkte

package/concepts/de/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Warum werden Tools zuerst aufgelistet?
+
+Im Context-Panel von cc-viewer **erscheinen Tools vor System Prompt und Messages**. Diese Reihenfolge spiegelt exakt die **KV-Cache-Präfix-Sequenz der Anthropic API** wider.
+
+## KV-Cache-Präfix-Sequenz
+
+Wenn die Anthropic API den KV-Cache aufbaut, verkettet sie den Kontext in dieser **festen Reihenfolge** zu einem Präfix:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Das bedeutet: **Tools befinden sich vor dem System Prompt, ganz am Anfang des Cache-Präfixes**.
+
+## Warum haben Tools ein höheres Cache-Gewicht als System?
+
+Beim KV-Cache-Präfix-Matching ist **früher Inhalt entscheidender** — jede Änderung macht alles Folgende ungültig:
+
+1. **Präfix-Matching beginnt am Anfang**: Der KV-Cache vergleicht die aktuelle Anfrage token-für-token vom Anfang mit dem gecachten Präfix. Sobald eine Abweichung gefunden wird, wird der gesamte nachfolgende Inhalt invalidiert.
+
+2. **Änderung der Tools = gesamter Cache invalidiert**: Da Tools an erster Stelle stehen, **bricht jede Änderung an Tool-Definitionen (auch das Hinzufügen oder Entfernen eines einzelnen MCP-Tools) das Präfix vom ersten Moment an**, wodurch alle gecachten System Prompt- und Messages-Inhalte invalidiert werden.
+
+3. **Änderung von System = Messages-Cache invalidiert**: Der System Prompt befindet sich in der Mitte, sodass seine Änderungen nur den nachfolgenden Messages-Teil invalidieren.
+
+4. **Änderung von Messages = nur das Ende betroffen**: Messages stehen am Ende, sodass das Anhängen neuer Messages nur ein kleines abschließendes Segment invalidiert — Tools- und System-Cache bleiben intakt.
+
+## Praktische Auswirkungen
+
+| Änderungstyp | Cache-Auswirkung | Typisches Szenario |
+|-------------|-------------|-----------------|
+| Tool hinzugefügt/entfernt | **Vollständige Invalidierung** | MCP-Server verbinden/trennen, IDE-Plugin ein-/ausschalten |
+| System Prompt-Änderung | Messages-Cache verloren | CLAUDE.md bearbeiten, system reminder einfügen |
+| Neue Message angehängt | Nur Tail-Inkrement | Normaler Gesprächsfluss (am häufigsten, am günstigsten) |
+
+Deshalb ist `tools_change` in [CacheRebuild](CacheRebuild.md) oft der teuerste Rebuild-Grund — es bricht die Präfix-Kette ganz am Anfang.
+
+## Layout-Design von cc-viewer
+
+cc-viewer ordnet das Context-Panel so an, dass es der KV-Cache-Präfix-Sequenz entspricht:
+
+- **Reihenfolge von oben nach unten = Reihenfolge der Cache-Präfix-Verkettung**
+- **Änderungen weiter oben haben größeren Einfluss auf die Cache-Trefferquote**
+- In Kombination mit dem [KV-Cache-Text](KVCacheContent.md)-Panel können Sie den vollständigen Cache-Präfix-Text direkt einsehen

package/concepts/en/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Why Are Tools Listed First?
+
+In cc-viewer's Context panel, **Tools appear before System Prompt and Messages**. This ordering precisely mirrors the **Anthropic API's KV-Cache prefix sequence**.
+
+## KV-Cache Prefix Sequence
+
+When Anthropic's API constructs the KV-Cache, it concatenates context into a prefix in this **fixed order**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+This means **Tools sit before System Prompt at the very beginning of the cache prefix**.
+
+## Why Do Tools Have Higher Cache Weight Than System?
+
+In KV-Cache prefix matching, **earlier content is more critical** — any change invalidates everything after it:
+
+1. **Prefix matching starts from the beginning**: The KV-Cache compares the current request against the cached prefix token-by-token from the start. The moment a mismatch is found, all subsequent content is invalidated.
+
+2. **Tools change = entire cache invalidated**: Since Tools come first, any change to tool definitions (even adding or removing a single MCP tool) **breaks the prefix from the very start**, invalidating all cached System Prompt and Messages.
+
+3. **System change = Messages cache invalidated**: System Prompt sits in the middle, so its changes only invalidate the Messages portion that follows.
+
+4. **Messages change = only the tail affected**: Messages are at the end, so appending new messages only invalidates a small trailing segment — Tools and System cache remain intact.
+
+## Practical Impact
+
+| Change Type | Cache Impact | Typical Scenario |
+|-------------|-------------|-----------------|
+| Tool added/removed | **Full invalidation** | MCP server connect/disconnect, IDE plugin toggle |
+| System Prompt change | Messages cache lost | CLAUDE.md edit, system reminder injection |
+| New message appended | Tail increment only | Normal conversation flow (most common, cheapest) |
+
+This is why `tools_change` in [CacheRebuild](CacheRebuild.md) tends to be the most expensive rebuild reason — it breaks the prefix chain at the very front.
+
+## cc-viewer's Layout Design
+
+cc-viewer arranges the Context panel to match the KV-Cache prefix sequence:
+
+- **Top-to-bottom order = cache prefix concatenation order**
+- **Changes higher up have greater impact on cache hit rate**
+- Paired with the [KV-Cache-Text](KVCacheContent.md) panel, you can see the full cache prefix text directly

package/concepts/es/ToolsFirst.md

@@ -0,0 +1,47 @@
+# ¿Por qué se listan primero los Tools?
+
+En el panel Context de cc-viewer, **los Tools aparecen antes que el System Prompt y los Messages**. Este orden refleja con precisión la **secuencia de prefijo KV-Cache de la API de Anthropic**.
+
+## Secuencia de prefijo KV-Cache
+
+Cuando la API de Anthropic construye el KV-Cache, concatena el contexto en un prefijo en este **orden fijo**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Esto significa que **los Tools se encuentran antes del System Prompt, al comienzo del prefijo de caché**.
+
+## ¿Por qué los Tools tienen mayor peso en caché que System?
+
+En la coincidencia de prefijo KV-Cache, **el contenido más temprano es más crítico** — cualquier cambio invalida todo lo que viene después:
+
+1. **La coincidencia de prefijo comienza desde el principio**: El KV-Cache compara la solicitud actual con el prefijo almacenado en caché token por token desde el inicio. En el momento en que se detecta una discrepancia, todo el contenido posterior queda invalidado.
+
+2. **Cambio en Tools = todo el caché invalidado**: Como los Tools están primero, cualquier cambio en las definiciones de tool (incluso agregar o eliminar un solo MCP tool) **rompe el prefijo desde el mismísimo inicio**, invalidando todo el System Prompt y los Messages almacenados en caché.
+
+3. **Cambio en System = caché de Messages invalidado**: El System Prompt está en el medio, por lo que sus cambios solo invalidan la porción de Messages que le sigue.
+
+4. **Cambio en Messages = solo el final se ve afectado**: Los Messages están al final, por lo que agregar nuevos messages solo invalida un pequeño segmento final — los cachés de Tools y System permanecen intactos.
+
+## Impacto práctico
+
+| Tipo de cambio | Impacto en caché | Escenario típico |
+|-------------|-------------|-----------------|
+| Tool agregado/eliminado | **Invalidación completa** | Conexión/desconexión de servidor MCP, activación/desactivación de plugin IDE |
+| Cambio en System Prompt | Caché de Messages perdido | Edición de CLAUDE.md, inyección de system reminder |
+| Nuevo message agregado | Solo incremento de cola | Flujo de conversación normal (el más común, el más económico) |
+
+Por eso `tools_change` en [CacheRebuild](CacheRebuild.md) tiende a ser la razón de reconstrucción más costosa — rompe la cadena de prefijo desde el principio.
+
+## Diseño del panel de cc-viewer
+
+cc-viewer organiza el panel Context para que coincida con la secuencia de prefijo KV-Cache:
+
+- **Orden de arriba a abajo = orden de concatenación del prefijo de caché**
+- **Los cambios más arriba tienen mayor impacto en la tasa de aciertos del caché**
+- Junto con el panel [KV-Cache-Text](KVCacheContent.md), puedes ver el texto completo del prefijo de caché directamente

package/concepts/fr/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Pourquoi les Tools sont-ils listés en premier ?
+
+Dans le panneau Context de cc-viewer, **les Tools apparaissent avant le System Prompt et les Messages**. Cet ordre reflète précisément la **séquence de préfixe KV-Cache de l'API Anthropic**.
+
+## Séquence de préfixe KV-Cache
+
+Lorsque l'API Anthropic construit le KV-Cache, elle concatène le contexte en un préfixe dans cet **ordre fixe** :
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Cela signifie que **les Tools se trouvent avant le System Prompt, tout au début du préfixe de cache**.
+
+## Pourquoi les Tools ont-ils un poids de cache supérieur à System ?
+
+Dans la correspondance de préfixe KV-Cache, **le contenu en début de séquence est plus critique** — toute modification invalide tout ce qui suit :
+
+1. **La correspondance de préfixe commence par le début** : Le KV-Cache compare la requête actuelle au préfixe mis en cache token par token depuis le début. Dès qu'une divergence est détectée, tout le contenu suivant est invalidé.
+
+2. **Modification des Tools = tout le cache invalidé** : Les Tools étant en première position, toute modification des définitions de tool (même l'ajout ou la suppression d'un seul MCP tool) **brise le préfixe dès le tout début**, invalidant tous les System Prompt et Messages mis en cache.
+
+3. **Modification de System = cache des Messages invalidé** : Le System Prompt se trouve au milieu, donc ses modifications n'invalident que la portion Messages qui suit.
+
+4. **Modification des Messages = seule la fin est affectée** : Les Messages sont à la fin, donc l'ajout de nouveaux messages n'invalide qu'un petit segment final — les caches Tools et System restent intacts.
+
+## Impact pratique
+
+| Type de modification | Impact sur le cache | Scénario typique |
+|-------------|-------------|-----------------|
+| Tool ajouté/supprimé | **Invalidation complète** | Connexion/déconnexion d'un serveur MCP, activation/désactivation d'un plugin IDE |
+| Modification du System Prompt | Cache des Messages perdu | Édition de CLAUDE.md, injection de system reminder |
+| Nouveau message ajouté | Incrément de queue uniquement | Flux de conversation normal (le plus fréquent, le moins coûteux) |
+
+C'est pourquoi `tools_change` dans [CacheRebuild](CacheRebuild.md) tend à être la raison de reconstruction la plus coûteuse — elle brise la chaîne de préfixe dès le tout début.
+
+## Conception de la mise en page de cc-viewer
+
+cc-viewer organise le panneau Context pour correspondre à la séquence de préfixe KV-Cache :
+
+- **Ordre de haut en bas = ordre de concaténation du préfixe de cache**
+- **Les modifications plus haut ont un impact plus grand sur le taux de succès du cache**
+- Associé au panneau [KV-Cache-Text](KVCacheContent.md), vous pouvez voir directement le texte complet du préfixe de cache

package/concepts/it/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Perché i Tools sono elencati per primi?
+
+Nel pannello Context di cc-viewer, **i Tools appaiono prima di System Prompt e Messages**. Questo ordine riflette con precisione la **sequenza del prefisso KV-Cache dell'API di Anthropic**.
+
+## Sequenza del prefisso KV-Cache
+
+Quando l'API di Anthropic costruisce il KV-Cache, concatena il contesto in un prefisso in questo **ordine fisso**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Ciò significa che **i Tools si trovano prima del System Prompt, all'inizio del prefisso di cache**.
+
+## Perché i Tools hanno un peso di cache maggiore di System?
+
+Nella corrispondenza del prefisso KV-Cache, **il contenuto precedente è più critico** — qualsiasi modifica invalida tutto ciò che segue:
+
+1. **La corrispondenza del prefisso inizia dall'inizio**: Il KV-Cache confronta la richiesta corrente con il prefisso memorizzato nella cache token per token dall'inizio. Nel momento in cui viene rilevata una discrepanza, tutto il contenuto successivo viene invalidato.
+
+2. **Modifica dei Tools = intera cache invalidata**: Poiché i Tools sono in prima posizione, qualsiasi modifica alle definizioni dei tool (anche aggiungere o rimuovere un singolo MCP tool) **rompe il prefisso dal primissimo inizio**, invalidando tutti i System Prompt e i Messages memorizzati nella cache.
+
+3. **Modifica di System = cache dei Messages invalidata**: Il System Prompt si trova nel mezzo, quindi le sue modifiche invalidano solo la porzione dei Messages che segue.
+
+4. **Modifica dei Messages = solo la coda è interessata**: I Messages sono alla fine, quindi aggiungere nuovi messages invalida solo un piccolo segmento finale — le cache di Tools e System rimangono intatte.
+
+## Impatto pratico
+
+| Tipo di modifica | Impatto sulla cache | Scenario tipico |
+|-------------|-------------|-----------------|
+| Tool aggiunto/rimosso | **Invalidazione completa** | Connessione/disconnessione server MCP, attivazione/disattivazione plugin IDE |
+| Modifica del System Prompt | Cache dei Messages persa | Modifica di CLAUDE.md, iniezione di system reminder |
+| Nuovo message aggiunto | Solo incremento della coda | Flusso di conversazione normale (il più comune, il meno costoso) |
+
+Ecco perché `tools_change` in [CacheRebuild](CacheRebuild.md) tende ad essere il motivo di ricostruzione più costoso — rompe la catena del prefisso fin dall'inizio.
+
+## Design del layout di cc-viewer
+
+cc-viewer organizza il pannello Context in modo da corrispondere alla sequenza del prefisso KV-Cache:
+
+- **Ordine dall'alto verso il basso = ordine di concatenazione del prefisso di cache**
+- **Le modifiche più in alto hanno un impatto maggiore sul tasso di successo della cache**
+- Abbinato al pannello [KV-Cache-Text](KVCacheContent.md), è possibile vedere direttamente il testo completo del prefisso di cache

package/concepts/ja/ToolsFirst.md

@@ -0,0 +1,47 @@
+# なぜToolsが最初に表示されるのか？
+
+cc-viewerのContextパネルでは、**ToolsはSystem PromptとMessagesより前に表示されます**。この順序は、**Anthropic APIのKV-Cacheプレフィックスシーケンス**を正確に反映しています。
+
+## KV-Cacheプレフィックスシーケンス
+
+Anthropic のAPIがKV-Cacheを構築する際、コンテキストを以下の**固定された順序**でプレフィックスとして連結します：
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+つまり、**ToolsはSystem Promptより前、キャッシュプレフィックスの最先頭に位置します**。
+
+## なぜToolsはSystemよりキャッシュの重みが大きいのか？
+
+KV-Cacheのプレフィックスマッチングでは、**前方のコンテンツほど重要**です — 変更が発生すると、それ以降のすべてが無効化されます：
+
+1. **プレフィックスマッチングは先頭から開始される**：KV-Cacheは現在のリクエストをキャッシュされたプレフィックスと先頭からtoken単位で比較します。不一致が見つかった瞬間、それ以降のコンテンツはすべて無効化されます。
+
+2. **Toolsの変更 = キャッシュ全体が無効化**：Toolsは最前列にあるため、tool定義の変更（MCP toolの追加・削除1つでも）は**プレフィックスを最先頭から破壊し**、キャッシュされたSystem PromptとMessagesすべてを無効化します。
+
+3. **Systemの変更 = Messagesキャッシュが無効化**：System Promptは中間に位置するため、その変更は後続のMessages部分のみを無効化します。
+
+4. **Messagesの変更 = 末尾部分のみ影響**：Messagesは末尾にあるため、新しいmessageの追加は小さな末尾セグメントのみを無効化します — ToolsとSystemのキャッシュはそのまま保持されます。
+
+## 実際の影響
+
+| 変更の種類 | キャッシュへの影響 | 典型的なシナリオ |
+|-------------|-------------|-----------------|
+| Tool追加/削除 | **完全無効化** | MCPサーバーの接続/切断、IDEプラグインの切り替え |
+| System Promptの変更 | Messagesキャッシュが失われる | CLAUDE.mdの編集、system reminderの挿入 |
+| 新しいmessageの追加 | 末尾の増分のみ | 通常の会話フロー（最も一般的、最もコストが低い） |
+
+これが、[CacheRebuild](CacheRebuild.md)における`tools_change`が最もコストの高いリビルド理由になりやすい理由です — プレフィックスチェーンを最前部から破壊するからです。
+
+## cc-viewerのレイアウト設計
+
+cc-viewerはContextパネルをKV-Cacheプレフィックスシーケンスと一致するように配置しています：
+
+- **上から下の順序 = キャッシュプレフィックスの連結順序**
+- **上位の変更ほどキャッシュヒット率への影響が大きい**
+- [KV-Cache-Text](KVCacheContent.md)パネルと組み合わせることで、キャッシュプレフィックスの全テキストを直接確認できます

package/concepts/ko/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Tools가 왜 먼저 나열되는가?
+
+cc-viewer의 Context 패널에서 **Tools는 System Prompt와 Messages보다 앞에 표시됩니다**. 이 순서는 **Anthropic API의 KV-Cache 프리픽스 시퀀스**를 정확히 반영한 것입니다.
+
+## KV-Cache 프리픽스 시퀀스
+
+Anthropic의 API가 KV-Cache를 구성할 때, 컨텍스트를 다음 **고정된 순서**로 프리픽스에 연결합니다:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+즉, **Tools는 System Prompt보다 앞에, 캐시 프리픽스의 맨 처음에 위치합니다**.
+
+## Tools가 System보다 캐시 가중치가 높은 이유는?
+
+KV-Cache 프리픽스 매칭에서는 **앞쪽의 콘텐츠일수록 더 중요**합니다 — 변경이 발생하면 그 이후의 모든 내용이 무효화됩니다:
+
+1. **프리픽스 매칭은 처음부터 시작됩니다**: KV-Cache는 현재 요청을 캐시된 프리픽스와 처음부터 token 단위로 비교합니다. 불일치가 발견되는 순간, 이후의 모든 콘텐츠가 무효화됩니다.
+
+2. **Tools 변경 = 전체 캐시 무효화**: Tools가 맨 앞에 있기 때문에, tool 정의의 변경(MCP tool 하나를 추가하거나 제거하는 것만으로도)은 **프리픽스를 맨 처음부터 깨뜨려**, 캐시된 System Prompt와 Messages 전체를 무효화합니다.
+
+3. **System 변경 = Messages 캐시 무효화**: System Prompt는 중간에 위치하므로, 변경 시 그 뒤에 오는 Messages 부분만 무효화됩니다.
+
+4. **Messages 변경 = 끝부분만 영향받음**: Messages는 마지막에 있으므로, 새로운 message 추가는 작은 끝부분 세그먼트만 무효화합니다 — Tools와 System 캐시는 그대로 유지됩니다.
+
+## 실제 영향
+
+| 변경 유형 | 캐시 영향 | 일반적인 시나리오 |
+|-------------|-------------|-----------------|
+| Tool 추가/제거 | **전체 무효화** | MCP 서버 연결/연결 해제, IDE 플러그인 전환 |
+| System Prompt 변경 | Messages 캐시 손실 | CLAUDE.md 편집, system reminder 삽입 |
+| 새 message 추가 | 끝부분 증분만 | 일반적인 대화 흐름 (가장 일반적, 가장 저렴) |
+
+이것이 [CacheRebuild](CacheRebuild.md)에서 `tools_change`가 가장 비용이 많이 드는 리빌드 이유가 되기 쉬운 이유입니다 — 프리픽스 체인을 맨 앞에서부터 깨뜨리기 때문입니다.
+
+## cc-viewer의 레이아웃 설계
+
+cc-viewer는 Context 패널을 KV-Cache 프리픽스 시퀀스와 일치하도록 배치합니다:
+
+- **위에서 아래로의 순서 = 캐시 프리픽스 연결 순서**
+- **위쪽의 변경일수록 캐시 히트율에 더 큰 영향을 미침**
+- [KV-Cache-Text](KVCacheContent.md) 패널과 함께 사용하면, 캐시 프리픽스의 전체 텍스트를 직접 확인할 수 있습니다

package/concepts/no/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Hvorfor vises Tools først?
+
+I cc-viewers kontekstpanel vises **Tools før System Prompt og Messages**. Denne rekkefølgen gjenspeiler nøyaktig **Anthropic API-ens KV-Cache-prefiks-sekvens**.
+
+## KV-Cache-prefiks-sekvens
+
+Når Anthropic's API bygger opp KV-Cache, setter den sammen konteksten til et prefiks i denne **faste rekkefølgen**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Dette betyr at **Tools befinner seg før System Prompt helt i begynnelsen av cache-prefikset**.
+
+## Hvorfor har Tools høyere cache-vekt enn System?
+
+Ved KV-Cache-prefiksmatchning er **tidlig innhold mer kritisk** — enhver endring ugyldiggjør alt som kommer etter:
+
+1. **Prefiksmatchning starter fra begynnelsen**: KV-Cache sammenligner den gjeldende forespørselen med det bufrede prefikset token for token fra starten. I det øyeblikket et avvik oppdages, ugyldiggjøres alt etterfølgende innhold.
+
+2. **Tools endres = hele cachen ugyldiggjøres**: Siden Tools kommer først, vil enhver endring i verktøydefinisjoner (selv å legge til eller fjerne ett enkelt MCP-tool) **bryte prefikset helt fra starten**, og ugyldiggjøre all bufret System Prompt og Messages.
+
+3. **System endres = Messages-cache ugyldiggjøres**: System Prompt befinner seg i midten, så dens endringer ugyldiggjør bare den etterfølgende Messages-delen.
+
+4. **Messages endres = bare halen påvirkes**: Messages er på slutten, så å legge til nye meldinger ugyldiggjør bare et lite avsluttende segment — cache for Tools og System forblir intakt.
+
+## Praktisk betydning
+
+| Endringstype | Cache-påvirkning | Typisk scenario |
+|--------------|-----------------|-----------------|
+| Tool lagt til/fjernet | **Full ugyldiggjøring** | MCP server tilkobling/frakobling, IDE-plugin av/på |
+| System Prompt-endring | Messages-cache tapt | CLAUDE.md-redigering, system reminder-injeksjon |
+| Ny melding lagt til | Bare hale-inkrement | Normal samtaleflyt (vanligst, billigst) |
+
+Dette er grunnen til at `tools_change` i [CacheRebuild](CacheRebuild.md) typisk er den dyreste gjenoppbyggingsårsaken — den bryter prefikskjeden helt fremst.
+
+## cc-viewers layoutdesign
+
+cc-viewer arrangerer kontekstpanelet slik at det matcher KV-Cache-prefiks-sekvensen:
+
+- **Rekkefølge fra topp til bunn = cache-prefiks-sammensettingsrekkefølge**
+- **Endringer høyere opp har større innvirkning på cache-hitrate**
+- Kombinert med [KV-Cache-Text](KVCacheContent.md)-panelet kan du se den fullstendige cache-prefiks-teksten direkte

package/concepts/pl/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Dlaczego Tools są wyświetlane jako pierwsze?
+
+W panelu kontekstu cc-viewer **Tools pojawiają się przed System Prompt i Messages**. Ta kolejność dokładnie odzwierciedla **sekwencję prefiksu KV-Cache w Anthropic API**.
+
+## Sekwencja prefiksu KV-Cache
+
+Gdy Anthropic API buduje KV-Cache, łączy kontekst w prefiks w tej **stałej kolejności**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Oznacza to, że **Tools znajdują się przed System Prompt na samym początku prefiksu cache**.
+
+## Dlaczego Tools mają większy wpływ na cache niż System?
+
+W dopasowywaniu prefiksu KV-Cache **wcześniejsza treść jest bardziej krytyczna** — każda zmiana unieważnia wszystko, co po niej następuje:
+
+1. **Dopasowywanie prefiksu zaczyna się od początku**: KV-Cache porównuje bieżące żądanie z zbuforowanym prefiksem token po tokenie od początku. W momencie znalezienia niezgodności cała późniejsza treść zostaje unieważniona.
+
+2. **Zmiana Tools = cały cache unieważniony**: Ponieważ Tools są na pierwszym miejscu, każda zmiana w definicjach narzędzi (nawet dodanie lub usunięcie jednego MCP tool) **przerywa prefiks od samego początku**, unieważniając cały zbuforowany System Prompt i Messages.
+
+3. **Zmiana System = cache Messages unieważniony**: System Prompt znajduje się w środku, więc jego zmiany unieważniają tylko następującą po nim część Messages.
+
+4. **Zmiana Messages = dotyczy tylko końca**: Messages są na końcu, więc dołączanie nowych wiadomości unieważnia jedynie niewielki końcowy segment — cache Tools i System pozostaje nienaruszony.
+
+## Praktyczny wpływ
+
+| Typ zmiany | Wpływ na cache | Typowy scenariusz |
+|------------|---------------|-------------------|
+| Tool dodane/usunięte | **Pełne unieważnienie** | Połączenie/rozłączenie serwera MCP, włączenie/wyłączenie wtyczki IDE |
+| Zmiana System Prompt | Utrata cache Messages | Edycja CLAUDE.md, wstrzyknięcie system reminder |
+| Nowa wiadomość dodana | Tylko przyrost końcowy | Normalny przepływ rozmowy (najczęstszy, najtańszy) |
+
+Dlatego `tools_change` w [CacheRebuild](CacheRebuild.md) jest zazwyczaj najdroższym powodem przebudowy — przerywa łańcuch prefiksu na samym początku.
+
+## Projekt układu cc-viewer
+
+cc-viewer rozmieszcza panel kontekstu tak, aby odpowiadał sekwencji prefiksu KV-Cache:
+
+- **Kolejność od góry do dołu = kolejność łączenia prefiksu cache**
+- **Zmiany wyżej mają większy wpływ na współczynnik trafień cache**
+- W połączeniu z panelem [KV-Cache-Text](KVCacheContent.md) możesz bezpośrednio zobaczyć pełny tekst prefiksu cache

package/concepts/pt-BR/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Por que os Tools são listados primeiro?
+
+No painel Context do cc-viewer, **os Tools aparecem antes do System Prompt e dos Messages**. Essa ordenação reflete precisamente a **sequência de prefixo KV-Cache da API da Anthropic**.
+
+## Sequência de prefixo KV-Cache
+
+Quando a API da Anthropic constrói o KV-Cache, ela concatena o contexto em um prefixo nesta **ordem fixa**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Isso significa que **os Tools ficam antes do System Prompt, bem no início do prefixo de cache**.
+
+## Por que os Tools têm maior peso de cache do que System?
+
+Na correspondência de prefixo KV-Cache, **o conteúdo anterior é mais crítico** — qualquer alteração invalida tudo o que vem depois:
+
+1. **A correspondência de prefixo começa pelo início**: O KV-Cache compara a requisição atual com o prefixo em cache token por token desde o início. No momento em que uma divergência é encontrada, todo o conteúdo subsequente é invalidado.
+
+2. **Alteração nos Tools = cache inteiro invalidado**: Como os Tools vêm primeiro, qualquer alteração nas definições de tool (mesmo adicionar ou remover um único MCP tool) **quebra o prefixo desde o início absoluto**, invalidando todos os System Prompt e Messages em cache.
+
+3. **Alteração no System = cache de Messages invalidado**: O System Prompt fica no meio, então suas alterações invalidam apenas a porção de Messages que o segue.
+
+4. **Alteração nos Messages = apenas o final é afetado**: Os Messages ficam no final, então adicionar novos messages invalida apenas um pequeno segmento final — os caches de Tools e System permanecem intactos.
+
+## Impacto prático
+
+| Tipo de alteração | Impacto no cache | Cenário típico |
+|-------------|-------------|-----------------|
+| Tool adicionado/removido | **Invalidação completa** | Conexão/desconexão de servidor MCP, ativação/desativação de plugin de IDE |
+| Alteração no System Prompt | Cache de Messages perdido | Edição de CLAUDE.md, injeção de system reminder |
+| Novo message adicionado | Apenas incremento de cauda | Fluxo de conversa normal (o mais comum, o mais barato) |
+
+É por isso que `tools_change` no [CacheRebuild](CacheRebuild.md) tende a ser o motivo de reconstrução mais custoso — ele quebra a cadeia de prefixo bem na frente.
+
+## Design de layout do cc-viewer
+
+O cc-viewer organiza o painel Context para corresponder à sequência de prefixo KV-Cache:
+
+- **Ordem de cima para baixo = ordem de concatenação do prefixo de cache**
+- **Alterações mais acima têm maior impacto na taxa de acerto do cache**
+- Combinado com o painel [KV-Cache-Text](KVCacheContent.md), você pode ver diretamente o texto completo do prefixo de cache

package/concepts/ru/ToolsFirst.md

@@ -0,0 +1,47 @@
+# Почему Tools перечислены первыми?
+
+В панели Context в cc-viewer **Tools отображаются раньше System Prompt и Messages**. Этот порядок точно отражает **последовательность префикса KV-Cache API Anthropic**.
+
+## Последовательность префикса KV-Cache
+
+Когда API Anthropic формирует KV-Cache, он объединяет контекст в префикс в следующем **фиксированном порядке**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Это означает, что **Tools находятся перед System Prompt, в самом начале префикса кэша**.
+
+## Почему Tools имеют больший вес в кэше, чем System?
+
+При сопоставлении префиксов KV-Cache **более ранний контент является более критичным** — любое изменение делает недействительным всё, что следует после:
+
+1. **Сопоставление префикса начинается с самого начала**: KV-Cache сравнивает текущий запрос с кэшированным префиксом token за token с начала. Как только обнаруживается несоответствие, весь последующий контент становится недействительным.
+
+2. **Изменение Tools = весь кэш недействителен**: Поскольку Tools стоят первыми, любое изменение определений tool (даже добавление или удаление одного MCP tool) **нарушает префикс с самого начала**, делая недействительными все кэшированные System Prompt и Messages.
+
+3. **Изменение System = кэш Messages недействителен**: System Prompt находится посередине, поэтому его изменения делают недействительной только следующую за ним часть Messages.
+
+4. **Изменение Messages = затронут только хвост**: Messages находятся в конце, поэтому добавление новых messages делает недействительным лишь небольшой хвостовой сегмент — кэши Tools и System остаются нетронутыми.
+
+## Практическое влияние
+
+| Тип изменения | Влияние на кэш | Типичный сценарий |
+|-------------|-------------|-----------------|
+| Tool добавлен/удалён | **Полная инвалидация** | Подключение/отключение сервера MCP, включение/выключение плагина IDE |
+| Изменение System Prompt | Кэш Messages утерян | Редактирование CLAUDE.md, внедрение system reminder |
+| Добавлено новое message | Только хвостовой инкремент | Обычный ход разговора (самый частый, самый дешёвый) |
+
+Вот почему `tools_change` в [CacheRebuild](CacheRebuild.md) как правило является наиболее дорогостоящей причиной перестройки — она нарушает цепочку префикса с самого начала.
+
+## Дизайн макета cc-viewer
+
+cc-viewer организует панель Context в соответствии с последовательностью префикса KV-Cache:
+
+- **Порядок сверху вниз = порядок объединения префикса кэша**
+- **Изменения выше имеют большее влияние на показатель попаданий в кэш**
+- В сочетании с панелью [KV-Cache-Text](KVCacheContent.md) вы можете напрямую увидеть полный текст префикса кэша