chore(i18n): refresh uk translations

docs/uk/tools/thinking.md

@@ -1,130 +1,131 @@
 ---
 read_when:
-    - Налаштування парсингу або значень за замовчуванням для директив мислення, fast-mode чи verbose
+    - Налаштування розбору директив мислення, швидкого режиму або докладного режиму чи значень за замовчуванням
 summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань
 title: Рівні мислення
 x-i18n:
-    generated_at: "2026-04-24T23:39:00Z"
+    generated_at: "2026-04-25T01:07:35Z"
     model: gpt-5.4
     provider: openai
-    source_hash: 177fa325f48d6b6e28a085337cf30b8d2d1d31a094cef846c5af8633e013d4b6
+    source_hash: 0537f10d3dd3251ac41590bebd2d83ba8b2562725c322040b20f32547c8af88d
     source_path: tools/thinking.md
     workflow: 15
 ---
 
 ## Що це робить
 
-- Вбудована директива в будь-якому вхідному тілі повідомлення: `/t <level>`, `/think:<level>` або `/thinking <level>`.
+- Вбудована директива в будь-якому вхідному тілі: `/t <level>`, `/think:<level>` або `/thinking <level>`.
 - Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive | max`
   - minimal → “think”
   - low → “think hard”
   - medium → “think harder”
   - high → “ultrathink” (максимальний бюджет)
-  - xhigh → “ultrathink+” (GPT-5.2+ і моделі Codex, а також effort для Anthropic Claude Opus 4.7)
-  - adaptive → adaptive thinking під керуванням провайдера (підтримується для Claude 4.6 на Anthropic/Bedrock і Anthropic Claude Opus 4.7)
-  - max → максимальне міркування провайдера (зараз Anthropic Claude Opus 4.7)
+  - xhigh → “ultrathink+” (GPT-5.2+ і моделі Codex, а також зусилля Anthropic Claude Opus 4.7)
+  - adaptive → адаптивне мислення під керуванням провайдера (підтримується для Claude 4.6 на Anthropic/Bedrock, Anthropic Claude Opus 4.7 і Google Gemini dynamic thinking)
+  - max → максимальне міркування провайдера (наразі Anthropic Claude Opus 4.7)
   - `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`.
   - `highest` зіставляється з `high`.
 - Примітки щодо провайдерів:
-  - Меню та перемикачі thinking залежать від профілю провайдера. Плагіни провайдерів оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`.
-  - `adaptive`, `xhigh` і `max` оголошуються лише для профілів провайдерів/моделей, які їх підтримують. Введені директиви з непідтримуваними рівнями відхиляються з переліком допустимих варіантів для цієї моделі.
-  - Наявні збережені непідтримувані рівні переназначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, тоді як `xhigh` і `max` повертаються до найбільшого підтримуваного рівня, відмінного від `off`, для вибраної моделі.
-  - Моделі Anthropic Claude 4.6 за замовчуванням використовують `adaptive`, якщо явний рівень thinking не задано.
-  - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Його значення effort API за замовчуванням і надалі визначається провайдером, якщо ви явно не задасте рівень thinking.
-  - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` є директивою thinking, а `xhigh` — це налаштування effort в Opus 4.7.
-  - Anthropic Claude Opus 4.7 також підтримує `/think max`; воно зіставляється з тим самим шляхом максимального effort, який визначається провайдером.
-  - Моделі OpenAI GPT зіставляють `/think` через специфічну для моделі підтримку effort в Responses API. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload для вимкненого reasoning замість надсилання непідтримуваного значення.
-  - MiniMax (`minimax/*`) на Anthropic-сумісному streaming-шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задали thinking у параметрах моделі або запиту. Це запобігає витоку дельт `reasoning_content` з не нативного формату потоку Anthropic у MiniMax.
-  - Z.AI (`zai/*`) підтримує лише бінарний thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, розглядається як `on` (зіставляється з `low`).
+  - Меню та перемикачі мислення керуються профілем провайдера. Плагіни провайдерів оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`.
+  - `adaptive`, `xhigh` і `max` рекламуються лише для профілів провайдера/моделі, які їх підтримують. Введені директиви для непідтримуваних рівнів відхиляються з показом дійсних варіантів для цієї моделі.
+  - Наявні збережені непідтримувані рівні переназначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, а `xhigh` і `max` — до найбільшого підтримуваного небінарного рівня, відмінного від `off`, для вибраної моделі.
+  - Для моделей Anthropic Claude 4.6 за замовчуванням використовується `adaptive`, якщо явний рівень мислення не задано.
+  - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Типовий рівень effort для його API залишається під керуванням провайдера, якщо ви явно не задасте рівень мислення.
+  - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — налаштування effort для Opus 4.7.
+  - Anthropic Claude Opus 4.7 також підтримує `/think max`; це зіставляється з тим самим шляхом максимального effort під керуванням провайдера.
+  - Моделі OpenAI GPT зіставляють `/think` через підтримку effort у Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого reasoning замість надсилання непідтримуваного значення.
+  - Google Gemini зіставляє `/think adaptive` з dynamic thinking Gemini під керуванням провайдера. Запити Gemini 3 пропускають фіксований `thinkingLevel`, тоді як запити Gemini 2.5 надсилають `thinkingBudget: -1`; фіксовані рівні, як і раніше, зіставляються з найближчим `thinkingLevel` або бюджетом Gemini для цього сімейства моделей.
+  - MiniMax (`minimax/*`) на Anthropic-сумісному потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` із ненативного формату Anthropic stream у MiniMax.
+  - Z.AI (`zai/*`) підтримує лише бінарне thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`).
   - Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`.
 
 ## Порядок визначення
 
 1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення).
-2. Перевизначення сесії (задається надсиланням повідомлення, що містить лише директиву).
-3. Типове значення для агента (`agents.list[].thinkingDefault` у конфігурації).
-4. Глобальне типове значення (`agents.defaults.thinkingDefault` у конфігурації).
-5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі з підтримкою reasoning визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без reasoning залишаються на `off`.
+2. Перевизначення сесії (встановлюється надсиланням повідомлення, що містить лише директиву).
+3. Значення за замовчуванням для агента (`agents.list[].thinkingDefault` у конфігурації).
+4. Глобальне значення за замовчуванням (`agents.defaults.thinkingDefault` у конфігурації).
+5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі зі здатністю до міркування визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без міркування залишаються `off`.
 
 ## Встановлення значення за замовчуванням для сесії
 
-- Надішліть повідомлення, що **містить лише** директиву (пробіли дозволені), наприклад `/think:medium` або `/t high`.
-- Це закріплюється для поточної сесії (за замовчуванням окремо для кожного відправника); скасовується через `/think:off` або скидання через бездіяльність сесії.
-- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сесії лишається без змін.
-- Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень thinking.
+- Надішліть повідомлення, яке **містить лише** директиву (допускаються пробіли), наприклад `/think:medium` або `/t high`.
+- Це зберігається для поточної сесії (типово окремо для кожного відправника); скидається через `/think:off` або під час idle reset сесії.
+- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команду буде відхилено з підказкою, а стан сесії залишиться без змін.
+- Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення.
 
 ## Застосування за агентом
 
-- **Embedded Pi**: визначений рівень передається в runtime вбудованого агента Pi.
+- **Вбудований Pi**: визначений рівень передається в runtime агента Pi у межах процесу.
 
-## Fast mode (/fast)
+## Швидкий режим (/fast)
 
 - Рівні: `on|off`.
-- Повідомлення лише з директивою перемикає перевизначення fast mode для сесії та повертає `Fast mode enabled.` / `Fast mode disabled.`.
-- Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан fast mode.
-- OpenClaw визначає fast mode в такому порядку:
-  1. Вбудована директива/повідомлення лише з директивою `/fast on|off`
+- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`.
+- Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму.
+- OpenClaw визначає швидкий режим у такому порядку:
+  1. Вбудоване/директивне `/fast on|off`
   2. Перевизначення сесії
-  3. Типове значення для агента (`agents.list[].fastModeDefault`)
+  3. Значення за замовчуванням для агента (`agents.list[].fastModeDefault`)
   4. Конфігурація для моделі: `agents.defaults.models["<provider>/<model>"].params.fastMode`
   5. Резервний варіант: `off`
-- Для `openai/*` fast mode зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses.
-- Для `openai-codex/*` fast mode надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації.
-- Для прямих публічних запитів `anthropic/*`, зокрема трафіку з OAuth-автентифікацією, надісланого до `api.anthropic.com`, fast mode зіставляється з рівнями сервісу Anthropic: `/fast on` задає `service_tier=auto`, `/fast off` задає `service_tier=standard_only`.
+- Для `openai/*` швидкий режим зіставляється з обробкою пріоритету OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses.
+- Для `openai-codex/*` швидкий режим надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації.
+- Для прямих публічних запитів `anthropic/*`, включно з трафіком, автентифікованим через OAuth і надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` встановлює `service_tier=auto`, `/fast off` встановлює `service_tier=standard_only`.
 - Для `minimax/*` на Anthropic-сумісному шляху `/fast on` (або `params.fastMode: true`) переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.
-- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають типове значення fast mode, якщо задано обидва. OpenClaw, як і раніше, пропускає вставку рівня сервісу Anthropic для проксі-базових URL, що не належать Anthropic.
-- `/status` показує `Fast` лише коли fast mode увімкнено.
+- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають значення швидкого режиму за замовчуванням, якщо встановлено обидва. OpenClaw, як і раніше, пропускає впровадження service tier Anthropic для не-Anthropic proxy base URL.
+- `/status` показує `Fast` лише тоді, коли швидкий режим увімкнено.
 
-## Директиви verbose (/verbose або /v)
+## Докладні директиви (/verbose або /v)
 
 - Рівні: `on` (мінімальний) | `full` | `off` (за замовчуванням).
-- Повідомлення лише з директивою перемикає verbose для сесії та повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану.
-- `/verbose off` зберігає явне перевизначення сесії; очистити його можна через інтерфейс Sessions, вибравши `inherit`.
-- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні.
-- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень verbose.
-- Коли verbose увімкнено, агенти, які надсилають структуровані результати інструментів (Pi, інші JSON-агенти), повертають кожен виклик інструмента як окреме повідомлення лише з метаданими, з префіксом `<emoji> <tool-name>: <arg>`, коли доступно (path/command). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як streaming-дельти.
-- Зведення про збої інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими подробицями помилок приховуються, якщо verbose не дорівнює `on` або `full`.
-- Коли verbose має значення `full`, вивід інструментів також пересилається після завершення (окремою бульбашкою, обрізаний до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання триває, наступні бульбашки інструментів врахують нове налаштування.
+- Повідомлення лише з директивою перемикає докладність для сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану.
+- `/verbose off` зберігає явне перевизначення сесії; очистіть його через інтерфейс Sessions, вибравши `inherit`.
+- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні.
+- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності.
+- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом `<emoji> <tool-name>: <arg>`, коли доступно (path/command). Ці підсумки інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти.
+- Підсумки збоїв інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими деталями помилок приховуються, якщо verbose не дорівнює `on` або `full`.
+- Коли verbose має значення `full`, після завершення також пересилаються виводи інструментів (окремою бульбашкою, скорочені до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання триває, наступні бульбашки інструментів врахують нове налаштування.
 
-## Директиви trace для Plugin (/trace)
+## Директиви трасування Plugin (/trace)
 
 - Рівні: `on` | `off` (за замовчуванням).
-- Повідомлення лише з директивою перемикає вивід trace для Plugin у сесії та повертає `Plugin trace enabled.` / `Plugin trace disabled.`.
-- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні.
-- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень trace.
-- `/trace` вужчий за `/verbose`: він показує лише рядки trace/debug, що належать Plugin, наприклад зведення налагодження Active Memory.
-- Рядки trace можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді помічника.
+- Повідомлення лише з директивою перемикає вивід трасування Plugin для сесії та відповідає `Plugin trace enabled.` / `Plugin trace disabled.`.
+- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні.
+- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування.
+- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать плагіну, як-от підсумки налагодження Active Memory.
+- Рядки трасування можуть з’являтися в `/status` і як подальше діагностичне повідомлення після звичайної відповіді помічника.
 
-## Видимість reasoning (/reasoning)
+## Видимість міркувань (/reasoning)
 
 - Рівні: `on|off|stream`.
-- Повідомлення лише з директивою перемикає, чи показувати блоки thinking у відповідях.
-- Коли увімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`.
-- `stream` (лише Telegram): транслює reasoning у чернеткову бульбашку Telegram під час генерування відповіді, а потім надсилає фінальну відповідь без reasoning.
+- Повідомлення лише з директивою перемикає, чи показуються блоки мислення у відповідях.
+- Коли ввімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`.
+- `stream` (лише Telegram): транслює reasoning у чернетку бульбашки Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без reasoning.
 - Псевдонім: `/reason`.
-- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning.
-- Порядок визначення: вбудована директива, потім перевизначення сесії, потім типове значення для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`).
+- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань.
+- Порядок визначення: вбудована директива, потім перевизначення сесії, потім значення за замовчуванням для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`).
 
 ## Пов’язане
 
-- Документація режиму elevated розміщена в [Elevated mode](/uk/tools/elevated).
+- Документація режиму elevated міститься в [Elevated mode](/uk/tools/elevated).
 
-## Heartbeats
+## Heartbeat
 
-- Тіло запиту Heartbeat — це налаштований heartbeat prompt (за замовчуванням: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в heartbeat-повідомленні застосовуються як звичайно (але уникайте зміни типових значень сесії з heartbeat-повідомлень).
-- Доставка Heartbeat за замовчуванням надсилає лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або для окремого агента `agents.list[].heartbeat.includeReasoning: true`.
+- Тіло перевірки Heartbeat — це налаштований prompt heartbeat (типово: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні heartbeat застосовуються як зазвичай (але уникайте зміни значень сесії за замовчуванням через heartbeat).
+- Доставка Heartbeat за замовчуванням надсилає лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або `agents.list[].heartbeat.includeReasoning: true` для окремого агента.
 
-## Вебінтерфейс чату
+## Веб-інтерфейс чату
 
-- Перемикач thinking у вебчаті при завантаженні сторінки відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії.
-- Вибір іншого рівня негайно записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
-- Перший варіант завжди — `Default (<resolved level>)`, де визначене типове значення береться з профілю thinking провайдера для активної моделі сесії плюс та сама резервна логіка, яку використовують `/status` і `session_status`.
-- Перемикач використовує `thinkingLevels`, що повертаються рядком/defaults сесії Gateway, а `thinkingOptions` зберігається як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни володіють наборами рівнів, специфічними для моделей.
-- `/think:<level>` як і раніше працює та оновлює той самий збережений рівень сесії, тому директиви в чаті й перемикач залишаються синхронізованими.
+- Селектор мислення у веб-чаті відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії під час завантаження сторінки.
+- Вибір іншого рівня одразу записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
+- Перший варіант завжди має вигляд `Default (<resolved level>)`, де визначене значення за замовчуванням надходить із профілю мислення провайдера для активної моделі сесії плюс та сама логіка резервного варіанта, яку використовують `/status` і `session_status`.
+- Перемикач використовує `thinkingLevels`, повернуті рядком/defaults сесії Gateway, а `thinkingOptions` зберігаються як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни керують наборами рівнів, специфічними для моделі.
+- `/think:<level>` як і раніше працює та оновлює той самий збережений рівень сесії, тож директиви чату й перемикач залишаються синхронізованими.
 
 ## Профілі провайдерів
 
-- Плагіни провайдерів можуть надавати `resolveThinkingProfile(ctx)`, щоб визначити підтримувані рівні моделі та значення за замовчуванням.
+- Плагіни провайдерів можуть надавати `resolveThinkingProfile(ctx)` для визначення підтримуваних рівнів моделі та значення за замовчуванням.
 - Кожен рівень профілю має збережений канонічний `id` (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` або `max`) і може містити відображувану `label`. Бінарні провайдери використовують `{ id: "low", label: "on" }`.
-- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів мають використовувати `resolveThinkingProfile`.
-- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі id і мітки профілю, які використовує перевірка runtime.
+- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів слід реалізовувати через `resolveThinkingProfile`.
+- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі id і label профілю, які використовує перевірка в runtime.