SuperAPI AI 工具集

browser-storage-durability-contracts

智能体与模型

查看项目

更新于 10-16 06:44

技能介绍

该技能用于复核一个主张:浏览器本地数据是否真的已提交,以及当本地副本被阻塞、中止、不可用或被删除时,产品能否如实告知用户。

用途与主要能力:定位持久化失败所处阶段,包括打开/升级、事务执行、事务提交、配额与持久化、连接异常关闭、恢复,并记录数据库名与版本、事务模式与对象仓库、请求/事务事件、浏览器上下文和用户可见的丢失表现。支持用至少两个活动上下文复现升级问题,主张长连接在收到 versionchange 事件后让出所有权并关闭,schema 变更保持在升级事务内,避免在活动事务中出现异步空档,并以事务 complete 事件而非单个请求成功作为写入结果。

用法要点:用 rg 搜索 indexedDB.open、upgradeneeded、blocked、versionchange、transaction、TransactionInactiveError、navigator.storage、QuotaExceededError、deleteDatabase 等线索,并在运行时记录新旧数据库版本、blocked、versionchange、complete、abort、error 和异常名;用 navigator.storage.estimate() 和 persisted()/persist() 结果作为证据而非精确计量。

限制:estimate() 数值为近似且按源统计,persist() 被拒属正常结果,持久化存储不保证用户不会删除;该技能不设计服务端同步、冲突解决、备份架构,也不负责选择 IndexedDB 与 localStorage;仅在运行时证据能把损坏阶段与用户可见损失、永久阻塞升级、虚假已保存/已同步声明等关联时才值得报告。