# Мобильный доступ и PWA

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

## Подключение с телефона или планшета {#connect}

1. На хосте откройте **Настройки → Удалённый доступ → Удалённое управление**, затем **Запустить удалённое управление**.
2. Отсканируйте QR-код сопряжения мобильным устройством и откройте ссылку в браузере, которым собираетесь пользоваться дальше.
3. Альтернатива — настройте [прямой доступ](remote-access.md), откройте доступный доверенный HTTPS-URL хоста и войдите с паролем сервера.

Удалённое управление требует сопряжения устройства; прямые подключения — маршрутизации, доступного слушателя и аутентификации. Не используйте `localhost` на телефоне для доступа к рабочей станции. Потеря данных сайта или смена профиля браузера может потребовать нового входа или сопряжения; см. [удалённое управление](remote-control.md).

## Установка PWA {#install-pwa}

1. Откройте рабочий URL CodeNomad через доверенный HTTPS в браузере с поддержкой установки.
2. В Chrome/Edge и подобных используйте установку в адресной строке или действие браузера **Install CodeNomad**, если предложено. В Safari iPhone/iPad используйте **Share → Add to Home Screen**; точное название зависит от ОС/браузера.
3. Откройте новый значок запуска и войдите или выполните сопряжение там, если браузерное хранилище отдельное.

Установка относится к устройству/браузеру и origin. Она не устанавливает Node, Git или OpenCode на телефон, не запускает серверную часть и не предоставляет нативные настольные интеграции. Удаление значка не удаляет разговоры хоста; для прекращения доступа отдельно отзовите сопряжённое устройство.

### Безопасный контекст и сертификаты {#secure-context}

Удалённая установка PWA и доступ к микрофону требуют безопасного контекста, признанного браузером. Используйте доверенный HTTPS-сертификат с точным именем хоста/IP. Созданному локальному сертификату устройство/браузер клиента должно явно доверять; страница предупреждения или обход — ненадёжная настройка установки. Исключения localhost браузера относятся к самому устройству, не к HTTP LAN-адресу другого хоста.

Если установки нет, сначала подтвердите доверие HTTPS и поддержку браузера, затем откройте страницу в полном браузере вместо встроенного QR/внутри приложения. При проблемах микрофона проверьте разрешения сайта браузера/ОС и раздел [Голос](voice.md). Не отключайте аутентификацию или проверку TLS ради установки.

## Работа с сенсорным интерфейсом {#touch-layout}

Используйте **Левая панель** и **Правая панель** для навигации и инструментов. На узких экранах панели перекрывают разговор, не навязывая ширину настольного холста; открытие одной плавающей панели закрывает другую. Выбор сессии или **Информация об экземпляре** в плавающей панели сессий закрывает её, чтобы показать выбранное, даже уже показанную сессию; **Назад** и **Вперёд** оставляют её открытой. При нехватке места действия заголовка разговора переходят в меню переполнения.

Поле ввода сохраняет агента, модель и мышление внизу. Размер поля меняется с видимым разговором, включая экранную клавиатуру; длинные черновики прокручиваются. На устройствах только с сенсорным вводом отправка не открывает экранную клавиатуру снова, чтобы вы могли прочитать ответ; коснитесь поля ввода, чтобы продолжить. Пока сессия работает, меню **Больше действий** поля ввода предлагает **Поставить сообщение в очередь** или **Направить сейчас** — то, чего не делает ваша обычная отправка, — без сочетания аппаратной клавиатуры. Открытие прерывания временно сжимает поле ввода без изменения сохранённой высоты и черновика. Отвечайте на разрешения/вопросы в панели над ним, сохраняя доступность её нижних действий. См. [разговоры](conversations.md) и [разрешения](permissions.md).

## Ограничения возможностей и подключения {#limits}

| Возможность | Мобильный браузер / PWA |
| --- | --- |
| Проекты, разговоры, файлы и разрешения | Работают на подключённом серверном хосте с его контролем доступа. Вложения устройства загружаются с телефона; ссылки проекта разрешаются на хосте. |
| Нативные настольные окна, меню ОС и нативная автоматизация хоста | Не предоставляются установкой PWA. |
| Браузерный предпросмотр | Не получает возможности нативного гостевого браузера; резервное отображение ограничено браузером. |
| Контент SideCar и WebSockets | Зависят от пути подключения; удалённое управление блокирует прокси контента SideCar и обслуживает веб-предпросмотр вместе с его WebSocket, пока хост это разрешает. См. [точные ограничения](remote-control.md). |
| Микрофон, буфер обмена, уведомления и приглашение установки | Зависят от браузера/ОС, безопасного контекста и разрешений пользователя. |
| Работа без сети | Нет автономной серверной части или кэшированной истории API. Статические ресурсы интерфейса могут кэшироваться, но документы и ответы API не являются автономным рабочим пространством. |

Поддерживайте доступность серверной части. Приостановка мобильной ОС или смена сети могут разорвать поток событий; возврат переподключает и читает текущее состояние без гарантированного повтора событий. Проверьте завершение действия перед повтором. Закрытие PWA не останавливает отдельную серверную часть; выход из настольного приложения хоста и его серверной части делает удалённое управление недоступным до следующего запуска.