cx-viewer 1.0.3 → 1.0.4

package/concepts/ru/Tool-TaskStop.md

@@ -1,32 +0,0 @@
-# TaskStop
-
-## Определение
-
-Останавливает работающую фоновую задачу.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `task_id` | string | Нет | ID фоновой задачи для остановки |
-| `shell_id` | string | Нет | Устарел, используйте `task_id` вместо этого |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Завершение долго работающей задачи, которая больше не нужна
-- Отмена ошибочно запущенной фоновой задачи
-
-## Примечания
-
-- Возвращает статус успеха или неудачи
-- Параметр `shell_id` устарел, следует использовать `task_id`
-
-## Оригинальный текст
-
-<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/ru/Tool-TaskUpdate.md

@@ -1,123 +0,0 @@
-# TaskUpdate
-
-## Определение
-
-Обновляет статус, содержимое или зависимости задачи в списке задач.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `taskId` | string | Да | ID задачи для обновления |
-| `status` | enum | Нет | Новый статус: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Нет | Новый заголовок |
-| `description` | string | Нет | Новое описание |
-| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения |
-| `owner` | string | Нет | Новый ответственный за задачу (имя агента) |
-| `metadata` | object | Нет | Метаданные для слияния (установка в null удаляет ключ) |
-| `addBlocks` | string[] | Нет | Список ID задач, заблокированных этой задачей |
-| `addBlockedBy` | string[] | Нет | Список ID предшествующих задач, блокирующих эту задачу |
-
-## Переход статусов
-
-```
-pending → in_progress → completed
-```
-
-`deleted` может быть установлен из любого статуса, безвозвратно удаляет задачу.
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Пометка задачи как `in_progress` при начале работы
-- Пометка задачи как `completed` после завершения работы
-- Установка зависимостей между задачами
-- Обновление содержимого задачи при изменении требований
-
-**Важные правила:**
-- Помечайте как `completed` только при полном завершении задачи
-- При ошибках или блокировках сохраняйте статус `in_progress`
-- Не помечайте как `completed`, когда тесты не проходят, реализация неполная или возникли неразрешённые ошибки
-
-## Примечания
-
-- Перед обновлением следует получить актуальное состояние задачи через TaskGet, чтобы избежать устаревших данных
-- После завершения задачи вызовите TaskList для поиска следующей доступной задачи
-
-## Оригинальный текст
-
-<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/ru/Tool-TeamCreate.md

@@ -1,38 +0,0 @@
-# TeamCreate
-
-## Определение
-
-Создаёт новую команду для координации нескольких агентов, работающих над проектом. Команды обеспечивают параллельное выполнение задач через общий список задач и межагентный обмен сообщениями.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|----------|-----|--------------|----------|
-| `team_name` | string | Да | Название новой команды |
-| `description` | string | Нет | Описание / назначение команды |
-| `agent_type` | string | Нет | Тип / роль руководителя команды |
-
-## Что создаётся
-
-- **Файл конфигурации команды**: `~/.claude/teams/{team-name}/config.json` — хранит список участников и метаданные
-- **Каталог списка задач**: `~/.claude/tasks/{team-name}/` — общий список задач для всех участников команды
-
-Команды имеют соответствие 1:1 со списками задач.
-
-## Рабочий процесс команды
-
-1. **TeamCreate** — создать команду и её список задач
-2. **TaskCreate** — определить задачи для команды
-3. **Agent** (с `team_name` + `name`) — запустить участников, вступающих в команду
-4. **TaskUpdate** — назначить задачи участникам через `owner`
-5. Участники работают над задачами и общаются через **SendMessage**
-6. Завершить работу участников, затем **TeamDelete** для очистки
-
-## Связанные инструменты
-
-| Инструмент | Назначение |
-|------------|------------|
-| `TeamDelete` | Удалить команду и каталоги задач |
-| `SendMessage` | Межагентное взаимодействие внутри команды |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
-| `Agent` | Запустить участников, вступающих в команду |

package/concepts/ru/Tool-TeamDelete.md

