cx-viewer 1.0.0

package/concepts/tr/Tool-TeamDelete.md

@@ -0,0 +1,30 @@
+# TeamDelete
+
+## Tanım
+
+Çok agent'lı işbirliği çalışması tamamlandığında bir takımı ve ilişkili görev dizinlerini kaldırır. Bu, TeamCreate'in temizlik karşılığıdır.
+
+## Davranış
+
+- Takım dizinini kaldırır: `~/.claude/teams/{team-name}/`
+- Görev dizinini kaldırır: `~/.claude/tasks/{team-name}/`
+- Mevcut oturumdan takım bağlamını temizler
+
+**Önemli**: Takımın hâlâ aktif üyeleri varsa TeamDelete başarısız olur. Takım üyeleri önce SendMessage kapatma istekleri aracılığıyla düzgün şekilde kapatılmalıdır.
+
+## Tipik Kullanım
+
+TeamDelete, bir takım iş akışının sonunda çağrılır:
+
+1. Tüm görevler tamamlanır
+2. Takım üyeleri `shutdown_request` ile `SendMessage` aracılığıyla kapatılır
+3. **TeamDelete** takım ve görev dizinlerini kaldırır
+
+## İlgili Araçlar
+
+| Araç | Amaç |
+|------|------|
+| `TeamCreate` | Yeni bir takım ve görev listesi oluştur |
+| `SendMessage` | Takım üyeleriyle iletişim kur / kapatma istekleri gönder |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Paylaşılan görev listesini yönet |
+| `Agent` | Takıma katılan takım üyelerini başlat |

package/concepts/tr/Tool-WebFetch.md

@@ -0,0 +1,55 @@
+# WebFetch
+
+## Tanım
+
+Belirtilen URL'nin web sayfası içeriğini çeker, HTML'yi markdown'a dönüştürür ve prompt'a göre AI modeli ile içeriği işler.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `url` | string (URI) | Evet | Çekilecek tam URL |
+| `prompt` | string | Evet | Sayfadan hangi bilginin çıkarılacağını açıklar |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Herkese açık web sayfalarının içeriğini alma
+- Çevrimiçi belgelere başvurma
+- Web sayfasından belirli bilgileri çıkarma
+
+**Kullanıma uygun değil:**
+- Kimlik doğrulama gerektiren URL'ler (Google Docs, Confluence, Jira, GitHub vb.) — önce özel MCP aracı aranmalıdır
+- GitHub URL'leri — öncelikle `gh` CLI kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- URL tam ve geçerli bir URL olmalıdır
+- HTTP otomatik olarak HTTPS'ye yükseltilir
+- İçerik çok büyükse sonuçlar özetlenebilir
+- 15 dakikalık otomatik temizlenen önbellek içerir
+- URL farklı bir ana bilgisayara yönlendirildiğinde, araç yönlendirme URL'sini döndürür ve yeni URL ile tekrar istek yapılması gerekir
+- MCP tarafından sağlanan web fetch aracı mevcutsa, onu tercih edin
+
+## Orijinal Metin
+
+<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
+
+- Fetches content from a specified URL and processes it using an AI model
+- Takes a URL and a prompt as input
+- Fetches the URL content, converts HTML to markdown
+- Processes the content with the prompt using a small, fast model
+- Returns the model's response about the content
+- Use this tool when you need to retrieve and analyze web content
+
+Usage notes:
+  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
+  - The URL must be a fully-formed valid URL
+  - HTTP URLs will be automatically upgraded to HTTPS
+  - The prompt should describe what information you want to extract from the page
+  - This tool is read-only and does not modify any files
+  - Results may be summarized if the content is very large
+  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
+  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
+  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
+</textarea>

package/concepts/tr/Tool-WebSearch.md

