用途:在构建 Routing Solution 项目之前,检查并安装所需的构建前置条件,确认环境已准备好部署 Route Optimizer。
主要能力:第一步检查各工具是否安装,包括 Cortex Code CLI(cortex --version)、Podman(podman --version)、Docker(docker --version,Podman 已装时可选)、容器运行时是否运行(podman info 或 docker info)、Snowflake CLI(snow --version)、Snowflake 连接(snow connection list)、Git(git --version)以及可选的 GitHub CLI(gh --version)。结果以必备项/可选项状态汇总表呈现。
使用方式:若全部必备项就绪,提示可以继续并可运行 build routing solution;若有缺失,进入安装向导,由用户选择要安装的项目,再按平台给出命令,如 macOS 上 brew install podman 后执行 podman machine init 与 podman machine start,Snowflake CLI 使用 pip install snowflake-cli-labs 并通过 snow connection add 配置连接,Git 使用 brew install git 或 xcode-select --install,可选 GitHub CLI 在各平台有多种安装方式并可用 gh auth login 认证。安装后重跑第一步检查进行验证。
限制:Podman 与 Docker 只需其一,不必同时安装;配置 Snowflake 连接需账户标识、用户名与认证方式等用户输入;文档列出若干常见问题,如 brew 或 pip 命令缺失、Docker 守护进程未运行、Docker 权限不足、Snowflake 连接失败等,均给出对应处理方式。错误日志遵循 AGENTS.md 约定,日志前缀为 routing-prerequisites。