@@ -1,30 +0,0 @@
-# TeamDelete
-
-## Определение
-
-Удаляет команду и связанные каталоги задач после завершения работы в рамках многоагентного взаимодействия. Является операцией очистки, обратной по отношению к TeamCreate.
-
-## Поведение
-
-- Удаляет каталог команды: `~/.claude/teams/{team-name}/`
-- Удаляет каталог списка задач: `~/.claude/tasks/{team-name}/`
-- Очищает контекст команды из текущей сессии
-
-**Важно**: TeamDelete завершится ошибкой, если в команде ещё есть активные участники. Сначала необходимо корректно завершить работу всех участников через запросы shutdown в SendMessage.
-
-## Типичное использование
-
-TeamDelete вызывается в конце рабочего процесса команды:
-
-1. Все задачи выполнены
-2. Участники завершают работу через `SendMessage` с `shutdown_request`
-3. **TeamDelete** удаляет каталоги команды и задач
-
-## Связанные инструменты
-
-| Инструмент | Назначение |
-|------------|------------|
-| `TeamCreate` | Создать новую команду и её список задач |
-| `SendMessage` | Взаимодействие с участниками команды / отправка запросов shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
-| `Agent` | Запустить участников, вступающих в команду |

package/concepts/ru/Tool-WebFetch.md

@@ -1,55 +0,0 @@
-# WebFetch
-
-## Определение
-
-Получает содержимое веб-страницы по указанному URL, конвертирует HTML в markdown и обрабатывает содержимое с помощью AI-модели согласно prompt.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `url` | string (URI) | Да | Полный URL для получения |
-| `prompt` | string | Да | Описание информации для извлечения со страницы |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Получение содержимого публичных веб-страниц
-- Просмотр онлайн-документации
-- Извлечение определённой информации с веб-страниц
-
-**Неподходящее применение:**
-- URL, требующие аутентификации (Google Docs, Confluence, Jira, GitHub и т.д.) — сначала поищите специализированный инструмент MCP
-- URL GitHub — предпочитайте использование `gh` CLI
-
-## Примечания
-
-- URL должен быть полным, валидным URL
-- HTTP автоматически обновляется до HTTPS
-- Слишком большое содержимое может быть сокращено
-- Включает 15-минутный самоочищающийся кеш
-- Когда URL перенаправляет на другой хост, инструмент возвращает URL перенаправления — необходимо повторить запрос с новым URL
-- Если доступен инструмент web fetch, предоставляемый MCP, предпочитайте его использование
-
-## Оригинальный текст
-
-<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/ru/Tool-WebSearch.md

@@ -1,58 +0,0 @@
-# WebSearch
-
-## Определение
-
-Выполняет запрос к поисковой системе, возвращая результаты поиска для получения актуальной информации.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `query` | string | Да | Поисковый запрос (минимум 2 символа) |
-| `allowed_domains` | string[] | Нет | Включать только результаты с этих доменов |
-| `blocked_domains` | string[] | Нет | Исключать результаты с этих доменов |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Получение актуальной информации за пределами даты отсечки знаний модели
-- Поиск текущих событий и последних данных
-- Поиск новейшей технической документации
-
-## Примечания
-
-- Результаты поиска возвращаются в формате гиперссылок markdown
-- После использования необходимо добавить раздел "Sources:" в конце ответа со списком соответствующих URL
-- Поддерживает фильтрацию доменов (включение/исключение)
-- В поисковых запросах следует использовать текущий год
-- Доступно только в США
-
-## Оригинальный текст
-
-<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/ru/Tool-Write.md

@@ -1,39 +0,0 @@
-# Write
-
-## Определение
-
-Записывает содержимое в локальную файловую систему. Если файл уже существует, перезаписывает его.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `file_path` | string | Да | Абсолютный путь к файлу (должен быть абсолютным) |
-| `content` | string | Да | Содержимое для записи |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Создание новых файлов
-- Когда требуется полная перезапись содержимого файла
-
-**Неподходящее применение:**
-- Модификация локального содержимого файла — следует использовать Edit
-- Не следует проактивно создавать файлы документации (*.md) или README, если пользователь явно не просит
-
-## Примечания
-
-- Если целевой файл уже существует, его необходимо сначала прочитать через Read, иначе операция завершится ошибкой
-- Перезаписывает всё содержимое существующего файла
-- Предпочитайте Edit для редактирования существующих файлов, Write предназначен только для создания новых файлов или полной перезаписи
-
-## Оригинальный текст
-
-<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/ru/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Определение
-
-Выполняет код Python в ядре Jupyter текущего файла notebook.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `code` | string | Да | Код Python для выполнения |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Выполнение кода в среде Jupyter notebook
-- Тестирование фрагментов кода
-- Анализ данных и вычисления
-
-**Неподходящее применение:**
-- Выполнение кода вне среды Jupyter — следует использовать Bash
-- Модификация файлов — следует использовать Edit или Write
-
-## Примечания
-
-- Это инструмент MCP (Model Context Protocol), предоставляемый интеграцией с IDE
-- Код выполняется в текущем ядре Jupyter, состояние сохраняется между вызовами
-- Если пользователь явно не просит, следует избегать объявления переменных или изменения состояния ядра
-- После перезапуска ядра состояние теряется
-
-## Оригинальный текст
-
-<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/ru/Tool-getDiagnostics.md