@@ -0,0 +1,58 @@
+# WebSearch
+
+## Tanım
+
+Arama motoru sorgusu çalıştırır ve güncel bilgi almak için arama sonuçlarını döndürür.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `query` | string | Evet | Arama sorgusu (en az 2 karakter) |
+| `allowed_domains` | string[] | Hayır | Yalnızca bu alan adlarından sonuçları dahil et |
+| `blocked_domains` | string[] | Hayır | Bu alan adlarından sonuçları hariç tut |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Modelin bilgi kesme tarihini aşan güncel bilgileri alma
+- Güncel olayları ve en son verileri bulma
+- En güncel teknik belgeleri arama
+
+## Dikkat Edilecekler
+
+- Arama sonuçları markdown köprü formatında döndürülür
+- Kullanımdan sonra yanıtın sonuna "Sources:" bölümü eklenmeli ve ilgili URL'ler listelenmelidir
+- Alan adı filtrelemeyi destekler (dahil etme/hariç tutma)
+- Arama sorgusunda güncel yıl kullanılmalıdır
+- Yalnızca ABD'de kullanılabilir
+
+## Orijinal Metin
+
+<textarea readonly>
+- Allows Claude to search the web and use the results to inform responses
+- Provides up-to-date information for current events and recent data
+- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
+- Use this tool for accessing information beyond Claude's knowledge cutoff
+- Searches are performed automatically within a single API call
+
+CRITICAL REQUIREMENT - You MUST follow this:
+  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
+  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
+  - This is MANDATORY - never skip including sources in your response
+  - Example format:
+
+    [Your answer here]
+
+    Sources:
+    - [Source Title 1](https://example.com/1)
+    - [Source Title 2](https://example.com/2)
+
+Usage notes:
+  - Domain filtering is supported to include or block specific websites
+  - Web search is only available in the US
+
+IMPORTANT - Use the correct year in search queries:
+  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
+  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
+</textarea>

package/concepts/tr/Tool-Write.md

@@ -0,0 +1,39 @@
+# Write
+
+## Tanım
+
+İçeriği yerel dosya sistemine yazar. Dosya zaten mevcutsa üzerine yazar.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `file_path` | string | Evet | Dosyanın mutlak yolu (mutlak yol olmalıdır) |
+| `content` | string | Evet | Yazılacak içerik |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Yeni dosya oluşturma
+- Dosya içeriğinin tamamen yeniden yazılması gerektiğinde
+
+**Kullanıma uygun değil:**
+- Dosyadaki kısmi içeriği değiştirme — Edit kullanılmalıdır
+- Kullanıcı açıkça istemediği sürece proaktif olarak belge dosyaları (*.md) veya README oluşturulmamalıdır
+
+## Dikkat Edilecekler
+
+- Hedef dosya zaten mevcutsa, önce Read ile okunmuş olmalıdır, aksi takdirde başarısız olur
+- Mevcut dosyanın tüm içeriğini üzerine yazar
+- Mevcut dosyaları düzenlemek için Edit'i tercih edin; Write yalnızca yeni dosya oluşturma veya tamamen yeniden yazma için kullanılır
+
+## Orijinal Metin
+
+<textarea readonly>Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
+- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>

package/concepts/tr/Tool-executeCode.md

@@ -0,0 +1,41 @@
+# executeCode (mcp__ide__executeCode)
+
+## Tanım
+
+Mevcut notebook dosyasının Jupyter kernel'ında Python kodu çalıştırır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `code` | string | Evet | Çalıştırılacak Python kodu |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Jupyter notebook ortamında kod çalıştırma
+- Kod parçacıklarını test etme
+- Veri analizi ve hesaplama
+
+**Kullanıma uygun değil:**
+- Jupyter dışı ortamda kod çalıştırma — Bash kullanılmalıdır
+- Dosya değiştirme — Edit veya Write kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
+- Kod mevcut Jupyter kernel'ında çalıştırılır, durum çağrılar arasında kalıcıdır
+- Kullanıcı açıkça istemediği sürece değişken tanımlamaktan veya kernel durumunu değiştirmekten kaçınılmalıdır
+- Kernel yeniden başlatıldığında durum kaybolur
+
+## Orijinal Metin
+
+<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
+    
+    All code will be executed in the current Jupyter kernel.
+    
+    Avoid declaring variables or modifying the state of the kernel unless the user
+    explicitly asks for it.
+    
+    Any code executed will persist across calls to this tool, unless the kernel
+    has been restarted.</textarea>

package/concepts/tr/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Tanım
+
+VS Code'dan sözdizimi hataları, tür hataları, lint uyarıları gibi dil tanılama bilgilerini alır.
+
+## Parametreler
+
+| Parametre | Tür | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `uri` | string | Hayır | Dosya URI'si. Belirtilmezse tüm dosyaların tanılama bilgilerini alır |
+
+## Kullanım Senaryoları
+
+**Kullanıma uygun:**
+- Kodun sözdizimi, tür, lint gibi anlamsal sorunlarını kontrol etme
+- Kod düzenledikten sonra yeni hata oluşup oluşmadığını doğrulama
+- Kod kalitesini kontrol etmek için Bash komutlarının yerine kullanma
+
+**Kullanıma uygun değil:**
+- Test çalıştırma — Bash kullanılmalıdır
+- Çalışma zamanı hatalarını kontrol etme — kodu çalıştırmak için Bash kullanılmalıdır
+
+## Dikkat Edilecekler
+
+- Bu bir MCP (Model Context Protocol) aracıdır ve IDE entegrasyonu tarafından sağlanır
+- Yalnızca VS Code / IDE ortamında kullanılabilir
+- Kod sorunlarını kontrol etmek için Bash komutları yerine bu aracı tercih edin
+
+## Orijinal Metin
+
+<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/tr/Tools.md

@@ -0,0 +1,67 @@
+# Claude Code Araç Listesi
+
+Claude Code, Anthropic API'nin tool_use mekanizması aracılığıyla modele bir dizi yerleşik araç sunar. Her MainAgent isteğinin `tools` dizisi bu araçların tam JSON Schema tanımlarını içerir ve model yanıtında `tool_use` content block aracılığıyla bunları çağırır.
+
+Aşağıda tüm araçların kategorize edilmiş dizini bulunmaktadır.
+
+## Agent Sistemi
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Task](Tool-Task.md) | Karmaşık çok adımlı görevleri işlemek için alt agent (SubAgent) başlatma |
+| [TaskOutput](Tool-TaskOutput.md) | Arka plan görevinin çıktısını alma |
+| [TaskStop](Tool-TaskStop.md) | Çalışan arka plan görevini durdurma |
+| [TaskCreate](Tool-TaskCreate.md) | Yapılandırılmış görev listesi girdisi oluşturma |
+| [TaskGet](Tool-TaskGet.md) | Görev detaylarını alma |
+| [TaskUpdate](Tool-TaskUpdate.md) | Görev durumunu, bağımlılıkları vb. güncelleme |
+| [TaskList](Tool-TaskList.md) | Tüm görevleri listeleme |
+
+## Dosya İşlemleri
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Read](Tool-Read.md) | Dosya içeriğini okuma (metin, resim, PDF, Jupyter notebook desteği) |
+| [Edit](Tool-Edit.md) | Kesin dize değiştirme ile dosya düzenleme |
+| [Write](Tool-Write.md) | Dosya yazma veya üzerine yazma |
+| [NotebookEdit](Tool-NotebookEdit.md) | Jupyter notebook hücresini düzenleme |
+
+## Arama
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Glob](Tool-Glob.md) | Dosya adı kalıp eşleştirmesiyle dosya arama |
+| [Grep](Tool-Grep.md) | ripgrep tabanlı dosya içeriği arama |
+
+## Terminal
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Bash](Tool-Bash.md) | Shell komutu çalıştırma |
+
+## Web
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [WebFetch](Tool-WebFetch.md) | Web sayfası içeriğini çekme ve AI ile işleme |
+| [WebSearch](Tool-WebSearch.md) | Arama motoru sorgusu |
+
+## Planlama ve Etkileşim
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Planlama moduna girme, uygulama planı tasarlama |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Planlama modundan çıkma ve planı kullanıcı onayına sunma |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Açıklama veya karar almak için kullanıcıya soru sorma |
+
+## Eklentiler
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [Skill](Tool-Skill.md) | Beceri (slash command) çalıştırma |
+
+## IDE Entegrasyonu
+
+| Araç | Kullanım Amacı |
+|------|----------------|
+| [getDiagnostics](Tool-getDiagnostics.md) | VS Code dil tanılama bilgilerini alma |
+| [executeCode](Tool-executeCode.md) | Jupyter kernel'da kod çalıştırma |

