用途：在修改真实 Maven 或 Gradle Spring AI 项目之前先做只读检查。内置诊断 CLI 离线、与厂商无关，读取构建文件、应用配置与源码，报告兼容性线索、不安全默认值、缺失的 conversation ID、流式前置条件、工具/MCP 边界、检索配置与可观测性风险。
用法：先确认项目根目录及任务是只读还是将改代码/配置；首次变更前确认目标项目、范围与回滚路径。运行： python3 spring-ai/scripts/spring_ai_check.py --root /path/to/project --json 返回稳定 JSON，含 status、project、facts、findings、errors。退出码 0 表示无 error 级问题，1 表示有 error 级问题或经 --strict 提升的 warning，2 表示调用无效或项目不可读。
工作流：保留 JSON 输出与项目版本。对照官方 Spring AI 与 Spring Boot 文档核对构建兼容性，不凭传递依赖推断支持。检查 ChatClient advisor 顺序与参数；每个 memory advisor 调用需显式 conversation ID，来自认证/会话边界，禁止共用默认值。检索时先验证文档归属与授权，分别测试空检索、过期数据、厂商错误与延迟。工具与 MCP 的模型请求视为不可信提案，授权与执行归应用，需限制工具名、参数、超时、重试、副作用与审计字段。流式输出在完成前视为暂定，测试取消、超时、断连与失败完成。生产默认关闭 prompt/completion 日志。
限制：检查器不证明厂商连通性、模型质量、RAG 正确性或生产就绪；静态诊断不能替代真实冒烟测试。版本方面官方当前稳定线为 2.0.1 并保留 1.0 参考（1.0.9），API 在不同线间存在差异，检查器只报告观察到的版本并标记不确定性。