@@ -1,32 +0,0 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
-
-## Определение
-
-Получает диагностическую информацию языка из VS Code, включая синтаксические ошибки, ошибки типов, предупреждения lint и т.д.
-
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `uri` | string | Нет | URI файла. Если не указан, получает диагностику всех файлов |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Проверка семантических проблем кода: синтаксис, типы, lint и т.д.
-- Верификация после редактирования кода на предмет новых ошибок
-- Замена команд Bash для проверки качества кода
-
-**Неподходящее применение:**
-- Запуск тестов — следует использовать Bash
-- Проверка ошибок времени выполнения — следует использовать Bash для выполнения кода
-
-## Примечания
-
-- Это инструмент MCP (Model Context Protocol), предоставляемый интеграцией с IDE
-- Доступен только в среде VS Code / IDE
-- Предпочитайте использование этого инструмента вместо команд Bash для проверки проблем с кодом
-
-## Оригинальный текст
-
-<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/ru/Tools.md

@@ -1,67 +0,0 @@
-# Обзор инструментов Claude Code
-
-Claude Code предоставляет модели набор встроенных инструментов через механизм tool_use API Anthropic. Массив `tools` в каждом запросе MainAgent содержит полные определения JSON Schema этих инструментов, а модель вызывает их в ответе через блоки content `tool_use`.
-
-Ниже приведён категоризированный индекс всех инструментов.
-
-## Система агентов
-
-| Инструмент | Назначение |
-|------|------|
-| [Task](Tool-Task.md) | Запуск суб-агента (SubAgent) для обработки сложных многоэтапных задач |
-| [TaskOutput](Tool-TaskOutput.md) | Получение результата фоновой задачи |
-| [TaskStop](Tool-TaskStop.md) | Остановка работающей фоновой задачи |
-| [TaskCreate](Tool-TaskCreate.md) | Создание записи в структурированном списке задач |
-| [TaskGet](Tool-TaskGet.md) | Получение деталей задачи |
-| [TaskUpdate](Tool-TaskUpdate.md) | Обновление статуса задачи, зависимостей и т.д. |
-| [TaskList](Tool-TaskList.md) | Отображение списка всех задач |
-
-## Операции с файлами
-
-| Инструмент | Назначение |
-|------|------|
-| [Read](Tool-Read.md) | Чтение содержимого файла (поддержка текста, изображений, PDF, Jupyter notebook) |
-| [Edit](Tool-Edit.md) | Редактирование файла через точную замену строк |
-| [Write](Tool-Write.md) | Запись или перезапись файла |
-| [NotebookEdit](Tool-NotebookEdit.md) | Редактирование ячеек Jupyter notebook |
-
-## Поиск
-
-| Инструмент | Назначение |
-|------|------|
-| [Glob](Tool-Glob.md) | Поиск файлов по шаблону имени |
-| [Grep](Tool-Grep.md) | Поиск по содержимому файлов на основе ripgrep |
-
-## Терминал
-
-| Инструмент | Назначение |
-|------|------|
-| [Bash](Tool-Bash.md) | Выполнение команд shell |
-
-## Web
-
-| Инструмент | Назначение |
-|------|------|
-| [WebFetch](Tool-WebFetch.md) | Получение содержимого веб-страниц и обработка с помощью AI |
-| [WebSearch](Tool-WebSearch.md) | Запросы к поисковой системе |
-
-## Планирование и взаимодействие
-
-| Инструмент | Назначение |
-|------|------|
-| [EnterPlanMode](Tool-EnterPlanMode.md) | Вход в режим планирования, проектирование плана реализации |
-| [ExitPlanMode](Tool-ExitPlanMode.md) | Выход из режима планирования и отправка плана на утверждение пользователю |
-| [AskUserQuestion](Tool-AskUserQuestion.md) | Задать вопрос пользователю для уточнения или принятия решения |
-
-## Расширения
-
-| Инструмент | Назначение |
-|------|------|
-| [Skill](Tool-Skill.md) | Выполнение навыка (slash command) |
-
-## Интеграция с IDE
-
-| Инструмент | Назначение |
-|------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Получение диагностической информации языка из VS Code |
-| [executeCode](Tool-executeCode.md) | Выполнение кода в ядре Jupyter |

