用途：排查 Apple Foundation Models 使用中的异常，包括上下文窗口超限、护栏违规、生成缓慢、可用性失败、语言不支持与输出异常。核心观点是这些问题多源于对模型能力的误解，而非框架缺陷。
首要能力：提供可用性检查（SystemLanguageModel.default.availability 与 unavailable 原因）、支持语言检查、上下文用量估算（4096 token 约 12000 字符）、用 Instruments 的 Foundation Models 模板做性能剖析，以及通过 session.transcript.entries 检查会话记录。
典型诊断方向：设备不支持 Apple Intelligence、地区限制、用户未在设置中启用；exceededContextWindowSize 需压缩会话记录；guardrailViolation 属内容策略；unsupportedLanguageOrLocale 需先检查支持语言列表。输出错误多因把模型当世界知识库使用，应改用工具调用或服务端 LLM；结构错误应使用 @Generable 而非手动解析 JSON；结果不一致可通过 GenerationOptions 的 sampling、temperature 调整。性能问题可通过预热、流式输出、includeSchemaInPrompt 与拆分复杂提示优化；界面冻结通常是主线程阻塞，应放入 Task。
限制：资料仅覆盖诊断思路与示例片段，未提供完整安装命令、版本要求、价格或平台完整清单，具体实现细节暂未提供。