SuperAPI AI 工具集

axiom-storage-diag

智能体与模型

查看项目

更新于 10-16 00:23

技能介绍

用途:诊断 iOS 本地文件存储异常,覆盖文件消失、重启后数据丢失、备份体积过大、无法保存文件、文件未找到、存储写满、后台任务访问失败等场景。核心观点是 90% 的存储问题源于存储目录选择错误、文件保护等级理解偏差或缺少备份排除设置,而非 iOS 文件系统缺陷。

主要能力:

  • 定位文件位置:/tmp/ 会被系统积极清理,/Caches/ 在存储压力下被清理,/Documents/ 与 /Library/Application Support/ 不会被清理且参与备份。
  • 检查文件保护等级,例如 .complete 会在设备锁定时导致文件不可访问。
  • 检查备份排除状态(isExcludedFromBackup)与文件是否存在及大小。
  • 提供决策树,区分重启后消失、随机消失、部分文件丢失、无权限、备份过大等分支并给出修复方向。
  • 总结常见模式:tmp/ 文件消失、Caches 被清理、.complete 阻断后台、下载内容导致备份膨胀。

使用方式:先运行强制首步诊断,依次检查存储位置、保护等级、备份状态和文件状态;再按症状走决策树。必要代码保持原样,例如使用 FileManager.default.attributesOfItem(atPath:) 读取 protectionKey,使用 url.resourceValues(forKeys: [.isExcludedFromBackupKey]) 检查排除状态。写入时可用 .completeFileProtectionUntilFirstUserAuthentication 替代 .completeFileProtection 以支持后台访问。

适用场景:iOS 应用调试、线上用户反馈数据丢失、备份审核被拒、后台任务无法读取文件等。

限制:资料针对 iOS 文件系统,未提供其他平台信息;未说明具体价格、许可或安装方式;具体修复需结合实际目录与保护配置判断。