该技能用于离线优先应用的数据可移植性设计,核心是把备份/恢复与导出严格分开。备份需精确、机器可读、可往返,是恢复唯一接受的来源;导出(CSV、PDF)是交互产物,天然有损,必须拒绝作为恢复源。
主要规则:每个备份文件先写信封(formatVersion、schemaVersion、appVersion、exportedAtUtc、payload 校验和),恢复先校验校验和、拒绝高于应用的 schemaVersion,旧版本沿与数据库相同的前进迁移路径处理。恢复全有或全无,先导入全新暂存数据库并校验,关闭句柄后以原子重命名发布,旧文件保留作回滚。
机器格式只含规范值:整数最小单位、SI 整数、ISO-8601 UTC、稳定 ID、未翻译枚举码;不得出现本地化数字、格式化日期、货币符号或翻译标签。身份由内容指定(UUID/ULID),不得使用 rowid。
合并策略需显式说明并在执行前展示(全量替换或按 ID 合并)。导出通过 IOSink 流式写入临时文件并原子重命名,失败必须删除临时文件且不发布任何产物;没有显式用户操作,任何内容不得离开沙箱,分享/保存经注入的 Gateway。CSV 需按 RFC 4180 转义并防公式注入。导出/恢复返回类型化 Result,失败原因逐项区分。
必须测试:恶意夹具往返、重复导入幂等、各类拒绝、失败无产物、CSV 转义。暂未提供具体收费、平台支持或性能数据。