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.md (or send Accept: text/markdown).

Обзор 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/; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.

# 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).

Выберите путь к рабочему столу

Запустите совместно веб-версию и рабочий стол для локальной работы, затем создайте и проверьте собственную цель с учетом предварительных требований к ее платформе. Подписание магазина, установщики и поведение физического рабочего стола требуют отдельного принятия.

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 только когда этого требует нативная функция.

Чтобы продолжить настройку, прочитайте Запустите и настройте оболочку.