feat(sync): 实现设备认证与对象版本协议原型

2026-09-07 15:45:37 +08:00
parent f193f699b2
commit 7fffbcd55a
17 changed files with 1444 additions and 0 deletions
@@ -0,0 +1,34 @@
+# 第三阶段实施与验收记录
+
+基线：`f193f69`；分支：`feat/phase3-completion`。范围以[第三阶段实施规划](../architecture/第三阶段实施规划.md)为准。**第三阶段尚未完整交付，不可作为发布候选。**
+
+## 决策与状态
+
+| 项目 | 决策 / 当前状态 | 依据与恢复 |
+| --- | --- | --- |
+| 同步入口 | 冻结 `server sync/`，生产 PostgreSQL + S3 | SQLite + 磁盘仅用于隔离协议测试 |
+| Sync v1 | CAS、幂等、设备撤销、对象上传和历史已实现 | [契约](../contracts/Sync-v1契约.md)，完整生产验收待执行 |
+| 历史保留 | 永久保留 Revision、tombstone 和历史对象 | 暂不 GC，容量达到配额时拒绝上传；可逆地增加保留策略 |
+| Host | `frontend/src-tauri/`，Rust 文件日志及 outbox | Tauri 与 Sidecar 生命周期、完整交互待验收 |
+| 平台隔离 | 未证明 OS 沙箱的第三方进程默认禁用 | 能力许可不等同 OS 沙箱，不以用户点击绕过 |
+| 发布 | 不启用自动更新与安装包分发 | 签名、迁移、恢复、三平台实机尚未通过 |
+
+## 已执行验证
+
+- Sync v1：18 项隔离测试通过，Windows / Python 3.13.9 / SQLite / 磁盘对象 Fixture。包括双线程并发 CAS；不是 PostgreSQL 多 Worker 压测。
+- 依赖：后端和前端 frozen 安装成功；Sync 独立 uv.lock 已生成。
+- 真实模型、个人 Vault、真实音频和凭据未作为测试输入。
+
+## 完整范围跟踪
+
+| 里程碑 | 状态 | 未满足退出条件 |
+| --- | --- | --- |
+| M0 | 进行中 | 社区签名契约、平台原型、负责人/预算确认、完整 Host 原型 |
+| M1 | 待开始 | 原生编辑完整闭环、Sidecar、Stronghold 迁移、菜单与多窗口 |
+| M2 | 待开始 | 社区与安装升级事务、真实包全生命周期、安全隔离 |
+| M3 | 进行中 | PostgreSQL/MinIO 运行与备份恢复、运维和负载门禁 |
+| M4 | 待开始 | Rust 上传/拉取循环、冲突 UI、两台实机离线同步 |
+| M5 | 待开始 | 七类社区、OCR、质量专项和主题/WebView 交互矩阵 |
+| M6 | 待开始 | 安装更新签名、升级迁移、三平台和性能门禁 |
+
+本机未发现 Docker 命令；Compose 尚未运行。真实厂商调用需获准账号与费用上限，音频质量需有授权且带标注的数据，当前均未执行。不能以这些外部条件缺失解释尚未实现的普通工程范围。