用途：面向 Core Data 与 SwiftData 的数据层问题诊断与迁移指导，适用于模式迁移崩溃、并发线程约束错误、关系访问导致的 N+1 性能问题、SwiftData 与 Core Data 混用冲突，以及迁移在本地通过但生产环境失败等情况。
主要能力：提供强制诊断步骤，先判断崩溃类型（如 “Unresolvable fault” 对应模式不匹配、“different thread” 对应线程约束、变慢对应 N+1、数据损坏对应不安全迁移）；对比存储版本与应用模型版本；检查上下文并发类型与线程；用 -com.apple.CoreData.SQLDebug 1 统计 SQL；并识别 SwiftData 与 Core Data 是否共用同一存储。给出决策树，将问题导向轻量迁移、重迁移、异步上下文、结构化并发、关系预取、批量获取、SwiftData 降级 Core Data 等具体模式。
使用方式：按强制顺序执行——先诊断再改代码，一次只应用一个模式，在真机与真实数据上验证迁移，部署前做迁移安全校验。资料中给出 NSPersistentStoreCoordinator.metadataForPersistentStore、context.perform、request.relationshipKeyPathsForPrefetching、fetchBatchSize 等代码示例。
限制：强调模拟器每次重建会删除数据库从而掩盖模式不匹配，必须真机测试；不得在未诊断时改代码，不得用模拟器成功当作迁移安全的证明，不得混合多个迁移模式；明确不建议因问题而改用其他数据库。具体收费、平台版本要求与完整安装命令暂未提供。