zames_pro 2.82.139 → 2.82.141

package/dist/i18n/common.js

@@ -15,7 +15,6 @@ export const commonMessages = {
         en: 'Working directory: {v}',
     },
     'status.review_mode': { ru: 'Режим ревью: {v}', en: 'Review mode: {v}' },
-    'status.review_none': { ru: 'нет', en: 'no' },
     'status.orig_dir': {
         ru: 'Исходная директория: {v}',
         en: 'Original directory: {v}',
@@ -29,19 +28,19 @@ export const commonMessages = {
         ru: 'System prompt на след. задаче: {v}',
         en: 'System prompt next task: {v}',
     },
-    'status.last_chat': { ru: 'Last chat: {v}', en: 'Last chat: {v}' },
+    'status.last_chat': { ru: 'Последний чат: {v}', en: 'Last chat: {v}' },
     'status.sessions': { ru: 'Сессии: {v}', en: 'Sessions: {v}' },
     'status.dev': {
-        ru: 'Dev mode (auto-reload): {v}',
+        ru: 'Режим разработки (авто-перечитывание): {v}',
         en: 'Dev mode (auto-reload): {v}',
     },
     'status.max_iter': {
         ru: 'Лимит итераций: {v} (0 = без лимита)',
         en: 'Iteration limit: {v} (0 = unlimited)',
     },
-    'status.headless': { ru: 'Headless: {v}', en: 'Headless: {v}' },
-    'status.debug': { ru: 'Debug: {v}', en: 'Debug: {v}' },
-    'status.undo': { ru: 'Undo: {v}', en: 'Undo: {v}' },
+    'status.headless': { ru: 'Без окна (headless): {v}', en: 'Headless: {v}' },
+    'status.debug': { ru: 'Отладка: {v}', en: 'Debug: {v}' },
+    'status.undo': { ru: 'Откат (undo): {v}', en: 'Undo: {v}' },
     'status.checkpoint': { ru: 'Чекпойнты: {v}', en: 'Checkpoints: {v}' },
     'status.transcript': { ru: 'Транскрипт: {v}', en: 'Transcript: {v}' },
     'status.locale': { ru: 'Язык: {v}', en: 'Language: {v}' },
@@ -109,8 +108,8 @@ export const commonMessages = {
         en: 'The sign-in did not carry over to headless — staying in the visible window (it can be minimised).',
     },
     'msg.first_hint': {
-        ru: 'Подсказка: «/» — список команд, Ctrl+R — поиск по истории, картинку можно вставить через Ctrl+Shift+V.',
-        en: 'Hint: "/" lists commands, Ctrl+R searches history, paste an image with Ctrl+Shift+V.',
+        ru: 'Подсказка: «/» — список команд, Ctrl+R — поиск по истории, картинку можно вставить через Ctrl+V (пустая вставка).',
+        en: 'Hint: "/" lists commands, Ctrl+R searches history, paste an image with Ctrl+V (or an empty paste).',
     },
     'msg.queue_hint': {
         ru: 'Пока агент работает, можно печатать следующее сообщение — оно уйдёт в очередь (Enter — отправить, Esc — прервать).',
@@ -143,9 +142,15 @@ export const commonMessages = {
     'askuser.your_answer': { ru: 'Ваш ответ:', en: 'Your answer:' },
     'askuser.hint_select': { ru: 'выбор', en: 'select' },
     'askuser.hint_ok': { ru: 'ок', en: 'ok' },
-    'askuser.hint_dismiss': { ru: 'закрыть', en: 'dismiss' },
+    // Not 'dismiss': Esc in the option list returns NOTHING, so the model gets
+    // no answer at all -- the same outcome as Esc while typing the own answer.
+    'askuser.hint_dismiss': { ru: 'без ответа', en: 'no answer' },
     'askuser.hint_send': { ru: 'отправить', en: 'send' },
     'askuser.hint_cancel': { ru: 'отмена', en: 'cancel' },
+    'askuser.enter_send': {
+        ru: 'Enter — отправить ответ (многострочный — через вставку)',
+        en: 'Enter sends the answer (multi-line: paste it)',
+    },
     'confirm.yes': { ru: 'Да', en: 'Yes' },
     'confirm.no': { ru: 'Нет', en: 'No' },
     'perm.ask_sub': {
@@ -209,8 +214,8 @@ export const commonMessages = {
         en: '⚠ No image found in the clipboard (tried: {via}).',
     },
     'msg.clip_hint': {
-        ru: '   Проще всего: вставьте путь к файлу (например tmp/pic.png) — файл приложится к сообщению. Для клипборда нужна утилита (Linux/X11 — xclip или xsel, Wayland — wl-clipboard; Windows — PowerShell, macOS — pngpaste).',
-        en: '   Easiest: paste a path to a file (e.g. tmp/pic.png) — it will be attached to the message. Clipboard paste needs a tool (Linux/X11 — xclip or xsel, Wayland — wl-clipboard; Windows — PowerShell, macOS — pngpaste).',
+        ru: '   Проще всего: вставьте путь к файлу (например tmp/pic.png) — файл приложится к сообщению. Для клипборда нужна утилита: Linux/X11 — xclip или xsel, Wayland — wl-paste (пакет wl-clipboard), Windows — powershell.exe, macOS — pngpaste.',
+        en: '   Easiest: paste a path to a file (e.g. tmp/pic.png) — it will be attached to the message. Clipboard paste needs a tool: Linux/X11 — xclip or xsel, Wayland — wl-paste (the wl-clipboard package), Windows — powershell.exe, macOS — pngpaste.',
     },
     'msg.clip_container': {
         ru: '   Похоже, вы в контейнере/Dev Container: клипборд Windows отсюда недоступен. Вставьте путь к файлу (например tmp/pic.png) — он приложится к сообщению.',

package/dist/i18n/config.js

@@ -68,8 +68,8 @@ export const configMessages = {
         en: 'Full-screen TUI mode (alternate screen)',
     },
     'cfg.f.ui_mouseScroll': {
-        ru: 'Колесо: лог или терминал (выкл = выделение без Shift)',
-        en: 'Wheel: log or terminal (off = select without Shift)',
+        ru: 'Колесо мыши: вкл (по умолчанию) — скроллит диалог, выделение через Shift; выкл — мышью владеет терминал (обычное выделение, колесо инертно)',
+        en: 'Mouse wheel: on (default) — scrolls the dialog, select with Shift; off — the terminal owns the mouse (normal selection, wheel inert)',
     },
     'cfg.f.maxIterations': {
         ru: 'Лимит итераций на задачу',
@@ -251,6 +251,13 @@ export const configMessages = {
         ru: 'Язык переключён на {v}.',
         en: 'Language switched to {v}.',
     },
+    // The project `.zamesrc.json` is merged AFTER the home config, so a key it
+    // also sets silently wins — the operator sees "saved", then the old value
+    // after a restart (a stale `ui.locale: en` looked like a lost setting).
+    'cfg.shadowed': {
+        ru: '⚠ Проектный конфиг {file} переопределяет: {keys} — после перезапуска будет его значение. Уберите эти ключи из проектного файла.',
+        en: '⚠ The project config {file} overrides: {keys} — after a restart its value wins. Remove these keys from the project file.',
+    },
     'cfg.lang_usage': {
         ru: 'Использование: /config lang <ru|en>',
         en: 'Usage: /config lang <ru|en>',

package/dist/i18n/deepseek.js

@@ -77,8 +77,8 @@ export const deepseekMessages = {
         en: '✖ Could not paste the whole text into the input ({got} of {want} chars). The message was not sent to avoid sending a truncated text. Retry or split the message.',
     },
     'ds.send_no_start': {
-        ru: '✖ Ответ не начал генерироваться за 35с даже после повторной отправки. Проверь чат {provider} вручную (возможно, кнопка отправки не нажимается или сессия разлогинилась).',
-        en: '✖ The answer did not start generating within 35s even after resending. Check the {provider} chat manually (the send button may not be clickable or the session may have expired).',
+        ru: '✖ Ответ не начал генерироваться примерно за 50с (30с + 20с после повторного Enter). Проверь чат {provider} вручную (возможно, кнопка отправки не нажимается или сессия разлогинилась).',
+        en: '✖ The answer did not start generating within about 50s (30s + 20s after a second Enter). Check the {provider} chat manually (the send button may not be clickable or the session may have expired).',
     },
     'ds.send_no_new_answer': {
         ru: '✖ Новый ответ не получен — на странице остался прежний текст. Возможно, сообщение не отправилось. Проверь чат {provider} вручную.',

package/dist/i18n/doctor.js

@@ -6,13 +6,18 @@ export const doctorMessages = {
     'doctor.not_repo': { ru: 'не репозиторий', en: 'not a repository' },
     'doctor.loaded': { ru: 'загружен', en: 'loaded' },
     'doctor.error': { ru: 'ошибка: {v}', en: 'error: {v}' },
-    'doctor.unknown': { ru: 'неизвестно', en: 'unknown' },
     'doctor.bundled': { ru: 'встроенный chromium', en: 'bundled chromium' },
     'doctor.auth_saved': {
-        ru: 'сессия сохранена (авто-вход готов)',
-        en: 'session saved (auto re-login ready)',
+        ru: 'сессия сохранена — авто-вход готов',
+        en: 'session saved — auto re-login ready',
+    },
+    // Says what the row checks: the per-provider marker written AFTER a sign-in.
+    // A profile with a live cookie but no marker also lands here, so "no saved
+    // session" would be wrong (and the fix is to open the chat, not to sign in).
+    'doctor.auth_none': {
+        ru: 'нет отметки о входе (отметка пишется после входа этого провайдера)',
+        en: 'no sign-in marker (written after this provider signs in)',
     },
-    'doctor.auth_none': { ru: 'нет сохранённой сессии', en: 'no saved session' },
     'doctor.clipboard_none': {
         ru: 'инструмент не найден (вставка картинок отключена)',
         en: 'no tool found (image paste disabled)',
@@ -110,7 +115,6 @@ export const doctorMessages = {
         ru: 'Перезагружено модулей: {n}. Браузер и чат не тронуты.',
         en: 'Modules reloaded: {n}. Browser and chat untouched.',
     },
-    'msg.not_dir': { ru: 'Не директория: {v}', en: 'Not a directory: {v}' },
     'prompt.review': { ru: 'REVIEW', en: 'REVIEW' },
     'msg.workdir_error': {
         ru: 'Не удалось определить рабочую директорию:',

package/dist/i18n/glm.js

@@ -4,8 +4,8 @@
 // `model.*` / `provider.*` keys live in i18n/help.ts and i18n/qwen.ts.
 export const glmMessages = {
     'glm.guest_mode': {
-        ru: 'GLM: вход не выполнен, работаю гостем (сообщения может блокировать капча). Войдите через /provider login или запустите с --headed.',
-        en: 'GLM: not signed in, running as a guest (a captcha may block messages). Log in via /provider login or launch with --headed.',
+        ru: '✖ GLM: гостевой лимит z.ai исчерпан (без входа доступно лишь несколько сообщений), сообщение не отправлено. Войдите через /provider login или запустите с --headed.',
+        en: '✖ GLM: the z.ai guest limit is exhausted (a signed-out visitor gets only a few messages), the message was not sent. Log in via /provider login or launch with --headed.',
     },
     'glm.login_ok': {
         ru: 'GLM: вход выполнен.',

package/dist/i18n/help.js

@@ -35,17 +35,17 @@ export const helpMessages = {
         en: 'headless browser (default)',
     },
     'help.opt.headed': {
-        ru: 'показать окно браузера (отладка/вход)',
-        en: 'show the browser window (debug/sign-in)',
+        ru: 'показать окно браузера (отладка/вход; GLM и так работает с окном)',
+        en: 'show the browser window (debug/sign-in; GLM already runs headed)',
     },
     'help.opt.provider': {
-        ru: 'выбрать провайдера чата (deepseek | qwen | glm) на этот запуск',
-        en: 'select the chat provider (deepseek | qwen | glm) for this run',
+        ru: 'выбрать провайдера чата на этот запуск (deepseek | qwen | glm; сохраняется в конфиг)',
+        en: 'select the chat provider for this run (deepseek | qwen | glm; saved to the config)',
     },
     'help.opt.debug': { ru: 'подробный лог', en: 'verbose log' },
     'help.opt.dev': {
-        ru: 'режим разработки: авто-перечитывание модулей',
-        en: 'dev mode: auto-reload modules',
+        ru: 'режим разработки: dev-команды, BACKLOG-заметки в промпте и авто-перечитывание модулей',
+        en: 'dev mode: dev-only commands, BACKLOG notes in the prompt and module auto-reload',
     },
     'help.opt.version': { ru: 'показать версию', en: 'show version' },
     'help.opt.no_color': {
@@ -62,52 +62,52 @@ export const helpMessages = {
         en: 'type + Enter              queue a message (sent after the current task)',
     },
     'help.key.history': {
-        ru: '↑ / ↓                    история введённых сообщений',
-        en: '↑ / ↓                     input history',
+        ru: '↑ / ↓                    история введённых сообщений (сохраняется в ~/.zames/history.json)',
+        en: '↑ / ↓                     input history (saved to ~/.zames/history.json)',
     },
     'help.key.search': {
-        ru: 'Ctrl+R                   поиск по истории (обратный)',
-        en: 'Ctrl+R                    reverse-search the history',
+        ru: 'Ctrl+R                   поиск по истории ввода (обратный; Ctrl+R — дальше, Enter — принять, Esc — отмена)',
+        en: 'Ctrl+R                    reverse search the input history (Ctrl+R next, Enter accept, Esc cancel)',
     },
     'help.key.undo': {
         ru: 'Ctrl+_                   отменить правку в строке ввода',
         en: 'Ctrl+_                    undo the last edit in the input line',
     },
     'help.key.words': {
-        ru: 'Ctrl+← / Ctrl+→          перемещение по словам',
-        en: 'Ctrl+← / Ctrl+→           move by words',
+        ru: 'Ctrl+← / Ctrl+→          перемещение по словам (Ctrl+Delete / Alt+Delete — удалить слово справа)',
+        en: 'Ctrl+← / Ctrl+→           move by words (Ctrl+Delete / Alt+Delete — delete the word right)',
+    },
+    'help.key.clear_screen': {
+        ru: 'Ctrl+L                   очистить экран и перерисовать блок ввода',
+        en: 'Ctrl+L                    clear the screen and repaint the input block',
     },
     'help.key.slash': {
-        ru: '/ + Tab                  подсказка и автодополнение slash-команд (Ctrl+N/P — вверх/вниз)',
-        en: '/ + Tab                   slash-command hints and completion (Ctrl+N/P — up/down)',
+        ru: '/ + Tab                  подсказка и автодополнение slash-команд (Ctrl+N/P — выбор)',
+        en: '/ + Tab                   slash-command hints and completion (Ctrl+N/P — select)',
     },
     'help.key.newline': {
-        ru: 'Ctrl+J / Ctrl+Enter      новая строка (Shift+Enter в терминалах с поддержкой)',
-        en: 'Ctrl+J / Ctrl+Enter       new line (Shift+Enter in capable terminals)',
-    },
-    'help.key.backslash': {
-        ru: '\\ + Enter                тоже новая строка',
-        en: '\\ + Enter                also a new line',
+        ru: '\\ + Enter / Ctrl+J       новая строка (Enter убирает этот \\; Ctrl+Enter и Shift+Enter — только в терминалах с kitty-протоколом)',
+        en: '\\ + Enter / Ctrl+J        new line (Enter drops that \\; Ctrl+Enter and Shift+Enter only in terminals with the kitty protocol)',
     },
     'help.key.attach': {
-        ru: 'Ctrl+Shift+V картинки      вставить изображение/файл (сохранится в tmp)',
-        en: 'Ctrl+Shift+V image         paste an image/file (saved to tmp)',
+        ru: 'Ctrl+V / пустая вставка    картинку/файл из буфера обмена в <project>/tmp (вставляется маркер)',
+        en: 'Ctrl+V / empty paste       an image/file from the clipboard into <project>/tmp (a marker is inserted)',
     },
     'help.key.esc': {
-        ru: 'Esc, Ctrl+C              прервать текущую генерацию',
-        en: 'Esc, Ctrl+C               abort current generation',
+        ru: 'Esc, Ctrl+C              Esc — прервать генерацию; Ctrl+C — прервать инструмент, второй раз (в 2с) — весь прогон; без задачи — выход',
+        en: 'Esc, Ctrl+C               Esc — abort generation; Ctrl+C — abort the tool, twice (within 2s) — the whole run; idle — exit',
     },
     'help.key.scroll': {
-        ru: 'PgUp / PgDn              вверх/вниз по диалогу (Home/End — в начало/конец) [full-screen]',
-        en: 'PgUp / PgDn               up/down the dialog (Home/End — top/bottom) [full-screen]',
+        ru: 'колесо / PgUp / PgDn    прокрутка диалога (колесо — при ui.mouseScroll=on, умолч.; Home/End — в начало/конец при пустом вводе) [full-screen]',
+        en: 'wheel / PgUp / PgDn      scroll the dialog (the wheel needs ui.mouseScroll=on, the default; Home/End — top/bottom with an empty input) [full-screen]',
     },
     'help.key.wheel': {
         ru: 'ui.mouseScroll            on (умолч.) — колесо скроллит диалог (выделение Shift); off — выделение мышью',
         en: 'ui.mouseScroll            on (default) — wheel scrolls the dialog (select: Shift); off — select with the mouse',
     },
     'help.key.bang': {
-        ru: '!команда                  выполнить shell-команду напрямую (мимо модели)',
-        en: '!command                  run a shell command directly (bypass the model)',
+        ru: '!команда                  выполнить shell-команду напрямую, без модели (вывод в транскрипт)',
+        en: '!command                  run a shell command directly, no model (output goes to the transcript)',
     },
     'help.commands': { ru: 'Команды:', en: 'Commands:' },
     'help.sec.session': { ru: 'Сессия', en: 'Session' },
@@ -122,105 +122,108 @@ export const helpMessages = {
         en: '/new, /clear             new chat (reset context)',
     },
     'help.cmd.sessions': {
-        ru: '/sessions [фильтр]        список сохранённых сессий (можно фильтровать)',
-        en: '/sessions [filter]        list saved sessions (optionally filtered)',
+        ru: '/sessions [фильтр]        сохранённые сессии: фильтр по заголовку или каталогу (в TUI — выбор и открытие)',
+        en: '/sessions [filter]        saved sessions: filter by title or workdir (the TUI opens the pick list)',
     },
     'help.cmd.resume_id': {
-        ru: '/resume-id <id>          восстановить сессию по полному id',
-        en: '/resume-id <id>          resume a session by full id',
+        ru: '/resume-id <id>          открыть сессию по полному id и напечатать диалог',
+        en: '/resume-id <id>          open a session by full id and print its dialogue',
     },
     'help.cmd.chats': {
-        ru: '/chats [фильтр]          список последних чатов провайдера',
-        en: '/chats [filter]          recent chats of the active provider',
+        ru: '/chats [фильтр]          последние чаты провайдера (в TUI — выбор и открытие, с диалогом)',
+        en: '/chats [filter]          recent chats of the active provider (the TUI opens the pick list and prints the dialogue)',
     },
     'help.cmd.last': {
-        ru: '/last                    открыть последний чат этого каталога',
-        en: '/last                    open the last chat of this directory',
+        ru: '/last                    открыть последний чат этого каталога и напечатать диалог',
+        en: "/last                    open this directory's last chat and print its dialogue",
     },
     'help.cmd.chat': {
-        ru: '/chat                    показать текущий chat id',
-        en: '/chat                    show current chat id',
+        ru: '/chat                    показать текущий chat id и его URL',
+        en: '/chat                    show the current chat id and its URL',
     },
     'help.cmd.cd': {
-        ru: '/cd <path>               сменить рабочую директорию',
-        en: '/cd <path>               change working directory',
+        ru: '/cd <path>               сменить рабочую директорию (без аргумента — вернуться в корень; следующая задача начнёт новый чат)',
+        en: '/cd <path>               change the working directory (no argument — back to the root; the next task starts a fresh chat)',
     },
     'help.cmd.pwd': {
         ru: '/pwd                     текущая директория',
         en: '/pwd                     current directory',
     },
     'help.cmd.status': {
-        ru: '/status                  состояние сессии',
-        en: '/status                  session state',
+        ru: '/status                  состояние сессии: каталог, чат, лимиты, пауза, флаги, MCP, токены',
+        en: '/status                  session state: dir, chat, limits, pause, toggles, MCP, tokens',
     },
     'help.cmd.reload': {
-        ru: '/reload                  перечитать модули логики без перезапуска',
-        en: '/reload                  hot-reload logic modules',
+        ru: '/reload                  перечитать модули логики (browser.ts и login — только после перезапуска)',
+        en: '/reload                  hot-reload logic modules (browser.ts and login need a restart)',
     },
     'help.cmd.undo': {
         ru: '/undo                    откатить последнюю запись/правку',
         en: '/undo                    revert the last write/edit',
     },
     'help.cmd.undo_list': {
-        ru: '/undo-list               список того, что можно откатить',
-        en: '/undo-list               list revertable changes',
+        ru: '/undo-list (/history)    список того, что можно откатить',
+        en: '/undo-list (/history)    list revertable changes',
     },
     'help.cmd.rewind': {
-        ru: '/rewind [n]              откатить рабочее дерево к чекпойнту',
-        en: '/rewind [n]              roll the working tree back to a checkpoint',
+        ru: '/rewind [n|<штамп>] [--yes] откатить рабочее дерево к чекпойнту (без аргумента — самая свежая; спросит подтверждение, --yes — без вопроса для скриптов)',
+        en: '/rewind [n|stamp] [--yes] roll the working tree back to a checkpoint (no argument = the newest; asks first, --yes skips the question for scripts)',
     },
     'help.cmd.rewind_list': {
-        ru: '/rewind-list             список чекпойнтов',
-        en: '/rewind-list             list checkpoints',
+        ru: '/rewind-list (/checkpoints) список чекпойнтов (штамп и каталог)',
+        en: '/rewind-list (/checkpoints) list checkpoints (stamp and directory)',
     },
     'help.cmd.transcript': {
         ru: '/transcript              путь к файлу транскрипта',
         en: '/transcript              transcript file path',
     },
     'help.cmd.diff': {
-        ru: '/diff [--staged] показать git diff',
-        en: '/diff [--staged] show working tree git diff',
+        ru: '/diff [--staged] показать git diff (--staged — изменения в индексе)',
+        en: '/diff [--staged] show git diff (--staged — staged changes)',
     },
     'help.cmd.diffstat': {
-        ru: '/diffstat сводка изменений (git diff --stat)',
-        en: '/diffstat change summary (git diff --stat)',
+        ru: '/diffstat [--staged] сводка изменений (git diff --stat)',
+        en: '/diffstat [--staged] change summary (git diff --stat)',
     },
     'help.cmd.retry': {
-        ru: '/retry повторить последнюю задачу в этом чате',
-        en: '/retry resend the last task into this chat',
+        ru: '/retry повторить последнюю задачу в этом чате (тот же чат, промпт не пересылается)',
+        en: '/retry resend the last task into this chat (same chat, no prompt resend)',
     },
     'help.cmd.rename': {
-        ru: '/rename <title> задать имя текущей сессии',
-        en: '/rename <title> set the current session title',
+        ru: '/rename <title> задать имя сессии в zames (чат на сайте не переименовывается)',
+        en: '/rename <title> set the session title in zames (the web chat is not renamed)',
     },
     'help.cmd.context': {
-        ru: '/context что загружено в промпт (AGENTS/MEMORY/skills/commands)',
-        en: '/context what is loaded into the prompt (AGENTS/MEMORY/skills/commands)',
+        ru: '/context что загружено в промпт (AGENTS/MEMORY/skills/commands), размеры и объём промпта',
+        en: '/context what the prompt loads (AGENTS/MEMORY/skills/commands), their sizes and the prompt size',
     },
     'help.cmd.copy': {
-        ru: '/copy скопировать последний ответ в буфер обмена',
-        en: '/copy copy the last answer to the clipboard',
+        ru: '/copy скопировать последний ответ в буфер обмена (нужна утилита: wl-copy/xclip/xsel, pbcopy, clip)',
+        en: '/copy copy the last answer to the clipboard (needs a clipboard tool: wl-copy/xclip/xsel, pbcopy, clip)',
+    },
+    'help.cmd.cost': {
+        ru: '/cost (/usage) статистика сессии: задачи, инструменты, время, контекст',
+        en: '/cost (/usage) session stats: tasks, tools, time, context',
     },
-    'help.cmd.cost': { ru: '/cost статистика сессии', en: '/cost session stats' },
     'help.cmd.limits': {
-        ru: '/limits                  телеметрия отправок и текущая пауза',
-        en: '/limits                  send telemetry and the current pause',
+        ru: '/limits                  статистика отправок, лимитов и текущая пауза',
+        en: '/limits                  send, rate-limit and current-pause stats',
     },
     'help.cmd.export': {
-        ru: '/export [file] выгрузить сессию в Markdown',
-        en: '/export [file] export the session to Markdown',
+        ru: '/export [file] выгрузить сессию в Markdown (по умолчанию zames-export-<время>.md)',
+        en: '/export [file] export the session to Markdown (default zames-export-<stamp>.md)',
     },
     'help.cmd.doctor': {
-        ru: '/doctor диагностика установки и конфига',
-        en: '/doctor diagnose install and config',
+        ru: '/doctor диагностика: node, git, конфиг, браузер, буфер обмена, MCP, провайдер',
+        en: '/doctor diagnose node, git, config, browser, clipboard, MCP and the provider',
     },
     'help.cmd.add_dir': {
-        ru: '/add-dir <path> проверить директорию',
-        en: '/add-dir <path> validate a directory',
+        ru: '/add-dir <path> проверить директорию (только проверка — песочницу не меняет)',
+        en: '/add-dir <path> validate a directory (check only — the sandbox is unchanged)',
     },
     'help.cmd.review': {
-        ru: '/review [focus] ревью незакоммиченных изменений',
-        en: '/review [focus] review uncommitted changes',
+        ru: '/review [фокус] [--staged] ревью изменений агентом (без правок; --staged — индекс)',
+        en: '/review [focus] [--staged] agent review of the changes (no edits; --staged — the index)',
     },
     'help.cmd.improve': {
         ru: '/improve [id] взять следующий пункт BACKLOG и довести до тестов',
@@ -247,8 +250,8 @@ export const helpMessages = {
         en: 'BACKLOG collapsed: {n} archived block(s) removed.',
     },
     'help.cmd.backlog': {
-        ru: '/backlog <текст> записать идею в BACKLOG.md',
-        en: '/backlog <text> record an idea in BACKLOG.md',
+        ru: '/backlog <текст> записать идею в BACKLOG.md (collapse — свернуть архив)',
+        en: '/backlog <text> record an idea in BACKLOG.md (collapse — prune archive)',
     },
     'backlog.usage': {
         ru: 'Использование: /backlog <текст идеи>',
@@ -271,60 +274,63 @@ export const helpMessages = {
         en: 'Nothing to collapse: there are no archived blocks.',
     },
     'help.cmd.compact': {
-        ru: '/compact сжать историю и открыть новый чат с резюме',
-        en: '/compact compact the history and open a new chat with the summary',
+        ru: '/compact сжать историю в резюме и продолжить в НОВОМ чате (старый остаётся)',
+        en: '/compact summarize the history and continue in a NEW chat (the old one stays)',
     },
     'help.cmd.queue': {
-        ru: '/queue [clear] показать/очистить очередь сообщений',
-        en: '/queue [clear] list/clear the pending message queue',
+        ru: '/queue [list|ls|clear|c|clean] очередь сообщений, ждущих отправки: показать (list/ls) или очистить (clear/c/clean); можно во время работы',
+        en: '/queue [list|ls|clear|c|clean] messages waiting to be sent: list (list/ls) or clear (clear/c/clean); works while the agent is busy',
     },
     'help.cmd.tasks': {
-        ru: '/tasks список задач агента (TodoWrite)',
-        en: '/tasks the agent task list (TodoWrite)',
+        ru: '/tasks текущий чек-лист агента (TodoWrite): статусы шагов (можно во время работы)',
+        en: "/tasks the agent's current checklist (TodoWrite): step statuses (works while the agent is busy)",
     },
     'help.cmd.thinking': {
-        ru: '/thinking [on|off] включить/выключить режим размышления (можно во время работы)',
-        en: '/thinking [on|off] toggle Deep thinking (works while the agent is busy)',
+        ru: '/thinking [on|off] режим размышления: DeepSeek/Qwen — тумблер, GLM — всегда включён (можно во время работы)',
+        en: '/thinking [on|off] reasoning mode: a toggle on DeepSeek/Qwen, always on for GLM (works while busy)',
     },
     'help.cmd.web': {
-        ru: '/web [on|off] включить/выключить поиск в интернете (можно во время работы)',
-        en: '/web [on|off] toggle Smart search (works while the agent is busy)',
+        ru: '/web [on|off] (также /websearch) поиск в интернете: DeepSeek — «Smart search», Qwen — пункт «Web search» (можно во время работы)',
+        en: '/web [on|off] (also /websearch) web search: DeepSeek "Smart search", Qwen the "Web search" menu item (works while busy)',
     },
     'help.cmd.goal': {
-        ru: '/goal <условие> задать условие завершения; агент работает, пока оно не выполнено (снимается автоматически)',
-        en: '/goal <condition> set a completion condition; the agent works until it is met (auto-cleared)',
+        ru: '/goal <условие> задать цель (работает, пока не выполнена; clear/off — снять, без аргумента или on — показать)',
+        en: '/goal <condition> set the goal (runs until met; clear/off — drop, no argument or on — show it)',
     },
     'help.cmd.plan': {
-        ru: '/plan [on|off] режим плана: только чтение, без правок и команд',
-        en: '/plan [on|off] plan mode: read-only, no edits or commands',
+        ru: '/plan [on|off] режим плана (чтение без правок); без аргумента — переключить',
+        en: '/plan [on|off] plan mode (read-only); no argument toggles it',
     },
     'plan.on': {
-        ru: 'Режим плана ВКЛ: доступны только инструменты чтения. Правки и команды запрещены. /plan off — выключить.',
-        en: 'Plan mode ON: only read tools are available. Edits and commands are disabled. /plan off to disable.',
+        ru: 'Режим плана ВКЛ: доступны только инструменты чтения. Правки, команды и MCP-инструменты с мутирующим именем запрещены. /plan off — выключить.',
+        en: 'Plan mode ON: only read tools are available. Edits, commands and MCP tools with a mutating name are disabled. /plan off to disable.',
     },
     'plan.off': {
         ru: 'Режим плана ВЫКЛ: агент снова может писать и запускать команды.',
         en: 'Plan mode OFF: the agent can edit and run commands again.',
     },
+    // BOTH accepted values produce the SAME wire format: JSON Lines, one
+    // event per line (there is no single-document mode). `jsonl` is the
+    // canonical name, `json` a synonym kept for convenience.
     'help.opt.output_format': {
-        ru: 'формат вывода: text|json|jsonl (для скриптов)',
-        en: 'output format: text|json|jsonl (for scripts)',
+        ru: 'поток событий в stdout как JSON Lines — по одному событию на строку (jsonl — каноничное имя, json — его синоним; человеческий текст — в stderr)',
+        en: 'event stream on stdout as JSON Lines, one event per line (jsonl is the canonical name, json a synonym; human text goes to stderr)',
     },
     'help.opt.plan': {
         ru: 'стартовать в режиме плана (только чтение)',
         en: 'start in plan mode (read-only)',
     },
     'help.cmd.loop': {
-        ru: '/loop <интервал> <задача> периодически повторять задачу (напр. 10m)',
-        en: '/loop <interval> <task> repeat a task periodically (e.g. 10m)',
+        ru: '/loop <интервал> <задача> повторять задачу (s/m/h; без единицы — секунды; первый запуск сразу; минимум 15с)',
+        en: '/loop <interval> <task> repeat a task (s/m/h; no unit means seconds; the first run is immediate; minimum 15s)',
     },
     'help.cmd.cron': {
-        ru: '/cron <выражение> <задача> запускать по расписанию (5 полей)',
-        en: '/cron <expr> <task> schedule a task (5-field cron)',
+        ru: '/cron "<мин> <час> <день> <мес> <дow>" <задача> запуск по расписанию (5 полей; первый — только после наступления времени)',
+        en: '/cron "<min> <hour> <dom> <month> <dow>" <task> schedule a task (5 fields; the first run waits for the schedule)',
     },
     'help.cmd.jobs': {
-        ru: '/jobs [rm <id>|clear] список/удаление запланированных задач',
-        en: '/jobs [rm <id>|clear] list/remove scheduled tasks',
+        ru: '/jobs [rm <id>|clear] список запланированных задач; rm <id> — удалить, clear — снять все',
+        en: '/jobs [rm <id>|clear] list scheduled jobs; rm <id> removes one, clear removes all',
     },
     'sched.loop_usage': {
         ru: 'Использование: /loop <интервал> <задача>, например /loop 10m проверь тесты',
@@ -338,9 +344,12 @@ export const helpMessages = {
         ru: 'Интервал «{v}» не распознан — задача НЕ добавлена. Единицы: s/sec, m/min, h (например, /loop 10m проверь тесты). Без единицы — СЕКУНДЫ (120 = 120с), для минут нужен суффикс m.',
         en: 'Interval "{v}" was not recognized — NO job was added. Units: s/sec, m/min, h (e.g. /loop 10m run the tests). Without a unit it means SECONDS (120 = 120s); use the m suffix for minutes.',
     },
+    // The floor is zames' OWN (MIN_LOOP_MS), not the provider throttle: that
+    // one is 15s on DeepSeek, 4s on Qwen and 0 on GLM, so quoting a single
+    // number here was wrong on two of the three backends.
     'sched.loop_too_short': {
-        ru: 'Слишком часто: минимум {min} (троттлинг отправок 15с).',
-        en: 'Too frequent: minimum {min} (the send throttle is 15s).',
+        ru: 'Слишком часто: минимальный интервал /loop — {min} (реже — бессмысленно: отправка всё равно ждёт троттлинга провайдера).',
+        en: 'Too frequent: the minimum /loop interval is {min} (anything faster is pointless: sending still waits for the provider throttle).',
     },
     'sched.added': {
         ru: '⏰ Задача #{id} добавлена ({when}): {task}',
@@ -453,24 +462,24 @@ export const helpMessages = {
         en: 'Directory exists: {v}. Check only — the sandbox is fixed at startup, access is NOT granted (relaunch with --dir to work there).',
     },
     'help.cmd.config': {
-        ru: '/config                  настройки: показать и изменить',
-        en: '/config                  settings: view and edit',
+        ru: '/config [menu|list|show|ls|get|set|reset|unset|path|paths|lang|language] настройки: меню или подкоманды (пишет в домашний конфиг)',
+        en: '/config [menu|list|show|ls|get|set|reset|unset|path|paths|lang|language] settings: menu or subcommands (writes the home config)',
     },
     'help.cmd.lang': {
         ru: '/config lang <ru|en>     сменить язык интерфейса и агента',
         en: '/config lang <ru|en>     switch UI and agent language',
     },
     'help.cmd.provider': {
-        ru: '/provider <id>          переключить провайдера чата',
-        en: '/provider <id>           switch the chat provider',
+        ru: '/provider <id> | status | login — сменить бэкенд (сразу), показать состояние или повторить вход',
+        en: '/provider <id> | status | login — switch the backend (live), show the state or re-run the sign-in',
     },
     'help.cmd.model': {
-        ru: '/model [id]              показать/выбрать модель провайдера',
-        en: '/model [id]              show/pick the provider model',
+        ru: '/model [id]              список моделей или выбор по id (Qwen/GLM; в TUI — список выбора)',
+        en: '/model [id]              list models or pick one by id (Qwen/GLM; the TUI shows a pick list)',
     },
     'help.cmd.debug_dom': {
-        ru: '/debug-dom               сохранить HTML страницы (для отладки)',
-        en: '/debug-dom               dump page HTML (debug)',
+        ru: '/debug-dom               сохранить HTML страницы и найденные селекторы в ~/.zames/logs',
+        en: '/debug-dom               dump page HTML and matched selectors to ~/.zames/logs',
     },
     'help.no_topic': {
         ru: 'Нет команды по запросу «{v}». Попробуй /help без аргумента.',
@@ -522,20 +531,20 @@ export const helpMessages = {
     'help.cmd.skill': { ru: 'навык (SKILL.md)', en: 'skill (SKILL.md)' },
     'help.cmd.custom': { ru: 'пользовательская команда', en: 'custom command' },
     'help.cmd.skills': {
-        ru: '/skills                  список найденных навыков',
-        en: '/skills                  list discovered skills',
+        ru: '/skills                  список навыков: имя, источник, описание, путь',
+        en: '/skills                  list skills: name, source, description, path',
     },
     'help.cmd.memory': {
-        ru: '/memory                  показать MEMORY.md и AGENTS.md',
-        en: '/memory                  show MEMORY.md and AGENTS.md',
+        ru: '/memory                  какие AGENTS.md и MEMORY.md реально загружены (пути)',
+        en: '/memory                  which AGENTS.md and MEMORY.md are loaded (paths)',
     },
     'help.cmd.remember': {
-        ru: '/remember <текст>        дописать заметку в MEMORY.md',
-        en: '/remember <text>         append a note to MEMORY.md',
+        ru: '/remember <текст>        дописать заметку в MEMORY.md проекта (создаст файл)',
+        en: '/remember <text>         append a note to the project MEMORY.md (creates it)',
     },
     'help.cmd.init': {
-        ru: '/init [--force]          изучить проект и создать AGENTS.md',
-        en: '/init [--force]          analyze the project and create AGENTS.md',
+        ru: '/init [--force]          агент изучит проект и напишет AGENTS.md (--force — перезаписать)',
+        en: '/init [--force]          the agent explores the repo and writes AGENTS.md (--force — overwrite)',
     },
     'help.skills': {
         ru: 'Навыки и свои команды:',