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

# Команды, файлы и конфигурация

Узнайте, куда вставлять команды, как открыть правильную папку проекта, редактировать файлы .env, остановить команду разработки десктопа и сообщить об ошибке настройки, не раскрывая секретов.

## Команда поступает в терминал

Терминал — это окно, в котором вы вводите инструкции для своего компьютера. В Visual Studio Code сначала откройте папку supastack, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Новый терминал запускается в этой папке. В Windows выберите PowerShell, используя меню рядом с кнопкой + на терминале. Используйте блоки macOS/Linux в терминале macOS или Linux.

Вставляйте только содержимое командного блока, по одной команде за раз, и нажмите Enter. Не вставляйте окружающие обратные кавычки Markdown, приглашение, такое как PS C:\..., или пример вывода. Строки, начинающиеся с #, являются пояснениями; они ничего не запускают. Дождитесь завершения каждой команды установки, прежде чем вводить следующую команду. Серверная команда продолжает выполняться и не возвращает новое приглашение, пока вы ее не остановите.


## Проверьте, какую папку использует терминал

Корень репозитория означает папку supastack верхнего уровня, содержащую package.json, pnpm-workspace.yaml, приложения и пакеты. Если в шаге не указано иное, запускайте команды там. Команда ниже печатает текущую папку; в списке файлов должен быть указан package.json. В Windows также работают PowerShell pwd и ls.

Если список показывает только содержимое apps/desktop, введите cd ../.. и нажмите Enter, чтобы вернуться в корень. Если показана домашняя папка, введите cd, затем пробел и полный путь к вашему клону, в кавычках, если в нём есть пробелы. Обычно проще открыть папку проекта в редакторе и создать новый терминал.

```
pwd
ls
```


## Конфигурация хранится в файле, а не в терминале

Блок типа AI_PROVIDER=fake представляет собой текст конфигурации. Откройте указанный файл .env в редакторе, найдите строку, начинающуюся с AI_PROVIDER=, замените ее значение и сохраните с помощью Ctrl + S (Command + S в macOS). Каждая настройка занимает одну строку в формате KEY=value. Не добавляйте обратные кавычки Markdown. Избегайте дублирования копий одного и того же ключа в одном файле.

Используйте корневой .env для команд миграции базы данных и apps/web/.env.local для Web-бэкенда — в checkout только Desktop этот файл принадлежит отдельному репозиторию бэкенда. Десктопная оболочка не читает файлы .env: SUPASTACK_APP_URL — это настройка окружения терминала, которую вы передаёте в командной строке при запуске, а не конфигурация, хранящаяся в файле. Храните файл-пример без изменений для справки.

Файлы, имена которых начинаются с точки, могут быть скрыты в вашем файловом менеджере; Проводник редактора показывает их. Убедитесь, что имя файла именно .env.local, а не .env.local.txt. Эти локальные файлы могут содержать пароли и исключены из Git; не загружайте их и не вставляйте их содержимое в сообщения поддержки.

[Найдите значение каждой настройки](https://supastack.dev/ru/docs/desktop/project-structure.md)


## Держите команду разработки запущенной; используйте другой терминал для команд

Команда разработки десктопа компилирует оболочку Rust и открывает окно во время работы. Держите её терминал открытым, пока вы тестируете окно. Серверная команда продолжает работать и не возвращает новое приглашение, пока вы её не остановите.

Чтобы запустить другую команду, пока сервер активен, выберите «Терминал» → «Новый терминал» в редакторе. Новый терминал — это отдельное окно в тот же проект. Чтобы остановить сервер, выберите его терминал и нажмите Ctrl + C один раз. В Windows, если вас спросят «Завершить пакетное задание», введите Y и нажмите Enter. Дождитесь обычного запроса, прежде чем запускать его снова.

После изменения настроек оболочки остановите команду десктопа Ctrl + C и запустите снова. Ядро Rust перекомпилируется при каждом запуске; изменение SUPASTACK_APP_URL означает передачу нового значения при следующем запуске, а не редактирование сохранённого файла.

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


## Прочтите неудачу и попросите полезную помощь

Если при установке возвращается красный текст ошибки, остановитесь на этом шаге. Прочитайте первую ошибку, а не продолжайте запускать приложение. Команда не найдена обычно означает отсутствие инструмента; отсутствие package.json обычно означает неправильную папку; ECONNREFUSED обычно означает, что необходимый сервер или база данных не работает; EADDRINUSE означает, что другой процесс уже использует этот порт.

При обращении за помощью укажите свою операционную систему, руководство URL и номер шага, точную введенную команду и первое сообщение об ошибке. Удалите пароли, ключи API, токены и часть пароля из любой базы данных URL. Не отправляйте файлы .env. Скриншот ошибки может помочь, но копируемый текст легче диагностировать.

[Устранение конкретной ошибки установки](https://supastack.dev/ru/docs/desktop/troubleshooting.md)


## Вперёд

[Позвольте агенту выполнить настройку](https://supastack.dev/ru/docs/desktop/agent-setup.md)