Windows 命令行

AirCode Ø Windows 設置爲 PowerShell 和 Command Prompt 安裝 aircode 命令。它使用了桌面應用程序中已經嵌入的 Node.js 運行時間和 ConPTY 支持;不需要 WSL 和系統 Node.js 安裝。

安裝或更新 AirCode Ø 後,打開新的終端 ,以便接收更新用戶 PATH,然後驗證命令:

aircode version
aircode serve --help

安裝程序解決了與其自身安裝目錄相關的命令,因此在安裝中支持選擇自定義目錄。

桌面可執行或服務器命令?

如果你想…	使用
將電子窗口連接到本地或遠程服務器	打開 AirCode Ø 桌面應用程序
運行嵌入式本地服務器並從電子中使用	打開桌面應用程序並選擇在此機器上運行
運行無電子窗口的服務器	打開終端並運行 `aircode serve`

桌面執行器不是受支援的 --serve 入口點:它總是開啟電子。 aircode 命令使用與桌面應用程序安裝的運行時間和服務器負載,但啓動了單獨的前沿過程。桌面操作模式查看完整生命週期概述。

啓動服務器

serve 是默認命令,因此這些表單等同於:

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

服務器在前沿運行,並將日誌寫入該終端。按 Ctrl+C 以清潔地停止。每個項目的 root 都會得到自己的孤立的運行時狀態和會話名稱空間。當另一個根已經使用了偏好端口時, 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>`	無	公共 HTTP(S) 基礎 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

將指定給 Windows 機器的確切 VPN 地址綁定:

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 Ø Web 應用程序和其認證的 API。它不會將項目目錄轉換爲公共文件共享:文件訪問仍然針對 projectsRoot 下的項目,並由服務器執行。

其他設置

代理可執行路徑、會話限制、瀏覽器控制、知識、編排、通知和代幣優化仍然可通過環境變量和 config.json。請參閱配置有關完整的配置優先級和常見設置。