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

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

Терминал — это окно, в котором вы вводите инструкции для своего компьютера. В 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; не загружайте их и не вставляйте их содержимое в сообщения поддержки.

• Найдите значение каждой настройки

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

Команда разработки десктопа компилирует оболочку 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. Скриншот ошибки может помочь, но копируемый текст легче диагностировать.

• Устранение конкретной ошибки установки