zames_pro 2.65.1 → 2.66.1

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.66.1] - 2026-10-07
+
+### Changed
+
+- README: русский перевод теперь свёрнут в `<details>` прямо в `README.md`,
+  поэтому его можно читать на странице npm, не уходя на GitHub. npm рендерит
+  readme тем же GitHub Flavored Markdown, что и GitHub, а отдельный
+  `README.ru.md` на npm-странице не виден (у npm один readme на пакет).
+  Обе языковые версии собираются из `docs/readme.{en,ru}.md` скриптом
+  `npm run build:readme`; `test/readme-built.test.ts` следит за рассинхроном.
+
+## [2.66.0] - 2026-10-07
+
+### Added
+
+- **release:** add scripts/release.mts for one-command release prep (G4)
+
+### Fixed
+
+- **reload:** include commands, run-task and attach-refs in hot-reload (G2)
+
+### Changed
+
+- apply prettier to files touched by G2/F1
+
 ## [2.65.1] - 2026-10-07
 
 ### Fixed

package/README.md

@@ -14,6 +14,12 @@
   <a href="https://github.com/Viqto0r/zames_pro/actions/workflows/test.yml"><img src="https://github.com/Viqto0r/zames_pro/actions/workflows/test.yml/badge.svg" alt="tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
   <a href="package.json"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node.js"></a>
