Professor Mari, ваш встроенный ассистент

Professor Mari – встроенный ассистент на главном экране. Она объясняет приложение, помогает его настроить, а также создает или правит для вас персонажей, персоны, лорбуки и пресеты. Ее изменения можно отменить с карточки изменений в течение ограниченного времени (см. Проверка ее изменений).

Где ее найти

1. Перейдите на главный экран. Он виден, когда не открыт ни один чат.
2. Нажмите Ask Professor Mari (спросить Professor Mari) в виджете Professor Mari или нажмите вкладку Professor.

Откроется ее окно. До нее можно добраться и с любого экрана: введите текст в поиске и выберите Ask Prof. Mari (спросить Professor Mari), нажмите <kbd>Ctrl</kbd>+<kbd>J</kbd> (<kbd>⌘</kbd>+<kbd>J</kbd> на Mac) или, на телефоне, потяните вниз от верхней панели. В шапке ее окна написано Ready to help, когда она свободна, и Working on it..., пока она работает.

Напишите сообщение обычным языком и нажмите <kbd>Enter</kbd>. <kbd>Shift</kbd>+<kbd>Enter</kbd> переносит строку. Если выключить Enter sends to Professor Mari (Enter отправляет Professor Mari) в ее настройках, <kbd>Enter</kbd> переносит строку, а <kbd>Ctrl</kbd>+<kbd>Enter</kbd> отправляет. Первое сообщение открывает достижение Hello World.

Все ее настройки открываются через Settings → General → Search and Professor Mari settings → Open (настройки → общие → настройки поиска и Professor Mari → открыть) или шестеренкой в поиске. На компьютере ползунки Height (высота) и Width (ширина) в разделе Professor Mari window (окно Professor Mari) меняют размер ее окна. На телефоне ее окно занимает весь экран.

Создание персонажа с Mari

Перед началом: добавьте аккаунт для генерации текста. См. Подключение к провайдеру ИИ и Выбор аккаунта для нее.

1. Откройте ее окно (см. выше).
2. Если в чате уже есть сообщения, сначала нажмите New chat (новый чат). Текущий чат сохранится в Chats (чаты).
3. Нажмите плашку Create a character (создать персонажа). Она заполнит поле сообщения. Если плашки нет, напишите запрос сами.
4. Допишите к тексту свою идею, например имя и характер, затем нажмите <kbd>Enter</kbd>.
5. Ответьте на ее вопросы. Выберите вариант или напишите свой, затем нажмите Submit (отправить).
6. Когда она закончит, нажмите Open на результате, чтобы посмотреть нового персонажа.
7. Если изменение вам не нравится, нажмите Undo (отменить) на его карточке изменений.

Если не получилось: если аккаунт не добавлен, при нажатии кнопки отправки открывается список Connections (подключения). Выберите или добавьте аккаунт там.

Что она умеет

Перед правкой она читает объект, а если запрос расплывчатый, переспрашивает.

• Объяснить настройку, режим или понятие.
• Создать или отредактировать персонажа, персону или лорбук. Карточка персонажа задает ИИ имя, характер и манеру речи. Персона – это карточка персонажа, которая представляет вас. Лорбук – это набор фактов о мире, которые ИИ читает, когда в чате появляются их ключевые слова.
• Написать для персонажа интерактивный онбординг и заполнить лист набора правил для установленного набора правил Game Mode. Если значение не соответствует набору правил, ее правка отклоняется с объяснением причины.
• Создать или отредактировать тему оформления, агента, пресет промпта или черновик личного расширения (Personal Extension). Черновик остается выключенным, пока вы не прочитаете его код и не одобрите его в Settings → Addons (настройки → дополнения).
• Отредактировать один раздел пресета на месте, не заменяя весь пресет.
• Сравнить агентов для скачивания и подсказать, какие подходят под вашу цель. Для установки она направляет вас в Agents → Agent Organizer (агенты → организатор агентов). См. Справочник агентов для скачивания.
• Создать или назначить изображения, например аватары, спрайты и фоны. Сначала нужен аккаунт для генерации изображений. Сама она его не создает.
• Найти общедоступные страницы вики Fandom, когда вы собираете материал о персонаже или мире.

