diff --git a/INSTALL.md b/INSTALL.md
index cc8aa55..5897cbf 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,7 +1,27 @@
 # Инструкция по установке
 
-Агент **Dionis** — профиль Hermes Agent: личный помощник. Ставится одной командой из
-файла, который передал вам владелец. Ключ API у каждого свой.
+Агент **Dionis** — профиль Hermes Agent: личный помощник. Ключ API у каждого свой.
+
+---
+
+## Быстрый путь: запустить `setup.cmd`
+
+Если вам передали папку с файлами `setup.cmd`, `setup.ps1` и `vasily-<версия>.bundle` —
+просто **запустите `setup.cmd` двойным кликом**. Скрипт сам:
+
+1. найдёт рядом файл агента;
+2. снимает метку «скачано из интернета» (иначе Windows блокирует запуск);
+3. при необходимости поставит Git и Hermes Agent;
+4. поставит агента (при повторном запуске — обновит);
+5. создаст файл ключа и откроет его в Блокноте — **ключ вписываете вы** (единственный ручной шаг);
+6. проверит, что агент отвечает, и покажет команду запуска.
+
+Windows может один раз спросить подтверждение (SmartScreen) — это нормально.
+Первый запуск занимает несколько минут, окно закрывать нельзя.
+Протокол установки сохраняется рядом: `setup-log.txt`.
+
+Дальше — раздел 5 «Запустить». Остальные разделы нужны, только если что-то пошло не так
+или вы ставите агента вручную.
 
 ---
 
@@ -137,25 +157,24 @@
 
 ## 7. Обновление агента
 
-Владелец передаёт новый файл `vasily-<новая версия>.bundle`. Дальше в PowerShell:
+**Автоматически:** положить новый `vasily-<новая версия>.bundle` в ту же папку, где лежит
+`setup.cmd`, и снова запустить `setup.cmd`. Скрипт увидит установленного агента, обновит
+его и оставит ваш ключ, память и переписку. Прежний бандл можно не удалять — берётся
+самый свежий по имени.
+
+**Вручную**, если предпочитаете команды:
 
 ```powershell
 cd $env:USERPROFILE\Downloads
 git clone vasily-v1.0.2.bundle vasily-dist-new
-
-# снять флаг «только чтение» с внутренних файлов агента (Windows-особенность git)
-powershell -Command "Get-ChildItem -Force -Recurse `"$env:LOCALAPPDATA\hermes\profiles\vasily\.git`" | ForEach-Object { $_.Attributes = 'Normal' }"
+Remove-Item -Recurse -Force .\vasily-dist-new\.git
 
 hermes profile install .\vasily-dist-new --force --yes
 ```
 
-`--force` перезаписывает файлы агента (`SOUL.md`, `config.yaml`, `skills/`),
-**не трогая** ваши `.env` с ключом, память и историю переписки.
-
-> Строка со снятием «только чтение» — не украшение: git кладёт внутренние файлы
-> (`…\vasily\.git\objects\pack\*`) с атрибутом ReadOnly, а установщик при `--force`
-> пытается удалить старую копию и падает с `PermissionError: [WinError 5]`. Если
-> видите эту ошибку — выполните строку с `Attributes = 'Normal'` и повторите установку.
+Строка с удалением `.git` — не украшение: git помечает файлы внутри `.git/objects/pack`
+атрибутом «только чтение», и установщик падает с `PermissionError: [WinError 5]`.
+Если этой папки нет, строка ничего не делает.
 
 Посмотреть, что стоит:
 
@@ -189,6 +208,8 @@
 | `Profile 'vasily' does not exist` | агент не установлен — вернуться к шагу 3 |
 | Ответы вида «нет доступа к модели», 401 | ключ в `.env` пустой/с опечаткой — проверить строку и `hermes -p vasily config env-path` |
 | Установка не находит файл агента | файл не в текущем каталоге — проверить `cd $env:USERPROFILE\Downloads` и имя файла |
-| `PermissionError: [WinError 5]` при обновлении с `--force` | снять «только чтение» в `…\profiles\vasily\.git` (шаг 7) и повторить |
+| `PermissionError: [WinError 5]` при обновлении | удалить папку `.git` в распакованном дистрибутиве перед установкой (шаг 7) |
+| `WinError 32` — файл занят другим процессом | запущено приложение Hermes: значок в трее → Выход, затем запустить `setup.cmd` снова |
+| Установка идёт слишком долго | первый запуск качает Python, Node и зависимости — это минуты, не ошибка |
 | `vasily: команда не найдена` | `C:\Users\<вы>\.local\bin` не в PATH — использовать `hermes -p vasily chat` |
 | Общий диагноз | `hermes -p vasily doctor` |
diff --git a/README.md b/README.md
index d87e44a..a09aaa8 100644
--- a/README.md
+++ b/README.md
@@ -3,10 +3,13 @@
 Профиль Hermes Agent: личный помощник руководителя. Персона, базовый конфиг, 58 скиллов.
 Автор: AI laboratory SCRUM company.
 
-**Получателю агента:** пошаговая инструкция — [`INSTALL.md`](INSTALL.md). Агент
-передаётся файлом `vasily-<версия>.bundle`; доступ к репозиторию не нужен.
+**Получателю агента:** пошаговая инструкция — [`INSTALL.md`](INSTALL.md).
+Короткий путь — запустить `setup.cmd` двойным кликом (он ставит Git, Hermes и агента,
+оставляет вписать только ключ). Вручную — из файла `vasily-<версия>.bundle`,
+доступ к репозиторию не нужен.
 
-**Автору:** это исходник дистрибутива.
+**Автору:** это исходник дистрибутива. Пакет для передачи собирается скриптом
+`dist/vasily-setup/build-package.ps1`.
 
 ## Что внутри
 
diff --git a/distribution.yaml b/distribution.yaml
index d85d2c0..c6218ca 100644
--- a/distribution.yaml
+++ b/distribution.yaml
@@ -1,5 +1,5 @@
 name: vasily
-version: 1.2.0
+version: 1.2.1
 description: "Личный помощник руководителя: документы, письма, договоры, расчёты, поиск, задачи."
 hermes_requires: ">=0.21.6"
 author: "AI laboratory SCRUM company"