Частые вопросы

Короткие ответы на частые вопросы о приложении Marinara Engine. В каждом ответе есть ссылка на руководство с подробными шагами.

Как открыть Marinara Engine с телефона или другого устройства?

Marinara работает как сервер на одном компьютере, а открывается в браузере. Скрипты запуска позволяют другим устройствам достучаться до сервера, но контроль доступа блокирует их, пока вы не зададите вход (имя пользователя и пароль) на компьютере-хосте. До этого удаленное устройство видит только страницу Access blocked (доступ заблокирован).

  1. Оставьте Marinara запущенной на компьютере-хосте.
  2. Узнайте локальный IP-адрес хоста. В Windows выполните ipconfig и посмотрите значение IPv4 Address (адрес IPv4). В macOS или Linux выполните hostname -I.
  3. На другом устройстве откройте в браузере http://<host IP>:7860, например http://192.168.1.42:7860. 7860 – порт по умолчанию.
  4. Задайте вход. Откройте Marinara с другого устройства: на странице блокировки есть форма Setup code (код настройки). Найдите одноразовый код в журнале сервера на компьютере-хосте (в Docker выполните docker logs <container> 2>&1 | grep "setup code"), затем введите его вместе с новыми именем пользователя и паролем. Или откройте Settings → Advanced → Access (настройки → дополнительно → доступ) в браузере, где вы уже вошли на хосте.
  5. Войдите. Чтобы добавить другие устройства без ввода пароля, используйте Add a device (добавить устройство) в Settings → Advanced → Access.

В обычной настольной установке на том же компьютере (127.0.0.1) пароль не нужен. Обратный прокси на том же компьютере считается удаленным посетителем, и ему нужен вход. Все варианты, коды настройки и Docker описаны в руководстве Удаленный доступ. Для устройств в разных сетях используйте Tailscale: см. Подключение откуда угодно через Tailscale. Если подключиться не удается, см. Устранение неполадок.

Есть ли мобильное приложение Marinara?

Отдельного нативного приложения нет. На телефоне или планшете пользуйтесь веб-приложением в браузере. Большинство браузеров предлагают Add to Home Screen (добавить на домашний экран) или Install App (установить приложение). Так оно сохраняется как PWA (сайт, который открывается как приложение, без панели браузера).

На Android можно также скачать последнюю версию APK. Она запускает Marinara на телефоне через Termux. См. Руководство по установке на Android (Termux). Для iPhone и iPad см. Руководство по приложению PWA для iOS / iPadOS.

В приложении для Android экран запуска предлагает Open in browser (открыть в браузере), Retry connection (повторить подключение) и Install / Start Marinara. Чтобы позже изменить выбор, используйте Settings → General → App Behavior → Open Android launcher (app or browser) (настройки → общие → поведение приложения → открыть экран запуска Android: приложение или браузер). В старых APK вход выполняется вручную по адресу /android-login.

Можно ли играть с другими людьми?

Да. Необязательный многопользовательский режим позволяет нескольким людям вести один общий чат Conversation, Roleplay или Game. Каждый участник включает настройку, а затем создает комнату или подключается к ней. Гостям не нужен ключ ИИ. Пароль не делает неизвестного хоста безопасным. Перед включением прочитайте настройку, предупреждения и ограничения многопользовательского режима.

Что за три режима чата?

Как выбрать режим, см. в руководстве Начало работы с приложением Marinara Engine.

Как сменить часовой пояс для расписаний в режиме Conversation?

Откройте чат Conversation, затем выберите Schedule timezone (часовой пояс расписаний) в Chat Settings (настройки чата). Use device (как на устройстве) возвращает часовой пояс вашего устройства. Это одна общая настройка для всех чатов Conversation, и она синхронизируется с другими устройствами на том же сервере. См. Режим Conversation: начало работы.

Есть ли у каждого чата Conversation свое расписание?

Нет. Расписание принадлежит персонажу, поэтому его используют все чаты Conversation с этим персонажем. Изменить его можно в Character Editor → Convo → Weekly schedule (редактор персонажа → Convo → недельное расписание).

Чтобы получать мгновенные ответы в одном чате, выключите Conversation schedules (расписания Conversation) в Chat Settings этого чата. Ручное переопределение статуса, например dnd, все равно действует, и оно принадлежит персонажу во всех чатах. Чтобы снять его, используйте clear.

Нужен ли ключ API, чтобы пользоваться приложением Marinara?

Да, для онлайн-сервисов ИИ. Ключ API – это секретный код от сервиса ИИ, который позволяет Marinara пользоваться вашим аккаунтом в этом сервисе. Чтобы начать чат, нужен хотя бы один аккаунт. Откройте Connections (подключения), нажмите Add (добавить), выберите сервис, вставьте ключ и нажмите Connect (подключиться). См. Подключение к провайдеру ИИ.

Некоторым вариантам ключ не нужен. Варианты по подписке (Claude, ChatGPT и Grok) авторизуются через программу командной строки. Built-in model (встроенная модель) работает на вашем компьютере. См. Настройка встроенной модели.

Какие провайдеры ИИ поддерживаются?

Marinara поддерживает OpenAI, Anthropic, Google Gemini, OpenRouter и многие другие сервисы для генерации текста, изображений и видео, а также серверы OpenAI-compatible (совместимые с OpenAI), например Ollama, LM Studio и KoboldCpp. Полный список – в руководстве Поддерживаемые провайдеры ИИ. Как добавить провайдера, см. Подключение к провайдеру ИИ.

Marinara платная?

