1dabb5110f
docs(help): bring the user guide back in line with the current app The help was written on 2026-10-14 and about forty user-visible changes merged since without touching it, so several pages described controls that no longer exist: Missions still listed four playbooks and a Save step for preferences that now save on each change, the depth editor kept its old names, notifications still had their former switches, and voice input pointed to a microphone button that is not in the composer. Every English page was re-checked claim by claim against the current labels (English UI messages) and behaviour, then the nine translations were updated to match, using each locale's own UI labels. Notable corrections: Missions (Compare two models, autosaving defaults with Apply to / Global / Reset, Subsession nesting depth, prepared hand-offs, retired-task interrupts, the named causes of "Mission Control is unavailable", standalone server support); conversations and history (reasoning/tool durations, token lines adding up the cleanup selection, presets including Nothing, timeline markers following Message content, in-place reveal of long text, Open in session, focus after send, Queue message / Steer now, Retrying); settings (notification routing table and defaults, Stats, Mode, info tips, Server setting badge, localized native menus); shortcuts (72 actions, Clear shortcut, Ctrl/Cmd+K); voice (More actions entries, Save status); files (live Workspace refresh, Show 200 more); OpenCode, install, server and updates (2.1.1 recommended, OpenCode 2 beside an older installation, version card first, private loopback listener for Missions, preview releases offered once all builds are published); providers, integrations, browser, SideCars, desktop and remote pages. Translations also repaired older drift, mainly the project-tab closing passages. The Chat settings table header (Default state, its title, item column, the thinking row and its accessible label) was still English in eight locales; it is now translated so the help can cite what users see. AGENTS.md now asks every PR changing user-visible behavior to update the affected help pages in the same PR, since CI validates structure and links but not whether the text still matches the UI; it also corrects the needs-input notification default. USER_HELP.md no longer claims native menus stay English. Validation: npm run test:help (all ten locales, 25 pages, heading ids unchanged), a full help build, and the i18n and transcript-visibility unit tests.
9 KiB
Мобильный доступ и PWA
Используйте браузерный интерфейс телефона или планшета для продолжения работы на серверном хосте. Установка PWA меняет способ открытия интерфейса, не место хранения проектов, учётных данных или выполнения агента.
Подключение с телефона или планшета
- На хосте откройте Настройки → Удалённый доступ → Удалённое управление, затем Запустить удалённое управление.
- Отсканируйте QR-код сопряжения мобильным устройством и откройте ссылку в браузере, которым собираетесь пользоваться дальше.
- Альтернатива — настройте прямой доступ, откройте доступный доверенный HTTPS-URL хоста и войдите с паролем сервера.
Удалённое управление требует сопряжения устройства; прямые подключения — маршрутизации, доступного слушателя и аутентификации. Не используйте localhost на телефоне для доступа к рабочей станции. Потеря данных сайта или смена профиля браузера может потребовать нового входа или сопряжения; см. удалённое управление.
Установка PWA
- Откройте рабочий URL CodeNomad через доверенный HTTPS в браузере с поддержкой установки.
- В Chrome/Edge и подобных используйте установку в адресной строке или действие браузера Install CodeNomad, если предложено. В Safari iPhone/iPad используйте Share → Add to Home Screen; точное название зависит от ОС/браузера.
- Откройте новый значок запуска и войдите или выполните сопряжение там, если браузерное хранилище отдельное.
Установка относится к устройству/браузеру и origin. Она не устанавливает Node, Git или OpenCode на телефон, не запускает серверную часть и не предоставляет нативные настольные интеграции. Удаление значка не удаляет разговоры хоста; для прекращения доступа отдельно отзовите сопряжённое устройство.
Безопасный контекст и сертификаты
Удалённая установка PWA и доступ к микрофону требуют безопасного контекста, признанного браузером. Используйте доверенный HTTPS-сертификат с точным именем хоста/IP. Созданному локальному сертификату устройство/браузер клиента должно явно доверять; страница предупреждения или обход — ненадёжная настройка установки. Исключения localhost браузера относятся к самому устройству, не к HTTP LAN-адресу другого хоста.
Если установки нет, сначала подтвердите доверие HTTPS и поддержку браузера, затем откройте страницу в полном браузере вместо встроенного QR/внутри приложения. При проблемах микрофона проверьте разрешения сайта браузера/ОС и раздел Голос. Не отключайте аутентификацию или проверку TLS ради установки.
Работа с сенсорным интерфейсом
Используйте Левая панель и Правая панель для навигации и инструментов. На узких экранах панели перекрывают разговор, не навязывая ширину настольного холста; открытие одной плавающей панели закрывает другую. При нехватке места действия заголовка разговора переходят в меню переполнения.
Поле ввода сохраняет агента, модель и мышление внизу. Размер поля меняется с видимым разговором, включая экранную клавиатуру; длинные черновики прокручиваются. На устройствах только с сенсорным вводом отправка не открывает экранную клавиатуру снова, чтобы вы могли прочитать ответ; коснитесь поля ввода, чтобы продолжить. Пока сессия работает, меню Больше действий поля ввода предлагает Поставить сообщение в очередь или Направить сейчас — то, чего не делает ваша обычная отправка, — без сочетания аппаратной клавиатуры. Открытие прерывания временно сжимает поле ввода без изменения сохранённой высоты и черновика. Отвечайте на разрешения/вопросы в панели над ним, сохраняя доступность её нижних действий. См. разговоры и разрешения.
Ограничения возможностей и подключения
| Возможность | Мобильный браузер / PWA |
|---|---|
| Проекты, разговоры, файлы и разрешения | Работают на подключённом серверном хосте с его контролем доступа. Вложения устройства загружаются с телефона; ссылки проекта разрешаются на хосте. |
| Нативные настольные окна, меню ОС и нативная автоматизация хоста | Не предоставляются установкой PWA. |
| Браузерный предпросмотр | Не получает возможности нативного гостевого браузера; резервное отображение ограничено браузером. |
| Контент SideCar и WebSockets | Зависят от пути подключения; удалённое управление блокирует прокси контента SideCar, содержимое предпросмотра и переходы на WebSocket. См. точные ограничения. |
| Микрофон, буфер обмена, уведомления и приглашение установки | Зависят от браузера/ОС, безопасного контекста и разрешений пользователя. |
| Работа без сети | Нет автономной серверной части или кэшированной истории API. Статические ресурсы интерфейса могут кэшироваться, но документы и ответы API не являются автономным рабочим пространством. |
Поддерживайте доступность серверной части. Приостановка мобильной ОС или смена сети могут разорвать поток событий; возврат переподключает и читает текущее состояние без гарантированного повтора событий. Проверьте завершение действия перед повтором. Закрытие PWA не останавливает отдельную серверную часть; выход из настольного приложения хоста и его серверной части делает удалённое управление недоступным до следующего запуска.