cx-viewer 1.0.2 → 1.0.4

package/concepts/pt-BR/Tool-TaskStop.md

@@ -1,32 +0,0 @@
-# TaskStop
-
-## Definição
-
-Para uma tarefa em segundo plano que está em execução.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `task_id` | string | Não | ID da tarefa em segundo plano a parar |
-| `shell_id` | string | Não | Descontinuado, use `task_id` em vez disso |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Encerrar tarefas de longa duração que não são mais necessárias
-- Cancelar tarefas em segundo plano iniciadas por engano
-
-## Observações
-
-- Retorna status de sucesso ou falha
-- O parâmetro `shell_id` está descontinuado, deve-se usar `task_id`
-
-## Texto original
-
-<textarea readonly>
-- Stops a running background task by its ID
-- Takes a task_id parameter identifying the task to stop
-- Returns a success or failure status
-- Use this tool when you need to terminate a long-running task
-</textarea>

package/concepts/pt-BR/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## Definição
-
-Atualiza o status, conteúdo ou dependências de uma tarefa na lista de tarefas.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `taskId` | string | Sim | ID da tarefa a atualizar |
-| `status` | enum | Não | Novo status: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Não | Novo título |
-| `description` | string | Não | Nova descrição |
-| `activeForm` | string | Não | Texto no gerúndio exibido quando em andamento |
-| `owner` | string | Não | Novo responsável pela tarefa (nome do agent) |
-| `metadata` | object | Não | Metadados a mesclar (definir como null para excluir chave) |
-| `addBlocks` | string[] | Não | Lista de IDs de tarefas bloqueadas por esta tarefa |
-| `addBlockedBy` | string[] | Não | Lista de IDs de tarefas pré-requisito que bloqueiam esta tarefa |
-
-## Fluxo de Status
-
-```
-pending → in_progress → completed
-```
-
-`deleted` pode ser atingido a partir de qualquer status, removendo permanentemente a tarefa.
-
-## Cenários de Uso
-
-**Adequado para:**
-- Marcar tarefa como `in_progress` ao iniciar o trabalho
-- Marcar tarefa como `completed` após concluir o trabalho
-- Definir dependências entre tarefas
-- Atualizar conteúdo da tarefa quando requisitos mudam
-
-**Regras importantes:**
-- Só marcar como `completed` quando a tarefa estiver totalmente concluída
-- Manter como `in_progress` ao encontrar erros ou bloqueios
-- Não marcar como `completed` quando testes falham, implementação está incompleta ou há erros não resolvidos
-
-## Observações
-
-- Antes de atualizar, deve-se obter o status mais recente da tarefa via TaskGet para evitar dados desatualizados
-- Após concluir uma tarefa, chamar TaskList para encontrar a próxima tarefa disponível
-
-## Texto original
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
-
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
-
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
-
-## Fields You Can Update
-
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-Make sure to read a task's latest state using `TaskGet` before updating it.
-
-## Examples
-
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
-
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
-```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
-```
-
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
-
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>

package/concepts/pt-BR/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## Definição
-
-Cria uma nova equipe para coordenar múltiplos agents trabalhando em um projeto. As equipes permitem execução paralela de tarefas por meio de uma lista de tarefas compartilhada e troca de mensagens entre agents.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|-----------|------|-------------|-----------|
-| `team_name` | string | Sim | Nome para a nova equipe |
-| `description` | string | Não | Descrição / propósito da equipe |
-| `agent_type` | string | Não | Tipo / papel do líder da equipe |
-
-## O que é criado
-
-- **Arquivo de configuração da equipe**: `~/.claude/teams/{team-name}/config.json` — armazena lista de membros e metadados
-- **Diretório da lista de tarefas**: `~/.claude/tasks/{team-name}/` — lista de tarefas compartilhada para todos os integrantes
-
-Equipes têm correspondência 1:1 com listas de tarefas.
-
-## Fluxo de trabalho da equipe
-
-1. **TeamCreate** — criar a equipe e sua lista de tarefas
-2. **TaskCreate** — definir tarefas para a equipe
-3. **Agent** (com `team_name` + `name`) — iniciar integrantes que entram na equipe
-4. **TaskUpdate** — atribuir tarefas aos integrantes via `owner`
-5. Integrantes trabalham nas tarefas e se comunicam via **SendMessage**
-6. Encerrar integrantes ao concluir, depois **TeamDelete** para limpeza
-
-## Ferramentas relacionadas
-
-| Ferramenta | Finalidade |
-|------------|------------|
-| `TeamDelete` | Remover equipe e diretórios de tarefas |
-| `SendMessage` | Comunicação entre agents dentro da equipe |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gerenciar a lista de tarefas compartilhada |
-| `Agent` | Iniciar integrantes que entram na equipe |

