For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/desktop/run.md (or send Accept: text/markdown).

Запустите и настройте оболочку

Запустите оболочку разработки Tauri и подключите её к веб-приложению.

Задать вопрос об этом руководстве

Прохождение для начинающих

Предварительные требования: прочтите два руководства для начинающих ниже и завершите локальную настройку рабочего стола, включая предварительные требования к Rust и операционной системе. Блок кода запускает как веб-приложение, так и Tauri в монорепозитории; при оформлении заказа только на рабочем столе используйте отфильтрованную команду только после отдельного запуска доступного веб-сервера. Tauri загружает этот сервер.

Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы.

1. Откройте apps/desktop/src-tauri/src/lib.rs; попросите своего агента изменить только поведение именованного окна/панели/горячих клавиш и сохранить пользовательский интерфейс продукта в веб-приложении.

2. Запустите оболочку и проверьте близко к лотку, Выход и CmdOrCtrl+Shift+Space; тест supastack:///settings/appearance?preview=1#main.

3. Он должен сфокусировать существующее окно и сохранить путь/запрос/фрагмент. Если открывается не та страница, сравните настроенный источник и точный маршрут.

Для пользовательского кода начните с предоставленного prompts/README.md и скопируйте ближайшее приглашение: prompts/new-app-screen.md для экрана приложения или prompts/new-landing-page.md для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать AGENTS.md, .ai/PROJECT_CONTEXT.md и соответствующие зеркала .ai/; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.

# Monorepo: start the web app and desktop shell together
corepack pnpm dev:desktop

# Desktop-only checkout: start Tauri after a web backend is already reachable
corepack pnpm --filter @supastack/desktop dev

Сохранение поведения оболочки в Rust

src-tauri/src/lib.rs создает главное окно веб-просмотра размером 1200×800. Закрытие скрывает его в лотке; Выход из игры. Собственные меню обеспечивают действия «Домой», «Назад», «Вперед», «Обновить», масштабирование, полноэкранный режим и действия в окне. Восстановление состояния окна сохраняет размер/положение.

Обработка ссылок и вызов

Оболочка принимает маршруты supastack:// и разрешает их относительно точно настроенного источника приложения HTTP(S). Ссылка только с путём вроде supastack:///settings/appearance?preview=1#main отображается напрямую на /settings/appearance?preview=1#main, тогда как ссылка с authority вроде supastack://workspace/settings отображается на /workspace/settings; supastack:///auth/callback?code=... отображается на /auth/callback?code=.... Строки запроса и фрагменты сохраняются.

Ссылки запуска применяются до показа первого окна. Ссылки времени выполнения macOS используют on_open_url Tauri; аргументы второго экземпляра Windows и Linux используют колбэк single-instance с включённой функцией deep-link. Действительные ссылки фокусируют и ведут существующее окно.

В оболочке остаются только ссылки HTTP(S) без учётных данных с точно настроенными схемой, хостом и действующим портом. Ссылки HTTP(S), mailto: и tel: без учётных данных могут открываться извне; битые ссылки, учётные данные, неподдерживаемые схемы, порты в кастомных ссылках и попытки обхода отклоняются. Настроенный URL бэкенда тоже отклоняет учётные данные и откатывается к следующему действительному источнику/источнику по умолчанию.

SUPASTACK_APP_URL=https://your-app.example
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space

supastack:///settings/appearance?preview=1#main
# Opens https://your-app.example/settings/appearance?preview=1#main

Проверка поведения, специфичного для платформы

Внедренное автономное наложение предлагает повторить попытку, скрывается в сети и перезагружает веб-приложение. Тестируйте фокус, ярлыки, масштабирование меню, трей и вызов глубоких ссылок на каждой целевой ОС; Сами по себе проверки модуля URL не доказывают эти встроенные взаимодействия.

Принятие рабочего стола

Настройка и конфигурация

Установите зависимости рабочей области и набор инструментов Rust, а также необходимые для каждой ОС Tauri (WebView2 поставляется с Windows; для macOS и Linux нужны свои документированные пакеты). corepack pnpm --filter @supastack/desktop dev запускает tauri dev: оно собирает ядро Rust, показывает пользовательский интерфейс-заполнитель и загружает решенное приложение URL.

Сначала используется значение SUPASTACK_APP_URL во время запуска, затем — сохранённое при сборке. Принимаются только URL HTTP(S) без учётных данных; иначе проверяется следующий вариант. SUPASTACK_DESKTOP_HOTKEY меняет CmdOrCtrl+Shift+Space на горячую клавишу по умолчанию. При ошибочном значении используется значение по умолчанию, запуск не прекращается.

corepack pnpm --filter @supastack/desktop dev
corepack pnpm --filter @supastack/desktop typecheck

SUPASTACK_APP_URL=https://app.example.com \
SUPASTACK_DESKTOP_HOTKEY=CmdOrCtrl+Shift+Space \
corepack pnpm --filter @supastack/desktop dev

Рабочий процесс внедрения

Главное окно остаётся на точно настроенном источнике, включая протокол и порт. URL HTTP(S) без учётных данных, а также mailto и tel могут открываться в системном браузере; остальные протоколы отменяются.

Зарегистрированные ссылки supastack:// переносят свой путь, запрос и фрагмент на настроенный источник приложения. Одинаковая проверка применяется при запуске, системных событиях открытия URL и повторном запуске процесса, поэтому диплинк не может перенаправить оболочку на другой хост.

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

Проверка и устранение неполадок

После изменений в src-tauri выполните cargo check и cargo test через скрипты пакета. Затем проверьте переходы только на точный источник, открытие разрешённых внешних URL, маршрут supastack:// на настроенном источнике приложения, работу области уведомлений и клавиши, а также сохранение входа после перезапуска.