用途：排查 Core Data 生产环境问题，包括架构不匹配导致的崩溃、线程约束错误、关系访问引发的 N+1 性能下降、SwiftData 与 Core Data 混用冲突，以及迁移在模拟器通过但真机失败等情况。核心观点是多数问题源于对线程约束、迁移要求和关系查询模式的误解，而非框架缺陷。
主要能力：提供强制诊断步骤，先识别崩溃类型（如 Unresolvable fault 对应架构不匹配、different thread 对应线程约束、变慢对应 N+1），再按决策树选择单一模式处理。涵盖轻量迁移（新增可选字段、带默认值的必填字段、删除字段、重命名）、重量迁移（NSEntityMigrationPolicy 自定义转换，如 String 转 Date）、后台异步上下文、async/await 结构化并发、关系预取、批量抓取、SwiftData 与 Core Data 桥接及迁移测试安全。
使用方式：先运行诊断代码，比较持久化存储元数据版本与应用模型版本，检查线程与上下文并发类型，用 -com.apple.CoreData.SQLDebug 1 统计 SQL 查询，确认是否混用 SwiftData 与 Core Data。再按决策树应用单一模式，禁止同时组合多个迁移模式。
适用场景：iOS/macOS 使用 Core Data 或 SwiftData 的应用在架构变更、并发访问、关系查询性能、数据层选型时参考。
限制：资料强调必须在真机用真实数据测试迁移，模拟器会删除数据库而掩盖架构不匹配；禁止未诊断就改代码、禁止用模拟器成功作为迁移安全证明、禁止未做部署前验证就上线。具体 API 可用版本与完整实现细节以官方文档为准，资料未提供收费、平台支持范围等信息。