Начните с плашки

В пустом чате Professor Mari начать помогают стартовые плашки: Create a character, Create a lorebook (создать лорбук) и Create a persona (создать персону). Нажмите плашку, чтобы заполнить поле сообщения, затем отредактируйте текст перед отправкой. Во время пошаговой задачи плашки меняются под следующий шаг. Плашки бывают только в чатах Professor Mari.

Когда в запросе остаются настоящие развилки, она может задать вопросы в карточке с вопросами под своим ответом: до четырех вопросов, по одному, с вариантами и отмеченной рекомендацией. Выберите вариант или напишите свой, затем нажмите Submit. Ваши ответы уходят следующим сообщением. Можно и не трогать карточку, а написать сообщение. Ничего из того, что она предложила вместе с вопросом, не выполняется, пока вы не ответите.

Спросите там, где вы работаете

Эти места открывают ее с редактируемым черновиком и небольшой плашкой Context (контекст). Это метка над полем сообщения, и ее можно убрать перед отправкой:

• Редакторы Character, Persona, Lorebook и Preset (персонажа, персоны, лорбука и пресета).
• Ответы FAQ: Ask Prof. Mari about this (спросить Professor Mari об этом).
• Поиск: выберите результат, затем Ask Prof. Mari.
• Состояния ошибки, например с кнопкой Try again (попробовать снова): Ask Professor Mari.

Она не получает объект целиком только потому, что вы открыли его редактор.

Выбор аккаунта для нее

Перед началом: добавьте аккаунт для генерации текста. См. Подключение к провайдеру ИИ.

1. Нажмите кнопку подключения рядом со скрепкой. На ней написано название ее аккаунта или Select connection (выбрать подключение), если аккаунт не выбран.
2. Выберите аккаунт для генерации текста в списке Connections. Если вы скачали Built-in model (встроенная модель), она тоже появится здесь.
3. Нажмите на модель в списке, чтобы использовать ее. Модель сохраняется в аккаунте, поэтому другие ваши чаты с этим аккаунтом тоже переключатся на нее. У Built-in model списка моделей нет.

На телефоне коснитесь аккаунта, чтобы использовать его, или коснитесь стрелки в конце его строки, чтобы сначала увидеть его модели. Если аккаунтов еще нет, в списке написано Add a connection (добавить подключение).

Проверка ее изменений

Когда она что-то меняет, она сразу сохраняет изменение и показывает под своим ответом карточку изменений. В карточке перечислено каждое измененное поле. Для правки текста видны старые и новые слова. Show all (показать все) показывает все поля, а Technical details (технические подробности) – исходную команду.

У карточки одно действие: Undo. Оно возвращает предыдущую сохраненную версию. Пока хранится копия для отмены, любое изменение можно отменить в любом режиме разрешений. Режим разрешений решает только то, спрашивает ли она сначала.

• Not saved с причиной означает, что изменение не удалось. Try again снова отправляет ей запрос.
• Пометка Undo until видна только в последние 24 часа. Копия для отмены хранится до 14 дней, и сохраняются только 50 самых новых. После этого на карточке написано Undo closed, а изменение остается.
• Шаг в списке ее работы, который заканчивается на · not saved, был только предпросмотром. Ничего не изменилось.
• Правка, которая ничего не меняет, не сохраняется и не получает карточку.
• У персонажей и персон есть еще история версий в редакторах – второй способ вернуться назад.
• Она не может редактировать или удалять собственную карточку. Marinara восстанавливает ее при каждом запуске.

Карточка принадлежит чату, в котором она внесла изменение. При удалении чата его изменения сохраняются, а карточки удаляются.

Изменения, которые ждут вас