package/concepts/tr/ToolsFirst.md

@@ -0,0 +1,77 @@
+# Tools Neden İlk Sırada Gösterilir?
+
+cc-viewer'ın Bağlam panelinde **Tools, System Prompt ve Messages'tan önce görünür**. Bu sıralama, **Anthropic API'nin KV-Cache önek sırasını** tam olarak yansıtır.
+
+## KV-Cache Önek Sırası
+
+Anthropic'in API'si KV-Cache'i oluştururken, bağlamı bu **sabit sırayla** bir önek olarak birleştirir:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Bu, **Tools'un cache önekinin en başında System Prompt'tan önce yer aldığı** anlamına gelir.
+
+## Tools Neden System'dan Daha Fazla Cache Ağırlığına Sahip?
+
+KV-Cache önek eşleştirmesinde **önceki içerik daha kritiktir** — herhangi bir değişiklik, sonrasındaki her şeyi geçersiz kılar:
+
+1. **Önek eşleştirmesi baştan başlar**: KV-Cache, mevcut isteği önbellekteki önekle baştan token token karşılaştırır. Bir uyuşmazlık bulunduğu anda, sonraki tüm içerik geçersiz kılınır.
+
+2. **Tools değişirse = tüm cache geçersiz**: Tools ilk sırada olduğundan, araç tanımlarındaki herhangi bir değişiklik (tek bir MCP tool eklenmesi veya kaldırılması bile) **öneki en başından bozar** ve önbelleğe alınan tüm System Prompt ile Messages'ı geçersiz kılar.
+
+3. **System değişirse = Messages cache geçersiz**: System Prompt ortada yer aldığından, değişiklikler yalnızca sonrasındaki Messages bölümünü geçersiz kılar.
+
+4. **Messages değişirse = yalnızca kuyruk etkilenir**: Messages en sonda yer aldığından, yeni mesajlar eklemek yalnızca küçük bir son segmenti geçersiz kılar — Tools ve System cache'i bütün kalır.
+
+## Pratik Etki
+
+| Değişiklik Türü | Cache Etkisi | Tipik Senaryo |
+|-----------------|-------------|---------------|
+| Tool eklendi/kaldırıldı | **Tam geçersizleştirme** | MCP sunucu bağlan/kes, IDE eklentisi aç/kapat |
+| System Prompt değişikliği | Messages cache kaybı | CLAUDE.md düzenleme, system reminder enjeksiyonu |
+| Yeni mesaj eklendi | Yalnızca kuyruk artışı | Normal konuşma akışı (en yaygın, en ucuz) |
+
+Bu nedenle [CacheRebuild](CacheRebuild.md)'deki `tools_change`, genellikle en pahalı yeniden oluşturma nedenidir — önek zincirini en baştan kırar.
+
+## Araç tanımları neden "beyinden" önce yerleştirilir?
+
+Önbellekleme açısından, Tools'un ilk sırada olması teknik bir gerçektir. Ancak bilişsel tasarım açısından da bu sıralama mantıklıdır — **Tools eller ve ayaklardır, System Prompt beyindir**.
+
+Harekete geçmeden önce, bir kişi hangi uzuvlara ve araçlara sahip olduğunu algılamalıdır. Bir bebek önce dünyanın kurallarını (System) anlayıp sonra tutmayı öğrenmez — önce ellerinin ve ayaklarının olduğunu algılar, ardından çevreyle etkileşim yoluyla kuralları kademeli olarak anlar. Benzer şekilde, bir LLM görev talimatlarını (System Prompt) almadan önce hangi araçları çağırabileceğini (dosya okuma, kod yazma, arama, komut çalıştırma) bilmelidir, böylece talimatları işlerken "ne yapabilirim" ve "nasıl yapmalıyım" sorularını doğru değerlendirebilir.
+
+Eğer tersi olsaydı — modele önce "görevin bu modülü yeniden yapılandırmak", sonra "Read, Edit, Bash araçların var" deseydiniz — model görevi anlarken yetenek sınırları hakkında kritik bilgiden yoksun olurdu, potansiyel olarak gerçekçi olmayan planlar üretebilir veya mevcut yaklaşımları gözden kaçırabilirdi.
+
+**Elindeki kartları bil, sonra nasıl oynayacağına karar ver.** Tools'un System'den önce gelmesinin arkasındaki bilişsel mantık budur.
+
+## MCP araçları neden bu konumda?
+
+MCP (Model Context Protocol) araçları, yerleşik araçlar gibi, Tools alanının en başına yerleştirilir. MCP'nin bağlamdaki konumunu anlamak, gerçek faydalarını ve maliyetlerini değerlendirmeye yardımcı olur.
+
+### MCP Avantajları
+
+- **Yetenek genişletme**: MCP, modellerin harici hizmetlere (veritabanı sorguları, API çağrıları, IDE işlemleri, tarayıcı kontrolü vb.) erişmesini sağlar ve yerleşik araçların sınırlarını aşar
+- **Açık ekosistem**: Herkes bir MCP sunucusu uygulayabilir; model yeniden eğitim olmadan yeni yetenekler kazanır
+- **İsteğe bağlı yükleme**: MCP sunucuları görev senaryosuna göre seçici olarak bağlanabilir/bağlantısı kesilebilir, esnek araç setleri oluşturulabilir
+
+### MCP Maliyetleri
+
+- **Önbellek katili**: Her MCP aracının JSON Schema tanımı KV-Cache ön ekinin en başına eklenir. Bir MCP aracı eklemek/kaldırmak = **tüm önbellek baştan geçersiz kılınır**. MCP sunucularını sık sık bağlama/bağlantı kesme, önbellek isabet oranını büyük ölçüde düşürür
+- **Ön ek şişmesi**: MCP araç Şemaları genellikle yerleşik araçlardan daha büyüktür (ayrıntılı parametre açıklamaları, enum değerleri vb.). Çok sayıda MCP aracı, Tools alanındaki token sayısını önemli ölçüde artırır ve Messages için kullanılabilir bağlam alanını daraltır
+- **Gecikme yükü**: MCP araç çağrıları süreçler arası iletişim gerektirir (stdio/SSE üzerinden JSON-RPC), yerleşik fonksiyon çağrılarından bir büyüklük derecesi daha yavaştır
+- **Kararlılık riski**: MCP sunucuları çökebilen, zaman aşımına uğrayabilen veya beklenmeyen formatlar döndürebilen harici süreçlerdir ve ek hata işleme gerektirir
+
+### Pratik Öneriler
+
+| Senaryo | Öneri |
+|---------|-------|
+| Uzun konuşmalar, sık etkileşim | Önbellek ön eki kararlılığını korumak için MCP araç sayısını minimize edin |
+| Kısa görevler, tek seferlik işlemler | MCP araçlarını serbestçe kullanın; önbellek etkisi sınırlıdır |
+| Sık MCP sunucusu ekleme/kaldırma | Her değişiklik tam önbellek yeniden oluşturmayı tetikler; araç setini sabitlemeyi düşünün |
+| Aşırı büyük Tool Şemaları | Ön ek token tüketimini azaltmak için açıklamaları ve enum'ları kısaltın |
+
+cc-viewer'ın Context panelinde, MCP araçları yerleşik araçlarla birlikte Tools alanında görüntülenir ve her aracın Şema boyutunu ve önbellek ön ekine katkısını net bir şekilde gösterir.

