增强 MACA 查找诊断输出

[ghangz]

该 PR 改进查找 MACA 工具链失败时的诊断信息，输出已检查路径和缺失项，方便定位环境配置问题。

这个修改面向沐曦 GPU 适配场景中比较容易影响开发、构建或验证稳定性的环节，把原来需要人工排查的问题前移到工具链、运行前检查或基准脚本中处理。实现上保持对现有默认行为的兼容，只在检测到明确配置、输入或环境异常时给出更直接的诊断，避免引入额外运行依赖，也方便维护者独立审阅该分支。

已在沐曦算力环境中完成对应分支验证，验证记录包含真实运行日志、命令输出和失败路径检查，本地归档目录为：E:/Documents/muxi/测试报告/mcTVM_new_toolchain_validation_20260608。提交分支：mengz/improve-find-maca-diagnostics，目标仓库：MetaX-MACA/mcTVM。

[gemini-code-assist]

Code Review

This pull request improves the 'find_maca' CMake macro by properly initializing and clearing MACA-related variables to prevent stale state, quoting path variables, and adding validation checks. A new test is also added to verify that stale state is correctly cleared. Feedback suggests unsetting cached library variables before calling 'find_library' to handle SDK path changes in the same build directory, and quoting variables within 'message' calls to handle paths with spaces safely.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

问题分析：
在 CMake 中，find_library 会将查找结果缓存到 CMake Cache 中（例如 MACA_MACAMCC_LIBRARY）。当用户在同一个构建目录中切换 MACA SDK 路径（例如从 /opt/maca 切换到另一个自定义路径）时，由于 Cache 中已存在旧的路径，find_library 将不会重新执行搜索，而是直接复用缓存中的旧库路径。这会导致 include 目录与库文件版本不匹配，引发难以排查的编译或运行期错误。

解决方案：
在调用 find_library 之前，先使用 unset(... CACHE) 清理对应的缓存变量。由于我们指定了 PATHS 和 NO_DEFAULT_PATH，重新搜索的开销极小，但能极大提高构建的可靠性。

    unset(MACA_MACAMCC_LIBRARY CACHE)
    unset(MACA_HCA_LIBRARY CACHE)
    unset(MACA_FLASHATTN_LIBRARY CACHE)
    find_library(MACA_MACAMCC_LIBRARY mcruntime PATHS "${__maca_sdk}/lib" NO_DEFAULT_PATH)
    find_library(MACA_HCA_LIBRARY mxc-runtime64 PATHS "${__maca_sdk}/lib" NO_DEFAULT_PATH)
    find_library(MACA_FLASHATTN_LIBRARY mcFlashAttn PATHS "${__maca_sdk}/lib" NO_DEFAULT_PATH)

[gemini-code-assist]

问题分析：
在 CMake 中，如果变量（如 ${__maca_sdk}）中包含空格或特殊字符，不加双引号直接传递给 message 可能会导致参数被拆分或输出格式异常。

解决方案：
建议将变量嵌入到双引号字符串中，以确保路径中含有空格时也能正确输出。

      message(STATUS "MACA SDK candidate did not pass validation: ${__maca_sdk}")
      message(STATUS "Expected MACA include directory: ${MACA_INCLUDE_DIRS}")
      message(STATUS "Expected MACA runtime library mcruntime under: ${__maca_sdk}/lib")