用途：CompileIQ 的排障速查表，按用户观察到的症状定位原因并给出第一步动作，再进入对应细节章节。
主要能力：覆盖 Search 首次评估挂起/套接字超时、每次评估返回 INVALID_SCORE、每次评估返回相同分数、fromhex 相关 TypeError、返回格式不符、收敛停滞、无效率上升、验证 CV% 过高、需要解释获胜 ACF 的机制等场景。
必要用法：超时先提高 CIQ_SOCKET_TIMEOUT=120，仍挂起则设 CIQ_SEARCH_SPACES_DIR=<本地镜像>，再不行设 CIQ_PROCESS_MODE=spawn；不要用 BLAS 符号链接（已过时）。分数不变多为框架缓存问题，可用 TRITON_ALWAYS_COMPILE=1、HELION_SKIP_CACHE=1、独立 TRITON_CACHE_DIR 或清理构建目录破缓存。排障时可用 CIQ_KEEP_CACHE=1 保留 ~/.cache/compileiq/ 以便复现；用 pandas 读取 results.csv 按 generation 汇总无效数与最优分，或运行 python scripts/diagnose_csv.py results.csv。性能分析用 NCU 两段式对比 baseline 与 ACF 版本，关注计算吞吐、内存吞吐、占用率、寄存器压力、L2 压力等指标；也可用 ptxas -v 检查寄存器与溢出。
适用场景：CompileIQ 搜索异常、结果异常或需要解释性能提升来源时。
限制：资料未提供具体版本兼容范围、平台要求与收费信息；部分命令需按实际环境调整。