用途：在调试 Foundation Models 问题时使用，如上下文超限（exceededContextWindowSize）、护栏违规（guardrailViolation）、生成缓慢、可用性故障、不支持语言或不预期输出。其核心观点是约 80% 的问题源于对模型能力、上下文上限（4096 tokens）或可用性要求的误解，而非框架缺陷。
主要能力：提供红旗信号清单（生成超 5 秒、UI 卡顿、模拟器正常但真机失败等）；强制首步诊断，包括检查 availability、supportedLanguages、transcript 条目与粗略 token 估算、用 Instruments 的 Foundation Models 模板做延迟分析、检查 transcript 调试；并给出决策树，按“无法启动、生成失败、输出错误、太慢、UI 冻结”分流到对应模式。
模式要点：可用性分设备不支持、地区限制、用户未开启 Apple Intelligence；上下文超限需压缩会话（保留首尾条目）；护栏违规需优雅提示；语言不支持需先检查 supportedLanguages；错误输出区分用例错配（世界知识 vs 摘要/抽取）、手写 JSON 解析（应改用 @Generable）、缺外部数据（应使用 Tool 调用）与采样（可用 GenerationOptions 的 greedy 或 temperature）；性能问题涉及预热、流式输出、includeSchemaInPrompt 与提示拆分；UI 冻结源于主线程阻塞，需用 Task {}。
适用场景：iOS/macOS 上基于 SystemLanguageModel 与 LanguageModelSession 的 AI 功能开发与排障。
限制：资料未提供具体价格、平台版本要求与完整 API 文档；示例代码仅为诊断方向，实际使用需依官方文档与自身环境验证。