@reformer/builder 3.0.0-beta.2 → 3.0.0-beta.3

package/README.md

@@ -61,6 +61,48 @@ npm run builder
   Arc, Brave).
 - **Mode A** — создать новую схему с нуля и выгрузить/скопировать JSON или сгенерированный код.
 
+## Ассистент
+
+Ассистент живёт в правой панели наравне с инспектором: вкладки «Свойства» и «Ассистент» на правом
+рейле переключают зону, `⌘/Ctrl+Shift+K` открывает ассистента, `⌥⌘B` сворачивает зону целиком.
+Он правит форму по описанию на обычном языке: «добавь email», «сделай телефон обязательным»,
+«поставь имя и фамилию в одну строку».
+
+Как это устроено и почему так:
+
+- **Модель не пишет JSON.** Она вызывает операции редактора (вставить узел, задать свойство,
+  перенести, сгруппировать), а схему собирает сам билдер — теми же функциями, что палитра и
+  инспектор. Имена компонентов модель обязана брать из каталога; выдуманное имя отклоняется.
+- **Изменения показываются до применения.** Ход агента правит копию схемы; вы видите список
+  изменений и решаете, применять ли. Применённый ход отменяется **одним** `Ctrl+Z`.
+- **Если форму правили руками, пока агент работал**, применение сообщит о расхождении вместо того,
+  чтобы молча перезаписать вашу правку.
+
+### Подключение канала к модели
+
+Ключ вводится в самой панели (кнопка ⚙) и хранится **в этом браузере**. Поддерживаются:
+
+| Канал                        | Куда идёт запрос                | Ключ            |
+| ---------------------------- | ------------------------------- | --------------- |
+| Anthropic                    | напрямую из браузера            | ваш             |
+| OpenAI                       | напрямую из браузера            | ваш             |
+| Локальный OpenAI-совместимый | `localhost` (Ollama, LM Studio) | обычно не нужен |
+
+Список моделей запрашивается у провайдера — вшитого списка нет, устаревать нечему.
+
+**О безопасности честно.** В облачных каналах запрос идёт из браузера напрямую к провайдеру, и ключ
+доступен странице. Это приемлемо для локального инструмента с вашим собственным ключом (Anthropic
+описывает такой сценарий явно — отсюда заголовок `anthropic-dangerous-direct-browser-access`), но
+для публичного стенда — нет. Используйте ключ с ограниченным бюджетом. Для Ollama потребуется
+разрешить обращение со страницы: `OLLAMA_ORIGINS`.
+
+**Содержимое формы — данные, а не команды.** Подписи и тексты внутри схемы могут содержать текст,
+похожий на инструкцию агенту; ассистент их не исполняет.
+
+Без настроенного канала панель объясняет, чего не хватает, а остальной редактор работает как
+обычно. Ни SDK, ни сама панель не попадают в первый чанк: за ассистента не платит размером тот,
+кто им не пользуется.
+
 ## Шаблоны форм
 
 Новая форма создаётся из **шаблона** — набора файлов с плейсхолдерами вместо имени формы. Панель