用途：compileiq-bootstrap 用于在全新主机或容器上验证 CompileIQ 能否运行，不安装系统库、不写状态文件，只输出通过或失败清单及下一步修复命令。适用时机包括首次环境搭建、Search().start() 首次评估卡住、升级 CUDA、compileiq wheel 或 Python venv 之后。
主要检查项：1) CUDA 工具包 13.3+，因 --apply-controls 机制要求 CUDA 13.3 或更高，用 nvcc --version 与 ptxas --version 校验，失败则升级 CUDA 并把 /usr/local/cuda/bin 加入 PATH、/usr/local/cuda/lib64 加入 LD_LIBRARY_PATH。2) GPU 可见性，用 nvidia-smi --query-gpu=name,compute_cap --format=csv 查看；CompileIQ 最积极针对计算能力 9.0（Hopper/H100）与 10.0（Blackwell/B200），但也可用于 PTXAS 支持所选架构的任何 GPU。3) 导入解析，一次性导入 Search、类型、搜索空间、工具函数与各类 Worker，失败则 pip install compileiq 或从源码 pip install -e .。4) 搜索空间解析往返，调用 PtxasSearchSpace().retrieve() 并断言文件存在且非空，用于提前发现网络或隔离环境问题；首次运行从 GitHub releases 下载并缓存到 ~/.cache/compileiq/<tag>/。
相关环境变量：CIQ_SOCKET_TIMEOUT（默认 20 秒，大搜索空间可调至 60-120）、CIQ_KEEP_CACHE（设为 1/true/yes 保留 .cache 供事后回放）、CIQ_PROCESS_MODE（forkserver/fork/spawn，受限主机可改 spawn）、CIQ_SEARCH_SPACES_DIR（本地镜像路径，隔离主机用它跳过网络）、CIQ_SEARCH_SPACES_REPO（默认 NVIDIA/CompileIQ）、CIQ_SS_TAG_PREFIX（默认 search-spaces-）。自检脚本：bash scripts/check_env.sh，全部通过退出 0，否则返回失败数并打印对应修复命令。
限制与注意：首次评估的 socket 超时与 BLAS 无关，当前二进制不需要 BLAS/LAPACK；若卡住可依次提高 CIQ_SOCKET_TIMEOUT=120、设置本地镜像 CIQ_SEARCH_SPACES_DIR、切换 CIQ_PROCESS_MODE=spawn。本技能不安装系统库，缺少 nvcc、ptxas 或 Python 解释器时只报错交由用户决定安装方式。后续可接 compileiq-search-space、compileiq-booster-pack、compileiq-author-objective。