+  <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-strict-3178c6.svg" alt="TypeScript"></a>
+  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome"></a>
+</p>
+
+<p align="center">
+  <strong>English</strong> | <a href="https://github.com/Viqto0r/zames_pro/blob/master/README.ru.md">Русский</a>
 </p>
 
 A terminal coding agent that works on top of [chat.deepseek.com](https://chat.deepseek.com/) through Playwright.
@@ -27,6 +33,28 @@ directory, reads and edits files, runs commands, and commits to git.
   <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/demo.png" alt="zames session in the terminal" width="860">
 </p>
 
+## Quick start
+
+```bash
+npm install -g zames_pro   # Chromium for Playwright is downloaded automatically
+cd your-project            # any folder the agent should work in
+zames                      # sign in once, then describe your task
+```
+
+There is **no API key and no per-token bill**: zames signs in to **your own
+[chat.deepseek.com](https://chat.deepseek.com/) account** in a real (headless)
+Chromium and drives the web chat like a regular user. The first launch asks for
+your DeepSeek login once (the session is stored in `~/.zames/profile`); after
+that just run `zames` and type a task in plain language:
+
+```text
+❯ refactor the config loader and add a test for the new default
+```
+
+While the agent works you can keep typing — a message sent mid-task is queued
+and runs right after it, in the same chat. `Esc` aborts the current generation,
+`/help` lists commands, `/exit` quits.
+
 ## How it works
 
 zames does not call the model API. It launches a headless Chromium with a
@@ -54,7 +82,7 @@ Key pieces:
 
 ## Table of contents
 
-- [Features](#features) · [Why zames?](#why-zames) · [Requirements](#requirements)
+- [Quick start](#quick-start) · [Features](#features) · [Why zames?](#why-zames) · [Requirements](#requirements)
 - [How it works](#how-it-works) · [Installation](#installation) · [Signing in](#signing-in) · [Usage](#usage)
 - [Tools](#tools) · [Slash commands](#slash-commands)
 - [Project context, skills and memory](#project-context-skills-and-memory) · [MCP (external tools)](#mcp-external-tools) · [Configuration](#configuration)
@@ -457,3 +485,487 @@ first-party API client.
 ## License
 
 MIT
+
+<details>
+<summary>🇷🇺 Читать по-русски (Russian)</summary>
+
+Терминальный coding-агент, работающий поверх [chat.deepseek.com](https://chat.deepseek.com/) через Playwright.
+По духу он похож на Claude Code / Codex CLI: запускается в текущей
+директории, читает и правит файлы, выполняет команды и коммитит в git.
+
+> API-ключ не нужен — агент управляет веб-чатом DeepSeek как обычный
+> пользователь через настоящий (headless) браузер.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/demo.png" alt="сессия zames в терминале" width="860">
+</p>
+
+## Быстрый старт
+
+```bash
+npm install -g zames_pro   # Chromium для Playwright скачается автоматически
+cd your-project            # любая папка, в которой должен работать агент
+zames                      # один раз войти, дальше просто описывайте задачу
+```
+
+Здесь **нет API-ключа и нет оплаты за токены**: zames входит в **ваш
+собственный аккаунт [chat.deepseek.com](https://chat.deepseek.com/)** в
+настоящем (headless) Chromium и управляет веб-чатом как обычный пользователь.
+При первом запуске он один раз спросит логин DeepSeek (сессия сохраняется в
+`~/.zames/profile`); после этого достаточно запустить `zames` и написать
+задачу обычным языком:
+
+```text
+❯ отрефактори загрузчик конфига и добавь тест на новый дефолт
+```
+
+Пока агент работает, можно продолжать печатать — сообщение, отправленное
+посреди задачи, встанет в очередь и уйдёт сразу после неё, в тот же чат.
+`Esc` прерывает текущую генерацию, `/help` показывает команды, `/exit` — выход.
+
+## Как это работает
+
+zames не вызывает API модели. Он запускает headless Chromium с постоянным
+профилем, входит в `chat.deepseek.com` как человек, печатает задачу в поле
+чата и читает ответ обратно.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Viqto0r/zames_pro/master/docs/how-it-works.png" alt="как работает zames" width="860">
+</p>
+
+Словами: вы вводите задачу → zames отправляет системный промпт и задачу в
+веб-чат DeepSeek → модель отвечает → zames разбирает вызов инструмента,
+выполняет его локально, возвращает результат обратно и печатает финальный
+ответ.
+
+Ключевые детали:
+
+- **Ответ читается из сырого сетевого потока** (SSE), а не из отрендеренного
+  DOM, поэтому JSON вызова инструмента с шаблонными строками и экранированием
+  остаётся целым.
+- **Постоянный профиль** (`~/.zames/profile`) держит вас залогиненным;
+  User-Agent headless-браузера подменяется, чтобы CDN DeepSeek не отдавал 403
+  на вход.
+- **Троттлинг отправки** (15 с по умолчанию) щадит рейт-лимит веб-чата во
+  время долгих прогонов с инструментами.
+- **Агент запесочен** в директорию запуска — ни один инструмент не может
+  читать или писать выше неё.
+
+## Содержание
+
+- [Быстрый старт](#быстрый-старт) · [Возможности](#возможности) · [Почему zames?](#почему-zames) · [Требования](#требования)
+- [Как это работает](#как-это-работает) · [Установка](#установка) · [Вход в аккаунт](#вход-в-аккаунт) · [Использование](#использование)
+- [Инструменты](#инструменты) · [Слэш-команды](#слэш-команды)
+- [Контекст проекта, навыки и память](#контекст-проекта-навыки-и-память) · [MCP (внешние инструменты)](#mcp-внешние-инструменты) · [Конфигурация](#конфигурация)
+- [FAQ](#faq) · [Ссылки](#ссылки) · [Лицензия](#лицензия)
+
+## Возможности
+
+- **Инструменты как в Claude Code / Codex** — `Read`, `Write`, `Edit`, `Bash`,
+  `Glob`, `Grep`, плюс `MultiEdit`, `ApplyPatch`, `LS`, `TodoWrite`, git- и
+  веб-инструменты. Каждая правка подкреплена `/undo`.
+- **Работает, пока вы печатаете** — сообщения, набранные во время задачи,
+  встают в очередь и уходят сразу после неё, в тот же чат (как набор текста
+  во время генерации на сайте).
+- **Режим плана** — `/plan` (или `--plan`) убирает все мутирующие инструменты,
+  чтобы агент изучал код, не трогая дерево.
+- **Контекст проекта** — читает `AGENTS.md`, `MEMORY.md`, навыки (`SKILL.md`) и
+  пользовательские команды из репозитория и `~/.zames`, как в Codex / Claude
+  Code.
+- **Поддержка MCP** — подключение внешних серверов инструментов (например,
+  `@playwright/mcp`).
+- **Планировщик** — `/loop`, `/cron` и `/jobs` повторяют задачи по таймеру.
+- **Двуязычный интерфейс** — русский / английский (`/config lang`).
+
+## Почему zames?
+
+- **Нет API-ключа и счёта за токены** — используется ваш собственный аккаунт
+  чата DeepSeek, а не платный API. Удобно для долгих задач с инструментами.
+- **Тот же рабочий процесс, что в Claude Code / Codex** — инструменты,
+  `AGENTS.md`, навыки, MCP и слэш-команды, так что всё знакомо с первого дня.
+- **Работает без присмотра** — headless по умолчанию, возобновляемые сессии,
+  `/loop` и `/cron` для задач по расписанию.
+- **Local-first** — профиль браузера, учётные данные и логи не покидают вашу
+  машину, а агент запесочен в директорию проекта.
+
+## Требования
+
+- Node.js >= 20
+- Аккаунт DeepSeek. При первом запуске zames спросит логин/пароль DeepSeek в
+  терминале (и сохранит их в `~/.zames/config.json` после успешного входа,
+  поэтому более поздний разлогин обрабатывается автоматически, без повторных
+  вопросов). Можно также войти вручную в окне браузера, когда он headed.
+
+## Вход в аккаунт
+
+Браузер по умолчанию работает **headless**. Когда DeepSeek требует входа,
+zames:
+
+1. переиспользует сессию из постоянного профиля (`~/.zames/profile`), если она
+   ещё валидна;
+2. иначе входит автоматически по сохранённым учётным данным
+   (`browser.auth.username` / `browser.auth.password`);
+3. иначе спрашивает логин/пароль в терминале (в TTY) и после успешного входа
+   запоминает их для следующего раза;
+4. иначе показывает подсказку про ручной вход.
+
+Чтобы войти руками (например, если DeepSeek показывает капчу), запустите с
+видимым окном:
+
+```bash
+zames --headed
+```
+
+Флаг `--headless` (значение по умолчанию) и `headless: true` в конфиге держат
+браузер без окна; `--headed` / `headless: false` показывают его.
+
+Headless работает из коробки: headless Chrome обычно представляется как
+`HeadlessChrome/...`, и CDN DeepSeek блокирует такой User-Agent ответом 403,
+поэтому zames срезает этот маркер перед загрузкой страницы (сохраняя реальную
+версию движка). `--headed` нужен не только ради входа.
+
+Учётные данные и переключатели можно также править из `/config`
+(`browser.auth.username`, `browser.auth.password`, `browser.auth.saveSession`).
+
+## Установка
+
+```bash
+npm install -g zames_pro
+```
+
+Chromium для Playwright скачивается автоматически при установке. На Linux/WSL
+необходимые системные библиотеки тоже ставятся, если доступен `sudo` без
+пароля; иначе выполните один раз вручную:
+
+```bash
+npx playwright install chromium
+sudo npx playwright install-deps chromium
+```
+
+## Использование
+
+Перейдите в папку проекта и запустите:
+
+```bash
+zames
+```
+
+Агент работает внутри директории, из которой он запущен, и не может её покинуть (песочница).
+
+Пока агент работает, можно продолжать печатать: Enter ставит сообщение в
+очередь (оно уйдёт сразу после текущей задачи, в тот же чат), а Esc / Ctrl+C
+прерывают текущую генерацию. Это повторяет набор текста во время генерации на
+сайте DeepSeek.
+
+### Строка ввода
+
+Промпт — это небольшой редактор строки с постоянной историей:
+
+- `↑` / `↓` — переход по истории сообщений (сохраняется в
+  `~/.zames/history.json`, поэтому переживает перезапуск); внутри
+  многострочного сообщения стрелки двигают по строкам.
+- `Ctrl+R` — инкрементальный поиск по истории в обратном порядке (как в bash):
+  печатайте для фильтра, `Ctrl+R` — за более старыми совпадениями, `Enter` —
+  принять, `Esc` — отменить.
+- `Ctrl+_` — отменить последнюю правку строки ввода (случайно нажатые
+  `Ctrl+U` / `Ctrl+K` можно вернуть).
+- `Ctrl+U` — очистить строку, `Ctrl+K` — удалить до конца строки, `Ctrl+W` —
+  удалить слово перед курсором, `Ctrl+←`/`Ctrl+→` — переход по словам.
+- `\` + `Enter`, `Ctrl+J`, `Ctrl+Enter` или `Shift+Enter` — вставить новую
+  строку.
+- `/` + `Tab` — подсказки и автодополнение слэш-команд.
+- `!команда` — выполнить shell-команду напрямую, минуя модель (как bash-режим
+  Claude Code). Действует та же песочница, что и для инструмента `Bash`, так
+  что прямая команда тоже не может выйти за пределы проекта.
+
+Установите `NO_COLOR=1`, чтобы отключить цвета (иначе используется спокойная
+палитра по умолчанию).
+
+### Картинки и файлы
+
+В строку ввода можно вставить картинку или файл (Ctrl+Shift+V / Shift+Insert
+или собственной вставкой терминала). zames сохраняет его в `<project>/tmp` и
+показывает маркер в строке — `[image#1]` для картинок, `[file#1]` для прочих
+файлов — затем загружает реальный файл в чат вместе с вашим сообщением. Это те
+же форматы, что принимает веб-чат DeepSeek (PNG, JPEG, GIF, WEBP, BMP, SVG и
+обычные типы документов).
+
+Вставка картинки работает, когда терминал передаёт её как `data:` URL или как
+base64-блок с узнаваемой сигнатурой изображения. Можно также вставить путь к
+локальному файлу (перетащите файл в терминал или скопируйте его путь); если
+файл существует — он прикрепляется, иначе текст вставляется как обычно.
+
+Нажмите Ctrl+V (или сделайте пустую вставку), и zames прочитает картинку прямо
+из буфера обмена: Linux через wl-paste (Wayland) или xclip/xsel (X11), macOS
+через pngpaste, Windows через PowerShell. Нужные Linux-утилиты ставятся
+автоматически при `npm install` (best-effort, через определённый пакетный
+менеджер). Если картинка не найдена, zames сообщит об этом и напишет, какой
+инструмент пробовал, вместо молчания.
+
+### Опции
+
+```
+zames --task <текст задачи>
+zames --chat <id>
+zames --new-chat
+zames --resend-prompt
+zames --dir <path>
+zames --headless
+zames --headed
+zames --plan
+zames --output-format jsonl
+zames --debug
+zames --version
+zames --help
+```
+
+### Машиночитаемый вывод (скрипты / CI)
+
+Для одноразовых запусков (`--task`) агент может выдавать поток событий как JSON
+lines в stdout, оставляя весь человеческий текст в stderr:
+
+```bash
+zames --task "summarize the diff" --output-format jsonl
+```
+
+Каждая строка — одно событие (`tool_call`, `tool_result`, `assistant_final`, …),
+так что это сразу пайпится в `jq`:
+
+```bash
+zames --task "..." --output-format jsonl \
+  | jq -r 'select(.type=="assistant_final") | .message'
+```
+
+## Инструменты
+
+У агента тот же стиль инструментов, что в Claude Code / Codex CLI:
+
+- **Файловые** — `Read`, `Write`, `Edit`, `Bash`, `Glob`, `Grep`. `Read` по
+  умолчанию отдаёт сырое содержимое; передайте `numbered=true`, чтобы получить
+  нумерацию строк в стиле `cat -n` (только для справки — не вставляйте её в
+  `Edit`).
+- **Дополнительные** — `LS` (список директории), `MultiEdit` (несколько правок
+  одного файла атомарно), `TodoWrite` (чек-лист задач сессии), `ApplyPatch`
+  (мультифайловый патч в формате V4A от Codex: `*** Begin Patch` … `*** End Patch`).
+- **Git** — `GitStatus`, `GitDiff`, `GitLog`, `GitShow`, `GitBranchList`,
+  `GitAdd`, `GitCommit`, `GitPush`.
+- **Web** — `WebFetch`, `WebSearch`.
+- **Служебный** — `respond` (финальный ответ оператору, завершает задачу).
+
+Все файловые инструменты остаются внутри рабочей директории (песочница).
+`Write`/`Edit` и `MultiEdit`/`ApplyPatch` делают резервную копию (undo) перед
+изменением файла.
+
+## Слэш-команды
+
+Введите / в промпте для подсказок (Tab дополняет). Кроме команд сессии и
+конфига (/new, /chats, /resume, /cd, /status, /config, /undo, /transcript,
+/mcp, /skills, /memory, /init, /reload, /debug-dom, /help, /exit) есть
+несколько в духе Claude Code / Codex CLI:
+
+- /diff [--staged] — показать git-диф рабочего дерева (--staged для индекса).
+- /diffstat — сводка изменений одной строкой (`git diff --stat`).
+- /context — показать, что загружено в промпт (AGENTS.md, MEMORY.md, навыки,
+  пользовательские команды) и размер системного промпта.
+- /retry — отправить последнюю задачу в тот же чат заново (удобно после
+  обрезанного или пустого ответа).
+- /rename <title> — задать заголовок текущей сессии (виден в /sessions).
+- /copy — скопировать последний ответ ассистента в буфер обмена ОС.
+- /cost (алиас /usage) — статистика сессии: задачи, вызовы инструментов,
+  длительность и размер контекста в токенах (DeepSeek
+  `accumulated_token_usage`).
+- /export [file] — записать транскрипт сессии в Markdown-файл
+  (по умолчанию zames-export-<stamp>.md).
+- /doctor — диагностика node, git, конфига, браузера, буфера обмена и MCP.
+- /add-dir <path> — проверить дополнительную директорию (песочница
+  фиксируется при старте; для записи туда перезапустите с --dir).
+- /resume <n> (после /chats) и /resume-id <id> — открыть чат и НАПЕЧАТАТЬ его
+  диалог в терминал, чтобы восстановленный контекст был виден. Показываются
+  только последние 20 сообщений (`RESTORED_HISTORY_LIMIT`). /last открывает
+  последний чат текущей директории без поиска; /sessions показывает сохранённые
+  сессии с их относительным возрастом.
+- /help <command> — полное описание одной команды (например, `/help diff`)
+  вместо всего списка.
+- /review [focus] [--staged] — попросить агента проверить незакоммиченные
+  изменения и сообщить находки (без правок кода).
+- /plan [on|off] — режим плана (только чтение). Пока он включён, мутирующие
+  инструменты (Write/Edit/MultiEdit/ApplyPatch/Bash, GitAdd/GitCommit/GitPush)
+  убраны из набора, чтобы агент изучал код, не трогая дерево. Стартовать в нём
+  можно с `--plan`.
+- /compact — попросить DeepSeek сжать текущий чат в передаточное резюме, затем
+  открыть НОВЫЙ чат, заново отправить системный промпт и положить резюме как
+  перенесённый контекст. Используйте, когда контекст разрастается.
+- /goal [text|clear] — задать долгоживущую цель сессии. Она добавляется в
+  начало каждого сообщения задачи, поэтому модель держит общую картину через
+  много ходов. Хранится в `<project>/.zames-goal` (git-ignored) и
+  восстанавливается при следующем запуске.
+- /loop <interval> <task> — повторять задачу периодически (например,
+  `/loop 10m run the tests`). /cron "<min> <hour> <dom> <month> <dow>" <task> —
+  запуск по расписанию. /jobs [rm <id>|clear] перечисляет и останавливает их.
+  Сработавшая задача попадает в ту же очередь сообщений, что и ваш ввод, так
+  что выполняется, когда агент свободен (никогда посреди генерации), и всё
+  равно соблюдает троттлинг отправки.
+- /thinking [on|off] и /web [on|off] — переключить Deep thinking / Smart search.
+  Их (а также /queue, /jobs, /goal, `/config <sub>`) можно использовать, ПОКА
+  агент работает — они не трогают текущую генерацию.
+- /queue [clear] — показать или очистить сообщения, ждущие отправки после
+  текущей задачи.
+
+Контекст в токенах показывается и вживую: в строке статуса над вводом слева
+спиннер/текст, справа — контекст (например, `125k · 13%`, процент от 1M
+контекста). Он ОКРАШЕН по уровню заполнения: зелёный ниже 50%, жёлтый 50-80%,
+красный выше 80%. Значение приходит из DeepSeek `accumulated_token_usage` и
+скрыто до первого ответа.
+
+## Контекст проекта, навыки и память
+
+Как в Codex / Claude Code, zames читает инструкции проекта и переиспользуемые
+процессы из вашего репозитория и из `~/.zames`.
+
+- **AGENTS.md** — инструкции проекта. Положите его в корень репозитория (или в
+  любую родительскую папку рабочей директории). Глобальные инструкции живут в
+  `~/.zames/AGENTS.md` (и `~/.claude/CLAUDE.md`). Запустите `/init`, и агент
+  изучит проект и напишет AGENTS.md на основе реальных команд сборки/тестов и
+  соглашений (`/init --force` перезапишет существующий файл).
+- **MEMORY.md** — долговечные заметки, переживающие сессии. Агент дописывает
+  сюда полезные факты; можно править вручную или добавить из промпта через
+  `/remember <text>`.
+- **Навыки** — папка с файлом `SKILL.md` (YAML-фронтматтер: `name`,
+  `description`, опционально `allowed-tools`, `user-invokable`) плюс любые
+  вспомогательные файлы. Ищутся в `.zames/skills/`, `.claude/skills/`,
+  `.agents/skills/`, `skills/` и `~/.zames/skills/`. Агент читает тело только
+  когда задача совпадает с описанием. Список — `/skills`; вызов —
+  `/<skill-name>`.
+- **Пользовательские команды** — `.md`-файлы в `.zames/commands/` (или
+  `.claude/commands/`). Поддерживают подстановки `$ARGUMENTS` / `{{args}}` и
+  вызываются как `/<command-name>`.
+
+Навыки и пользовательские команды видны в списке автодополнения «/» и в
+`/help`.
+
+```
+/skills                       список найденных навыков
+/memory                       показать действующие AGENTS.md / MEMORY.md
+/remember <text>              дописать долговечную заметку в MEMORY.md
+/init [--force]               проанализировать проект и создать AGENTS.md
+```
+
+## MCP (внешние инструменты)
+
+zames может использовать инструменты с серверов [MCP](https://modelcontextprotocol.io).
+Главный пример — @playwright/mcp: он даёт агенту настоящий браузер
+(navigate, click, snapshot, type, ...) поверх того, который zames уже
+использует для чата DeepSeek.
+
+Положите файл конфига (той же формы, что в Claude Code / Cursor):
+
+- `~/.zames/mcp.json` — глобальный
+- `<project>/.zames/mcp.json` — на уровне проекта (поздние файлы побеждают)
+- `<project>/.mcp.json` — привычное имя MCP
+
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest", "--headless", "--isolated"]
+    }
+  }
+}
+```
+
+ВАЖНО: держите MCP-браузер изолированным. @playwright/mcp по умолчанию
+использует ТУ ЖЕ директорию профиля, что и zames (~/.zames/profile). Если
+запустить его без --isolated (или без собственного --user-data-dir),
+MCP-браузер и браузер агента подерутся за один профиль, и чат DeepSeek
+покажет «Something went wrong when opening your profile». Всегда передавайте
+--isolated, как в примере выше.
+Серверы бывают и удалёнными ("url": "https://...", "transport": "sse").
+Их инструменты видны агенту как `server__tool` (например,
+`playwright__browser_navigate`) и перечисляются в `/mcp` и `/status`.
+Сервер, который не смог подключиться, пропускается с предупреждением и
+никогда не роняет агента.
+
+## Конфигурация
+
+Глобальный конфиг: `~/.zames/config.json`
+Локальный (на проект): `.zamesrc.json`
+
+Просматривать и менять настройки можно не выходя из агента — командой
+`/config`. Запустите её без аргументов, чтобы открыть интерактивное меню
+(↑/↓ — навигация, Enter — изменение, `d` — сброс, `q` — выход). Булевы и
+enum переключаются на месте; числа и строки открывают ввод.
+
+```
+/config                       интерактивное меню настроек
+/config list                  показать все изменяемые настройки
+/config get <path>            показать настройку
+/config set <path> <value>    изменить настройку
+/config reset <path>          сбросить настройку к дефолту
+/config path                  показать пути файлов конфига
+/config lang <ru|en>          переключить язык интерфейса и агента
+```
+
+Примеры:
+
+```
+/config set maxIterations 20
+/config set browser.deepThinking true   # DeepSeek Deep thinking (медленно; рассуждения скрыты)
+/config set browser.webSearch false     # DeepSeek Smart web search
+/config lang en
+```
+
+Изменения пишутся в проектный `.zamesrc.json` и применяются сразу (где это
+возможно без перезапуска).
+
+### Язык
+
+`/config lang ru` или `/config lang en` переключает и язык интерфейса
+(справка, сообщения, спиннер), и язык, на котором агент вам отвечает. Локаль
+хранится в `ui.locale` в файле конфига.
+
+Данные агента хранятся в `~/.zames`: профиль браузера, логи, история undo,
+сессии.
+
+## FAQ
+
+**Это официальный продукт DeepSeek?**
+Нет. zames управляет публичным веб-интерфейсом chat.deepseek.com через
+настоящий браузер, как обычный пользователь. Он не связан с DeepSeek.
+
+**Нужен ли API-ключ?**
+Нет. Вы один раз входите в свой аккаунт DeepSeek; сессия хранится в
+`~/.zames/profile` и переиспользуется.
+
+**Какую модель он использует?**
+Ту, которую использует веб-чат DeepSeek (DeepSeek-V3 или reasoning-модель при
+включённом «Deep thinking»). zames никогда не вызывает API напрямую.
+
+**Работает ли headless / на сервере?**
+Да — headless по умолчанию, а `--output-format jsonl` делает его скриптуемым.
+`--headed` нужен только для ручного входа или отладки селекторов.
+
+**Разрешена ли автоматизация веб-интерфейса?**
+Это зависит от условий DeepSeek; автоматизация сайта может их нарушать.
+Используйте на свой риск и держите троттлинг отправки (15 с по умолчанию),
+чтобы не бить по рейт-лимиту.
+
+**Чем отличается от Claude Code / Codex?**
+Та же форма (инструменты, `AGENTS.md`, навыки, MCP, слэш-команды), но работает
+на вашем аккаунте DeepSeek вместо API, как автоматизация браузера, а не
+first-party API-клиент.
+
+## Ссылки
+
+- **npm:** <https://www.npmjs.com/package/zames_pro>
+- **GitHub:** <https://github.com/Viqto0r/zames_pro>
+- **Changelog:** [`CHANGELOG.md`](CHANGELOG.md)
+- **Contributing:** [`CONTRIBUTING.md`](CONTRIBUTING.md)
+- **Security policy:** [`SECURITY.md`](SECURITY.md)
+- **Code of conduct:** [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)
+
+## Лицензия
+
+MIT
+
+</details>