chore: align sqlite control plane architecture

- replace default Convex control-plane wording with Rust SQLite control-plane across architecture, AGENTS, Reasonix, and design docs

- retire root Convex functions source and deploy script into recycle while keeping explicit cloud/compat/sync-replica boundaries

- add control-plane migration guard/docs and keep CodeGraph refreshed after the SQLite control-plane cutover
This commit is contained in:
lix-2026
2026-05-22 17:45:22 +08:00
parent 531e845600
commit 47e224d419
79 changed files with 7634 additions and 2600 deletions
+12 -6
View File
@@ -1,6 +1,11 @@
# 01-05 当前主线与优先级总览
> 更新时间:2026-05-21
> 更新时间:2026-05-22
>
> 2026-05-22 口径补充:
> - Rust SQLite control-plane 已承接默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面。
> - 根 `convex/` functions 源码已软删除到 `recycle/20260522-convex-runtime-retirement/convex/`,只作为审计 / 迁移对照素材;`desktop:hot` / `dev:hot` 不启动 Convex。
> - Convex 只保留历史迁移源、显式 cloud source、compat 和 sync replica 边界;不要把 Convex Auth、`aiSessions.ts` 或根 functions deploy 重新描述为默认控制面。
>
> 2026-05-21 口径补充:
> - 当前已进入 local-first MVP 后阶段:最小可用闭环已建立,后续重点是底座统一、compat 瘦身和产品化闭环。
@@ -8,7 +13,7 @@
> - 旧 Convex / Next / BlockNote 主链只作为 legacy / recycle / compat 背景,不再作为新增能力默认方向。
>
> 2026-05-18 口径补充:
> - 产品形态已调整为 `Local-first workspace`:本地文件夹是默认数据真相,Rust kernel 是唯一语义真相,Convex / 服务端降级为账号、分享、同步、协作和 AI 隔离控制面
> - 产品形态已调整为 `Local-first workspace`:本地文件夹是默认数据真相,Rust kernel 是唯一语义真相,Rust SQLite control-plane 是默认账号、分享、同步、协作和 AI 隔离控制面;Convex / 服务端降级为历史迁移源、显式 cloud source、compat 和 sync replica 边界
> - 产品定义可进一步收口为:`VSCode 简化版工作区内核 + tiptap markdown 编辑器 + Hermes / Reasonix agent + simplemindmap / office 插件 + Wolai 风格 web 壳 + 鉴权控制面`。
> - 上位设计已完成并迁入:`/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`。
> - 本地 Markdown 图片与附件上传已新增本地 route 并避免 Convex media asset,见 `bugs/03-rust-web/done/3-16-local-markdown-upload-uses-convex-media-asset-v1.md`;真实浏览器上传 / 刷新 / 文件树可见 smoke 已由 `scripts/task443-local-markdown-asset-upload-smoke.js` 覆盖。
@@ -29,6 +34,7 @@
- `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`
- `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`
- `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md`
- `/mnt/Data1T/mnote/design/03-rust-web/process/3-rust-web-long-term-architecture-v1.md`
补充:旧稿 `/mnt/Data1T/mnote/design/old/02-convex-rust-long-term-architecture/process/2-tree-first-graph-convex-rust-long-term-architecture-v1.md` 已降级为 `[recycle][legacy]` 历史过渡判断,只解释“不要无计划硬拆 Convex”,不再作为新增能力默认存储口径。
@@ -36,8 +42,8 @@
它们分别固定了四件事:
1. 长期事实源是 `tree-first graph kernel`
2. 本地文件夹是早期产品默认数据真相,Convex / 服务端降级为控制面与可选同步协作层
3. 旧 Convex 主存储链只作为当前代码过渡态,不再作为新增能力默认方向
2. 本地文件夹是早期产品默认数据真相,Rust SQLite control-plane 是默认控制面,Convex / 服务端降级为历史迁移源与显式 cloud / compat / sync replica
3. 旧 Convex 主存储链和根 Convex functions deploy 只作为历史 / 迁移对照,不再作为新增能力默认方向
4. `mnote-web` 是 Rust Web 承载层,长期继续承担 transport、projection 分发与切流
## 2. 当前第一优先级
@@ -64,7 +70,7 @@ P0-P6 已经有最小闭环证据;P7 已完成阶段性瘦身,但还不是
- 前期产品是 10 人以内、个人笔记默认独立、可分享、AI 隔离的知识库,不是默认云协作平台
- 本地 markdown 文件更适合作为 AI 编辑、上传下载、备份、git 管理和调试的默认数据形态
- Convex 配置、schema、functions、实时订阅和 storage 不应继续阻塞本地个人工作区主路径
- LocalFS 已成为默认 `WorkspaceSource` 方向,Convex 保留为账号、分享、同步和协作控制面
- LocalFS 已成为默认 `WorkspaceSource` 方向,SQLite control-plane 保留为账号、分享、同步和协作默认控制面Convex 只保留显式 cloud / compat / sync replica 边界
- 本地 Markdown 上传、管理员目录授权、冲突合并 UI、agent changed files、本地索引、分享 / 同步、资源模型与导出迁移均已进入最小闭环
### 2.1 Page Aggregate
@@ -179,4 +185,4 @@ P0-P6 已经有最小闭环证据;P7 已完成阶段性瘦身,但还不是
当前 `design/01-05` 的真实主线,不是“继续证明 Rust Web 值不值得做”,也不是“继续证明 `leptos-tiptap` 能不能用”,而是:
> **先把页面域、树域、上传下载和 AI 编辑收口到本地优先工作区,由 Rust kernel 持有唯一语义,再把 Convex 降级为账号、分享、同步和协作控制面。**
> **先把页面域、树域、上传下载和 AI 编辑收口到本地优先工作区,由 Rust kernel 持有唯一语义,由 SQLite control-plane 持有默认账号、分享、同步和协作控制面;Convex 只作为历史迁移源、显式 cloud source、compat 和 sync replica 边界保留。**