cx-viewer 1.0.3 → 1.0.4

package/concepts/uk/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/uk/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/uk/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/uk/Tool-TeamDelete.md

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

package/concepts/uk/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
-- Якщо доступний MCP-інструмент web fetch, надавайте йому перевагу
-
-## Оригінальний текст
-
-<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/uk/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/uk/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/uk/Tool-executeCode.md

@@ -1,41 +0,0 @@
-# executeCode (mcp__ide__executeCode)
-
-## Визначення
-
-Виконує Python-код у Jupyter kernel поточного файлу notebook.
-
-## Параметри
-
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `code` | string | Так | Python-код для виконання |
-
-## Сценарії використання
-
-**Підходить для:**
-- Виконання коду в середовищі Jupyter notebook
-- Тестування фрагментів коду
-- Аналіз даних та обчислення
-
-**Не підходить для:**
-- Виконання коду поза середовищем Jupyter — слід використовувати Bash
-- Зміна файлів — слід використовувати Edit або Write
-
-## Примітки
-
-- Це MCP (Model Context Protocol) інструмент, наданий інтеграцією з IDE
-- Код виконується в поточному Jupyter kernel, стан зберігається між викликами
-- Якщо користувач явно не просить, уникайте оголошення змінних або зміни стану kernel
-- Після перезапуску kernel стан втрачається
-
-## Оригінальний текст
-
-<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/uk/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/uk/Tools.md

@@ -1,67 +0,0 @@
-# Перелік інструментів Claude Code
-
-Claude Code надає моделі набір вбудованих інструментів через механізм tool_use API Anthropic. Масив `tools` кожного запиту MainAgent містить повні визначення JSON Schema цих інструментів, і модель викликає їх через `tool_use` content block у відповіді.
-
-Нижче наведено категоризований індекс усіх інструментів.
-
-## Система агентів
-
-| Інструмент | Призначення |
-|------------|-------------|
-| [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 kernel |

package/concepts/zh/CacheRebuild.md

@@ -1,36 +0,0 @@
-# Cache Rebuild（缓存重建）
-
-## 背景
-
-Anthropic 的 prompt caching 机制会将请求中的 system → tools → messages（到 cache breakpoint）按顺序拼接为缓存键。当缓存键与上一次请求完全一致时，API 返回 `cache_read_input_tokens`（缓存命中）；当缓存键发生变化，API 会重新创建缓存，返回大量 `cache_creation_input_tokens`，即缓存重建。
-
-缓存重建意味着额外的 token 计费（cache creation 的价格高于 cache read），因此识别重建原因对费用优化有直接价值。
-
-## 缓存重建原因分类
-
-cx-viewer 通过对比前后两个 MainAgent 请求的 body，精确判断缓存重建的原因：
-
-| 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`**：Codex 更新了 system prompt（如加载新的 CLAUDE.md、project instructions 变化）
-- **`tools_change`**：MCP server 连接/断开导致可用工具列表变化
-- **`model_change`**：用户通过 `/model` 命令切换模型
-- **`msg_truncated`**：对话过长触发上下文窗口管理，Codex 截断早期消息
-- **`msg_modified`**：Codex 对历史消息做了编辑（如 `/compact` 压缩摘要替换原始消息）

package/concepts/zh/KVCacheContent.md

@@ -1,49 +0,0 @@
-# KV-Cache 缓存内容
-
-## 什么是 Prompt Caching？
-
-当你与 Claude 对话时，每次 API 请求都会发送完整的对话上下文（system prompt + 工具定义 + 历史消息）。Anthropic 的 prompt caching 机制会将已经计算过的前缀内容缓存在服务端，后续请求如果前缀一致，则直接复用缓存结果，跳过重复计算，大幅降低延迟和费用。
-
-cx-viewer 中将这一机制称为"KV-Cache"，对应的是 Anthropic API 层面的 prompt caching，而非 LLM 内部 transformer 注意力层的 key-value cache。
-
-## 缓存的工作原理
-
-Anthropic 的 prompt caching 按照固定顺序拼接缓存键：
-
-```
-Tools → System Prompt → Messages（到 cache breakpoint）
-```
-
-只要这个前缀与 TTL 窗口内的任意一次请求完全一致，API 就会命中缓存（返回 `cache_read_input_tokens`），而非重新计算（`cache_creation_input_tokens`）。
-
-> **Codex 对 `cache_control` 属性并不强依赖，服务端会配合剔除部分这些属性，但依然能够很好的创建缓存，所以没有看到 `cache_control` 属性并不代表没有被缓存**
->
-> 对于 Codex 这类特殊客户端，Anthropic 服务端并不完全依赖请求中的 `cache_control` 属性来决定缓存行为。服务端会对特定字段（如 system prompt、tools 定义）自动执行缓存策略，即使请求中未显式携带 `cache_control` 标记。因此，当你在请求体中没有看到该属性时不必疑惑——服务端已在幕后完成了缓存操作，只是未将此信息暴露给客户端。这是 Codex 与 Anthropic API 之间的一种默契。
-
-## "当前 KV-Cache 缓存内容"是什么？
-
-cx-viewer 中显示的"当前 KV-Cache 缓存内容"，是从最近一次 MainAgent 请求中提取的、位于缓存边界（cache breakpoint）之前的内容。具体包括：
-
-- **System Prompt**：Codex 的系统指令，包含核心 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 提供了一个集中的视角，帮助你快速确认核心上下文是否出现劣化或被意外内容污染——无需逐条翻阅原始报文
-
-## 多级缓存策略
-
-Codex 对应的 KV-Cache 并非只有一份。服务端会为 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`）
-- **过期**：缓存有 5 分钟的 TTL（存活时间），超时后自动失效
-- **重建**：当 system prompt、工具列表、模型或消息内容发生变化时，缓存键不匹配，触发对应级别的缓存重建