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。请参阅配置有关完整的配置优先级和常见设置。