package/concepts/pt-BR/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## Definição
-
-Remove uma equipe e seus diretórios de tarefas associados quando o trabalho de colaboração multi-agent é concluído. Esta é a contrapartida de limpeza do TeamCreate.
-
-## Comportamento
-
-- Remove o diretório da equipe: `~/.claude/teams/{team-name}/`
-- Remove o diretório de tarefas: `~/.claude/tasks/{team-name}/`
-- Limpa o contexto da equipe da sessão atual
-
-**Importante**: TeamDelete falhará se a equipe ainda tiver integrantes ativos. Os integrantes devem ser encerrados graciosamente primeiro via solicitações de shutdown do SendMessage.
-
-## Uso típico
-
-TeamDelete é chamado no final de um fluxo de trabalho de equipe:
-
-1. Todas as tarefas estão concluídas
-2. Integrantes são encerrados via `SendMessage` com `shutdown_request`
-3. **TeamDelete** remove os diretórios de equipe e tarefas
-
-## Ferramentas relacionadas
-
-| Ferramenta | Finalidade |
-|------------|------------|
-| `TeamCreate` | Criar uma nova equipe e sua lista de tarefas |
-| `SendMessage` | Comunicar com integrantes / enviar solicitações de shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gerenciar a lista de tarefas compartilhada |
-| `Agent` | Iniciar integrantes que entram na equipe |