package/concepts/th/CacheRebuild.md

@@ -1,36 +0,0 @@
-# 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 ระบุสาเหตุของการสร้างแคชใหม่อย่างแม่นยำโดยเปรียบเทียบ body ของคำร้องขอ 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` ทันทีโดยไม่เปรียบเทียบ 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` แทนที่ข้อความต้นฉบับด้วยสรุปแบบบีบอัด)

package/concepts/th/KVCacheContent.md

@@ -1,49 +0,0 @@
-# เนื้อหาที่แคชใน KV-Cache
-
-## Prompt Caching คืออะไร?
-
-เมื่อคุณสนทนากับ Claude ทุกคำขอ API จะส่งบริบทการสนทนาทั้งหมด (system prompt + คำจำกัดความเครื่องมือ + ข้อความในอดีต) กลไก prompt caching ของ Anthropic จะแคชเนื้อหาคำนำหน้าที่คำนวณไว้แล้วบนเซิร์ฟเวอร์ หากคำขอถัดไปมีคำนำหน้าที่ตรงกัน ก็จะนำผลลัพธ์ที่แคชไว้มาใช้ซ้ำโดยตรง ข้ามการคำนวณซ้ำ ลดเวลาตอบสนองและค่าใช้จ่ายได้อย่างมาก
-
-ใน cc-viewer กลไกนี้เรียกว่า "KV-Cache" ซึ่งตรงกับ prompt caching ในระดับ Anthropic API ไม่ใช่ key-value cache ของชั้น attention ใน 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` ในคำขอทั้งหมดเพื่อกำหนดพฤติกรรมการแคช เซิร์ฟเวอร์จะดำเนินนโยบายการแคชอัตโนมัติสำหรับฟิลด์เฉพาะ (เช่น system prompt, คำจำกัดความเครื่องมือ) แม้ว่าคำขอจะไม่มีแท็ก `cache_control` อย่างชัดเจน ดังนั้นเมื่อคุณไม่เห็นคุณสมบัตินี้ในเนื้อหาคำขอ ไม่ต้องสงสัย — เซิร์ฟเวอร์ได้ดำเนินการแคชเบื้องหลังแล้ว เพียงแต่ไม่ได้เปิดเผยข้อมูลนี้ให้ไคลเอนต์ทราบ นี่คือความเข้าใจโดยปริยายระหว่าง Claude Code กับ Anthropic API
-
-## "เนื้อหาที่แคชใน KV-Cache ปัจจุบัน" คืออะไร?
-
-"เนื้อหาที่แคชใน KV-Cache ปัจจุบัน" ที่แสดงใน cc-viewer คือเนื้อหาที่แยกออกมาจากคำขอ MainAgent ล่าสุด ซึ่งอยู่ก่อนขอบเขตแคช (cache breakpoint) โดยเฉพาะรวมถึง:
-
-- **System Prompt**: คำสั่งระบบของ Claude Code รวมถึงคำสั่ง agent หลัก ข้อกำหนดการใช้เครื่องมือ คำสั่งโครงการ CLAUDE.md ข้อมูลสภาพแวดล้อม เป็นต้น
-- **Tools**: รายการคำจำกัดความเครื่องมือที่พร้อมใช้งานในปัจจุบัน (เช่น Read, Write, Bash, Agent, เครื่องมือ MCP เป็นต้น)
-- **Messages**: ส่วนที่แคชของประวัติการสนทนา (โดยปกติคือข้อความที่เก่ากว่า จนถึงแท็ก `cache_control` ตัวสุดท้าย)
-
-## ทำไมต้องดูเนื้อหาแคช?
-
-1. **ทำความเข้าใจบริบท**: รู้ว่า Claude "จำ" เนื้อหาใดในปัจจุบัน ช่วยให้คุณประเมินว่าพฤติกรรมนั้นตรงตามที่คาดหวังหรือไม่
-2. **การเพิ่มประสิทธิภาพค่าใช้จ่าย**: การเข้าถึงแคชมีค่าใช้จ่ายน้อยกว่าการคำนวณใหม่มาก การดูเนื้อหาแคชช่วยให้คุณเข้าใจว่าทำไมคำขอบางรายการจึงเรียกใช้การสร้างแคชใหม่ (cache rebuild)
-3. **การแก้ไขข้อบกพร่องในการสนทนา**: เมื่อคำตอบของ Claude ไม่ตรงตามที่คาดหวัง การตรวจสอบเนื้อหาแคชสามารถยืนยันว่า system prompt และข้อความในอดีตถูกต้อง
-4. **การตรวจสอบคุณภาพบริบท**: ในระหว่างการแก้ไขข้อบกพร่อง การเปลี่ยนแปลงการกำหนดค่า หรือการปรับ prompt KV-Cache-Text จะให้มุมมองที่เป็นศูนย์กลาง ช่วยให้คุณยืนยันอย่างรวดเร็วว่าบริบทหลักไม่ได้เสื่อมลงหรือถูกปนเปื้อนด้วยเนื้อหาที่ไม่คาดคิด — โดยไม่ต้องตรวจสอบข้อความต้นฉบับทีละรายการ
-
-## กลยุทธ์การแคชหลายระดับ
-
-KV-Cache ที่ตรงกับ Claude Code ไม่ได้มีเพียงสำเนาเดียว เซิร์ฟเวอร์จะสร้างแคชแยกต่างหากสำหรับ Tools และ System Prompt ซึ่งเป็นอิสระจากแคชส่วน Messages ข้อดีของการออกแบบนี้คือ: เมื่อสแต็กข้อความเกิดความผิดพลาด (เช่น การตัดบริบท การแก้ไขข้อความ) และจำเป็นต้องสร้างใหม่ จะไม่ทำให้แคชของ Tools และ System Prompt เป็นโมฆะไปด้วย หลีกเลี่ยงการคำนวณใหม่ทั้งหมด
-
-นี่คือกลยุทธ์การเพิ่มประสิทธิภาพจากฝั่งเซิร์ฟเวอร์ในขั้นตอนปัจจุบัน — เพราะคำจำกัดความเครื่องมือและ System Prompt ค่อนข้างเสถียรในระหว่างการใช้งานปกติและไม่ค่อยเปลี่ยนแปลง การแคชแยกต่างหากจะลดค่าใช้จ่ายในการสร้างใหม่ที่ไม่จำเป็นให้มากที่สุด ดังนั้นเมื่อคุณสังเกตแคช คุณจะพบว่านอกจากการสร้าง Tools ใหม่ที่ต้องรีเฟรชแคชทั้งหมด การเสียหายของ System Prompt และ Messages ยังคงมีแคชที่สืบทอดได้
-
-## วงจรชีวิตของแคช
-
-- **การสร้าง**: ในคำขอแรกหรือหลังจากแคชหมดอายุ API จะสร้างแคชใหม่ (`cache_creation_input_tokens`)
-- **การเข้าถึง**: เมื่อคำขอถัดไปมีคำนำหน้าที่ตรงกัน แคชจะถูกนำกลับมาใช้ใหม่ (`cache_read_input_tokens`)
-- **การหมดอายุ**: แคชมี TTL 5 นาที (ระยะเวลาการมีชีวิต) และหมดอายุโดยอัตโนมัติเมื่อหมดเวลา
-- **การสร้างใหม่**: เมื่อ system prompt รายการเครื่องมือ โมเดล หรือเนื้อหาข้อความเปลี่ยนแปลง คีย์แคชไม่ตรงกัน จะเรียกใช้การสร้างแคชใหม่ในระดับที่ตรงกัน