Marinara бесплатна. Вы платите только то, что берет ваш сервис ИИ. Кое-что можно попробовать бесплатно: изображениям Pollinations не нужен ключ, Stable Horde бесплатен, а Built-in model работает на вашем компьютере. Варианты по подписке используют платный тариф, который у вас, возможно, уже есть.

Мои ключи API в безопасности?

Да. Каждый ключ API шифруется алгоритмом AES-256 перед сохранением. При экспорте аккаунтов и профилей секретные значения не включаются, поэтому после Import Profile (импорт профиля) введите ключи заново, в том числе после импорта архива ZIP с полной резервной копией. В архиве ZIP с полной резервной копией лежат зашифрованные записи и файл ключа, которым они открываются, поэтому никому его не показывайте. См. Резервное копирование и восстановление.

Что такое карточка персонажа?

Карточка персонажа – это сохраненный профиль персонажа ИИ: имя, аватар, характер, предыстория и приветствие. Карточки создаются в редакторе Character Editor или импортируются из других приложений. См. Создание и редактирование персонажей.

Что такое лорбук и как применить один лорбук к нескольким персонажам?

Лорбук – это набор фактов о мире. Каждая запись попадает в промпт, только когда в чате появляются ее ключевые слова. Вы можете:

  1. Заполнить Linked Characters (связанные персонажи) или Linked Personas (связанные персоны) в редакторе лорбука. Тогда лорбук работает в любом чате с ними.
  2. Открыть Chat Settings → Lorebooks → Add Lorebook (настройки чата → лорбуки → добавить лорбук), чтобы прикрепить его к одному чату.
  3. Ограничить отдельные записи определенными персонажами.

См. Обзор лорбуков.

Что такое агент?

Агент – это необязательный помощник на базе ИИ, который работает во время чата и выполняет одну узкую задачу, например следит за сценой или добавляет карты. После свежей установки агентов нет. Откройте Agents → Agent Organizer (агенты → организатор агентов), выберите агента и установите его. Затем включайте его для каждого чата в Chat Settings. См. Агенты.

Как настроить Noodle?

Noodle – это локальная вымышленная социальная сеть для ваших персонажей. Установите Noodle через Agents → Agent Organizer, перезапустите Marinara, когда она попросит, затем откройте Home → Noodle (главная → Noodle). См. Noodle: встроенная социальная лента.

Почему персонаж не отвечает?

Обычно у чата нет аккаунта или модели, ключ API неверный или на аккаунте закончились средства. См. Персонаж не отвечает.

Почему персонаж не помнит, что было раньше?

Модели читают за раз лишь ограниченный объем текста, поэтому в длинных чатах старые сообщения выпадают. Помогают два инструмента. Memory Recall (память чата) возвращает подходящие старые сообщения, а сводки сжимают старые сообщения в краткие пересказы. Оба находятся в Chat Settings. Для длинных чатов Roleplay используйте Advanced Memory Recall (расширенная память чата) в Chat Settings → Memory Recall. См. Memory Recall и сводки чата.

Как сделать резервную копию данных?

Откройте Settings → Advanced → Backup & Export (настройки → дополнительно → резервная копия и экспорт) и нажмите Download Backup (скачать резервную копию). Так сохраняется архив .zip с вашими данными и загруженными файлами. Чтобы восстановить данные, используйте Import Profile (JSON/ZIP) в разделе Settings → Imports (настройки → импорт). В том же разделе можно включить ежедневное, еженедельное или ежемесячное резервное копирование. См. Резервное копирование и восстановление.

Как работают расширения и можно ли импортировать сторонний код?

По умолчанию черновики личных расширений создает только Professor Mari. Черновик сначала выключен, а перед запуском вы подтверждаете его точный код. Импорт сторонних расширений скрыт, пока администратор хоста не укажет ENABLE_EXTERNAL_EXTENSIONS=true в файле .env и вы не примете предупреждение в Settings → Advanced → Danger Zone (настройки → дополнительно → опасная зона). См. Личные расширения.

Где хранятся мои данные?

На компьютере, где работает Marinara, в папке data внутри установки. В облаке ничего не хранится. См. Где Marinara хранит ваши данные.

Потеряются ли данные при обновлении?

Нет. После обновления персонажи, чаты и настройки остаются на месте. И все же сначала сделайте резервную копию. При возврате на более старую версию можно потерять данные, которые хранит только новая версия. См. Обновление и Переход на старую версию.

Что умеет Professor Mari?

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

Что такое агент Storyboard и как им пользоваться в режиме Game Mode?

Он превращает готовый текст истории в изображения. Установите Storyboard через Agents → Agent Organizer, затем включите его в чате. См. Руководство по агенту Storyboard.

Могут ли персонажи говорить вслух во время звонка?

Да, в режиме Conversation. Для этого нужно настроить Text to Speech (синтез речи) в Connections. Шаги, включая распознавание речи для микрофона, описаны в руководстве Аудио- и видеозвонки в режиме Conversation.

Умеет ли Marinara генерировать изображения?

Да. Добавьте аккаунт для генерации изображений, например Pollinations (ключ не нужен) или платный сервис. См. Подключение к провайдеру ИИ.

Как читать документацию внутри приложения?

На главном экране нажмите Documentation (документация) в закладках. На телефоне сначала откройте меню закладок. В разделе FAQ на главном экране можно также нажать Open Documentation (открыть документацию).

Куда обратиться за помощью или сообщить об ошибке?

Начните с руководства Устранение неполадок. На главном экране Discord открывает чат сообщества, а Support – страницу поддержки проекта. Об ошибках и пожеланиях сообщайте на странице проекта в GitHub.

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