package/concepts/pt-BR/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## Definição
-
-Busca o conteúdo de uma URL especificada, converte HTML para markdown e processa o conteúdo usando um modelo de IA com base no prompt.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `url` | string (URI) | Sim | URL completa a ser buscada |
-| `prompt` | string | Sim | Descreve que informação extrair da página |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Obter conteúdo de páginas web públicas
-- Consultar documentação online
-- Extrair informações específicas de páginas web
-
-**Não adequado para:**
-- URLs que requerem autenticação (Google Docs, Confluence, Jira, GitHub, etc.) — deve primeiro procurar ferramentas MCP dedicadas
-- URLs do GitHub — prefira usar o CLI `gh`
-
-## Observações
-
-- A URL deve ser uma URL válida completa
-- HTTP é automaticamente atualizado para HTTPS
-- Resultados podem ser resumidos quando o conteúdo é muito grande
-- Inclui cache com auto-limpeza de 15 minutos
-- Quando a URL redireciona para um host diferente, a ferramenta retorna a URL de redirecionamento, sendo necessário fazer nova requisição com a nova URL
-- Se houver uma ferramenta web fetch fornecida por MCP disponível, prefira usá-la
-
-## Texto original
-
-<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/pt-BR/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## Definição
-
-Executa consultas em mecanismo de busca, retornando resultados de pesquisa para obter informações atualizadas.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `query` | string | Sim | Consulta de busca (mínimo 2 caracteres) |
-| `allowed_domains` | string[] | Não | Incluir apenas resultados destes domínios |
-| `blocked_domains` | string[] | Não | Excluir resultados destes domínios |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Obter informações atualizadas além da data de corte do conhecimento do modelo
-- Buscar eventos atuais e dados recentes
-- Pesquisar documentação técnica mais recente
-
-## Observações
-
-- Os resultados de busca são retornados em formato de hyperlinks markdown
-- Após o uso, é obrigatório incluir uma seção "Sources:" no final da resposta, listando as URLs relevantes
-- Suporta filtragem de domínios (inclusão/exclusão)
-- A consulta de busca deve usar o ano atual
-- Disponível apenas nos EUA
-
-## Texto original
-
-<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/pt-BR/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## Definição
-
-Escreve conteúdo no sistema de arquivos local. Se o arquivo já existir, será sobrescrito.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `file_path` | string | Sim | Caminho absoluto do arquivo (deve ser caminho absoluto) |
-| `content` | string | Sim | Conteúdo a ser escrito |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Criar novos arquivos
-- Quando é necessário reescrever completamente o conteúdo do arquivo
-
-**Não adequado para:**
-- Modificar conteúdo parcial de um arquivo — deve usar Edit
-- Não deve criar proativamente arquivos de documentação (*.md) ou README, a menos que o usuário solicite explicitamente
-
-## Observações
-
-- Se o arquivo de destino já existir, é obrigatório lê-lo primeiro via Read, caso contrário falhará
-- Sobrescreve todo o conteúdo do arquivo existente
-- Prefira usar Edit para editar arquivos existentes; Write é apenas para criar novos arquivos ou reescrita completa
-
-## Texto original
-
-<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/pt-BR/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Definição
-
-Executa código Python no kernel Jupyter do arquivo notebook atual.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `code` | string | Sim | Código Python a ser executado |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Executar código em ambiente Jupyter notebook
-- Testar trechos de código
-- Análise de dados e cálculos
-
-**Não adequado para:**
-- Execução de código fora do ambiente Jupyter — deve usar Bash
-- Modificar arquivos — deve usar Edit ou Write
-
-## Observações
-
-- Esta é uma ferramenta MCP (Model Context Protocol), fornecida pela integração com IDE
-- O código é executado no kernel Jupyter atual, o estado persiste entre chamadas
-- A menos que o usuário solicite explicitamente, deve-se evitar declarar variáveis ou modificar o estado do kernel
-- O estado é perdido após reiniciar o kernel
-
-## Texto original
-
-<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/pt-BR/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## Definição
-
-Obtém informações de diagnóstico de linguagem do VS Code, incluindo erros de sintaxe, erros de tipo, avisos de lint, etc.
-
-## Parâmetros
-
-| Parâmetro | Tipo | Obrigatório | Descrição |
-|------|------|------|------|
-| `uri` | string | Não | URI do arquivo. Se não fornecido, obtém diagnósticos de todos os arquivos |
-
-## Cenários de Uso
-
-**Adequado para:**
-- Verificar problemas semânticos como sintaxe, tipos e lint no código
-- Verificar se novas edições introduziram erros
-- Substituir comandos Bash para verificar qualidade do código
-
-**Não adequado para:**
-- Executar testes — deve usar Bash
-- Verificar erros de runtime — deve usar Bash para executar o código
-
-## Observações
-
-- Esta é uma ferramenta MCP (Model Context Protocol), fornecida pela integração com IDE
-- Disponível apenas em ambiente VS Code / IDE
-- Prefira usar esta ferramenta em vez de comandos Bash para verificar problemas no código
-
-## Texto original
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/pt-BR/Tools.md

@@ -1,67 +0,0 @@
-# Visão Geral das Ferramentas do Claude Code
-
-O Claude Code fornece ao modelo um conjunto de ferramentas integradas através do mecanismo tool_use da API da Anthropic. O array `tools` de cada requisição MainAgent contém as definições completas em JSON Schema dessas ferramentas, e o modelo as invoca através de content blocks `tool_use` na resposta.
-
-A seguir está o índice categorizado de todas as ferramentas.
-
-## Sistema de Agents
-
-| Ferramenta | Finalidade |
-|------|------|
-| [Task](Tool-Task.md) | Iniciar um sub-agent (SubAgent) para processar tarefas complexas de múltiplas etapas |
-| [TaskOutput](Tool-TaskOutput.md) | Obter a saída de tarefas em segundo plano |
-| [TaskStop](Tool-TaskStop.md) | Parar uma tarefa em segundo plano em execução |
-| [TaskCreate](Tool-TaskCreate.md) | Criar uma entrada na lista de tarefas estruturada |
-| [TaskGet](Tool-TaskGet.md) | Obter detalhes de uma tarefa |
-| [TaskUpdate](Tool-TaskUpdate.md) | Atualizar status, dependências, etc. de uma tarefa |
-| [TaskList](Tool-TaskList.md) | Listar todas as tarefas |
-
-## Operações de Arquivo
-
-| Ferramenta | Finalidade |
-|------|------|
-| [Read](Tool-Read.md) | Ler conteúdo de arquivo (suporta texto, imagens, PDF, Jupyter notebook) |
-| [Edit](Tool-Edit.md) | Editar arquivo através de substituição exata de string |
-| [Write](Tool-Write.md) | Escrever ou sobrescrever arquivo |
-| [NotebookEdit](Tool-NotebookEdit.md) | Editar células de Jupyter notebook |
-
-## Busca
-
-| Ferramenta | Finalidade |
-|------|------|
-| [Glob](Tool-Glob.md) | Buscar arquivos por padrão de nome de arquivo |
-| [Grep](Tool-Grep.md) | Busca de conteúdo de arquivo baseada em ripgrep |
-
-## Terminal
-
-| Ferramenta | Finalidade |
-|------|------|
-| [Bash](Tool-Bash.md) | Executar comandos shell |
-
-## Web
-
-| Ferramenta | Finalidade |
-|------|------|
-| [WebFetch](Tool-WebFetch.md) | Buscar conteúdo de página web e processar com IA |
-| [WebSearch](Tool-WebSearch.md) | Consulta em mecanismo de busca |
-
-## Planejamento e Interação
-
-| Ferramenta | Finalidade |
-|------|------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | Entrar no modo de planejamento para projetar plano de implementação |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | Sair do modo de planejamento e submeter plano para aprovação do usuário |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | Fazer perguntas ao usuário para obter esclarecimentos ou decisões |
-
-## Extensões
-
-| Ferramenta | Finalidade |
-|------|------|
-| [Skill](Tool-Skill.md) | Executar skill (slash command) |
-
-## Integração com IDE
-
-| Ferramenta | Finalidade |
-|------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Obter informações de diagnóstico de linguagem do VS Code |
-| [executeCode](Tool-executeCode.md) | Executar código no kernel Jupyter |

