Позвольте агенту выполнить настройку

Рутинную часть можно делегировать

Этот репозиторий написан так, чтобы агент кодирования мог его прочитать. Он содержит файл-карту (llms.txt), файл правил (AGENTS.md), заметки памяти для каждого файла (.ai/) и навыки задач (.agents/skills/). Отдельный checkout Desktop не включает папку prompts/, поэтому готовый промпт напечатан в этом руководстве — скопируйте его ниже вместо открытия файла.

Делегировать набор текста не значит пропустить проверки. Агент работает внутри вашей копии репозитория и должен отчитываться о выполненном с доказательствами. Разделы ниже показывают, как выглядит хороший отчёт, чтобы результат оставался под вашим контролем.

Этот путь настраивает оболочку Tauri и её подключение к Web-бэкенду — серверу, обрабатывающему аккаунты и данные. Десктопное окно только отображает этот бэкенд; если ваш checkout также содержит apps/web, агент может запустить его локально, а checkout только Desktop нуждается в предоставленном вам доступном адресе бэкенда.

• Вместо этого запустите приложение Desktop вручную

Что нужно сначала

Сначала пройдите подготовительное руководство: установлены Node.js, Git и редактор, принято приглашение GitHub, а папка supastack загружена на ваш компьютер. Агент работает внутри этой папки, поэтому всё из Прежде чем начать по-прежнему применимо.

Вам также понадобится инструмент, который может выступать кодинг-агентом — редактор со встроенным AI-агентом для кодирования (AI IDE) или агент, работающий в вашем терминале (агентный CLI). Подойдёт любой современный инструмент с возможностями агента; промпт уже описывает, что он должен прочитать и запустить, поэтому писать инструкции самостоятельно не нужно.

Наконец, определите две вещи, которые запрашивает промпт: адрес бэкенда, который окно должно загружать — http://localhost:3000 для локального бэкенда или предоставленный вам адрес HTTPS, — и установлены ли Rust и нативные инструменты сборки на этом компьютере.

Скопируйте промпт, заполните два поля, вставьте

Промпт — это блок кода ниже — выделите и скопируйте блок целиком.

Два плейсхолдера требуют вашего выбора. Замените <APP_URL> адресом бэкенда, который окно должно загружать — http://localhost:3000 для локального бэкенда или предоставленный вам адрес HTTPS. Замените <TOOLCHAIN: present | install> на present, когда rustc и cargo уже выводят версии, или install, когда агент должен сначала установить Rust и инструменты сборки ОС. Нумерованные шаги остаются точно как написано.

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

Что агент делает с промптом

Промпт указывает агенту на карту, правила и контрольный список безопасности, затем велит пройти настройку по порядку и доказать каждую фазу. Простыми словами, агент:

• Читает карту репозитория (llms.txt), правила проекта (AGENTS.md) и правила обращения с учётными данными (docs/agent-security.md), прежде чем что-либо трогать.
• Проверяет набор инструментов Rust и предварительные требования Tauri этой ОС и сообщает, что устанавливает, вместо сбоя в середине компиляции.
• Проверяет, что бэкенд отвечает по вашему адресу — запуская apps/web самостоятельно, только если эта папка существует в данном checkout, — вместо предположения о сервере, которого нет.
• Устанавливает зависимости, компилирует оболочку и открывает окно, затем сообщает о поведении окна, трея и ярлыка вызова с реальным выводом.
• Останавливается и сообщает после двух неудач одного и того же шага — он не обходит сбой и не удаляет что-либо без запроса.

Что проверить в отчёте агента

Хороший отчёт показывает доказательства, а не утверждения. Ищите за каждым PASS отвечающий URL бэкенда, завершённую установку зависимостей, завершённую компиляцию Rust и открытое окно — а не фразу вроде «всё работает».

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

Две вещи никогда не должны появляться: отключённая функция безопасности ради подавления ошибки и секретное значение, такое как пароль или ключ, напечатанное в чате или отчёте. Если вы видите что-либо из этого, считайте запуск проваленным.

Держите в уме разницу между оболочкой и настоящим входом. Окно, показывающее главную страницу вашего бэкенда, доказывает оболочку — настоящим аккаунтам всё ещё нужна база данных бэкенда. «Окно открылось» — это ещё не «аккаунты работают».

Если вы предпочитаете сделать это вручную

Каждый шаг, который выполняет агент, расписан в руководствах ниже — те же команды, те же проверки, в вашем темпе.

• Запустите приложение Desktop за 5 минут
• Прочитайте полную настройку оболочки
• Исправьте сбой настройки