产品底座与账户 / 运行底座

数据库 WAL 与自恢复

已实现待验证Windows 桌面 · 待验证macOS 桌面 · 待验证

桌面端数据库启用 WAL 日志与自动检查点,断电等异常后启动时自动体检,损坏时自动从最近有效备份恢复。

功能价值

桌面端数据库启用 WAL 日志与自动检查点,断电等异常后启动时自动体检,损坏时自动从最近有效备份恢复。

使用方式

默认启用,无需配置;备份脚本位于仓库 scripts/backup/。

所属模块

产品底座与账户 / 运行底座

适用平台

Windows 桌面 · 待验证macOS 桌面 · 待验证

当前状态

已实现待验证(相关代码更新时间:2026-09-11)

已知限制

  • 恢复以最近一次有效备份为准,两次备份之间的增量可能丢失

平台验证状态

本项适用于 2 个平台,逐平台独立判定:平台状态只由该平台的实机验收记录产生,总体状态由平台状态自动汇总,目录与页面都不存放可手写的状态。

Windows 桌面

待验证

该平台尚无实机验收记录。平台状态只由该平台的实机验收产生,代码与自动化测试不计入;本项在此平台保持「待验证」,不会因其他平台通过而变绿。

变为已验证需要完整 PASS acceptance JSON、可追溯的产品版本和 Git SHA、交付身份 JSON 与安装包 / 部署产物 SHA-256,以及引用有效且哈希匹配的截图、录像和运行日志。

macOS 桌面

待验证

该平台尚无完整且通过的实机验收记录。平台状态只由该平台的实机验收产生,代码与自动化测试不计入;本项在此平台保持「待验证」,不会因其他平台通过而变绿。

变为已验证需要完整 PASS acceptance JSON、可追溯的产品版本和 Git SHA、交付身份 JSON 与安装包 / 部署产物 SHA-256,以及引用有效且哈希匹配的截图、录像和运行日志。

实机补充记录

来源记录结果:partial(补充观察,不构成 PASS 验收);产品版本:1.0.0.5;Git SHA:8d50fe9d043391d5ba8857094a366a59a34ae43f(Git SHA 与交付 SHA 可追溯);安装包 / 交付 SHA-256:55a873779aa316fe1e2393ff043978187911b3e052b9762deaefdd6d4817e32f;来源 JSON SHA-256 005c8426913aaf189ede4b9098c47e69d9fd215e806b178fe520e82b71e8e849;身份 / 交付 JSON

身份 / 交付 JSON SHA-256:a94ec3adf9cde55a0ec5f6f407e78f624899c1ac6e393a6a760b1b83f508bac0

实机录像 / 操作流程

补充实机材料;SHA-256:1ff349d3e9099d0edf296be1a6bc7354eaa477f1ce82948c70e7f31399ad3608(原始文件:FHD/docs/evidence/e2e/macos-base-domain-recordings-20260925/media/videos/base-db.webm)

实机截图

数据库 WAL 与自恢复 已复核截图
补充实机材料;SHA-256:0589bbbf74f8ed6ece5b298b1368084e8bcdfd2b8cf33dd193c8c1a422fca9c6(原始文件:FHD/docs/evidence/e2e/macos-base-domain-recordings-20260925/media/screenshots/base-db.png)

运行日志

下载原件:base-db.log;SHA-256:1bc1f4408c8ae2d2a14ab046ab934af0fa5c2e1820929e713f43ae98a2d76ecd(仓库路径:FHD/docs/evidence/e2e/macos-base-domain-recordings-20260925/logs/base-db.log)

实现与测试(平台无关)

本项在 Windows 桌面、macOS 桌面 上尚无完整 PASS 实机验收记录,不完整记录与补充观察均不计入已验证状态;当前状态仅表示代码已合入。

图片内容复核(2026-09-20,Mac 1.0.0.5):个人主页与模型服务设置,未显示数据库恢复、健康响应、设备配对、权限验证或 OTA 结果。

源码实现

  • FHD/app/db/__init__.py
  • FHD/app/desktop_runtime/migrate.py

自动化测试

暂无

CI 门禁:待补本项 CI 证据

CI 工作流定义

暂无

未标注平台的补充资料

下列资料未绑定到具体平台,仅作实现与历史资料参考,不计入任何平台状态,也不构成实机验收。

实机截图

数据库 WAL 与自恢复 已复核截图
资料收录(未绑定平台验收)(原始文件:FHD/docs/evidence/capabilities/base-db-01-desktop-runtime-data-dir.png)