Отложенное изменение не сохраняется сразу, а ждет. Оно показывает Apply (применить) и Don't apply (не применять). Удаление показывает Delete (удалить) и Put back (вернуть). Изменения откладываются в режиме Manual, а также для важных файлов и зависимостей (см. Отложенные изменения файлов и библиотек). Поиск не показывает ее изменения: чтобы применить или отменить их, откройте Professor Mari.

Когда она создает или обновляет персонажа, персону, лорбук или пресет, в результате может появиться кнопка Open, которая открывает этот объект. У результата обновления может быть и кнопка Review (проверить), пока ожидается проверка.

Меню скрепки

Нажмите кнопку со скрепкой, подписанную Attach (прикрепить). В меню три раздела.

Те же действия можно набрать через /. См. Команды через /.

Прикрепление файлов

Выберите Attach files or photos или введите /attach. Она принимает изображения, файлы PDF и текстовые файлы, например .txt, .md, .json, .csv и .log, до 20 МБ каждый. Скриншот или файл можно также вставить в поле сообщения. Чтобы она прочитала изображение, выбранная модель должна принимать изображения на вход.

Ссылки на объекты через @

Введите @, чтобы указать ей на что-то из вашей библиотеки. Откроется список, сгруппированный по разделам Characters (персонажи), Personas (персоны), Lorebooks (лорбуки), Presets (пресеты), Skills, Memories, Chats, Agents (агенты) и Docs (документация). Продолжайте вводить, чтобы сузить список. Имена с пробелами не нужно заключать в кавычки.

• Стрелками перемещайтесь по списку, <kbd>Enter</kbd> или <kbd>Tab</kbd> выбирают пункт, а <kbd>Escape</kbd> закрывает список. На лорбуке стрелка вправо показывает его Entries (записи), чтобы можно было сослаться на одну запись.
• Рядом с редактором первая строка, Open beside me (открыто рядом со мной), добавляет ссылку на то, что открыто в редакторе. Рядом с редактором персонажа ее › (или стрелка вправо) показывает Fields (поля). Выбор поля переключает поле, над которым она работает, и заменяет плашку поля в строке контекста.
• Выбранное имя показывается плашкой над полем сообщения. Если удалить имя, ссылка исчезнет вместе с ним. × на плашке убирает ссылку, но оставляет ваш текст.
• В обычном тексте <kbd>Tab</kbd> дополняет имя, которое она предлагает серым цветом. Нажмите <kbd>Tab</kbd> еще раз, чтобы сделать его ссылкой. На сенсорном экране коснитесь серого имени, затем Tap to link (коснитесь, чтобы сделать ссылкой).

Ссылка отправляется один раз, вместе с сообщением, в которое вы ее добавили. После этого она видит однострочную пометку и при необходимости перечитывает объект. В одном сообщении может быть до 8 ссылок. Если вместе они занимают больше примерно четверти контекста модели (но не больше 60 000 символов), последние не отправляются. Вместо них она получает пометку и может прочитать их сама. Материалы по ссылкам считаются информацией, а не инструкциями.

Команды через /

Введите / в начале строки, чтобы увидеть список ее команд. Продолжайте вводить, чтобы отфильтровать список, затем нажмите <kbd>Enter</kbd>. В списке также есть ваши Skills и Memories. Выбор любого из них добавляет ссылку на него, как @.

Сообщения, пока она работает

Поле сообщения остается открытым, пока она работает. Вы сами выбираете, когда сообщение до нее дойдет.

• Send now (отправить сейчас) вставляет сообщение на ее следующем шаге, не останавливая ее. Ее ответ до этого момента сохраняется, ваше сообщение появляется под ним, и она продолжает, учитывая его.
• Send after her answer (отправить после ее ответа) ждет в списке над полем с пометкой Sends when she finishes. Когда она завершает работу без сбоев, она берет ожидающие сообщения по одному.

• Enter sends включено (по умолчанию): <kbd>Enter</kbd> отправляет сейчас. <kbd>Ctrl</kbd>+<kbd>Enter</kbd> ставит в очередь.
• Enter sends выключено: <kbd>Ctrl</kbd>+<kbd>Enter</kbd> отправляет сейчас. <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd> ставит в очередь.

