Operit 数据救援界面兼容性核对指南：v1.12.1 已发布接口、静态检查与修复保全策略

AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载数据救援是 Operit 在数据库或配置文件损坏场景下的最后防线。本指南聚焦 数据救援数据库健康 专题中的兼容性与核对章节3_CompatibilityAndVerification.md系统梳理 v1.12.1 中已发布接口的保留范围、静态核对清单、未执行项与交付状态。读完你将掌握如何确认既有数据救援入口没有被破坏、如何逐条核验配置和数据库检测功能的行为约束以及为什么不写实时库、修复需二次确认、原件一律保全是这套方案的安全底线。一、已发布接口v1.12.1 保留的数据救援能力兼容性核对的第一个结论是数据救援界面已包含在 v1.12.1 中且既有接口全部原样保留。新增的配置和数据库检测是对现有界面的增量扩展而非重构替换。保留的既有能力包括四类接口说明原始快照导入 / 导出对整个数据目录含 Preferences 与 Room 数据库文件做 ZIP 级整体备份与恢复SQL 输入 / 执行面向高级用户的 SQL 执行器可直接对数据库执行语句预设查询内置安全查询快捷入口消息数量、变体数量、会话字段等避免手工输入 SQL恢复后重启入口快照恢复完成后提供启动主应用按钮确保用户能回到正常流程这些能力与配置和数据库检测区域共存于同一 DataRecoveryActivity 中界面从上到下依次为状态面板、原始快照区导出/导入/恢复后重启、文件管理说明、SQL 执行器、以及位于其下方的配置和数据库检测区。也就是说检测功能插入在 SQL 执行器之后没有改动任何已有入口的交互位置与行为。二、静态核对清单七条行为约束的源码级验证静态核对是兼容性的核心交付物。文档给出了七条必须成立的约束下面结合源码逐条验证。1. 检测区域位于 SQL 执行器之后从 DataRecoveryActivity.kt 的 LazyColumn 布局可见data_recovery_sql_executorSQL 执行器section 之后才渲染data_recovery_database_health_section配置和数据库检测section符合文档声明。2. 检查报告默认折叠只直接展示通过数量与问题说明检测结果的渲染集中在ConfigurationAndDatabaseHealthReport组合函数中DataRecoveryActivity.kt报告卡片默认expanded false折叠态只显示三样东西健康等级摘要HEALTHY / NEEDS_REPAIR / MANUAL_RECOVERY_REQUIRED、通过数量与总数passedCount / totalCount、以及第一个问题的说明firstProblem。点击卡片才展开完整检查项明细配置检测项 数据库检测项逐条列出。这与检查报告默认折叠仅直接展示通过数量和问题说明的约束完全一致避免把诊断细节一次性倾倒给普通用户。3. 检测操作不向实时数据库执行写入 SQL数据库检测全程只读。在 RoomDatabaseHealthManager.inspectLocked 中数据库以SQLiteDatabase.OPEN_READONLY模式打开仅执行三类只读 PRAGMAPRAGMA quick_check完整性快速检查readQuickCheckPRAGMA user_version读取 schema 版本readUserVersionPRAGMA foreign_key_check外键违例计数countForeignKeyViolations三条查询均通过rawQuery执行不产生任何写入。4. 配置检测只读取隔离副本配置修复仅由用户确认后执行Preferences 配置文件的健康检测不是直接打开原文件而是先复制到隔离目录再验证PreferencesHealthManager.validateCopy 会把每个.preferences_pb文件拷贝到cacheDir下的preferences_health_UUID临时目录再在副本上用 DataStore 读取验证可读性返回Readable / Corrupt / Failed三种结论。原件在检测阶段完全不被触碰。修复动作同样受用户控制界面中修复按钮只有在报告canRepair true时才可用点击后先弹 AlertDialog 二次确认showHealthRepairConfirmationDataRecoveryActivity.kt确认后才调用repairStorage()。5. 修复操作需要用户二次确认如上所述数据库修复与配置修复共用同一个确认对话框流程。按钮启用条件为state.configurationHealthReport?.canRepair true || state.databaseHealthReport?.canRepair true且!state.isRunning从交互层面杜绝了误触。6. 原件保全不要求数据库能够成功打开这是保全策略的关键设计修复前的原件归档发生在数据库健康检测之后、且独立于检测结果。在 RoomDatabaseHealthManager.repair 中先inspectLocked得到待修复计划再调用 preserveDatabaseFiles把 DB、WAL、SHM、journal 四个文件按room_db_repair_source_时间戳_随机8位.zip命名写入 ZIP 归档。即使数据库文件本身损坏、SQLite 无法打开只要文件存在即可被原样打包符合原件保全不要求数据库能够成功打开的约束。配置修复同理preserveConfigurationFiles会在删除任何文件前先生成独立 ZIP。7. 中、英、日文案同步维护所有检测/修复文案均通过R.string.*资源引用如data_recovery_database_summary_healthy、data_recovery_configuration_file_corrupt等由系统多语言资源目录同步提供中文、英文、日文翻译保证三种语言界面行为一致。三、约束的延伸不修改启动流程与其他存储 owner文档最后两条静态约束涉及系统级边界值得单独展开不修改应用启动和其他存储 owner检测与修复全部由用户在数据救援界面手动触发不接入Application启动链路不替换 Preferences DataStore 的现有 owner也不修改 ObjectBox 的生命周期。这正是本方案与早期 PR #1006 的本质区别——后者试图在启动期间统一恢复 Preferences、Room 和 ObjectBox作用域过大而无法安全合并当前方案把恢复能力收窄为用户主动触发的、可追踪的检测与修复。检测操作不向实时数据库执行写入 SQL的另一层含义是完整 Room schema 与 migration chain 的验证是在隔离副本上完成的。参见 AppDatabase.validateRecoveryCopy将app_database及其 sidecar 复制为随机名的验证库删掉room_master_table后由 Room 重新打开强制对比真实表、列、外键与索引从而在不触碰线上库的前提下验证 migration chain 是否完整。四、未执行项与交付状态按仓库执行准则除非用户明确要求不运行编译、构建或测试命令——这是本专题文档的既定交付边界。也就是说本文档描述的兼容性结论来自代码结构核对静态核对而非 CI 构建产物读者如需实证可自行在本地执行对应模块的构建与测试。专题索引 index.md 标记状态为completed分支为feat/data-recovery-database-health并以 [DONE] 标注收尾。四个步骤文档Room 健康检查、明确修复与原件保全、兼容性与核对、Preferences 配置文件检测与修复均已按序完成本篇文章对应的正是其中第三步兼容性与核对。五、核对清单速查表核对项结论源码依据数据救援界面包含于 v1.12.1✅ 保留DataRecoveryActivity.kt检测区域在 SQL 执行器之后✅DataRecoveryActivity.kt报告默认折叠只展示通过数量与问题说明✅DataRecoveryActivity.kt检测不写实时库✅ 只读 PRAGMARoomDatabaseHealthManager.kt配置检测读隔离副本✅PreferencesHealthManager.kt修复需二次确认✅DataRecoveryActivity.kt原件保全不要求数据库可打开✅ 文件级 ZIP 归档RoomDatabaseHealthManager.kt中英日文案同步✅app/src/main/res多语言资源不修改启动与其他存储 owner✅仅数据救援界面手动触发不运行编译/构建/测试命令✅ 按仓库执行准则—六、进一步阅读数据救援数据库健康专题索引专题整体背景、作用域与非目标1_RoomHealthCheck.md数据库检测的三类 PRAGMA 与健康等级建模2_RepairAndPreservation.md修复计划生成与原件保全流程4_PreferencesHealth.mdPreferences 配置文件的隔离验证与重置策略核心实现RoomDatabaseHealthManager.kt、PreferencesHealthManager.kt、AppDatabase.kt赞分享AI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆【免费下载链接】OperitThe most powerful AI agent and AI chat software on Android/Operit是一款Android上能力最为强大、发展最久的AI Agent项目地址https://gitcode.com/gh_mirrors/op/Operit点击查看免费下载相关推荐Auxílio RS救援系统数据安全5个关键备份与恢复策略保障洪灾救援数据Auxílio RS救援系统数据安全5个关键备份与恢复策略保障洪灾救援数据 在洪灾救援的关键时刻Auxílio RS救援系统承载着成千上万受灾民众的生命线数TestDisk数据恢复完全攻略从紧急救援到专业修复TestDisk数据恢复完全攻略从紧急救援到专业修复 面对硬盘分区突然消失、重要数据无法访问的紧急情况TestDisk作为一款功能强大的开源数据恢复工具能存储GitHub_Trending/fron/frontend合规性检查确保救援平台符合数据保护法规GitHub_Trending/fron/frontend合规性检查确保救援平台符合数据保护法规 在救援平台运营中用户数据保护和隐私合规是至关重要的环节。G上一篇脚本优化指南让你的Playnite游戏库管理器更流畅下一篇PurgeCSS 快速上手用 PostCSS 插件移除未使用 CSS 的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考