Первые шаги: обучение и стартовая рукопись

Первый запуск: пустого стола не бывает

В первый раз слева нет ни одной записи, а шапка списка говорит «Книги нет». Рукопись при этом молча не заводится: приложение открывает окно «Новая рукопись» и ждёт, какую заготовку вы возьмёте. Что там за карточки — в статье «Шаблоны рукописей».

Рукопись «Как подключить чат» с двумя страницами-инструкциями лежит в этом же окне карточкой «Знакомство: как подключить чат» в категории «Начало работы». Выберете её — в списке появится книга с готовыми инструкциями. В сборке, где окна выбора нет, та же рукопись ставится сама: список у нового пользователя не пустой.

Предложение завести первую рукопись приходит один раз. Дальше за новую книгу отвечают пункт «Файл» → «Новая рукопись» и кнопка на приглашении «Рукопись не открыта».

Обучение: овца проводит по приложению

Экскурсия начинается не с первого запуска, а после того, как первая рукопись создана: пока рукописи нет, показывать нечего. Первый шаг — «Типаж автора», и он сам открывает экран рукописи.

Темы шагов идут по порядку: типаж автора, описание мира, сюжет, правила рукописи, референсы, чаты страницы, агенты, модель и уровень мышления, быстрые подсказки, сообщение и файлы. Последний шаг — «Обучение завершено».

Затемнение вокруг нужного элемента — это четыре прямоугольника, а не плёнка поверх окна. Поэтому подсвеченный блок остаётся живым: тоглы, вкладки и кнопки можно нажимать прямо во время обучения. Рядом встаёт чёрный бабл, сбоку — овца; карточка сама выбирает сторону, где больше места.

Пропустить можно на любом шаге: кнопка «Пропустить обучение» есть везде, Esc закрывает обучение целиком, стрелки ← и → листают шаги. Пройденное или пропущенное обучение запоминается и больше не всплывает.

Запустить заново — «Настройки» → «Обучение». Пункт в списке настроек сразу закрывает настройки и включает тур; в самом разделе ждёт кнопка «Запустить обучение» и статус — «уже пройдено» или «ещё не пройдено».

Если рукописей нет вовсе, запуск из настроек сначала предложит её завести. Закрытую рукопись обучение поднимет само — с полки или из последнего файла.

Стартовая рукопись «Как подключить чат»

Это ответ на вопрос «а как вообще подключить модель». Внутри две страницы-инструкции: «Как подключить Yandex» и «Как подключить GIGA-чат».

Что в них есть: подробные шаги со скриншотами — где взять ключ (Yandex Cloud или Sber Studio), какой шаблон выбрать, что вписать в «API-ключ», «Каталог (Folder ID)» и «Уровень доступа», как проверить связь и выбрать модель в чате. Плюс разбор частых ошибок (401, 403, 422) и честный список того, чего у провайдера пока нет.

• В конце каждой страницы — блок «Полезные ссылки»: консоли провайдеров, документация про ключи и каталог, страницы про сертификаты. Адреса открываются в системном браузере.
• Заголовок страницы показывает сам редактор над текстом, поэтому в тексте инструкции заголовка нет — он не повторяется дважды.
• Страницы остаются примером, а не рамкой: «+» у названия рукописи заводит рядом ещё одну страницу, и пишите в ней.

Что дальше

• Подключите модель. «Настройки» → «Провайдеры»: выберите готовый шаблон провайдера и вставьте ключ. Пока провайдера нет, приложение само предлагает его добавить. Подробно — «Провайдеры и модели», для машин без интернета — «Локальные модели».
• Напишите первую главу. Выберите страницу в списке слева и набирайте текст. Панель форматирования — над текстом, ответы модели приходят в чат справа. Обзор окна — «Экран рукописи: что где находится».
• Сохраните книгу в файл. Рукопись живёт в файле .ovbook: «Файл» → «Сохранить как». Как это устроено — «Книга — это файл».
• Загляните в сочетания клавиш. Их немного, и они быстро становятся привычкой — «Горячие клавиши».

Если что-то в установке пошло не так, начните с «Установка и первый запуск».