На Mac используйте <kbd>⌘</kbd> вместо <kbd>Ctrl</kbd>. Пока она работает, в пустом поле сообщения есть только кнопка Stop (остановить), которая отменяет текущую задачу. Когда вы начинаете печатать, Stop сменяется кнопкой отправки. Нажмите ее, чтобы выбрать Send now или Send after her answer. Это удобно на телефоне.

Send now подходит только для слов. Сообщение с файлами, ссылками @ или переданным полем вместо этого попадает в очередь. Так же поступает сообщение на другую тему или отправленное после смены режима разрешений. Об этом сообщает короткое уведомление. Нажмите X на сообщении, чтобы убрать его. В чате может ждать до 20 сообщений.

В таких случаях ожидающие сообщения не отправляются сами:

• Вы нажали Stop. Они возвращаются в поле сообщения.
• Она ждет вас (одобрения или ответа), запуск завершился ошибкой или приложение перезапустилось. Они показываются со статусом Held и кнопкой Send (отправить). Send отправляет только это одно сообщение.

Команды /restart и /title не работают, пока она занята. Они остаются в поле, пока она не закончит.

В длинной работе она ведет список дел под своим последним сообщением со счетчиком вроде 2 of 5. Редактировать его нельзя. После того как вы напишете новое сообщение, список становится приглушенным и подписывается Plan from before your last message.

Как найти чаты с Professor Mari

Ее чаты хранятся отдельно от обычного списка чатов.

1. Нажмите Chats в ее шапке.
2. Найдите чат через Search Prof. Mari chats (поиск по чатам с Professor Mari). Нажмите на чат, чтобы открыть его. Там же его можно переименовать или удалить.

Чтобы начать заново, нажмите New chat или введите /new. Сначала текущий чат сохраняется, и появляется сообщение Professor Mari's previous chat was saved.

Быстрые ответы в поиске

Быстрые ответы выключены, пока вы не включите Quick answers in Search (быстрые ответы в поиске) в Search and Professor Mari settings. Если вы вводите вопрос в поиске и ни один результат не подходит, она пишет короткий ответ только для чтения в карточке Quick answer · Read-only.

• В нем до трех предложений из документации Marinara. Он называет страницы, на которые опирается, и ничего не меняет. Тот же вопрос в течение пяти минут получает сохраненную копию.
• Под ним: Copy (скопировать), Answer again (ответить заново) и Continue with Prof. Mari (продолжить с Professor Mari). Последняя кнопка открывает ее окно в новом чате, названном по вашему вопросу.
• Wait after typing (пауза после ввода) задает, сколько ждет поиск. Answer with (чем отвечать) выбирает, кто отвечает: скачанная вами модель, Same as Prof. Mari (то же, что у Professor Mari) или другой аккаунт. Каждый ответ – один короткий запрос, поэтому платный аккаунт может стоить денег.
• Если ответ не получился, карточка объясняет почему. Choose a model (выбрать модель) появляется, только когда не хватает ключа или модели. Собственное сообщение сервиса находится под Details (подробности).

Справочник: настройки, Skills и воспоминания

Строка состояния и плашка на верхней панели

Ее окно можно закрыть, пока она работает. Тонкая линия вдоль нижнего края верхней панели колеблется, пока она работает, становится зеленой, когда она закончила, золотой, пока ждет одобрения, и красной, если последний запуск не удался. Пока ее окно закрыто, плашка на верхней панели показывает Working, Needs you, Done или Failed. Нажмите на плашку, чтобы вернуться в ее чат.

Внешний вид

В Search and Professor Mari settings → Appearance (настройки поиска и Professor Mari → внешний вид) выберите облик, например Basic, Prof. Mari loves Dottore или Safari Prof. Mari. Он виден в ее чате, в поиске, на главном экране и на верхней панели. Некоторые облики открываются после достаточного времени игры, а закрытый облик показывает, сколько часов вы уже наиграли.

