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. Закрытие скрывает его в лотке; Выход из игры. Собственные меню обеспечивают действия «Домой», «Назад», «Вперед», «Обновить», масштабирование, полноэкранный режим и действия в окне. Восстановление состояния окна сохраняет размер/положение.
Проверка поведения, специфичного для платформы
Внедренное автономное наложение предлагает повторить попытку, скрывается в сети и перезагружает веб-приложение. Тестируйте фокус, ярлыки, масштабирование меню, трей и вызов глубоких ссылок на каждой целевой ОС; Сами по себе проверки модуля 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:// на настроенном источнике приложения, работу области уведомлений и клавиши, а также сохранение входа после перезапуска.