package/concepts/tr/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Translate API Bağlam Kirliliği
+
+## Arka Plan
+
+CC-Viewer, Anthropic Messages API tarafından desteklenen yerleşik bir çeviri özelliği (`POST /api/translate`) içerir. Erken uygulamada, çeviri istekleri Claude Code oturumundan önbelleğe alınmış kimlik doğrulama bilgilerini yeniden kullanıyordu — hem `x-api-key` hem de `authorization` başlıkları dahil. Bu, ince ama ciddi bir soruna neden oldu: çeviri sonuçları sıklıkla alakasız içerik döndürüyordu.
+
+## Temel Neden
+
+### İki Kimlik Doğrulama Yöntemi Arasındaki Temel Fark
+
+Anthropic API iki kimlik doğrulama yöntemini destekler:
+
+| Yöntem | Başlık | Tipik Kaynak | Özellikler |
+|--------|--------|--------------|------------|
+| API Anahtarı | `x-api-key: sk-ant-...` | Ortam değişkeni / Console | Durumsuz, her istek bağımsızdır |
+| OAuth Token | `authorization: Bearer sessionToken` | Claude Code abonelik girişi | Oturuma bağlı, sunucu bağlam ilişkilendirmesini sürdürür |
+
+Temel fark: **API Anahtarları durumsuz (stateless)** — her istek tamamen bağımsızdır; oysa **OAuth oturum tokenları durumlu (stateful)** — Anthropic sunucusu aynı tokeni kullanan istekleri aynı oturum bağlamıyla ilişkilendirir.
+
+### Kirlilik Zinciri
+
+Claude Code abonelik OAuth girişi kullandığında, kimlik doğrulama akışı şöyle görünür:
+
+```
+Claude Code ana konuşma ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                      ↑
+CC-Viewer çeviri isteği ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Çeviri istekleri aynı oturum tokenını yeniden kullandığından, Anthropic sunucusu çeviri isteklerini Claude Code'un ana konuşma bağlamıyla ilişkilendirebilir. Bu durum şunlara yol açar:
+
+1. **Çeviri sonuçları ana konuşma bağlamından etkilenir**: Çeviri isteğinin sistem promptu "sen bir çevirmensin" olmasına rağmen, sunucu bağlamı hâlâ Claude Code'un konuşma geçmişini içerir ve bu modeli potansiyel olarak etkileyebilir
+2. **Ana konuşma çeviri istekleri tarafından bozulur**: Çeviri isteği içeriği (UI metin parçaları) ana konuşma bağlamına enjekte edilebilir ve Claude Code'un yanıtlarının sapmasına neden olabilir
+3. **Öngörülemeyen davranış**: Bağlam kirliliği sunucu tarafı davranışı olduğundan, istemci bunu tespit edemez veya kontrol edemez
+
+## Çıkarılan Dersler
+
+- **OAuth oturum tokenları "sadece başka bir API Anahtarı" değildir** — sunucu tarafı durumu taşırlar, yeniden kullanmak bağlamı paylaşmak anlamına gelir
+- **Dahili servis çağrıları, kullanıcı oturumlarıyla ilişkilendirmeden kaçınmak için bağımsız, durumsuz kimlik doğrulama kullanmalıdır**
+
+## Referanslar
+
+- [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/tr/UltraPlan.md

@@ -0,0 +1,55 @@
+# UltraPlan — Nihai Dilek Makinesi
+
+## UltraPlan Nedir
+
+UltraPlan, cc-viewer'in Claude Code'un yerel `/ultraplan` komutunun **yerelleştirilmiş uygulamasıdır**. `/ultraplan`'ın tüm yeteneklerini **Claude'un resmi uzak hizmetini başlatmaya gerek kalmadan** yerel ortamınızda kullanmanızı sağlar ve Claude Code'u **çoklu ajan işbirliği** kullanarak karmaşık planlama ve uygulama görevlerini yerine getirmeye yönlendirir.
+
+Normal Plan modu veya Agent Team ile karşılaştırıldığında, UltraPlan şunları yapabilir:
+- Görev karmaşıklığını otomatik olarak değerlendirip optimal planlama stratejisini seçmek
+- Kod tabanını farklı boyutlardan keşfetmek için birden fazla paralel ajan dağıtmak
+- Sektördeki en iyi uygulamalar için harici araştırma (webSearch) dahil etmek
+- Plan yürütmesinden sonra kod incelemesi için otomatik olarak bir Code Review Ekibi oluşturmak
+- Tam bir **Planla → Yürüt → İncele → Düzelt** kapalı döngüsü oluşturmak
+
+---
+
+## Önemli Notlar
+
+### 1. UltraPlan Her Şeye Kadir Değildir
+UltraPlan daha güçlü bir dilek makinesidir, ancak bu her dileğin gerçekleştirilebileceği anlamına gelmez. Plan ve Agent Team'den daha güçlüdür, ancak doğrudan "size para kazandıramaz". Makul görev ayrıntı düzeyini göz önünde bulundurun — her şeyi tek seferde başarmaya çalışmak yerine büyük hedefleri yürütülebilir orta ölçekli görevlere bölün.
+
+### 2. Şu Anda Programlama Projeleri İçin En Etkili
+UltraPlan'ın şablonları ve iş akışları, programlama projeleri için derinlemesine optimize edilmiştir. Diğer senaryolar (dokümantasyon, veri analizi vb.) denenebilir, ancak gelecek sürüm uyarlamalarını beklemek isteyebilirsiniz.
+
+### 3. Yürütme Süresi ve Bağlam Penceresi Gereksinimleri
+- Başarılı bir UltraPlan çalıştırması genellikle **30 dakika veya daha fazla** sürer
+- MainAgent'in büyük bir bağlam penceresine sahip olmasını gerektirir (1M bağlamlı Opus modeli önerilir)
+- Yalnızca 200K modeliniz varsa, **çalıştırmadan önce bağlamı `/clear` ile temizlediğinizden emin olun**
+- Claude Code'un `/compact` komutu bağlam penceresi yetersiz olduğunda kötü performans gösterir — alanın tükenmesinden kaçının
+- Yeterli bağlam alanını korumak, başarılı UltraPlan yürütmesi için kritik bir ön koşuldur
+
+Yerelleştirilmiş UltraPlan hakkında sorularınız veya önerileriniz varsa, tartışmak ve işbirliği yapmak için [GitHub'da Issues](https://github.com/anthropics/claude-code/issues) açmaktan çekinmeyin.
+
+---
+
+## Nasıl Çalışır
+
+UltraPlan iki çalışma modu sunar:
+
+### Otomatik Mod
+Görev karmaşıklığını (puan 4-12) otomatik olarak analiz eder ve farklı stratejilere yönlendirir:
+
+| Rota | Puan | Strateji |
+|------|------|----------|
+| Rota A | 4-6 | Doğrudan kod keşfi ile hafif planlama |
+| Rota B | 7-9 | Yapısal diyagramlarla planlama (Mermaid / ASCII) |
+| Rota C | 10-12 | Çoklu ajan keşfi + inceleme kapalı döngüsü |
+
+### Zorunlu Mod
+Rota C'nin tam çoklu ajan iş akışını doğrudan etkinleştirir:
+1. Kod tabanını eş zamanlı olarak keşfetmek için 5'e kadar paralel ajan dağıtma (mimari, dosya tanımlama, risk değerlendirmesi vb.)
+2. İsteğe bağlı olarak webSearch aracılığıyla sektör çözümlerini araştırmak için bir araştırma ajanı dağıtma
+3. Tüm ajan bulgularını ayrıntılı bir uygulama planında sentezleme
+4. Planı birden fazla perspektiften incelemek için bir inceleme ajanı dağıtma
+5. Onaylandıktan sonra planı yürütme
+6. Uygulamadan sonra kod kalitesini doğrulamak için otomatik olarak bir Code Review Ekibi oluşturma

package/concepts/uk/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (Інкрементальне порівняння тіла запиту)
+
+## Передумови
+
+MainAgent Claude Code використовує механізм повного надсилання контексту — кожен запит містить повну історію розмови, system prompt, визначення інструментів тощо. Це означає, що в міру просування розмови тіло запиту стає дедалі більшим, і безпосередній перегляд необробленого Body ускладнює швидке визначення того, "що саме було додано в цьому раунді".
+
+Body Diff JSON створений саме для вирішення цієї проблеми: він автоматично порівнює тіла двох послідовних запитів MainAgent, витягує інкрементальну частину і дозволяє одразу побачити, що саме було додано в цьому запиті.
+
+## Принцип роботи
+
+1. **Ідентифікація послідовних запитів MainAgent**: Поточний запит повинен бути типу MainAgent, і повинен існувати попередній запит MainAgent
+2. **Порівняння по полях**: Переглядаються всі поля верхнього рівня тіла запиту, внутрішні властивості з префіксом `_` пропускаються
+3. **Інтелектуальне витягування різниць**:
+   - Додані поля: Відображаються безпосередньо
+   - Видалені поля: Не відображаються (зазвичай не впливають на розуміння)
+   - Змінені поля: Відображається поточне значення
+   - Масив `messages` обробляється спеціально: Показуються лише додані повідомлення (оскільки в нормальній розмові використовується режим додавання, префіксні повідомлення не змінюються)
+4. **Виявлення зменшення тіла запиту**: Якщо поточне тіло запиту менше за попереднє, це означає, що відбулося обрізання контексту або скидання сесії; в цьому випадку замість diff відображається інформаційне повідомлення
+
+## Типові сценарії
+
+У звичайному раунді розмови Body Diff JSON зазвичай містить лише:
+- `messages`: 1~2 додані повідомлення (введення користувача + відповідь асистента з попереднього раунду)
+
+Якщо ви бачите в diff зміни полів `system`, `tools`, `model`, це означає, що в цьому раунді відбулася зміна конфігурації, що зазвичай є причиною перебудови кешу.
+
+## Спосіб використання
+
+- Body Diff JSON відображається на панелі деталей запиту MainAgent
+- Натисніть на заголовок, щоб розгорнути/згорнути
+- Підтримуються два режими перегляду — JSON і Text, а також копіювання одним кліком
+- У лівому верхньому куті в **CC-Viewer → Глобальні налаштування** можна встановити "Розгортати Body Diff JSON за замовчуванням"

package/concepts/uk/BodyFields.md

@@ -0,0 +1,42 @@
+# Опис полів Request Body
+
+Опис полів верхнього рівня request body Claude API `/v1/messages`.
+
+## Список полів
+
+| Поле | Тип | Опис |
+|------|------|------|
+| **model** | string | Назва використовуваної моделі, наприклад `claude-opus-4-6`, `claude-sonnet-4-6` |
+| **messages** | array | Історія повідомлень розмови. Кожне повідомлення містить `role` (user/assistant) та `content` (масив блоків: текст, зображення, tool_use, tool_result тощо) |
+| **system** | array | System prompt. Містить основні інструкції Codex, вказівки щодо використання інструментів, інформацію про середовище, вміст CLAUDE.md тощо. Блоки з `cache_control` кешуються через prompt caching |
+| **tools** | array | Список визначень доступних інструментів. Кожен інструмент містить `name`, `description` та `input_schema` (JSON Schema). MainAgent зазвичай має 20+ інструментів, SubAgent має лише кілька |
+| **metadata** | object | Метадані запиту, зазвичай містить `user_id` для ідентифікації користувача |
+| **max_tokens** | number | Максимальна кількість токенів в одній відповіді моделі, наприклад `16000`, `64000` |
+| **thinking** | object | Конфігурація розширеного мислення. `type: "enabled"` вмикає режим мислення, `budget_tokens` контролює верхню межу токенів мислення |
+| **context_management** | object | Конфігурація управління контекстом. `truncation: "auto"` дозволяє Codex автоматично скорочувати занадто довгу історію повідомлень |
+| **output_config** | object | Конфігурація виводу, наприклад налаштування `format` |
+| **stream** | boolean | Чи увімкнено потокову відповідь. Codex завжди використовує `true` |
+
+## Структура messages
+
+`content` кожного повідомлення — це масив блоків, типові типи:
+
+- **text**: Звичайний текстовий вміст
+- **tool_use**: Модель викликає інструмент (містить `name`, `input`)
+- **tool_result**: Результат виконання інструменту (містить `tool_use_id`, `content`)
+- **image**: Вміст зображення (base64 або URL)
+- **thinking**: Процес мислення моделі (режим розширеного мислення)
+
+## Структура system
+
+Масив system prompt зазвичай містить:
+
+1. **Основні інструкції агента** ("You are Codex...")
+2. **Правила використання інструментів**
+3. **Вміст CLAUDE.md** (інструкції на рівні проекту)
+4. **Нагадування про навички** (skills reminder)
+5. **Інформація про середовище** (OS, shell, статус git тощо) — фактично Codex дуже залежить від git. Якщо проект має git-репозиторій, Codex може демонструвати краще розуміння проекту, включаючи отримання віддалених змін та історії комітів для аналізу
+
+Блоки, позначені `cache_control: { type: "ephemeral" }`, кешуються Anthropic API на 5 хвилин. При влученні в кеш вони тарифікуються як `cache_read_input_tokens` (значно дешевше за `input_tokens`).
+
+> **Зверніть увагу**: Для спеціалізованих клієнтів, таких як Codex, сервер Anthropic фактично не повністю покладається на атрибут `cache_control` у запиті для визначення поведінки кешування. Сервер автоматично застосовує стратегії кешування для певних полів (таких як system prompt та визначення tools), навіть якщо запит явно не містить позначки `cache_control`. Тому не дивуйтесь, коли не бачите цей атрибут у request body — сервер уже виконав операцію кешування за лаштунками, просто не розкриває цю інформацію клієнту. Це негласна домовленість між Codex та Anthropic API.

package/concepts/uk/CacheRebuild.md

@@ -0,0 +1,36 @@
+# Cache Rebuild (Перебудова кешу)
+
+## Передумови
+
+Механізм prompt caching від Anthropic послідовно об'єднує system → tools → messages (до cache breakpoint) у запиті для формування ключа кешу. Коли ключ кешу повністю збігається з попереднім запитом, API повертає `cache_read_input_tokens` (влучання в кеш); коли ключ кешу змінюється, API створює кеш заново і повертає велику кількість `cache_creation_input_tokens`, тобто відбувається перебудова кешу.
+
+Перебудова кешу означає додаткову тарифікацію токенів (ціна cache creation вища за cache read), тому визначення причини перебудови має пряму цінність для оптимізації витрат.
+
+## Класифікація причин перебудови кешу
+
+cc-viewer порівнює тіла двох послідовних запитів MainAgent для точного визначення причини перебудови кешу:
+
+| reason | Значення | Спосіб визначення |
+|--------|----------|-------------------|
+| `ttl` | Кеш протермінувався | З моменту попереднього запиту MainAgent минуло більше 5 хвилин |
+| `system_change` | Зміна system prompt | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Зміна визначень інструментів | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Зміна моделі | `prev.model !== curr.model` |
+| `msg_truncated` | Стек повідомлень обрізано | Кількість messages у поточному запиті менша за попередній, зазвичай спричинено переповненням контекстного вікна |
+| `msg_modified` | Історичні повідомлення змінено | Вміст префіксних повідомлень не збігається (при нормальному додаванні префікс повинен бути ідентичним) |
+| `key_change` | Невідома зміна ключа | Fallback, коли жодна з вищезазначених умов не збігається |
+
+## Пріоритет визначення
+
+1. Спочатку перевіряється часовий інтервал — якщо минуло більше 5 хвилин, одразу визначається як `ttl`, порівняння body не виконується
+2. Потім послідовно перевіряються model, system, tools, messages
+3. Один запит може одночасно мати кілька причин (наприклад, зміна моделі + зміна system prompt), у цьому випадку масив `reasons` містить усі збіги, tooltip відображає їх порядково
+
+## Типові сценарії
+
+- **`ttl`**: Користувач призупинив роботу більш ніж на 5 хвилин і потім продовжив, кеш природно протермінувався
+- **`system_change`**: Claude Code оновив system prompt (наприклад, завантажено новий CLAUDE.md, змінилися project instructions)
+- **`tools_change`**: Підключення/відключення MCP server призвело до зміни списку доступних інструментів
+- **`model_change`**: Користувач змінив модель командою `/model`
+- **`msg_truncated`**: Занадто довга розмова спричинила управління контекстним вікном, Claude Code обрізав ранні повідомлення
+- **`msg_modified`**: Claude Code відредагував історичні повідомлення (наприклад, `/compact` стиснення замінило оригінальні повідомлення зведенням)