Skills

Skill – это короткий документ с инструкцией, который меняет то, как она обрабатывает определенный вид запросов.

1. Нажмите Skills в ее шапке. Откроется панель Professor Mari skills.
2. Нажмите New (создать), чтобы начать с шаблона, или Upload (загрузить), чтобы добавить файл .md или .txt.
3. Выберите Skill, чтобы отредактировать его поля Name, Description и Instructions, затем нажмите Save (сохранить). Delete удаляет его.

Выключите Skill, чтобы сохранить его, но не использовать. Если Skills нет, на панели написано No custom skills yet.

Встроенные Skills показаны в разделе Always on (всегда включены) с пометкой Built-in. Это ее руководства по персонажам, лорбукам, пресетам, темам оформления, расширениям, виджетам главного экрана и другим темам. Они доступны только для чтения, а обновление приложения заменяет их. Чтобы изменить один из них, скопируйте его текст в новый собственный Skill.

Воспоминания

Воспоминание – это постоянное предпочтение, которое она хранит, например как вы любите задавать ключевые слова записей лорбука. Попросите ее ("запомни, что ключевым словом записей я всегда делаю имя персонажа") или откройте Memories в ее шапке, чтобы создавать, редактировать, включать и выключать или удалять воспоминания, либо загрузить текстовый файл через Upload.

• Сохраненное ею воспоминание сначала выключено. Карточка изменений предлагает Turn on (включить). Она сохраняет воспоминание, только когда вы просите, и никогда из-за того, что ей велел прочитанный текст.
• Каждый раз она видит только короткий индекс ваших включенных воспоминаний и читает полный текст, когда воспоминание относится к делу. Воспоминание Persistent (постоянное) у нее перед глазами каждый раз, поэтому таких должно быть мало и они должны быть короткими.
• Если воспоминания расходятся с ее привычками по умолчанию, воспоминания важнее.

Доверие и восстановление после сбоев

Откройте Context в ее шапке, чтобы увидеть, что уйдет с вашим следующим сообщением, что остается в этом чате и как она работает: модель, лимит контекста и выполняется ли ее оболочка в изолированной среде. В шапке также видны ожидающие одобрения, Skills и Memories. Context не дает дополнительного доступа.

Если запрос не удался, чат сохраняет причину и показывает Retry (повторить), когда запрос можно отправить снова. Сначала устраните названную проблему с аккаунтом, изолированной средой или доступом. Если ваш вопрос не сохранился, он возвращается в поле сообщения вместе с файлами. Retry и Retry with another model (повторить с другой моделью) затем отправляют то, что находится в поле.

Как читать FAQ

Нажмите закладку FAQ или Read FAQ (читать FAQ) в виджете Learn the engine (изучить приложение), чтобы открыть Professor Mari's FAQ (FAQ от Professor Mari). Это готовый написанный список, а не чат с ИИ, поэтому он не знает вашу настройку. Введите текст в Search FAQ (поиск по FAQ), чтобы отфильтровать вопросы. У каждого вопроса есть тег категории, например Setup, Connections или Game Mode. Коснитесь вопроса, чтобы прочитать ответ.

Ограничения и безопасность

• Она не может обещать, что ее встроенные знания совпадают с вашей версией приложения. Во всем, что зависит от версии, доверяйте руководствам и заметкам о выпуске.
• Создание нового обычно безопасно. Правка существующего требует большей осторожности. Называйте конкретный объект и поле: "сократи приветствие Luna, характер оставь прежним" безопаснее, чем "перепиши этого персонажа".
• Если она говорит, что закончила, а в приложении этого не видно, верьте приложению и доделайте задачу в соответствующей панели.
• Если вы открываете Marinara с другого устройства, для ее правок нужен настроенный удаленный доступ. См. Удаленный доступ: вход и список разрешенных адресов.

Устранение неполадок

