Windows командная строка

Настройка AirCode Ø Windows устанавливает команду aircode для PowerShell и Command Prompt. Он использует время запуска Node.js и поддержку ConPTY, уже встроенную в настольное приложение; WSL и установка системы Node.js не требуются.

Откройте новый терминал **** после установки или обновления AirCode Ø , чтобы он получил обновленный пользователь PATH, затем проверьте команду:

aircode version
aircode serve --help

Инсталлятор решает команду относительно собственного инсталляционного каталога, поэтому поддерживается выбор настраиваемого каталога в настройке.

Desktop executable или серверная команда?

Если вы хотите…	Использование
Подключение окна Electron к локальному или удаленному серверу	Откройте приложение для рабочего стола AirCode Ø
Запустите встроенный локальный сервер и используйте его от Electron	Откройте приложение для рабочего стола и выберите Запустить на этой машине
Запустить сервер без окна Electron	Откройте терминал и запустите `aircode serve`

Настольная исполняемая программа не является поддерживаемой точкой ввода --serve : она всегда открывает Electron. Команда aircode использует время запуска и загрузку сервера, установленную с настольным приложением, но начинает отдельный процесс фронта. рабочие режимы рабочего стола для полного резюме жизненного цикла.

Запуск сервера

serve является по умолчанию, поэтому эти формы эквивалентны:

aircode serve --projects-root "D:\Projects"
aircode --projects-root "D:\Projects"

Сервер работает на переднем плане и записывает журналы в этот терминал. Нажмите Ctrl+C , чтобы остановить его. Каждый проект получает свое собственное изолированное состояние запуска и сеансовое название. Когда предпочтительный порт уже используется другим корнем, AirCode Ø автоматически выбирает следующий доступный порт.

Опции обслуживания

Опция	По умолчанию	Цель и эквивалентная настройка
`--projects-root <dir>`	текущий каталог	Корень, субфолдеры которого AirCode Ø представляет как проекты. Руководство должно уже существовать. ENV в: `AIRCODE_PROJECTS_ROOT`; JSON: `projectsRoot`
`--host <address>`	Tailscale IP Иначе `127.0.0.1`	Сетевой интерфейс , на котором прослушивается сервер HTTP . ENV в: `AIRCODE_HOST`; JSON: `host`
`--port <number>`	`7860`	HTTP порт от 1 до 65535. Явное занятое порт не удается вместо молчаливого изменения. ENV в: `AIRCODE_PORT`; JSON: `port`
`--public-url <url>`	нет	Public HTTP(S) base URL используется в ссылках и уведомлениях. ENV в: `AIRCODE_PUBLIC_URL`; JSON: `publicUrl`
`--config <file>`	файл конфигурации пользователя	Альтернативный файл конфигурации JSON . Название: `AIRCODE_CONFIG`
`--state-dir <dir>`	каталог состояния пользователя	Альтернативный каталог состояния запуска. Название: `AIRCODE_STATE_DIR`
`--password <value>`	сгенерированный или настроенный	Доступ к паролю для этого процесса. Удобный, но видимый в истории оболочки и потенциально процесс инспекции. ENV в: `AIRCODE_AUTH_PASSWORD`; JSON: `authPassword`
`--password-file <file>`	нет	Читать пароль доступа из частного файла
`--no-password`	Отключить	Ошибочно отключите аутентификацию; используйте только на намеренно доверенном интерфейсе
`-h`, `--help`	—	Показать командную помощь без запуска сервера

Стандартный файл конфигурации Windows является %USERPROFILE%\.config\aircode\config.json; состояние запуска по умолчанию переходит к специальным каталогам под %USERPROFILE%\.local\state\aircode\instances.

Дороги, содержащие пробелы, должны быть цитированы. Принимаются как --option value , так и --option=value . Опции командной строки имеют приоритет над переменными среды, которые имеют приоритет над config.json, а затем по умолчанию.

При первом запуске AirCode Ø генерирует пароль, сохраняет его в выбранном файле конфигурации и печатает его один раз. --password доступен, когда требуется полное провизионирование командной строки, но его значение может быть раскрыто посредством проверки процессов и истории оболочки. Предпочтите --password-file, защищенный файл конфигурации, или безопасно поставляемый AIRCODE_AUTH_PASSWORD. Отключение auth должно быть явным с --no-password.

Примеры

Многократные корни одновременно

Откройте один терминал в первом корне:

cd "$HOME\Desktop"
aircode

Затем открыть другой терминал в другом корне:

cd "$HOME\Documents"
aircode

Если Tailscale присвоил компьютеру 100.84.12.30 , два баннера могут сообщать о http://100.84.12.30:7860 и http://100.84.12.30:7861. Инстанции не имеют общего состояния запуска или сеансов. Запуск aircode снова из уже активного корня сообщает о его существующем URL вместо того, чтобы начать дубликат.

Только локальная машина

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860

Открыть http://127.0.0.1:7860.

Tailscale или частный VPN

Свяжите точный адрес VPN , присвоенный машине Windows :

aircode serve `
  --projects-root "D:\Projects" `
  --host 100.84.12.30 `
  --port 7860

Другие устройства в той же частной сети могут открыть http://100.84.12.30:7860. Предпочтите точный адрес VPN над 0.0.0.0.

Локальная сеть

aircode serve `
  --projects-root "D:\Projects" `
  --host 192.168.1.25 `
  --port 7860

Защитная стена Windows может попросить разрешить подключение. Разрешать только сетевые профили, которые вы планируете использовать.

Обратный прокси или туннель URL

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860 `
  --public-url "https://aircode.example.com"

--public-url только говорит AirCode Ø , какой адрес поместить в генерируемые ссылки. Не не открывает порт защитной стены, запускает обратный прокси или создает туннель. Используйте Удаленный доступ для встроенного выходной тоннеля, Tailscale или руководства в частной сети.

Отдельная конфигурация и состояние

aircode serve `
  --projects-root "D:\Projects" `
  --config "D:\AirCodeData\config.json" `
  --state-dir "D:\AirCodeData\state"

Если другой терминал должен запустить команду жизненного цикла против этого экземпляра, сначала настройте тот же каталог состояния:

$env:AIRCODE_STATE_DIR = "D:\AirCodeData\state"
aircode status
aircode stop

Совместное существование приложений для рабочего стола

Предварительный сервер CLI и локальный сервер, управляемый окном рабочего стола, являются отдельными процессами. aircode status и aircode stop ориентированы только на сервер CLI ; они не отчитываются и не контролируют сервер, управляемый рабочим столом. Перед повторным использованием одного и того же хоста и порта удалите AirCode Ø из иконы области уведомлений, а не только закрыв окно. В качестве альтернативы вы можете предоставить серверу CLI другой порт.

Начиная с терминала, выявляется веб-приложение AirCode Ø и его аутентифицированное API. Он не превращает каталог проектов в общедоступный файл: доступ к файлу остается предназначенным для проектов под projectsRoot и осуществляется сервером.

Дополнительные настройки

Агентские пути, ограничения сеансов, контролирующие элементы браузера, знания, оркестрация, уведомления и оптимизация токенов остаются доступными через переменные окружающей среды и config.json. Конфигурация Конфигурация для полной конфигурации приоритета и общих настроек.