ci(build): 增加第三阶段全量门禁与验收记录
This commit is contained in:
+6
-1
@@ -4,7 +4,7 @@
|
||||
|
||||
本目录集中保存团队开发期间需要长期维护的架构、接口、实现、协作和问题复盘文档。文档按用途分类，避免设计约束、开发记录与故障复盘混放。
|
||||
|
||||
当前文档基线为 2026-09-06：第一阶段和第二阶段 A～F 工程范围已经合并到 `main`，当前可运行形态仍为 Vue/Vite Web 前端与 FastAPI AI Core。Tauri/Rust Host、Stronghold、原生多 Vault 文件系统、生产级 MCP 沙箱和 Sync Server 尚未接入。
|
||||
当前第三阶段分支已实现 Tauri/Rust 原生 Vault、Sync v1 和签名社区目录的可测试原型；它仍缺少 Sidecar、Stronghold、生产插件隔离、完整同步客户端和发布门禁，不能作为第三阶段发布候选。状态与证据见[第三阶段实施与验收记录](development/第三阶段实施与验收记录.md)。
|
||||
|
||||
仓库入口文档：[项目 README](../README.md)、[前端 README](../frontend/README.md)、[后端 README](../backend/README.md)。
|
||||
|
||||
@@ -31,11 +31,16 @@
|
||||
- [第二阶段接口契约](contracts/第二阶段接口契约-开发版.md)
|
||||
- [前端页面需求说明](contracts/前端页面需求说明-开发版.md)
|
||||
- [Tauri / Rust 桌面客户端需求说明（第三阶段，计划）](contracts/Tauri-Rust桌面客户端需求说明-第三阶段.md)
|
||||
- [Rust Host v1 预览契约](contracts/Host-v1契约.md)
|
||||
- [Sync Protocol v1 契约](contracts/Sync-v1契约.md)
|
||||
- [Community Catalog v1 契约](contracts/Community-v1契约.md)
|
||||
|
||||
运行中的后端以 `/openapi.json` 为机器可读事实来源。接口契约用于描述设计意图、联调约束和实现状态；两者不一致时，应先确认代码行为，再在同一个 PR 中同步修正文档或实现。
|
||||
|
||||
## development：开发说明
|
||||
|
||||
- [第三阶段实施与验收记录](development/第三阶段实施与验收记录.md)
|
||||
|
||||
- [前端构建分块优化开发说明](development/前端构建分块优化开发说明.md)
|
||||
|
||||
- [工作区后台索引与保存开发说明](development/工作区后台索引与保存开发说明.md)
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
> 2026-09-06 后续修复补充：本地扩展安装登记、摘要复核恢复、ZIP 卸载清理以及工作区 context_menu/toolbar 入口已在第二阶段补丁实现。下文原始基线仍保留用于追踪；第三阶段应在此基础上完成迁移、签名、升级事务及生产隔离，不重复建设基础登记。真实质量与厂商验收仍未闭环。
|
||||
|
||||
> 2026-09-07 实施进展：分支已交付 Rust 原生 Vault、Sync v1、签名社区目录和社区前端的 Alpha 原型，细粒度状态与未完成门禁见[第三阶段实施与验收记录](../development/第三阶段实施与验收记录.md)。本规划的完整退出条件尚未满足。
|
||||
|
||||
基线日期：2026-09-06。状态：**计划，尚未交付第三阶段**。本规划以当前第二阶段代码及本地验收记录为起点；本次用户明确要求将各社区、Sync Server、Tauri / Rust 容器纳入第三阶段。未勾选项均为待实施，不以文档编写或接口命名代替实现。
|
||||
|
||||
## 1. 阶段目标与完成口径
|
||||
|
||||
@@ -9,26 +9,31 @@
|
||||
| 同步入口 | 冻结 `server sync/`，生产 PostgreSQL + S3 | SQLite + 磁盘仅用于隔离协议测试 |
|
||||
| Sync v1 | CAS、幂等、设备撤销、对象上传和历史已实现 | [契约](../contracts/Sync-v1契约.md)，完整生产验收待执行 |
|
||||
| 历史保留 | 永久保留 Revision、tombstone 和历史对象 | 暂不 GC，容量达到配额时拒绝上传；可逆地增加保留策略 |
|
||||
| Host | `frontend/src-tauri/`，Rust 文件日志及 outbox | Tauri 与 Sidecar 生命周期、完整交互待验收 |
|
||||
| Host | `frontend/src-tauri/`，Rust 文件日志、outbox、原生菜单与 Web/桌面适配 | [Host v1](../contracts/Host-v1契约.md)，Sidecar/Stronghold/完整交互待验收 |
|
||||
| Community | Ed25519 签名目录、七类校验和前端来源入口 | [Community v1](../contracts/Community-v1契约.md)，升级事务与生产运营待完成 |
|
||||
| 平台隔离 | 未证明 OS 沙箱的第三方进程默认禁用 | 能力许可不等同 OS 沙箱，不以用户点击绕过 |
|
||||
| 发布 | 不启用自动更新与安装包分发 | 签名、迁移、恢复、三平台实机尚未通过 |
|
||||
|
||||
## 已执行验证
|
||||
|
||||
- 后端：887 项 pytest 通过；新增 Web/桌面单写入者门禁测试。
|
||||
- 前端：87 个文件、471 项 Vitest 通过；TypeScript 检查与 Vite 生产构建通过，保留既有大 chunk 提示。
|
||||
- Sync v1：18 项隔离测试通过，Windows / Python 3.13.9 / SQLite / 磁盘对象 Fixture。包括双线程并发 CAS；不是 PostgreSQL 多 Worker 压测。
|
||||
- 依赖：后端和前端 frozen 安装成功；Sync 独立 uv.lock 已生成。
|
||||
- Community v1：13 项隔离测试通过；前端使用 Python 生成的真实 Ed25519 向量互验。
|
||||
- Rust：5 项文件恢复测试、clippy `-D warnings`、Tauri desktop 编译检查和 Windows GNU 开发构建通过。没有安装包或实机 UI 证据。
|
||||
- 文档相对链接、`git diff --check` 及 AI Core / Sync / Community 隔离冒烟通过。Gitea 工作流已加入，但未推送，因此无远端 Runner 证据。
|
||||
- 真实模型、个人 Vault、真实音频和凭据未作为测试输入。
|
||||
|
||||
## 完整范围跟踪
|
||||
|
||||
| 里程碑 | 状态 | 未满足退出条件 |
|
||||
| --- | --- | --- |
|
||||
| M0 | 进行中 | 社区签名契约、平台原型、负责人/预算确认、完整 Host 原型 |
|
||||
| M1 | 待开始 | 原生编辑完整闭环、Sidecar、Stronghold 迁移、菜单与多窗口 |
|
||||
| M2 | 待开始 | 社区与安装升级事务、真实包全生命周期、安全隔离 |
|
||||
| M0 | 进行中 | 平台隔离决策、负责人/预算确认、Sidecar/Stronghold 契约 |
|
||||
| M1 | 进行中 | Sidecar、Stronghold 迁移、多窗口、文件监听和完整桌面交互 |
|
||||
| M2 | 进行中 | 安装升级/回滚事务、真实包全生命周期和生产 OS 隔离 |
|
||||
| M3 | 进行中 | PostgreSQL/MinIO 运行与备份恢复、运维和负载门禁 |
|
||||
| M4 | 待开始 | Rust 上传/拉取循环、冲突 UI、两台实机离线同步 |
|
||||
| M5 | 待开始 | 七类社区、OCR、质量专项和主题/WebView 交互矩阵 |
|
||||
| M5 | 进行中 | 声明式候选尚未接 Runtime；OCR、质量专项和主题/WebView 交互矩阵 |
|
||||
| M6 | 待开始 | 安装更新签名、升级迁移、三平台和性能门禁 |
|
||||
|
||||
本机未发现 Docker 命令；Compose 尚未运行。真实厂商调用需获准账号与费用上限，音频质量需有授权且带标注的数据，当前均未执行。不能以这些外部条件缺失解释尚未实现的普通工程范围。
|
||||
|
||||
@@ -33,10 +33,10 @@
|
||||
| 领域 | 当前边界 |
|
||||
| --- | --- |
|
||||
| Agent / Streaming | 运行事件仍在进程内保存，后续需要持久化、`Last-Event-ID` 和断线重连 |
|
||||
| Security | 本地主密钥目前保存在数据目录，桌面端接入后迁移到系统凭据库 |
|
||||
| Extension | 扩展安装状态尚未持久化；MCP Host、进程隔离、签名与来源校验属于第二阶段 |
|
||||
| Security | 本地主密钥目前保存在数据目录；Rust Vault 文件服务已接入，Stronghold 迁移尚未完成 |
|
||||
| Extension | 安装状态已持久化、社区发行签名原型已接入；生产 OS 隔离和桌面 Extension Manager 尚未完成 |
|
||||
| AI Core | 音频转写当前只读取文本或 Host 预生成旁路文本，后续接入本地 ASR 队列 |
|
||||
| Desktop | Web Workspace 已连接 FastAPI 单 Vault；后续由 Tauri IPC 增加原生目录选择、多 Vault 和文件监听 |
|
||||
| Desktop | Tauri IPC 已支持单个原生 Vault 的选择、版本保存和恢复；最近列表、多窗口、监听、Sidecar 与同步循环尚未完成 |
|
||||
| Editor / Chat | 待补文件冲突合并及受控链接对话框；会话持久化已接入后端 SQLite |
|
||||
| Performance | Shiki 已复用单例，后续按首屏指标评估延迟加载或 Web Worker |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user