> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Обзор desktop Tauri-webview-оболочка вокруг того же веб-приложения — присутствие, а не второй продукт. ## Прохождение для начинающих Предварительные требования: прочтите два руководства для начинающих ниже и завершите локальную настройку рабочего стола, включая предварительные требования к Rust и операционной системе. Блок кода запускает как веб-приложение, так и Tauri в монорепозитории; при оформлении заказа только на рабочем столе используйте отфильтрованную команду только после отдельного запуска доступного веб-сервера. Tauri загружает этот сервер. Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы. 1. Выполните локальную настройку рабочего стола, затем откройте приложение в окне Tauri и войдите в ту же учетную запись, которую вы используете в браузере. 2. Посетите страницу рабочей области, скройте/покажите окно в трее и попробуйте воспользоваться ярлыком вызова. 3. Экран должен соответствовать веб-приложению, поскольку Tauri загружает настроенный серверный интерфейс. Если оно пусто, убедитесь, что `SUPASTACK_APP_URL` указывает на доступное работающее веб-приложение. Для пользовательского кода начните с предоставленного `prompts/README.md` и скопируйте ближайшее приглашение: `prompts/new-app-screen.md` для экрана приложения или `prompts/new-landing-page.md` для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` и соответствующие зеркала `.ai/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет. [Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md) [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md) [Локальная настройка рабочего стола](https://supastack.dev/ru/docs/desktop/ship-in-5-minutes.md) [Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md) ``` # 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 ``` ## Единый пользовательский интерфейс продукта, встроенная оболочка `apps/desktop` — это веб-просмотр Tauri в вашем веб-приложении. Он использует общий пользовательский интерфейс продукта, аутентификацию и чат с Интернетом; собственное поведение окна/лотка находится в `src-tauri/src/lib.rs`. Ему нужен доступный веб-сервер, и он не включает в себя независимый интерфейс продукта. ## Используйте встроенные функции оболочки Оболочка включает в себя меню в трее, близко к трею, фокус одного экземпляра, глобальную горячую клавишу вызова, собственные меню навигации/просмотра, внешние ссылки в системном браузере, вызов по глубоким ссылкам `supastack://`, запоминаемое состояние окна и наложение повторной попытки в автономном режиме. `SUPASTACK_APP_URL` выбирает бэкенд: сначала допустимое значение времени выполнения, затем значение времени сборки, затем localhost. `SUPASTACK_DESKTOP_HOTKEY` переопределяет `CmdOrCtrl+Shift+Space`. Подписанные релизные сборки внедряют `SUPASTACK_UPDATER_ENDPOINT` и `SUPASTACK_UPDATER_PUBKEY`; если путь эндпоинта содержит `{{channel}}`, в меню приложения становится доступен пункт **Beta Updates** (`stable` или `beta`, переопределяется во время запуска через `SUPASTACK_UPDATE_CHANNEL`). ## Выберите путь к рабочему столу Запустите совместно веб-версию и рабочий стол для локальной работы, затем создайте и проверьте собственную цель с учетом предварительных требований к ее платформе. Подписание магазина, установщики и поведение физического рабочего стола требуют отдельного принятия. [Настройте рабочий стол Tauri за 5 минут](https://supastack.dev/ru/docs/desktop/ship-in-5-minutes.md) [Поведение окна, панели задач и горячих клавиш](https://supastack.dev/ru/docs/desktop/run.md) [Сборки и распространение для настольных компьютеров](https://supastack.dev/ru/docs/desktop/release.md) ## Webview-оболочка, а не второе приложение apps/desktop — это оболочка Tauri 2.x. Ядро Rust в src-tauri владеет окном, системным треем и глобальной горячей клавишей, а webview загружает веб-приложение. Интерфейс, аутентификация, биллинг и ИИ берутся из той же кодовой базы Next.js — desktop-поверхность добавляет присутствие, а не параллельный продукт. Оболочка содержит страницу-заглушку в apps/desktop/ui, показываемую во время загрузки веб-приложения, поэтому холодный старт никогда не показывает пустое окно. ## Направьте оболочку на развёртывание Цель окна разрешается по порядку: SUPASTACK_APP_URL во время выполнения, затем SUPASTACK_APP_URL на этапе компиляции, затем http://localhost:3000. Принимаются только URL http и https — пустые или не-веб значения откатываются к следующему кандидату. Для разработки это означает, что оболочка подключается ко всему, что обслуживает corepack pnpm dev. Для рабочей среды установите переменную во время сборки, чтобы она была сохранена в развернутом веб-приложении. ## Секреты остаются на сервере Оболочка не несёт учётные данные провайдеров. Webview обращается к той же аутентифицированной API-поверхности, что и браузер — ключи провайдеров, секреты сессий и конфигурация биллинга остаются на сервере. Идентификатор бандла com.supastack.desktop и набор capabilities по умолчанию (core:default) держат webview в песочнице; расширяйте разрешения в src-tauri/capabilities только когда этого требует нативная функция. Чтобы продолжить настройку, прочитайте [Запустите и настройте оболочку](https://supastack.dev/ru/docs/desktop/run.md). ## Вперёд [Запустите настольное приложение за 5 минут](https://supastack.dev/ru/docs/desktop/ship-in-5-minutes.md)