package/concepts/ru/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild (пересборка кеша)
-
-## Контекст
-
-Механизм prompt caching Anthropic объединяет system → tools → messages (до точки разрыва кеша) в ключ кеша. Когда ключ кеша совпадает с предыдущим запросом, 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` | Обрезка стека сообщений | В текущем запросе меньше сообщений, чем в предыдущем, обычно из-за обрезки при переполнении контекстного окна |
-| `msg_modified` | Изменение истории сообщений | Содержимое префиксных сообщений не совпадает (при нормальном добавлении префикс должен быть идентичным) |
-| `key_change` | Неизвестное изменение ключа | Fallback, когда ни одно из вышеуказанных условий не совпало |
-
-## Приоритет определения
-
-1. Сначала проверяется временной интервал — более 5 минут означает `ttl`, без сравнения тел
-2. Затем последовательно проверяются: model, system, tools, messages
-3. Один запрос может одновременно соответствовать нескольким причинам (например, смена модели + изменение system prompt), тогда массив `reasons` содержит все совпавшие элементы, а tooltip отображает их построчно
-
-## Типичные сценарии
-
-- **`ttl`**: пользователь приостановил работу более чем на 5 минут, кеш естественно истёк
-- **`system_change`**: Claude Code обновил system prompt (например, загрузка нового CLAUDE.md, изменение инструкций проекта)
-- **`tools_change`**: подключение/отключение MCP-сервера привело к изменению списка доступных инструментов
-- **`model_change`**: пользователь переключил модель командой `/model`
-- **`msg_truncated`**: слишком длинный диалог вызвал управление контекстным окном, Claude Code обрезал ранние сообщения
-- **`msg_modified`**: Claude Code отредактировал исторические сообщения (например, `/compact` заменил оригинальные сообщения сжатым резюме)

package/concepts/ru/KVCacheContent.md

@@ -1,49 +0,0 @@
-# Содержимое KV-Cache
-
-## Что такое Prompt Caching?
-
-Когда вы общаетесь с Claude, каждый API-запрос отправляет полный контекст диалога (системный промпт + определения инструментов + история сообщений). Механизм prompt caching от Anthropic кэширует уже вычисленное содержимое префикса на стороне сервера, и если префикс последующих запросов совпадает, результат кэша используется повторно, минуя повторные вычисления, что значительно снижает задержку и стоимость.
-
-В cc-viewer этот механизм называется "KV-Cache", и он соответствует prompt caching на уровне Anthropic API, а не key-value cache в слоях внимания transformer внутри LLM.
-
-## Как работает кэширование
-
-Prompt caching от Anthropic объединяет ключи кэша в фиксированном порядке:
-
-```
-Tools → System Prompt → Messages (до точки разрыва кэша)
-```
-
-Если этот префикс полностью совпадает с любым запросом в окне TTL, API попадает в кэш (возвращая `cache_read_input_tokens`), а не выполняет повторное вычисление (`cache_creation_input_tokens`).
-
-> **Claude Code не зависит жёстко от атрибута `cache_control`, серверная сторона удаляет часть этих атрибутов, но по-прежнему успешно создаёт кэш, поэтому отсутствие атрибута `cache_control` не означает, что кэширование не работает**
->
-> Для специальных клиентов, таких как Claude Code, серверная сторона Anthropic не полностью полагается на атрибут `cache_control` в запросе для определения поведения кэширования. Сервер автоматически выполняет стратегию кэширования для определённых полей (таких как системный промпт, определения инструментов), даже если в запросе явно не указана метка `cache_control`. Поэтому, когда вы не видите этот атрибут в теле запроса, не стоит удивляться — сервер уже выполнил операцию кэширования за кулисами, просто не раскрывая эту информацию клиенту. Это негласное соглашение между Claude Code и Anthropic API.
-
-## Что такое "Текущее содержимое KV-Cache"?
-
-"Текущее содержимое KV-Cache", отображаемое в cc-viewer, извлекается из последнего запроса MainAgent и представляет содержимое, расположенное перед границей кэша (cache breakpoint). Конкретно включает:
-
-- **System Prompt**: Системные инструкции Claude Code, включая основные инструкции агента, правила использования инструментов, инструкции проекта CLAUDE.md, информацию об окружении и т.д.
-- **Tools**: Список определений доступных инструментов (таких как Read, Write, Bash, Agent, MCP-инструменты и т.д.)
-- **Messages**: Часть истории диалога, которая находится в кэше (обычно более ранние сообщения, до последней метки `cache_control`)
-
-## Зачем просматривать содержимое кэша?
-
-1. **Понимание контекста**: Узнайте, какое содержимое Claude "помнит" в данный момент, помогая вам определить, соответствует ли его поведение ожиданиям
-2. **Оптимизация затрат**: При попадании в кэш стоимость намного ниже, чем при пересчёте. Просмотр содержимого кэша помогает понять, почему определённые запросы вызвали перестроение кэша (cache rebuild)
-3. **Отладка диалога**: Когда ответ Claude не соответствует ожиданиям, проверка содержимого кэша подтверждает, правильны ли системный промпт и история сообщений
-4. **Мониторинг качества контекста**: В процессе отладки, изменения конфигурации или настройки промптов KV-Cache-Text предоставляет централизованное представление, помогая вам быстро подтвердить, не произошла ли деградация основного контекста или загрязнение неожиданным содержимым — без необходимости просматривать исходные сообщения по одному
-
-## Многоуровневая стратегия кэширования
-
-KV-Cache, соответствующий Claude Code, не является единственным. Серверная сторона генерирует отдельные кэши для Tools и System Prompt, независимые от кэша Messages. Преимущество такого дизайна в том, что когда стек messages нарушается (обрезка контекста, изменение сообщений и т.д.) и требуется перестроение, кэши Tools и System Prompt не инвалидируются вместе с ним, что позволяет избежать полного пересчёта.
-
-Это оптимизационная стратегия серверной стороны на текущем этапе — поскольку определения Tools и System Prompt при нормальном использовании относительно стабильны и редко меняются, раздельное кэширование позволяет максимально сократить ненужные затраты на перестроение. Поэтому при наблюдении за Cache вы обнаружите, что помимо перестроения Tools, которое требует полного обновления всех кэшей, нарушение System Prompt и Messages по-прежнему оставляет доступные унаследованные кэши.
-
-## Жизненный цикл кэша
-
-- **Создание**: При первом запросе или после инвалидации кэша API создаёт новый кэш (`cache_creation_input_tokens`)
-- **Попадание**: При последующих запросах с идентичным префиксом кэш повторно используется (`cache_read_input_tokens`)
-- **Истечение**: Кэш имеет TTL (время жизни) 5 минут и автоматически истекает по окончании этого периода
-- **Перестроение**: Когда системный промпт, список инструментов, модель или содержимое сообщений изменяются, ключ кэша не совпадает, вызывая перестроение соответствующего уровня кэша