Справочник для опытных пользователей

Эти разделы для тех, кто правит собственные файлы Marinara или хочет настроить, как она работает. Их можно пропустить.

Среда выполнения

В разделе Runtime (среда выполнения) можно выбрать Pi (experimental), вариант по умолчанию, или Classic (классический). Pi – это режим, в котором она больше думает, прежде чем действовать, и справляется с более длинными задачами. Если ваш аккаунт не может запустить Pi, она использует Classic. Изменение действует с ее следующего ответа, а Undo работает одинаково в обоих режимах. Если она странно ведет себя в Pi, переключитесь на Classic.

Read the handbook before the first write (читать руководство перед первой правкой), тоже в разделе Runtime, по умолчанию включено. Ее первая правка в области, для которой есть встроенный Skill, отклоняется, пока она не прочитает этот Skill. Это помогает небольшим моделям. Выключить эту настройку можете только вы.

Что ей доступно на вашем компьютере

Она может читать и менять собственные программные файлы Marinara и запускать команды в изолированной среде, поэтому может починить приложение. Большинству это никогда не понадобится.

• Ее файловые инструменты не выходят за папку, куда установлена Marinara. Прямые команды оболочки не могут читать другие ваши личные файлы, не имеют доступа к сети и не наследуют секреты сервера.
• .env, файл ключа, который защищает ваши сохраненные ключи API, и внутренние файлы Git ей недоступны.
• Она не может писать напрямую в папку данных, где лежат ваши персонажи и чаты. Вместо этого она использует описанный выше порядок изменений с проверкой.
• Изменения манифестов зависимостей, файлов блокировки, скриптов запуска, установщиков и процессов CI сначала подготавливаются и ждут вашего одобрения. Скрипты установки пакетов остаются выключенными.
• Команды сами останавливаются через короткое время.
• Если Marinara не может предоставить изолированную оболочку для macOS или Linux, прямые команды оболочки и mari code check выключаются. Она по-прежнему может пользоваться структурированными инструментами для файлов и данных приложения.

Отложенные изменения файлов и библиотек

• Sensitive files (важные файлы: файлы зависимостей, скрипты запуска, установщики, процессы CI) показывают путь и новое содержимое с кнопками Apply change (применить изменение) и Discard (отклонить).
• Dependencies (зависимости) показывают пакет npm, точную версию и контрольную сумму из реестра с кнопками Install (установить) и Not now (не сейчас). Команды установки в ее оболочке заблокированы. Одобрить библиотеку – значит довериться ее коду, когда Marinara его запускает.

Как она работает с решениями

Модель решений – это небольшая модель, которая отвечает на вопросы "да или нет". Для Activation questions (вопросы активации) агентов, утверждений Decision (решение) в лорбуках и условных промптов она сначала проверяет, какую модель решений вы выбрали.

• Она спрашивает, прежде чем добавить содержимое с решениями, а без модели решений не добавляет решения в новую работу, если вы не попросите.
• Она предпочитает использовать решения редко и с таймером: Sticky (удержание) или Cooldown (пауза) для записей лорбука, Trigger Cadence (периодичность запуска) для активации агентов, sticky, cooldown или every в условиях промпта.
• Она спрашивает, прежде чем добавить изменяемое содержимое в начало промпта или внутрь истории чата, чтобы начало промпта оставалось стабильным для кеширования промптов у сервиса.
• Скажите ей "Stop reminding me to set up a Decision model", чтобы напоминания прекратились.

См. Модели решений, Условные промпты, Создание своих агентов и Записи лорбука.

Команда mari

Изменение, сделанное командой mari в терминале, не принадлежит ни одному чату, поэтому его карточка изменений появляется во всех чатах Professor Mari.

Смежные руководства

• Начало работы с приложением Marinara Engine
• Обучающий тур при первом запуске
• Подключение к провайдеру ИИ
• Создание и редактирование персонажей
• Справочник агентов для скачивания
• Удаленный доступ: вход и список разрешенных адресов