Files
NotesAgentic/docs/development/第三阶段实施与验收记录.md

3.8 KiB
Raw Permalink Blame History

第三阶段实施与验收记录

基线:f193f69;分支:feat/phase3-completion。范围以第三阶段实施规划为准。第三阶段尚未完整交付,不可作为发布候选。

2026-09-08 文档补充:已编写五项生产化工程规划与验收目标,其验收 runner、工作包及量化指标均为待实施目标。本次只修改文档,不新增功能验收证据,不改变下表状态。

决策与状态

项目 决策 / 当前状态 依据与恢复
同步入口 冻结 server sync/,生产 PostgreSQL + S3 SQLite + 磁盘仅用于隔离协议测试
Sync v1 CAS、幂等、设备撤销、对象上传和历史已实现 契约,完整生产验收待执行
历史保留 永久保留 Revision、tombstone 和历史对象 暂不 GC,容量达到配额时拒绝上传;可逆地增加保留策略
Host frontend/src-tauri/Rust 文件日志、outbox、原生菜单与 Web/桌面适配 Host v1Sidecar/Stronghold/完整交互待验收
Community Ed25519 签名目录、七类校验和前端来源入口 Community v1,升级事务与生产运营待完成
平台隔离 未证明 OS 沙箱的第三方进程默认禁用 能力许可不等同 OS 沙箱,不以用户点击绕过
发布 不启用自动更新与安装包分发 签名、迁移、恢复、三平台实机尚未通过

已执行验证

  • 后端:887 项 pytest 通过;新增 Web/桌面单写入者门禁测试。
  • 前端:89 个文件、476 项 Vitest 通过;TypeScript 检查与 Vite 生产构建通过,保留既有大 chunk 提示。桌面标题栏窗口操作使用 Tauri capability,Web 模式不显示伪窗口按钮;标题栏“段落”菜单复用编辑命令能力门禁。AI 与文档滚动按钮改为同一底边横向错位,避免双滚动按钮出现时重叠。
  • Sync v118 项隔离测试通过,Windows / Python 3.13.9 / SQLite / 磁盘对象 Fixture。包括双线程并发 CAS;不是 PostgreSQL 多 Worker 压测。
  • Community v113 项隔离测试通过;前端使用 Python 生成的真实 Ed25519 向量互验。
  • Rust:系统 rustc/cargo 1.98.1x86_64-pc-windows-gnu)下,7 项文件恢复及最近 Vault 授权测试、rustfmt、clippy -D warnings 和 Tauri desktop 开发构建通过。没有安装包或新标题栏实机 UI 证据。
  • 文档相对链接、git diff --check 及 AI Core / Sync / Community 隔离冒烟通过。Gitea 工作流已加入,但未推送,因此无远端 Runner 证据。
  • 真实模型、个人 Vault、真实音频和凭据未作为测试输入。

完整范围跟踪

里程碑 状态 未满足退出条件
M0 进行中 平台隔离决策、负责人/预算确认、Sidecar/Stronghold 契约
M1 进行中 Sidecar、Stronghold 迁移、多窗口、文件监听和完整桌面交互
M2 进行中 安装升级/回滚事务、真实包全生命周期和生产 OS 隔离
M3 进行中 PostgreSQL/MinIO 运行与备份恢复、运维和负载门禁
M4 待开始 Rust 上传/拉取循环、冲突 UI、两台实机离线同步
M5 进行中 声明式候选尚未接 RuntimeOCR、质量专项和主题/WebView 交互矩阵
M6 待开始 安装更新签名、升级迁移、三平台和性能门禁

本机未发现 Docker 命令;Compose 尚未运行。真实厂商调用需获准账号与费用上限,音频质量需有授权且带标注的数据,当前均未执行。不能以这些外部条件缺失解释尚未实现的普通工程范围。