用途:当用户提到 SwiftData 审查、@Model 问题、迁移安全或性能检查时,该工具扫描 SwiftData 代码并给出审计报告。
主要能力:按五个阶段工作。第一阶段用 Glob、Grep、Read 工具映射架构,统计 @Model 声明、@Attribute、@Relationship、容器与上下文拓扑(ModelContainer、ModelConfiguration、@Environment(.modelContext))、迁移面(VersionedSchema、SchemaMigrationPlan、willMigrate/didMigrate)、同步与存储(cloudKitDatabase、.externalStorage、App Group、内存存储)。第二阶段检测 9 类反模式:模型未注册到 VersionedSchema、多对多关系缺少 = [] 默认值、在 didMigrate 而非 willMigrate 中 fetch、detached Task 捕获 @Environment 上下文、变更后缺少 save()、双向关系两侧同时更新、循环中的 N+1 抓取、过度索引、批量插入未分块。第三阶段推理完整性缺口,如 SchemaMigrationPlan 版本覆盖、CloudKit 一致性、谓词陈旧、外部存储清理、生产路径可访问 erase()、list 缺少 sortBy 等。第四阶段组合发现并提升严重级别,第五阶段给出 SAFE / FRAGILE / DANGEROUS 健康评分与摘要、按严重程度列出问题、文件名行号、影响与修复代码建议。
使用方式:资料提供直接调用名 axiom-audit-swiftdata;扫描时跳过测试、Previews、Pods、Carthage、.build、DerivedData、scratch、docs、.claude 等路径。要求必须实际运行工具取证据,不凭训练数据推理。
限制:报告需基于文件证据;超过 50 条同类问题仅显示前 10 条,超过 100 条总数只详列 CRITICAL/HIGH。收费、价格、平台与具体运行环境暂未提供。