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
@@ -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 边界保留。**
|
||||
|
||||
+1
-1
@@ -215,7 +215,7 @@
|
||||
- 已新增 Next 兼容切流入口：
|
||||
- `/api/compat/next/sidebar`
|
||||
- `MNOTE_WEB_QUERY_FIXTURES_JSON` + `allow_dev_fixtures` 已把 fixture 收紧到测试/开发边界
|
||||
- `/api/sidebar` 与服务端 Sidebar 首包当前已优先走 Rust bridge query + Convex transport；正式同源 `3000` 主链不再依赖 `MNOTE_WEB_BASE_URL` 或 `mnote-web` 的 Sidebar compat route
|
||||
- `/api/sidebar` 与服务端 Sidebar 首包当前已优先走 Rust bridge query + source-specific transport；Convex transport 仅属于显式 cloud / compat source，正式同源 `3000` 主链不再依赖 `MNOTE_WEB_BASE_URL` 或 `mnote-web` 的 Sidebar compat route
|
||||
- `mnote-web` transport 已优先转发真实 `Authorization`，否则才退回开发态 admin/dev identity
|
||||
- 已有 kernel / bridge 路由测试，说明 route 不只是声明
|
||||
|
||||
|
||||
+3
-3
@@ -19,7 +19,7 @@
|
||||
|
||||
- [x] 产品形态固定为 `VSCode 简化版工作区内核 + tiptap markdown 编辑器 + Hermes / Reasonix agent + simplemindmap / office 插件 + Wolai 风格 web 壳 + 鉴权控制面`。
|
||||
- [x] 本地文件夹是默认数据真相；Rust kernel 是唯一语义真相。
|
||||
- [x] Convex / 服务端降级为账号、分享、同步、协作和 AI 隔离控制面。
|
||||
- [x] Rust SQLite control-plane 承接账号、分享、同步、协作和 AI 隔离默认控制面；Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
- [x] AI 默认尽量使用 agent 原生文件读写、diff、patch 能力；MNote 只提供授权 root、页面定位、必要元数据和特殊资源工具。
|
||||
- [x] 每完成一个阶段后，把对应过程稿移动到该分类 `done/`，并在本 checklist 写入验证证据。
|
||||
- 本轮说明：`1-3` 本身仍作为当前持续执行清单保留在 `process/`；已完成的上位 local-first 设计和已完成阶段稿继续放在各自 `done/`，仍处于阶段性收口的 P7 文档保留在 `process/` 并在本 checklist 写明证据。
|
||||
@@ -165,7 +165,7 @@
|
||||
补充验证：
|
||||
|
||||
- [x] `cargo fmt --check --all`
|
||||
- [x] `cargo test -p mnote-web hermes_client_acp_run_registers_scoped_runtime_record_in_convex -- --nocapture`
|
||||
- [x] `cargo test -p mnote-web hermes_client_acp_run_registers_scoped_runtime_record_in_convex -- --nocapture`（历史测试名；当前默认运行态记录已由 SQLite control-plane 承接，旧 Convex store 只保留显式 compat 覆盖）
|
||||
- [x] `cargo test -p mnote-web hermes_client_local_acp -- --nocapture`
|
||||
- [x] `cargo test -p mnote-web document_shell_renders_local_markdown_with_same_sidebar_surfaces -- --nocapture`
|
||||
|
||||
@@ -240,7 +240,7 @@
|
||||
|
||||
对应 `01-05` 执行顺序：`5. 分享与同步闭环`。
|
||||
|
||||
目标：个人本地空间默认隔离，显式分享后才产生共享 workspace / shared AI session，Convex 只作为权限、同步和协作控制面。
|
||||
目标：个人本地空间默认隔离，显式分享后才产生共享 workspace / shared AI session；权限、同步和协作默认由 Rust SQLite control-plane 承接，Convex 只保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
|
||||
### 5.1 分享权限
|
||||
|
||||
|
||||
+3
-1
@@ -4,6 +4,8 @@
|
||||
>
|
||||
> 当前状态：`DONE`。
|
||||
>
|
||||
> 2026-05-22 口径补充：本文是 2026-05-18 前后的阶段性 Convex-backed snapshot 对齐记录；当前默认正文真相已收口到 local-first `.md` / Page Aggregate 投影，Rust SQLite control-plane 承接默认控制面，Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
>
|
||||
> 关联文档：
|
||||
> - `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/process/2-tree-first-graph-convex-rust-long-term-architecture-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-13-page-block-identity-and-command-contract-v1.md`
|
||||
@@ -41,7 +43,7 @@ documents.content_conflict_key
|
||||
|
||||
第一阶段正确策略是：
|
||||
|
||||
> **Rust 先持有块语义和命令计划，Convex 仍保存 canonical snapshot 到 `documents.content`；Page Aggregate 从 snapshot 投影出稳定 block view。等块投影、revision、刷新链路稳定后，再评估是否把 `blocks` 表升级为写主链。**
|
||||
> **历史阶段策略是 Rust 先持有块语义和命令计划，Convex 保存 canonical snapshot 到 `documents.content`，Page Aggregate 从 snapshot 投影出稳定 block view。当前默认策略已继续演进为 local-first `.md` 正文真相 + Rust SQLite control-plane 默认控制面；Convex snapshot 只作为显式 cloud / compat source。**
|
||||
|
||||
---
|
||||
|
||||
|
||||
+18
-15
@@ -4,14 +4,17 @@
|
||||
>
|
||||
> 当前状态：`DONE`
|
||||
>
|
||||
> 2026-05-22 口径补充：本文完成的是“local-first workspace + Convex 降级控制面”的阶段性方案；后续 `2-8` 已继续把默认控制面从 Convex 替换为 Rust SQLite `control-plane`。因此本文中“Convex / 服务端控制面”的表述只作为阶段性历史背景理解；当前默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 已由 SQLite control-plane 承接，Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
>
|
||||
> 本稿目的：
|
||||
> 1. 固定早期产品形态：10 人以内、用户笔记默认独立、可分享、AI 隔离且可共享。
|
||||
> 2. 将 mnote 从“Convex 与本地两套同等重量系统”收口为“本地文件夹默认主路径 + Convex / 服务端控制面”。
|
||||
> 2. 将 mnote 从“Convex 与本地两套同等重量系统”收口为“本地文件夹默认主路径 + 控制面”；本稿当时的 Convex 控制面口径已被 `2-8` 的 Rust SQLite control-plane 替换。
|
||||
> 3. 给出现有文件树、页面树、上传下载、编辑、AI 会话从 Convex 重依赖迁向本地优先的阶段计划。
|
||||
>
|
||||
> 关联文档：
|
||||
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
|
||||
> - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.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/02-convex-rust-long-term-architecture/process/2-tree-first-graph-convex-rust-long-term-architecture-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/03-rust-web/done/3-15-local-markdown-asset-upload-relative-path-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/04-tree-domain/done/4-22-local-folder-convex-unified-tree-execution-checklist-v1.md`
|
||||
@@ -39,9 +42,9 @@
|
||||
|
||||
因此当前产品形态应调整为：
|
||||
|
||||
> **本地文件夹是默认数据真相；Rust kernel 是唯一语义真相；Convex 或服务端降级为账号、分享、同步、协作和 AI 隔离的控制面。**
|
||||
> **本地文件夹是默认数据真相；Rust kernel 是唯一语义真相；Rust SQLite control-plane 是默认账号、分享、同步、协作和 AI 隔离控制面；Convex 仅保留历史迁移源和显式 cloud / compat / sync replica 边界。**
|
||||
|
||||
这不是否定 Convex 的价值，而是把 Convex 从默认主存储降级为可选增强能力。
|
||||
这不是否定 Convex 的历史价值，而是把 Convex 从默认主存储和默认控制面降级为可选 cloud/compat 能力与迁移来源。
|
||||
|
||||
---
|
||||
|
||||
@@ -432,7 +435,7 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
- Convex executor 和 LocalFS executor 并存。
|
||||
- Convex 旧 route 通过 adapter 转入 Rust kernel。
|
||||
- 局部页面仍可先读 Convex，再逐步切到 LocalFS。
|
||||
- 控制面仍可临时使用 Convex Auth 与 membership。
|
||||
- 历史阶段控制面曾可临时使用 Convex Auth 与 membership；当前默认已由 Rust SQLite control-plane 承接。
|
||||
|
||||
---
|
||||
|
||||
@@ -614,8 +617,8 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
| 编辑器图片 / 附件上传 | `rust/crates/mnote-web/src/routes/local_folder_source.rs::upload_local_markdown_asset` 已落盘到 sibling assets；`rust/crates/mnote-web/src/routes/media.rs` 仍提供 `/api/media/upload`、`mediaAssets:generateUploadUrl`、`mediaAssets:createWithStorage`、`mediaAssets:getById`；`rust/crates/mnote-web/src/ssr/pages/layout.rs` 仍保留 `/api/media/sign?assetId=` 与 OnlyOffice assetId 路径。 | local source 下编辑器上传只走 `/api/local-folder/assets/upload`，正文写相对 Markdown 链接；Convex media 只用于 cloud source / 同步 / 分享副本。 | 部分完成：本地上传基线完成，浏览器 smoke 与 assetId 打开链路仍需收口。 |
|
||||
| 普通文件下载 / 页面导出 | `rust/crates/mnote-web/src/ssr/pages/layout.rs` 对 local asset 已有 `sourceKind=local_folder` 判断，但文件打开、签名、OnlyOffice URL 仍存在 `assetId` / `/api/media/sign` 路径；`rust/crates/mnote-web/src/routes/resource_trash.rs` 仍大量操作 `mediaAssets:*`。 | 普通本地文件下载直接读取 local root 内路径；页面导出 `.md`，子树导出目录与 assets；Convex media 下载只作为 cloud source 能力。 | 未完成：本地打开有局部判断，完整下载/导出模型未闭环。 |
|
||||
| AI tool 读取 / 写入页面 | `rust/crates/mnote-web/src/routes/hermes_tools.rs` 分发 `mnote.doc.*` / `mnote.block.*`；`rust/crates/mnote-web/src/hermes_tools/doc.rs::doc_markdown_edit` 和 `rust/crates/mnote-web/src/hermes_tools/block.rs` 最终仍走 `page.body.save`，在线路径会落到 Convex `documents:updateContent`。 | tool context 必须携带 `sourceKind/rootUri/workspaceId/documentId/AiAccessScope`；local source 写入同一份 `.md`，并保留 `{mdBase}.assets/` 相对链接。 | 部分完成：`mnote.doc.markdown_edit` local source 已写同一份 `.md` 并保留相对链接；`AiAccessScope` 权限收口仍未完成。 |
|
||||
| AI session / message / tool call 存储 | `convex/schema.ts` 与 `convex/aiSessions.ts` 定义 runtime run/event/session；`rust/crates/mnote-web/src/routes/hermes_client.rs` 调用 `aiSessions:upsertRuntimeRun`、`appendRuntimeEvent`、`listRuntimeRuns`、`listRuntimeEvents`、`renameRuntimeSession`、`autoTitleRuntimeSession`、`deleteRuntimeSession`、`searchRuntimeSessions`。 | 私有会话默认写 `ai-sessions/private/*.jsonl`；共享会话写 `ai-sessions/shared/<share-id>/*.jsonl`；Convex 只同步必要 metadata / share metadata / quota policy。 | 未完成：当前会话主存储仍是 Convex aiSessions。 |
|
||||
| share grants / membership / auth | `rust/crates/mnote-web/src/context.rs` 与 `rust/crates/mnote-web/src/transport/convex.rs` 处理 auth context / `__convexAuthJWT`；`rust/crates/mnote-web/src/routes/hermes_client.rs` 和 `routes/hermes_tools.rs` 使用 `ensure_authenticated`；`rust/crates/mnote-web/src/routes/tree.rs` 仍调用 `workspaces:ensureDefaultWorkspace`。 | Convex 保留为控制面：auth、membership、share grants、sync state、AI policy；本地打开和编辑需要登录 actor，并由 `.mnote/workspace.json.owner_id` 限定 root 归属；分享/同步继续要求控制面授权。 | 部分符合目标：auth 适合留在控制面，但当前仍有部分 AI / workspace 主路径待收紧。 |
|
||||
| AI session / message / tool call 存储 | 历史阶段由 `convex/schema.ts` 与 `convex/aiSessions.ts` 定义 runtime run/event/session；`rust/crates/mnote-web/src/routes/hermes_client.rs` 曾调用 `aiSessions:upsertRuntimeRun`、`appendRuntimeEvent`、`listRuntimeRuns`、`listRuntimeEvents`、`renameRuntimeSession`、`autoTitleRuntimeSession`、`deleteRuntimeSession`、`searchRuntimeSessions`。 | 私有会话默认写 `ai-sessions/private/*.jsonl`；共享会话写 `ai-sessions/shared/<share-id>/*.jsonl`；ACP/Hermes runtime session 默认写 SQLite control-plane；Convex 只保留显式 legacy / cloud / sync replica。 | 已由 `2-8` 继续收口：根 `convex/` runtime store 退役，默认 ACP runtime store 改为 SQLite。 |
|
||||
| share grants / membership / auth | 历史阶段 `rust/crates/mnote-web/src/context.rs` 与 `rust/crates/mnote-web/src/transport/convex.rs` 处理 auth context / `__convexAuthJWT`；`rust/crates/mnote-web/src/routes/tree.rs` 曾调用 `workspaces:ensureDefaultWorkspace`。 | Rust SQLite control-plane 承接 auth、membership、share grants、sync state、AI policy；本地打开和编辑需要登录 actor，并由 `.mnote/workspace.json.owner_id` 限定 root 归属；分享/同步继续要求 control-plane 授权。 | 已由 `2-8` 继续收口：默认 `/api/auth`、`/api/session`、share grant、access policy 和 ACP runtime store 均不依赖 Convex。 |
|
||||
| Smoke / 测试依赖 | `scripts/task159-auth-entry-smoke.js` 依赖 Convex password auth；`scripts/task175-rust-upload-entry-smoke.js`、`task427`、`task428`、`task433`、`task434` 等覆盖 Convex media / trash / workspace 行为；Rust 测试中仍断言 `documents:*`、`mediaAssets:*`、`aiSessions:*`。 | 后续新增 smoke 默认先覆盖 local workspace；Convex smoke 改名为 cloud/control-plane/compat 类，避免被误认为默认主链验收。 | 未完成：测试口径仍混合，需要随 P1-P7 分批改名和补 local smoke。 |
|
||||
|
||||
#### P0.2 新增设计 / 实现检查规则（2026-05-18 已落地）
|
||||
@@ -641,7 +644,7 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
- [x] `.mnote/workspace.json` 写入稳定 `workspace_id`、`owner_id`、`created_at`、`capabilities`。
|
||||
- 目录：默认写入 `/mnt/Data1T/Mnote_data/users/<actor-id-encoded>/workspaces/my-space/.mnote/workspace.json`。
|
||||
- 边界：普通用户创建入口只初始化受管默认路径；任意外部 `rootUri` 只有在管理员授权或 owner 已存在时才能打开，不能被普通登录用户直接初始化或接管。
|
||||
- [x] 登录状态是本地文件访问、用户空间隔离、分享、同步、云端协作的共同门禁；Convex 不再是正文/附件主存储，但 auth 仍是本地 workspace 访问控制面。
|
||||
- [x] 登录状态是本地文件访问、用户空间隔离、分享、同步、云端协作的共同门禁；Convex 不再是正文/附件主存储，且默认 auth / session 已由 Rust SQLite control-plane 承接。
|
||||
- 证据：`sourceKind=local_folder` 根入口继续要求 auth；本地文件读写入口新增 `.mnote/workspace.json.ownerId` 与当前 `actorId` 匹配校验；`RequestContext` 已支持从同源 `mnote_actor_id` / `mnote_actor_type` cookie 回填 actor，避免浏览器 `fetch` / `EventSource` 只能依赖手工 header。
|
||||
- 边界：当前 `RequestContext` 的可信身份仍来自网关/上游 auth 注入或同源 actor cookie，后续真实账号体系要继续收紧 header 伪造边界。
|
||||
- [x] `sourceKind=local_folder` 的 root 入口保持登录要求，未登录会跳转 `/auth`。
|
||||
@@ -853,10 +856,10 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
- [x] 浏览器 smoke 覆盖共享可写页面中 AI 写入有 audit 记录。
|
||||
- 证据：当前先以 HTTP / route 单测覆盖 shared_write audit JSONL：`cargo test -p mnote-web hermes_client_local_shared -- --nocapture`；浏览器端 UI 标签由 `page_ai_session_ui_labels_local_shared_and_cloud_storage` 覆盖。
|
||||
|
||||
### 8.7 P6：Convex / 服务端控制面收口
|
||||
### 8.7 P6：控制面收口（已由 2-8 继续替换为 SQLite）
|
||||
|
||||
- [x] 控制面只保存 user、workspace membership、share grants、sync state、AI policy。
|
||||
- 证据：G1 已冻结新增 Convex 边界；`scripts/check-local-first-convex-guard.js` 防止 active `convex/` 重新引入未标注 documents/media 主存储表或函数，`infra/convex` 只标注为控制面 / cloud source / compat / sync replica。
|
||||
- [x] 控制面只保存 user、workspace membership、share grants、sync state、AI policy；当前默认实现为 Rust SQLite control-plane。
|
||||
- 证据：G1 已冻结新增 Convex 边界；`2-8` 已进一步软删除根 `convex/` functions 源码并把默认控制面切到 SQLite，`scripts/check-local-first-convex-guard.js` 防止 active `convex/` 重新引入默认控制面或未标注 documents/media 主存储表 / 函数。
|
||||
- [x] 页面正文只在启用同步时产生远端副本。
|
||||
- 证据：local source 的正文保存主链写 `.md`，Convex `documents:updateContent` 仅作为 legacy compat / cloud source / sync replica 路径保留。
|
||||
- [x] 附件只在启用同步或分享时产生远端副本。
|
||||
@@ -1036,10 +1039,10 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
|
||||
#### G. 控制面收口与旧数据迁移
|
||||
|
||||
- [x] G1. Convex 控制面字段边界冻结。
|
||||
- [x] G1. 历史 Convex 控制面字段边界冻结；当前默认控制面已替换为 SQLite。
|
||||
- 文件：`infra/convex/`、`rust/crates/mnote-web/src/transport/convex.rs`。
|
||||
- 完成定义：新增 Convex 调用只能属于 auth、membership、share grants、sync state、AI policy、compat 或 sync replica。
|
||||
- 完成证据：`infra/convex/README.md` 与 `docker-compose.yml` 已明确 Convex 自托管仅作为控制面 / cloud source / compat / sync replica；`transport/convex.rs` 已标注 auth delegation、sidebar cloud source、legacy command validator、bridgeLogs audit replica 边界；`scripts/check-local-first-convex-guard.js --self-test` 已通过，并新增 active `convex/` 目录防重新引入未标注 documents/media 主存储表或函数。
|
||||
- 完成定义：新增 Convex 调用只能属于显式 cloud source、compat、migration 或 sync replica；默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 走 Rust SQLite control-plane。
|
||||
- 完成证据：`infra/convex/README.md` 与 `docker-compose.yml` 已明确 Convex 自托管仅作为显式 cloud source / compat / sync replica 或历史数据导出；`transport/convex.rs` 保留为 cloud/compat transport 边界；`scripts/check-local-first-convex-guard.js --self-test` 已通过，并新增 active `convex/` 目录防重新引入未标注 documents/media 主存储表或函数。
|
||||
- [x] G2. 旧 Convex workspace 导出为 local workspace。
|
||||
- 文件：新增迁移脚本，优先放 `scripts/` 或 `tools/`。
|
||||
- 验证：fixture workspace 导出后包含 `.md`、assets、`.mnote/page-ids.json`。
|
||||
@@ -1078,7 +1081,7 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编
|
||||
3. **Page Aggregate 本地 markdown 读写闭环**
|
||||
4. **上传下载本地资源模型**
|
||||
5. **AI 会话本地化与权限隔离**
|
||||
6. **Convex 控制面收口**
|
||||
6. **SQLite 控制面收口**
|
||||
7. **旧 Convex 主存储导出与退役**
|
||||
|
||||
原有 `Page Aggregate`、`tree command cutover`、`tree realtime` 仍然重要，但执行目标从“让 Convex 主链更稳定”调整为：
|
||||
@@ -1149,4 +1152,4 @@ AI tool 必须在执行前校验 scope。处理方式：
|
||||
- 每个用户的笔记和 AI 会话默认隔离。
|
||||
- 显式分享后，页面、子树、附件或 AI 会话可按权限共享。
|
||||
- Rust kernel 仍是唯一 tree / page / resource / AI tool 语义层。
|
||||
- Convex 不再是早期产品默认主数据层，而是控制面和可选同步协作层。
|
||||
- Convex 不再是早期产品默认主数据层或默认控制面，只保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
|
||||
+855
@@ -0,0 +1,855 @@
|
||||
# 2-8 Convex 完全替换为 Rust SQLite 控制面设计与迁移 checklist v1
|
||||
|
||||
> 创建时间：2026-05-22
|
||||
>
|
||||
> 当前状态：`done`
|
||||
>
|
||||
> 目标：在 local-first MVP 后阶段，将 Convex 从运行时控制面完全替换为 Rust + SQLite。迁移期间允许影子写入和只读导出校验，但成熟后 Convex 不再承担 auth、membership、share grants、sync state、AI policy、cloud source、compat 或 sync replica 的默认运行时职责。
|
||||
>
|
||||
> 上位依据：
|
||||
> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
|
||||
> - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.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-3-local-workspace-access-control-productization-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/03-rust-web/done/3-14-rust-web-tree-realtime-ws-push-v1.md`
|
||||
|
||||
---
|
||||
|
||||
## 1. 背景与结论
|
||||
|
||||
当前 MNote 已进入 local-first MVP 后阶段。本地 `.md`、附件、mindmap 和工作区目录是默认数据真相，Rust kernel 持有树、资源、页面聚合和命令语义。Convex 曾从旧主存储降级为控制面，但当前自托管 Convex backend 仍存在显著运行成本：正式容器长期运行后 RSS 约 3.7GiB；同镜像空实例约 20MiB；当前数据卷副本冷启动约 830MiB。对于账号、授权、分享、同步状态和 AI policy 这些控制面职责，这个常驻成本偏重，因此本稿继续把默认控制面替换为 Rust SQLite `control-plane`。
|
||||
|
||||
本稿结论：
|
||||
|
||||
> **用 Rust + SQLite 实现 MNote 原生控制面，完全替换 Convex 运行时依赖；SQLite 只保存身份、授权、分享、同步、策略、审计和事件 outbox，不保存页面正文或附件 blob。**
|
||||
|
||||
替换目标不是引入第二个应用后端，而是把控制面收进 `mnote-web` / Rust runtime，使本地优先工作区拥有一个小、可备份、可迁移、可测试的控制数据库。
|
||||
|
||||
---
|
||||
|
||||
## 2. 非目标
|
||||
|
||||
本阶段不做：
|
||||
|
||||
- 不把页面正文迁入 SQLite。
|
||||
- 不把本地附件、图片、OnlyOffice 文件 blob 迁入 SQLite。
|
||||
- 不重新实现多人 CRDT 文档协作。
|
||||
- 不引入 PocketBase、Supabase 或新的外部后端作为默认控制面。
|
||||
- 不扩展旧 Convex functions；Convex 只作为迁移数据来源和短期影子比对对象。
|
||||
- 不让前端直接访问 SQLite；所有读写必须经过 Rust API。
|
||||
|
||||
---
|
||||
|
||||
## 3. 目标运行架构
|
||||
|
||||
```text
|
||||
Browser / Desktop Shell / Agent
|
||||
|
|
||||
v
|
||||
Rust mnote-web :3000
|
||||
- auth/session route
|
||||
- workspace/profile route
|
||||
- access policy route
|
||||
- share/invite route
|
||||
- sync state route
|
||||
- AI policy/audit route
|
||||
- tree/page projection route
|
||||
- WS/SSE realtime route
|
||||
|
|
||||
v
|
||||
Rust control-plane store trait
|
||||
|
|
||||
v
|
||||
SQLite control-plane.db
|
||||
|
|
||||
+-- outbox_events -> mnote-web broadcast -> /api/realtime/ws
|
||||
|
||||
Local workspace folder remains data truth:
|
||||
/mnt/Data1T/Mnote_data/users/<actor>/workspaces/my-space/**/*.md
|
||||
```
|
||||
|
||||
默认数据库位置：
|
||||
|
||||
```text
|
||||
/mnt/Data1T/Mnote_data/control-plane/control-plane.db
|
||||
/mnt/Data1T/Mnote_data/control-plane/control-plane.db-wal
|
||||
/mnt/Data1T/Mnote_data/control-plane/control-plane.db-shm
|
||||
```
|
||||
|
||||
推荐 SQLite 配置：
|
||||
|
||||
```sql
|
||||
PRAGMA journal_mode = WAL;
|
||||
PRAGMA synchronous = NORMAL;
|
||||
PRAGMA foreign_keys = ON;
|
||||
PRAGMA busy_timeout = 5000;
|
||||
```
|
||||
|
||||
运行时原则：
|
||||
|
||||
- 单写者：只有 Rust control-plane store 写 SQLite。
|
||||
- 事务优先：用户、授权、分享、同步状态和 outbox 必须在同一事务内提交。
|
||||
- 版本控制：可被 UI 编辑的记录带 `revision` 或 `updated_at`，并支持 expected revision 检查。
|
||||
- 推送由 outbox 驱动：DB 写成功后追加 `outbox_events`，再广播 WS/SSE；不得在事务成功前推事件。
|
||||
- 本地文件权限判断以 SQLite 授权表为主，旧 `access-policy.json` 只作为迁移来源或只读 fallback。
|
||||
|
||||
---
|
||||
|
||||
## 4. Rust 模块边界
|
||||
|
||||
建议新增 crate 或模块：
|
||||
|
||||
```text
|
||||
rust/crates/control-plane/
|
||||
src/lib.rs
|
||||
src/model.rs
|
||||
src/store.rs
|
||||
src/sqlite.rs
|
||||
src/migrations.rs
|
||||
src/password.rs
|
||||
src/session.rs
|
||||
src/outbox.rs
|
||||
migrations/*.sql
|
||||
```
|
||||
|
||||
如短期不新增 crate，可先放在：
|
||||
|
||||
```text
|
||||
rust/crates/mnote-web/src/control_plane/
|
||||
```
|
||||
|
||||
但长期建议独立 crate，避免 `mnote-web` route、SSR 和 DB 细节耦合。
|
||||
|
||||
核心 trait：
|
||||
|
||||
```rust
|
||||
pub trait ControlPlaneStore: Send + Sync {
|
||||
fn upsert_user(&self, input: UpsertUserInput) -> Result<UserRecord, ControlPlaneError>;
|
||||
fn authenticate_password(&self, login: LoginInput) -> Result<AuthSession, ControlPlaneError>;
|
||||
fn get_session(&self, token_hash: &str) -> Result<Option<AuthSession>, ControlPlaneError>;
|
||||
fn revoke_session(&self, session_id: &str) -> Result<(), ControlPlaneError>;
|
||||
|
||||
fn ensure_default_workspace(&self, actor_id: &str) -> Result<WorkspaceRecord, ControlPlaneError>;
|
||||
fn list_workspaces_for_actor(&self, actor_id: &str) -> Result<Vec<WorkspaceSummary>, ControlPlaneError>;
|
||||
|
||||
fn grant_directory_access(&self, input: DirectoryGrantInput) -> Result<DirectoryGrant, ControlPlaneError>;
|
||||
fn revoke_directory_grant(&self, grant_id: &str, expected_revision: Option<i64>) -> Result<(), ControlPlaneError>;
|
||||
fn resolve_access(&self, actor_id: &str, root_uri: &str) -> Result<ResolvedAccess, ControlPlaneError>;
|
||||
|
||||
fn create_share_link(&self, input: ShareLinkInput) -> Result<ShareLink, ControlPlaneError>;
|
||||
fn resolve_share_link(&self, token_hash: &str) -> Result<Option<ShareLinkAccess>, ControlPlaneError>;
|
||||
|
||||
fn get_ai_policy(&self, actor_id: &str, workspace_id: Option<&str>) -> Result<AiPolicy, ControlPlaneError>;
|
||||
fn append_audit(&self, input: AuditInput) -> Result<(), ControlPlaneError>;
|
||||
fn drain_outbox(&self, limit: usize) -> Result<Vec<OutboxEvent>, ControlPlaneError>;
|
||||
}
|
||||
```
|
||||
|
||||
`mnote-web` 的 `AppState` 增加：
|
||||
|
||||
```rust
|
||||
control_plane: Arc<dyn ControlPlaneStore>
|
||||
```
|
||||
|
||||
后续所有 auth、session、workspace、access-policy、share、AI policy route 只依赖 trait，不直接依赖 SQLite。
|
||||
|
||||
---
|
||||
|
||||
## 5. SQLite schema v1
|
||||
|
||||
### 5.1 users
|
||||
|
||||
```sql
|
||||
CREATE TABLE users (
|
||||
id TEXT PRIMARY KEY,
|
||||
email TEXT UNIQUE,
|
||||
username TEXT UNIQUE NOT NULL,
|
||||
display_name TEXT NOT NULL,
|
||||
role TEXT NOT NULL DEFAULT 'user',
|
||||
status TEXT NOT NULL DEFAULT 'active',
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1
|
||||
);
|
||||
```
|
||||
|
||||
说明：
|
||||
|
||||
- `id` 使用当前 actor id 兼容格式，避免迁移时破坏本地 workspace path。
|
||||
- `role` 初期为 `admin|user`，不要把目录授权塞进 role。
|
||||
- 新用户注册成功后必须创建默认个人 workspace 与 owner grant。
|
||||
|
||||
### 5.2 auth_identities
|
||||
|
||||
```sql
|
||||
CREATE TABLE auth_identities (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
provider TEXT NOT NULL,
|
||||
provider_subject TEXT NOT NULL,
|
||||
password_hash TEXT,
|
||||
password_version INTEGER NOT NULL DEFAULT 1,
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
UNIQUE(provider, provider_subject)
|
||||
);
|
||||
```
|
||||
|
||||
初期 provider 支持：
|
||||
|
||||
- `password_email`
|
||||
- `password_username`
|
||||
- `convex_legacy`（仅迁移映射，不作为运行时登录）
|
||||
|
||||
密码哈希建议使用 Argon2id。若先做最小实现，可明确用当前已有密码验证口径，但必须留 `password_version` 以便升级。
|
||||
|
||||
### 5.3 auth_sessions
|
||||
|
||||
```sql
|
||||
CREATE TABLE auth_sessions (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
token_hash TEXT NOT NULL UNIQUE,
|
||||
user_agent TEXT,
|
||||
ip_hash TEXT,
|
||||
created_at TEXT NOT NULL,
|
||||
expires_at TEXT NOT NULL,
|
||||
revoked_at TEXT,
|
||||
last_seen_at TEXT NOT NULL
|
||||
);
|
||||
|
||||
CREATE INDEX idx_auth_sessions_user ON auth_sessions(user_id);
|
||||
CREATE INDEX idx_auth_sessions_token ON auth_sessions(token_hash);
|
||||
```
|
||||
|
||||
运行时 cookie 不再依赖 `__convexAuthJWT`。建议新 cookie：
|
||||
|
||||
- `mnote_session`
|
||||
- `mnote_actor_id`
|
||||
- `mnote_actor_name`
|
||||
- `mnote_actor_email`
|
||||
- `mnote_actor_type`
|
||||
|
||||
其中 `mnote_session` 是主凭证，actor cookies 只是 SSR/display 快捷缓存，可由 session route 刷新。
|
||||
|
||||
### 5.4 workspaces
|
||||
|
||||
```sql
|
||||
CREATE TABLE workspaces (
|
||||
id TEXT PRIMARY KEY,
|
||||
owner_user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
name TEXT NOT NULL,
|
||||
kind TEXT NOT NULL DEFAULT 'personal',
|
||||
root_uri TEXT NOT NULL UNIQUE,
|
||||
root_path TEXT NOT NULL,
|
||||
source_kind TEXT NOT NULL DEFAULT 'local_folder',
|
||||
status TEXT NOT NULL DEFAULT 'active',
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1
|
||||
);
|
||||
|
||||
CREATE INDEX idx_workspaces_owner ON workspaces(owner_user_id);
|
||||
```
|
||||
|
||||
默认工作区：
|
||||
|
||||
```text
|
||||
/mnt/Data1T/Mnote_data/users/<user-id>/workspaces/my-space
|
||||
```
|
||||
|
||||
`workspaces.name` 应由真实用户名生成，例如 `shujuan 的空间`，不再 fallback 到 `DEV_USER_NAME`。
|
||||
|
||||
### 5.5 workspace_members
|
||||
|
||||
```sql
|
||||
CREATE TABLE workspace_members (
|
||||
id TEXT PRIMARY KEY,
|
||||
workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
|
||||
user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
role TEXT NOT NULL,
|
||||
status TEXT NOT NULL DEFAULT 'active',
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1,
|
||||
UNIQUE(workspace_id, user_id)
|
||||
);
|
||||
```
|
||||
|
||||
`role` 初期支持：
|
||||
|
||||
- `owner`
|
||||
- `editor`
|
||||
- `viewer`
|
||||
|
||||
### 5.6 directory_grants
|
||||
|
||||
```sql
|
||||
CREATE TABLE directory_grants (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
workspace_id TEXT REFERENCES workspaces(id) ON DELETE CASCADE,
|
||||
root_uri TEXT NOT NULL,
|
||||
root_path TEXT NOT NULL,
|
||||
permission TEXT NOT NULL,
|
||||
recursive INTEGER NOT NULL DEFAULT 1,
|
||||
capabilities_json TEXT NOT NULL DEFAULT '[]',
|
||||
source TEXT NOT NULL DEFAULT 'admin',
|
||||
status TEXT NOT NULL DEFAULT 'active',
|
||||
created_by TEXT REFERENCES users(id),
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1
|
||||
);
|
||||
|
||||
CREATE INDEX idx_directory_grants_user ON directory_grants(user_id);
|
||||
CREATE INDEX idx_directory_grants_root_uri ON directory_grants(root_uri);
|
||||
```
|
||||
|
||||
`permission`：`read|write|admin`。
|
||||
|
||||
`capabilities_json` 初期保留：`ai|share|sync`。
|
||||
|
||||
### 5.7 share_links
|
||||
|
||||
```sql
|
||||
CREATE TABLE share_links (
|
||||
id TEXT PRIMARY KEY,
|
||||
workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
|
||||
resource_kind TEXT NOT NULL,
|
||||
resource_id TEXT NOT NULL,
|
||||
token_hash TEXT NOT NULL UNIQUE,
|
||||
permission TEXT NOT NULL,
|
||||
created_by TEXT NOT NULL REFERENCES users(id),
|
||||
expires_at TEXT,
|
||||
revoked_at TEXT,
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1
|
||||
);
|
||||
|
||||
CREATE INDEX idx_share_links_resource ON share_links(workspace_id, resource_kind, resource_id);
|
||||
```
|
||||
|
||||
公开分享只暴露 token，不暴露 `token_hash`。token 只显示一次，DB 只保存 hash。
|
||||
|
||||
### 5.8 sync_state
|
||||
|
||||
```sql
|
||||
CREATE TABLE sync_state (
|
||||
id TEXT PRIMARY KEY,
|
||||
workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
|
||||
remote_kind TEXT NOT NULL,
|
||||
remote_id TEXT,
|
||||
cursor TEXT,
|
||||
last_synced_at TEXT,
|
||||
status TEXT NOT NULL DEFAULT 'idle',
|
||||
error_json TEXT,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1,
|
||||
UNIQUE(workspace_id, remote_kind)
|
||||
);
|
||||
```
|
||||
|
||||
Convex 完全替换后，`remote_kind='convex'` 只作为历史迁移状态，不作为默认同步目标。
|
||||
|
||||
### 5.9 ai_policies
|
||||
|
||||
```sql
|
||||
CREATE TABLE ai_policies (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_id TEXT REFERENCES users(id) ON DELETE CASCADE,
|
||||
workspace_id TEXT REFERENCES workspaces(id) ON DELETE CASCADE,
|
||||
allowed_roots_json TEXT NOT NULL DEFAULT '[]',
|
||||
model_policy_json TEXT NOT NULL DEFAULT '{}',
|
||||
quota_json TEXT NOT NULL DEFAULT '{}',
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
revision INTEGER NOT NULL DEFAULT 1
|
||||
);
|
||||
```
|
||||
|
||||
AI allowed roots 由 `directory_grants` 与 `ai_policies` 交集计算，不能只靠前端传入。
|
||||
|
||||
### 5.10 audit_log
|
||||
|
||||
```sql
|
||||
CREATE TABLE audit_log (
|
||||
id TEXT PRIMARY KEY,
|
||||
actor_user_id TEXT REFERENCES users(id),
|
||||
action TEXT NOT NULL,
|
||||
target_kind TEXT NOT NULL,
|
||||
target_id TEXT,
|
||||
metadata_json TEXT NOT NULL DEFAULT '{}',
|
||||
created_at TEXT NOT NULL
|
||||
);
|
||||
|
||||
CREATE INDEX idx_audit_actor ON audit_log(actor_user_id, created_at);
|
||||
CREATE INDEX idx_audit_target ON audit_log(target_kind, target_id, created_at);
|
||||
```
|
||||
|
||||
必须记录：
|
||||
|
||||
- 注册 / 登录 / 退出。
|
||||
- 管理员新增 / 删除授权。
|
||||
- 分享链接创建 / 撤销。
|
||||
- AI allowed roots 计算失败或越权拒绝。
|
||||
- 迁移导入和 Convex 下线操作。
|
||||
|
||||
### 5.11 outbox_events
|
||||
|
||||
```sql
|
||||
CREATE TABLE outbox_events (
|
||||
id TEXT PRIMARY KEY,
|
||||
topic TEXT NOT NULL,
|
||||
event_type TEXT NOT NULL,
|
||||
payload_json TEXT NOT NULL,
|
||||
created_at TEXT NOT NULL,
|
||||
delivered_at TEXT,
|
||||
attempts INTEGER NOT NULL DEFAULT 0
|
||||
);
|
||||
|
||||
CREATE INDEX idx_outbox_pending ON outbox_events(delivered_at, created_at);
|
||||
```
|
||||
|
||||
用于驱动：
|
||||
|
||||
- `/api/realtime/ws` 控制面事件。
|
||||
- share / membership UI 刷新。
|
||||
- 后续 sync worker。
|
||||
|
||||
### 5.12 legacy_id_map
|
||||
|
||||
```sql
|
||||
CREATE TABLE legacy_id_map (
|
||||
id TEXT PRIMARY KEY,
|
||||
legacy_system TEXT NOT NULL,
|
||||
legacy_kind TEXT NOT NULL,
|
||||
legacy_id TEXT NOT NULL,
|
||||
new_kind TEXT NOT NULL,
|
||||
new_id TEXT NOT NULL,
|
||||
metadata_json TEXT NOT NULL DEFAULT '{}',
|
||||
created_at TEXT NOT NULL,
|
||||
UNIQUE(legacy_system, legacy_kind, legacy_id)
|
||||
);
|
||||
```
|
||||
|
||||
用于从 Convex user/workspace/document/share/session 等历史 id 映射到新控制面 id。
|
||||
|
||||
---
|
||||
|
||||
## 6. API 与 route 切换设计
|
||||
|
||||
### 6.1 Auth
|
||||
|
||||
现状问题：
|
||||
|
||||
- 登录 / 注册路径仍有 Convex auth 依赖。
|
||||
- session response 可从 cookie/JWT 提取 actor name/email。
|
||||
- 新用户默认 workspace 名称仍可能 fallback 到 `DEV_USER_NAME`。
|
||||
|
||||
目标：
|
||||
|
||||
- `/api/auth/signup`：创建 `users`、`auth_identities`、默认 `workspaces`、`workspace_members(owner)`、`directory_grants(owner write)`、`auth_sessions`。
|
||||
- `/api/auth/signin`：按 email 或 username 查 identity，验证密码，创建 session。
|
||||
- `/api/auth/signout`：撤销 session，清 cookie。
|
||||
- `/api/session`：从 SQLite session 查真实用户，不再依赖 Convex JWT。
|
||||
|
||||
兼容：
|
||||
|
||||
- 迁移期可以继续读取旧 cookies 显示用户，但一旦 SQLite session 可用，应以 SQLite 为准。
|
||||
|
||||
### 6.2 Workspace 与目录授权
|
||||
|
||||
目标：
|
||||
|
||||
- `ensure_default_workspace_manifest` 之前先确保 SQLite 默认 workspace 记录存在。
|
||||
- local-folder read/write access 不再以 `access-policy.json` 为主，而是查 `directory_grants` + workspace owner/member。
|
||||
- `access-policy.json` 只在迁移工具中读取，用于生成 `directory_grants`。
|
||||
|
||||
管理员 API：
|
||||
|
||||
- `GET /api/admin/access-policy` 改读 SQLite。
|
||||
- `POST /api/admin/access-policy/validate-root` 保持 Rust 文件系统校验。
|
||||
- `POST /api/admin/access-policy/grants` 写 SQLite + audit + outbox。
|
||||
- `DELETE /api/admin/access-policy/grants/{grantId}` 写 SQLite + audit + outbox。
|
||||
|
||||
普通用户 API：
|
||||
|
||||
- `/user/access-policy` 只看自己可见 share / grants，不可提升权限。
|
||||
|
||||
### 6.3 Share
|
||||
|
||||
目标：
|
||||
|
||||
- 分享不再是“本地目录能不能访问”的隐式效果，而是显式 `share_links` / `directory_grants`。
|
||||
- share token 解析后生成受限 read grant 或 request-scoped access，不直接给全 workspace 写权限。
|
||||
|
||||
第一阶段最小分享：
|
||||
|
||||
- 创建 workspace/page/resource read link。
|
||||
- 撤销 link。
|
||||
- 通过 token 打开只读资源。
|
||||
|
||||
写分享、邀请、协作编辑后续建立在同一 schema 上扩展。
|
||||
|
||||
### 6.4 Realtime
|
||||
|
||||
当前 `/api/realtime/ws` 已不再需要 Convex idle polling。SQLite 控制面事件应复用现有 broadcast 机制：
|
||||
|
||||
```text
|
||||
SQLite transaction writes outbox_events
|
||||
-> outbox dispatcher reads pending event
|
||||
-> AppState broadcast channel send
|
||||
-> WS clients receive control-plane delta
|
||||
```
|
||||
|
||||
事件类型初期：
|
||||
|
||||
- `control.user.updated`
|
||||
- `control.workspace.updated`
|
||||
- `control.grant.created`
|
||||
- `control.grant.revoked`
|
||||
- `control.share.created`
|
||||
- `control.share.revoked`
|
||||
- `control.ai_policy.updated`
|
||||
|
||||
树 / 页面文件变更事件仍由 Rust tree live cache 和 local folder watcher 负责，不通过 Convex。
|
||||
|
||||
---
|
||||
|
||||
## 7. 迁移阶段
|
||||
|
||||
### Phase 0：设计落盘与任务拆分
|
||||
|
||||
- [x] 写入本设计稿。
|
||||
- [x] 拆分 Reasonix 并行任务。
|
||||
- [x] Codex 复核 Reasonix 输出后合入。
|
||||
|
||||
### Phase 1：SQLite store 骨架，不接运行时
|
||||
|
||||
目标：引入 `control-plane` crate 或 `mnote-web/src/control_plane` 模块，完成 schema、migration、store trait 和单测。
|
||||
|
||||
验收：
|
||||
|
||||
- [x] 可在临时目录创建 SQLite DB。
|
||||
- [x] migration 可重复执行。
|
||||
- [x] users/auth/workspaces/grants/share/outbox 基础 CRUD 单测通过。
|
||||
- [x] 不改现有运行时行为。
|
||||
- [x] 当前已完成：users/auth_sessions/workspaces/directory_grants/share_links/outbox 最小 CRUD 与单测；share 运行时接入仍在 Phase 4。
|
||||
|
||||
### Phase 2：Auth/session 切到 SQLite
|
||||
|
||||
目标：注册、登录、session、退出登录先走 SQLite。
|
||||
|
||||
验收：
|
||||
|
||||
- [x] 新注册用户默认写入 `users`。
|
||||
- [x] 新用户默认 workspace 与 owner grant 创建。
|
||||
- [x] `/api/session` 返回真实 name/email/id。
|
||||
- [x] 登录无需 Convex backend。
|
||||
- [x] 老 cookie / dev fallback 不再污染真实登录用户的 workspace 名称。
|
||||
- [x] 当前已完成：`/api/auth/session` 已支持 `mnote_session` cookie 优先从 SQLite session 解析真实用户；`/api/auth` 已接入 SQLite signUp/signIn/signOut，注册会写入 `users`、password identity、默认 workspace/owner grant 和 session cookie。mnote-web session route 定向测试已复跑确认。
|
||||
|
||||
### Phase 3：Access policy 切到 SQLite
|
||||
|
||||
目标：local folder read/write、管理员授权 UI/API、用户授权页都走 SQLite。
|
||||
|
||||
验收：
|
||||
|
||||
- [x] shujuan 这类新用户默认拥有个人空间写权限。
|
||||
- [x] 非管理员不能读写未授权目录。
|
||||
- [x] read grant 不允许 page write/tree mutation/asset upload。
|
||||
- [x] write grant 可创建页面。
|
||||
- [ ] 管理员新增/删除 grant 后 WS 推送控制面事件。
|
||||
|
||||
### Phase 4：Share / AI policy / sync state / AI runtime 切到 SQLite
|
||||
|
||||
目标：分享链接、AI policy、sync 状态、审计日志、Hermes/ACP runtime session 不再依赖 Convex 默认运行时。
|
||||
|
||||
验收：
|
||||
|
||||
- [x] 创建 / 撤销分享链接写入 SQLite。
|
||||
- [x] AI policy 可按用户 / workspace 写入并优先解析 workspace policy。
|
||||
- [x] sync_state 可被本地 worker 更新。
|
||||
- [x] audit_log 记录关键控制面操作。
|
||||
- [x] Hermes/ACP runtime run、event、session list/detail/search/resume、rename、auto-title、delete 默认读写 SQLite；旧 Convex store 仅通过显式 `legacyConvex=1` 进入。
|
||||
|
||||
### Phase 5：Convex shadow 验证与下线
|
||||
|
||||
目标：所有默认运行路径不访问 Convex。Convex 仅作为迁移导出源或手工回滚源。
|
||||
|
||||
验收：
|
||||
|
||||
- [x] 默认 Rust route / unit smoke 在未配置 Convex backend 时通过，覆盖 local-first session、授权管理、分享基础链路与 ACP runtime store。
|
||||
- [x] `npm run check:local-first-convex-guard` 更新为禁止新增 Convex 控制面代码。
|
||||
- [x] 本设计稿口径更新：Convex 退役为历史迁移源 / 显式 legacy 兼容入口。
|
||||
- [x] Docker / infra 层不在本稿执行中删除数据卷；Convex 真实停服切换只允许在迁移报告确认后执行。
|
||||
|
||||
---
|
||||
|
||||
## 9. 执行记录（2026-05-22）
|
||||
|
||||
### 已完成验证
|
||||
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture`
|
||||
- 20/20 通过。
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web session -- --nocapture`
|
||||
- 46/46 通过。
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web hermes_client_acp -- --nocapture`
|
||||
- 10/10 通过，确认 ACP runtime 默认 SQLite；旧 Convex store 仅由 `legacyConvex=1` 兼容测试覆盖。
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web local_access_policy -- --nocapture`
|
||||
- 2/2 通过，确认管理员授权写入、列表、撤销已切到 SQLite directory grants。
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web share_link -- --nocapture`
|
||||
- 1/1 通过，确认公开分享链接创建、列表、撤销已写入 SQLite。
|
||||
- `node scripts/migrate-control-plane-to-sqlite.js --dry-run --out /tmp/mnote-control-plane-migration-report.json`
|
||||
- 通过。
|
||||
- `npm run check:local-first-convex-guard`
|
||||
- 通过。
|
||||
- `cargo fmt --manifest-path rust/Cargo.toml --all --check`
|
||||
- 通过。
|
||||
|
||||
### 当前实现状态
|
||||
|
||||
- `control-plane` crate 已落地，覆盖 users / auth_identities / auth_sessions / workspaces / workspace_members / directory_grants / sync_state / ai_policies / audit_log / outbox_events / legacy_id_map 的 v1 schema。
|
||||
- `mnote-web` 已接入 SQLite session 读取与默认 workspace / owner grant 创建。
|
||||
- `mnote-web` 的 local folder 读写与管理员授权 API 已优先走 SQLite directory grants，旧 JSON policy 仅保留为迁移 fallback。
|
||||
- 授权管理 UI 已切到弹窗，不再挤掉左侧页面。
|
||||
- 分享链接、AI policy、sync_state、audit_log、outbox、ACP runtime run/event/session 管理已经有 SQLite store 与定向测试覆盖。
|
||||
- Convex 运行时控制面入口不再作为默认路径；保留 `legacyConvex=1` / `convex=1`、迁移 dry-run 与历史 transport 作为显式兼容边界。
|
||||
|
||||
### 后续跟踪项
|
||||
|
||||
- 密码哈希仍是明确标记的 `sha256-v1` 占位实现，需要后续升级 Argon2id 并写迁移策略。
|
||||
- 真实 Docker Compose 停服切换和 Convex 数据卷保留 / 归档属于运维执行，不在本稿自动执行。
|
||||
- 旧 Convex transport 与 `legacyConvex=1` 兼容入口保留给历史会话读取和人工回滚；新增默认路径不得再依赖它。
|
||||
|
||||
---
|
||||
|
||||
## 8. 数据迁移设计
|
||||
|
||||
迁移输入：
|
||||
|
||||
- `/mnt/Data1T/Mnote_data/control-plane/access-policy.json`
|
||||
- 当前本地 workspace `.mnote/workspace.json`
|
||||
- Convex 导出的 users/workspaces/share/session/aiSessions 数据（如果存在）
|
||||
- `.env.all` 中的历史 dev/admin 配置，仅作为管理员 bootstrap 输入
|
||||
|
||||
迁移输出：
|
||||
|
||||
- `control-plane.db`
|
||||
- `legacy_id_map`
|
||||
- `audit_log` 中的 migration 记录
|
||||
- `migration-report.json`
|
||||
|
||||
迁移规则：
|
||||
|
||||
1. 先创建 admin users。
|
||||
2. 再导入真实注册 users。
|
||||
3. 对每个用户确保默认 workspace。
|
||||
4. 读取 `.mnote/workspace.json` 建立 workspace 记录和 owner membership。
|
||||
5. 读取 `access-policy.json` 导入 directory grants。
|
||||
6. 读取 Convex share/membership/sync 数据导入对应表。
|
||||
7. 对旧 id 写 `legacy_id_map`。
|
||||
8. 生成报告：导入数量、跳过数量、冲突、不可迁移数据。
|
||||
|
||||
冲突处理：
|
||||
|
||||
- email 冲突：保留最早创建用户，其他写 report，需人工合并。
|
||||
- username 冲突：后导入用户追加短后缀，并写 audit。
|
||||
- root_uri 冲突：同一 root 只能有一个 workspace owner，其他访问者转为 membership/grant。
|
||||
- grant 冲突：同 user/root 取权限较高者，保留 capability 并集。
|
||||
|
||||
回滚：
|
||||
|
||||
- SQLite 迁移前复制原 DB 或写入新 DB 文件，未通过验证不替换 active DB。
|
||||
- Convex 下线前不删除 Convex 数据卷，只停止默认启动。
|
||||
- 每个迁移批次写 `migration_id`，便于 audit 和报告定位。
|
||||
|
||||
---
|
||||
|
||||
## 9. Reasonix 并行执行 checklist
|
||||
|
||||
### Worker A：SQLite schema/store 骨架
|
||||
|
||||
Ownership：
|
||||
|
||||
- `rust/crates/control-plane/**` 或 `rust/crates/mnote-web/src/control_plane/**`
|
||||
- `rust/Cargo.toml`
|
||||
- `rust/crates/mnote-web/Cargo.toml`（如选择内嵌模块则尽量不改）
|
||||
|
||||
任务：
|
||||
|
||||
- [x] 新增 ControlPlaneStore trait、models、SQLiteStore。
|
||||
- [x] 新增 migrations v1。
|
||||
- [x] 实现 users/auth_sessions/workspaces/directory_grants/outbox 最小 CRUD。
|
||||
- [x] 补 migration 和 CRUD 单测。
|
||||
|
||||
禁止：
|
||||
|
||||
- 不修改 auth route 和 gateway 行为。
|
||||
- 不删除 Convex transport。
|
||||
- 不改现有 local folder access 行为。
|
||||
|
||||
验收：
|
||||
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 或对应 `mnote-web control_plane` 测试。
|
||||
- `cargo fmt --check --all`。
|
||||
|
||||
### Worker B：Auth/session SQLite 切换准备
|
||||
|
||||
Ownership：
|
||||
|
||||
- `rust/crates/mnote-web/src/routes/session.rs`
|
||||
- `rust/crates/mnote-web/src/ssr/pages/auth.rs`
|
||||
- 可新增 `rust/crates/mnote-web/src/routes/auth_sqlite.rs`
|
||||
- 只读参考 `gateway.rs`，不得覆盖已有未提交改动。
|
||||
|
||||
任务：
|
||||
|
||||
- [x] 梳理现有 signIn/signUp/session cookie 链。
|
||||
- [x] 在不破坏现有行为前提下，设计并实现 SQLite session route adapter。
|
||||
- [ ] 新用户注册后应生成真实 display name/email/session response。
|
||||
- [ ] 补 `/api/session` 与注册/登录单测。
|
||||
|
||||
禁止：
|
||||
|
||||
- 不直接删除 Convex auth fallback。
|
||||
- 不改 local folder access policy 文件。
|
||||
- 不碰 `ssr/styles.rs`。
|
||||
|
||||
验收：
|
||||
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web session -- --nocapture`
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web auth -- --nocapture`
|
||||
|
||||
### Worker C：Access policy SQLite adapter
|
||||
|
||||
Ownership：
|
||||
|
||||
- `rust/crates/mnote-web/src/routes/local_folder_source.rs`
|
||||
- 可新增 `rust/crates/mnote-web/src/local_access_sqlite.rs`
|
||||
- 可新增 focused tests。
|
||||
|
||||
任务：
|
||||
|
||||
- [ ] 把 access policy 读写抽象成 trait/adapter，保留 JSON fallback。
|
||||
- [ ] 设计 SQLite grant 到 `ensure_local_workspace_read_access` / write access 的接入点。
|
||||
- [ ] 实现默认 workspace owner grant 的测试。
|
||||
- [ ] 覆盖 read grant 禁写、write grant 可写、未授权拒绝。
|
||||
|
||||
禁止：
|
||||
|
||||
- 不重写 tree command。
|
||||
- 不改 UI 页面。
|
||||
- 不删除 `access-policy.json` 支持。
|
||||
|
||||
验收：
|
||||
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web local_access_policy -- --nocapture`
|
||||
- `cargo test --manifest-path rust/Cargo.toml -p mnote-web local_workspace_access -- --nocapture`
|
||||
|
||||
### Worker D：迁移工具与 Convex 下线计划
|
||||
|
||||
Ownership：
|
||||
|
||||
- `scripts/migrate-control-plane-to-sqlite.js` 或 Rust CLI 等价脚本
|
||||
- `scripts/check-local-first-convex-guard.js`
|
||||
- `design/02-convex-rust-long-term-architecture/process/2-8-*` 只能追加执行记录，不改设计结论。
|
||||
|
||||
任务：
|
||||
|
||||
- [ ] 设计并实现迁移 dry-run 工具，读取 `access-policy.json` 与 workspace manifests。
|
||||
- [ ] 输出 `migration-report.json`。
|
||||
- [x] 增加 guard 检查：新增 Convex 控制面代码必须失败或标注迁移例外，根 `convex/` functions 回流默认控制面也必须失败。
|
||||
- [ ] 给出 Convex compose 下线 checklist。
|
||||
|
||||
禁止：
|
||||
|
||||
- 不执行真实破坏性迁移。
|
||||
- 不删除 Docker volume。
|
||||
- 不修改 `.env.all`。
|
||||
|
||||
验收：
|
||||
|
||||
- `node scripts/migrate-control-plane-to-sqlite.js --dry-run --out /tmp/mnote-control-plane-migration-report.json`
|
||||
- `npm run check:local-first-convex-guard`
|
||||
|
||||
---
|
||||
|
||||
## 10. 总体验收矩阵
|
||||
|
||||
完全切换前必须满足：
|
||||
|
||||
- [x] Convex backend 停止时，新用户可注册、登录、看到自己的个人空间。
|
||||
- [x] 新用户默认可在个人空间创建页面。
|
||||
- [x] 管理员可新增 / 删除目录授权。
|
||||
- [x] 普通用户不能访问未授权目录。
|
||||
- [x] read share 不能写，write grant 可以写。
|
||||
- [x] `/api/session` 不依赖 Convex JWT。
|
||||
- [x] `/api/realtime/ws` 能收到控制面事件。
|
||||
- [x] AI allowed roots 不扩大到未授权目录。
|
||||
- [x] `NEXT_PUBLIC_CONVEX_URL=http://127.0.0.1:9` 时 local-first 主路径 smoke 通过。
|
||||
- [x] `infra/convex` 不再被 `npm run desktop:hot` 或默认启动链路要求。
|
||||
- [x] 根 `convex/` functions 源码已软删除到 `recycle/20260522-convex-runtime-retirement/convex/`，`scripts/run-convex-deploy.js` 已随之归档。
|
||||
- [x] `package.json` / npm lock / pnpm lock 已移除只服务根 Convex functions 的 `@auth/core`、`@convex-dev/auth`、`convex` 依赖。
|
||||
- [x] 文档更新，明确 Convex 只作为历史迁移源或显式 legacy 兼容入口。
|
||||
|
||||
---
|
||||
|
||||
## 11. 风险与裁决
|
||||
|
||||
| 风险 | 裁决 |
|
||||
|---|---|
|
||||
| SQLite auth 自研带来安全责任 | 使用 Argon2id、token hash、session expiry、audit；不明文保存 token。 |
|
||||
| 迁移期间双写不一致 | 以 SQLite 为新主，Convex 只读导出；影子写仅用于比对，不作为裁决源。 |
|
||||
| 权限逻辑分散 | 所有 read/write/AI allowed roots 都经 control-plane store + local path canonicalization。 |
|
||||
| 多 worker 改同一文件冲突 | Reasonix 任务按 ownership 拆分，共享文件只允许建议或最小 adapter。 |
|
||||
| 一次性切流风险高 | 按 auth、access、share/AI、downline 分阶段切；每阶段保留独立 smoke。 |
|
||||
|
||||
---
|
||||
|
||||
## 12. 本轮执行记录
|
||||
|
||||
- 2026-05-22：Codex 写入本设计稿并拆分 Reasonix Worker A-D 任务书。
|
||||
- 2026-05-22：Worker D（迁移工具与 Convex 下线 guard）完成：
|
||||
- 新增 `scripts/migrate-control-plane-to-sqlite.js`：dry-run 迁移工具，支持 `--dry-run --out`、`--access-policy-path`、`--users-root`、`--skip-users`、`--from-snapshot`、`--verbose`。读取 access-policy.json 与所有用户 workspace.json，生成 users/workspaces/grants/legacy_id_map 建议，不写 DB。
|
||||
- 修改 `scripts/check-local-first-convex-guard.js`：新增 `MIGRATION_PERIOD_FORBIDDEN` 规则（users/workspaces/grants/share/sync/audit/outbox/ai_policies/legacy_id_map），新增 `MIGRATION_PERIOD_WAIVER = "sqlite-migration-waiver"`，新增 `isMigrationWaived` 辅助函数，更新 self-test 覆盖迁移期拦截。Shell 解释器问题导致 node 直接调用的验收命令未在 session 内完成，但通过 sandbox run_background 验证 dry-run 报告完整生成 , guard self-test 通过。
|
||||
- 2026-05-22：Codex 接管并完成 Phase 1 / Phase 2 session adapter 第一段：
|
||||
- 新增 `rust/crates/control-plane/` 并接入 Rust workspace 与 `mnote-web`，默认 DB 路径为 `/mnt/Data1T/Mnote_data/control-plane/control-plane.db`，支持 `MNOTE_CONTROL_PLANE_DB_PATH` 覆盖。
|
||||
- 实现 `users`、`auth_sessions`、`workspaces`、`workspace_members`、`directory_grants`、`outbox_events` 最小 store API；`ensure_default_workspace` 会为新用户生成个人空间和 owner write grant。
|
||||
- `/api/auth/session` 支持 `mnote_session` cookie 优先查 SQLite session，命中后返回真实 `userId/email/name/authMode=sqliteSession`，未命中时保留 forwarded actor / dev fallback。
|
||||
- 验证：`cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 8 passed；`cargo check --manifest-path rust/Cargo.toml -p mnote-web --lib` passed；迁移 dry-run 与 Convex guard self-test passed；`rustfmt --edition 2021 --check` 和本轮 `git diff --check` passed。`mnote-web` route 定向单测因测试制品链接阶段超过 180s 未完成，需后续在释放 cargo watch 或独立 target dir 后复跑。
|
||||
- 2026-05-22：Codex 继续推进 Phase 2 Auth/session SQLite 切换：
|
||||
- `control-plane` 增加 password identity 与 `authenticate_password`，支持 email/username 登录、错误密码拒绝，并创建 SQLite auth session；当前密码哈希为明确标记的 `sha256-v1` 占位实现，后续需升级 Argon2id。
|
||||
- `gateway::auth_api` 不再代理 Convex Auth：`signUp` 创建/更新用户、password identity、默认 workspace/owner grant 和 `mnote_session`；`signIn` 直接查 SQLite；`signOut` 撤销并清理 `mnote_session` 与旧 Convex cookies。
|
||||
- `/auth` 的已登录判断加入 `mnote_session` cookie，避免 SQLite 登录后仍停留在登录页。
|
||||
- 验证：`cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 12 passed；迁移 dry-run、Convex guard self-test、`rustfmt --edition 2021 --check`、本轮 `git diff --check` passed。`timeout 240s cargo check --manifest-path rust/Cargo.toml -p mnote-web --lib` 仍卡在 `rustc --crate-name mnote_web` 阶段并超时，未得到通过结论。
|
||||
- 2026-05-22：Codex 修复 SQLite session 在页面壳中的真实 actor 解析，并收口授权管理弹窗验证：
|
||||
- `gateway` 新增 `current_actor_id` / `current_actor_type` / `current_actor_display_name` / `default_workspace_name_for_context`，根入口、授权管理入口、文档页 shell、mindmap shell 均优先使用 SQLite `mnote_session` 对应的真实用户信息生成个人空间名。
|
||||
- 修复仅携带 `mnote_session` 时根入口仍按 anonymous 处理的问题；新注册用户进入 local-first landing 时会创建并显示自己的个人空间，例如 `shujuan 的空间`，不再 fallback 到 `开发用户 的空间`。
|
||||
- 授权管理 UI 保持弹窗模式，普通用户和管理员都使用同一个最小“文件夹地址 + 授权用户 ID + read/write”表单；管理员可授权任意本地文件夹，普通用户只能授权自己空间下的文件夹；读/写权限继续由 `directory_grants.permission` / share grant permission 保留。
|
||||
- 验证：`cargo test --manifest-path rust/Cargo.toml -p mnote-web root_entry_uses_sqlite_session_display_name_for_workspace_label -- --nocapture` passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web session -- --nocapture` 46 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web access_policy -- --nocapture` 7 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web share_grant -- --nocapture` 4 passed；`cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 15 passed。
|
||||
- 2026-05-22：Codex 继续收口 Phase 3 授权管理运行时：
|
||||
- 授权管理弹窗脚本从旧 `/api/*/share-grants` 切到 SQLite 目录授权 `/api/*/access-policy`；`share-grants` 仅保留给公开分享兼容链路，避免文件夹授权与公开分享混用。
|
||||
- 新增普通用户目录授权 API：`GET /api/user/access-policy`、`POST /api/user/access-policy/grants`、`DELETE /api/user/access-policy/grants/{grant_id}`。普通用户可以把自己空间下的文件夹授权给目标用户；目标用户获得 `directory_grants.permission=read|write` 对应能力；普通用户只能撤销自己创建的目录授权。
|
||||
- 修复首页隐藏授权模板自动初始化问题：普通用户首页不再预加载 `/api/admin/access-policy` 或旧 `/api/admin/share-grants`，只有打开弹窗或访问独立授权页时才读取授权列表。
|
||||
- 授权弹窗中的“授权记录”显示 SQLite `control-plane.db` 路径，不再显示旧 `share-grants.json`。
|
||||
- 验证：`cargo test --manifest-path rust/Cargo.toml -p mnote-web access_policy -- --nocapture` 8 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web share_grant -- --nocapture` 4 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web root_entry_renders_access_policy_dialog_templates_for_all_actors -- --nocapture` passed；`cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 15 passed；`cargo fmt --manifest-path rust/Cargo.toml --all --check` passed；`npm run check:local-first-convex-guard` passed；`git diff --check` passed。浏览器临时实例 `127.0.0.1:3010` 验证：首页初始不请求授权接口；打开账号菜单的“授权管理”后 URL 保持 `/`、左侧“我的页面 / Explorer / +”仍保留、弹窗请求 `/api/user/access-policy` 200、当前控制台 0 error。
|
||||
- 2026-05-22：Codex 推进 Phase 4 公开分享链接第一段：
|
||||
- 新增 SQLite share links 运行时 API：`GET /api/admin/share-links?workspaceId=...`、`POST /api/admin/share-links`、`DELETE /api/admin/share-links/{link_id}`，直接调用 `control-plane` 的 `create_share_link` / `list_share_links` / `revoke_share_link`。
|
||||
- API 响应只在创建时返回明文 `token`，列表和 link payload 不暴露 `token_hash`；撤销后 `resolve_share_link(token_hash)` 不再命中。
|
||||
- 分享链接创建 / 撤销写入 `audit_log` 的 `control.share.created` / `control.share.revoked`。旧 `/api/*/share-grants` 仍作为目标用户共享授权、shared-cache/sync 和 Hermes 共享上下文兼容链路保留，尚未切到 `share_links`。
|
||||
- 验证：先运行 `cargo test --manifest-path rust/Cargo.toml -p mnote-web share_link_api_creates_lists_and_revokes_sqlite_record -- --nocapture` 得到缺失 handler/type 的 RED 编译失败；实现后同命令 1 passed。随后 `cargo test --manifest-path rust/Cargo.toml -p control-plane share_link -- --nocapture` 1 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web share_grant -- --nocapture` 4 passed。
|
||||
- 2026-05-22：Codex 收口 Phase 4 / Phase 5 默认运行时：
|
||||
- `control-plane` 新增 `002-ai-runtime-store.sql`，落地 `ai_runtime_runs` / `ai_runtime_events`，并补齐 `upsert/list/append` 与 session `rename/auto-title/delete` store API。
|
||||
- `mnote-web` 的 ACP runtime session list/detail/search/resume、run/event persistence、rename、auto-title、delete 默认读写 SQLite；旧 Convex ACP runtime store 只在显式 `legacyConvex=1` 或 `convex=1` 时使用。
|
||||
- local folder 授权与 share link 创建 / 撤销已写入 outbox 并广播 `stream_delta_tx` 控制面事件，覆盖 `control.grant.created/revoked` 与 `control.share.created/revoked`。
|
||||
- 验证：`cargo test --manifest-path rust/Cargo.toml -p control-plane -- --nocapture` 20 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web hermes_client_acp -- --nocapture` 10 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web session -- --nocapture` 46 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web local_access_policy -- --nocapture` 2 passed；`cargo test --manifest-path rust/Cargo.toml -p mnote-web share_link -- --nocapture` 1 passed；迁移 dry-run 与 `npm run check:local-first-convex-guard` passed；`cargo fmt --manifest-path rust/Cargo.toml --all` 已执行。
|
||||
- 2026-05-22：Codex 追加完成 Convex runtime functions 源码退役清理：
|
||||
- 根 `convex/` 已按软删除规则移动到 `recycle/20260522-convex-runtime-retirement/convex/`，只作为历史审计 / 迁移对照素材。
|
||||
- `scripts/run-convex-deploy.js` 已移动到 `recycle/20260522-convex-runtime-retirement/scripts/run-convex-deploy.js`；默认仓库不再提供根 Convex functions deploy 入口。
|
||||
- `package.json`、`package-lock.json`、`pnpm-lock.yaml` 已移除只服务根 Convex functions 的 `@auth/core`、`@convex-dev/auth`、`convex` 依赖。
|
||||
- `npm run desktop:hot` 与 `npm run dev:hot` 均已确认只启动 Rust `mnote-web` hot 链路，不启动 Convex；`infra/convex` 仍保留为显式 cloud / compat / sync replica 服务基础设施。
|
||||
- `gateway.rs` 已移除旧 Convex Auth action proxy / username lookup / auth response cookie helper，默认 `/api/auth` 只走 SQLite session。
|
||||
- `scripts/check-local-first-convex-guard.js` 更新为拦截重新新增根 `convex/schema.ts`、`auth.ts`、`users.ts`、`aiSessions.ts`，防止退役 functions 源码回流默认控制面。
|
||||
@@ -40,7 +40,7 @@
|
||||
不同 `WorkspaceSource` 使用不同 substrate：
|
||||
|
||||
- `local_folder`：本地文件系统、watcher、rescan、命令执行结果。
|
||||
- `convex_workspace`：Convex 持久化、mutation / query、实时订阅、对象存储协作。
|
||||
- `convex_workspace`：显式 cloud / compat source 的 Convex 持久化、mutation / query、实时订阅、对象存储协作。
|
||||
|
||||
Convex 在这里是可选云端 / 协作 source 的 substrate，而不是所有工作区的默认 substrate：
|
||||
|
||||
@@ -281,7 +281,7 @@ Rust Web 负责：
|
||||
- [x] WS handler 用 `tokio::select!` 订阅 `stream_delta_tx` broadcast channel，mutation 后推送 delta 给所有客户端。
|
||||
- [x] 2026-05-17 commit `57ec8322`：SSE pollMs=1000 polling 替换为 WebSocket push + SSE fallback。Convex idle 查询从 17/min 降至 0/min。
|
||||
- [x] legacy React 侧已有 `useSidebarTreeStream` 与 `EventSource` consumer，并有协议 / delta 单测（SSE fallback 仍在用）。
|
||||
- [x] 当前 `3000` Rust shell 已直接挂载 tree live WebSocket consumer（默认 transport `convex-command-log-ws`），并通过 SSE fallback 的 `data-mnote-tree-live-applied` 应用 delta / resync。
|
||||
- [x] 当前 `3000` Rust shell 已直接挂载 tree live WebSocket consumer；旧 `convex-command-log-ws` 命名只代表历史 transport 标签，默认 live cache 不再要求 Convex backend，并通过 SSE fallback 的 `data-mnote-tree-live-applied` 应用 delta / resync。
|
||||
- [x] `task112` / `task120` / `task123` 已覆盖 `/api/tree/events` snapshot、delta / resync 与 stream owner 可用性。
|
||||
- [x] `task165` 已验证双 pane 不重复建立第二条 tree live stream。
|
||||
- [x] 2026-05-16 复核确认 workspace snapshot 同时携带 `data.dataset.kernel_sidebar_projection` 与 `data.dataset.kernel_file_tree_projection`，`task123` 已断言临时页 `doc:<documentId>` file tree row 出现在 `/api/tree/events` snapshot 中。
|
||||
|
||||
@@ -29,7 +29,7 @@
|
||||
- `3000` 保持唯一公开入口，不新增长期公开端口。
|
||||
- `mnote-web` 成为主 gateway、主 SSR shell、主 API transport、主 realtime transport 的 owner。
|
||||
- Next App Router 只能保留为内部 compat，负责尚未迁完的 legacy 页面或 React island bundle，不再新增长期业务语义。
|
||||
- Convex 保留为 storage / realtime substrate，不因为主 Web Rust 化而先拆。
|
||||
- Convex 保留为历史迁移源、显式 cloud source / compat / sync replica 边界；主 Web Rust 化后默认 storage / realtime / control-plane 不再依赖 Convex。
|
||||
- 页面、树、搜索、AI、Mindmap 的事实源继续向 Rust kernel / Page Aggregate / projection contract 收口。
|
||||
- `BlockNote` 保留为 fallback / 对照链，不作为主执行面迁移的阻塞项。
|
||||
|
||||
|
||||
@@ -299,7 +299,7 @@
|
||||
|
||||
> 2026-05-14 口径更新：
|
||||
> - 本阶段原先把页面 AI 继续收口为 `mnote-cli host / client`，现在已被 `design/07-ai/done/7-3-page-ai-hermes-panel-and-mnote-plugin-v1.md` 覆盖。
|
||||
> - 新长期方向是：页面 AI 面板使用 Leptos 实现 Hermes 页面内客户端；Hermes session/message/tool event/usage/model 是 AI 会话真相；mnote 只通过 Hermes skill/plugin 暴露页面、树、artifact、edge 等业务能力。
|
||||
> - 新长期方向是：页面 AI 面板使用 Leptos 实现 ACP/Hermes 页面内客户端；产品层运行态索引、权限和审计默认落 SQLite control-plane；mnote 通过 Hermes skill/plugin 暴露页面、树、artifact、edge 等业务能力。Hermes/Reasonix runtime 的内部 session/message/tool event/usage/model 不等同于 MNote 产品层会话真相。
|
||||
> - `mnote-cli` 只能作为 plugin 内部适配器或调试入口，不能再被写成页面 AI 唯一长期执行面。
|
||||
> - `design/07-ai/done/7-4-page-ai-hermes-panel-execution-checklist-v1.md` 已把页面 AI 主链推进到 Hermes session/run/events，并完成 `mnote.page.get`、正文写入、标题/页面设置、artifact、legacy guard、持久化审计和正式 `3000` smoke 矩阵；本节后续只跟踪 Rust Web 侧长期边界，不再保留旧 `/api/ai-agent/run` 待办作为当前状态。
|
||||
|
||||
|
||||
@@ -421,7 +421,7 @@ Leptos Islands 很适合承接下面这类长期目标：
|
||||
归位：
|
||||
|
||||
- 面板只保留 Hermes chat/session/run/tool event 的页面内子集 UI 与当前页面上下文桥接
|
||||
- Hermes 持有 session / message / usage / model 真相
|
||||
- ACP/Hermes runtime 持有执行层 session / message / usage / model；MNote 产品层运行态索引、权限和审计默认由 SQLite control-plane 持有
|
||||
- mnote 通过 Hermes skill/plugin 暴露页面、树、artifact、edge 工具，最终执行回到 Rust runtime / kernel
|
||||
- 面板按页面需要懒挂载成单独 island
|
||||
|
||||
|
||||
@@ -9,8 +9,8 @@
|
||||
`3000` 继续是唯一浏览器公开入口，但 tree route 不再承载长期树域主语义。
|
||||
|
||||
- Rust runtime 负责 tree command legality、canonical plan、write operation、domain event plan 与稳定 stream delta 语义。
|
||||
- Next route 负责 cookie/auth、Convex client、browser/substrate 能力桥、CommandEnvelope、transport、artifact writer 调用与用户可见回包。
|
||||
- Convex 继续作为 substrate 执行器，不重新生成 tree truth。
|
||||
- Rust `mnote-web` route 负责 session/actor、source-specific client、browser/substrate 能力桥、CommandEnvelope、transport、artifact writer 调用与用户可见回包；本文中的 Next route 是历史 thin-proxy 阶段记录。
|
||||
- Convex 仅在显式 cloud / compat source 下作为 substrate 执行器，不重新生成 tree truth；默认 local-first 路径走 LocalFS + Rust SQLite control-plane。
|
||||
|
||||
## 2. Thin Proxy Route
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
它不重新定义树域协议。已有结论继续成立：
|
||||
|
||||
- `tree-first graph kernel` 是长期对象真相层。
|
||||
- `Convex` 继续作为本地自托管存储、实时、文件协作底座。
|
||||
- Rust SQLite control-plane 承接默认 auth / share / sync / AI policy 控制面，Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
- `mnote-web` 是 Rust Web 主执行面，负责 projection、command、transport 与 realtime stream。
|
||||
- 前端和 tree shell 只消费稳定 projection，并持有本地交互态。
|
||||
|
||||
|
||||
@@ -28,7 +28,7 @@ ConvexWorkspaceSource -> Tree Kernel -> file_tree / page_tree / page_aggregate -
|
||||
|
||||
- `Convex` 不再是所有 workspace 的必经中介。
|
||||
- `Local Folder` 不经过 Convex，直接由 Rust source adapter 读取和写入本地文件系统。
|
||||
- `Convex` 继续作为 cloud workspace 的 source adapter，负责同步、协作、权限、分享和远程资源。
|
||||
- `Convex` 仅作为显式 cloud / compat workspace 的 source adapter 或 sync replica；同步、协作、权限、分享默认控制面已由 Rust SQLite control-plane 承接。
|
||||
- 两者共用同一套 projection、command、preflight、runtime state 和 UI。
|
||||
- 差异只允许出现在 `WorkspaceSource` 的 capability、preflight plan 和 executor 中。
|
||||
|
||||
|
||||
@@ -15,12 +15,12 @@
|
||||
- 使用本轮独立身份或独立 workspace 创建测试页面、子页面、附件、mindmap、table。
|
||||
- 对五类对象执行默认删除，确认进入对应垃圾箱。
|
||||
- 执行页面垃圾箱清空与资源垃圾箱清空。
|
||||
- 查询 Convex，确认本轮 document / media_asset / mindmap / document_table / document_table_rows 不再存在。
|
||||
- 查询当前 source 的持久化状态；历史 Convex source smoke 才确认 document / media_asset / mindmap / document_table / document_table_rows 不再存在。
|
||||
- 记录关联清理边界：Storage、OCR、LightRAG、page references、recent pages、favorites。
|
||||
|
||||
## 推荐方案
|
||||
|
||||
优先使用一次性 Convex Auth 用户：
|
||||
优先使用一次性 SQLite control-plane Auth 用户：
|
||||
|
||||
1. 通过 Rust `/api/auth` 走 password `signUp`，邮箱使用 `mnote.trash.<timestamp>@example.com`。
|
||||
2. 使用同一 browser/request context 打开 `/`，触发 `workspaces.ensureDefaultWorkspace` 创建独立 personal workspace。
|
||||
|
||||
@@ -22,7 +22,7 @@
|
||||
|
||||
- 不在默认测试账号既有 workspace 上执行批量删除。
|
||||
- 不对默认 workspace 执行 `emptyTrashByWorkspace`。
|
||||
- 使用一次性 Convex Auth 用户注册后自动获得的默认 workspace。
|
||||
- 使用一次性 SQLite control-plane Auth 用户注册后自动获得的默认 workspace；旧 Convex Auth 只作为历史 compat 对照。
|
||||
- 清理仅针对本轮创建对象；如清理失败，只记录对象 ID，不扩大删除范围。
|
||||
|
||||
## 3. 建议脚本
|
||||
|
||||
@@ -18,7 +18,7 @@
|
||||
- `tree.resource.restore -> mediaAssets:patchById`
|
||||
- `tree.resource.purge -> mediaAssets:purgeById`
|
||||
- `tree.resource.rename -> mediaAssets:patchById`
|
||||
- `storage-convex-bridge` 为上述命令提供默认 Convex 映射。
|
||||
- `storage-convex-bridge` 为上述命令提供历史 / cloud / compat source 的 Convex 映射；默认 local-first 资源生命周期不再依赖 Convex functions。
|
||||
- `wolai-frontend` 的 `/api/media/batch`：
|
||||
- `delete` 改为 `tree.resource.archive`
|
||||
- `restore` 改为 `tree.resource.restore`
|
||||
|
||||
@@ -54,14 +54,11 @@ pnpm test src/lib/documents/tree-command-client.test.ts src/lib/documents/restor
|
||||
真实浏览器 smoke：
|
||||
|
||||
```bash
|
||||
cd /mnt/Data1T/mnote/wolai-frontend
|
||||
npx convex dev --once --tail-logs disable --env-file ../.env.all --run ping:ping
|
||||
|
||||
cd /mnt/Data1T/mnote
|
||||
node scripts/task429-trash-restore-location-reveal-smoke.js
|
||||
```
|
||||
|
||||
结果：通过。脚本使用一次性用户 / workspace，在 3000 主入口验证：
|
||||
结果：通过。脚本使用一次性用户 / workspace，在 3000 主入口验证；历史记录中曾需手工注册 Convex functions，当前默认 auth/session/control-plane 已切到 SQLite，不再要求先启动 Convex：
|
||||
|
||||
- 删除子页面后通过 `tree.node.restore` 恢复，返回 `restore_location.parent_id` 为原父页面、`sort_order` 为原排序位。
|
||||
- 原排序位已被兄弟页面占用时，兄弟页面被后移，Convex 中不产生重复 `sort_order`。
|
||||
|
||||
@@ -63,15 +63,15 @@
|
||||
1. Next route 构造 `buildDocumentCommandEnvelope`
|
||||
2. `resolveRustBridgeCommandPlan`
|
||||
3. TS runtime 负责 transport dispatch
|
||||
4. Convex mutation 负责实际持久化
|
||||
4. source-specific executor 负责实际持久化；Convex mutation 仅属于历史 / cloud / compat source
|
||||
|
||||
因此当前形态是：
|
||||
|
||||
- `Convex substrate`
|
||||
- `WorkspaceSource substrate`（Convex 仅为历史 / cloud / compat source）
|
||||
- `Rust semantic owner`
|
||||
- `TS runtime transport dispatcher`
|
||||
|
||||
不是“Rust 已经直接替代 Convex 落库”。
|
||||
不是“所有 source 都由同一个前端 route 自行落库”；默认 local-first source 已继续演进为 Rust / LocalFS / SQLite control-plane。
|
||||
|
||||
### 2.3 当前仍留在前端的树语义
|
||||
|
||||
|
||||
@@ -397,11 +397,11 @@ GREEN：
|
||||
- E26 最小真源闭环：2026-05-02 已完成第一段 anchor 切片。`leptos-tiptap` paragraph/heading/blockquote/codeBlock/image/table 的 `blockId` 渲染同时输出 `data-block-id` 与 DOM `id`，浏览器 hash 命中走 `id=:blockId` + CSS `:target`，不是手工给 ProseMirror DOM 写临时 class；Rust runtime 复制链接和 hash 滚动继续只消费 `EditorBlock.block_id` 派生的 `attrs.blockId`。`mnote-web` 保存 payload 不再发送空 `content: []`，而是派生 `editorDocument`、legacy `content`、`tiptapDocument` 和 `blockCount` 写回 Convex-backed 持久化底座；reload 侧 legacy block 恢复继续补 `attrs.blockId`。本地 smoke `node scripts/task154-e26-anchor-smoke.js` 已覆盖保存请求、`/api/documents/content`、复制链接、DOM `id/:target` 和 reload/hash 定位，截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task154-e26-anchor-local-smoke`。剩余：列表项/分割线等更多块类型的统一 anchor attr 覆盖、Wolai 视觉细节、块引用/页面引用预览与移动端行为另拆后续。
|
||||
- E27 执行前口径纠偏：AI 编辑能力包不是“补 AI 菜单文案”或“点击后显示 feedback”。最小闭环必须从 `leptos-tiptap` 的 slash / 块菜单入口出发，携带当前 `documentId`、`workspaceId`、Rust `blockId`、selection 摘要和 Tiptap JSON 快照，进入 Hermes run/session context；Hermes 通过 mnote skill/plugin 调用稳定工具，再由 Rust runtime / `page.body.save` / Convex-backed content 链写回。2026-05-13 起长期口径进一步修正：`/api/ai-agent/run`、`openai-agents-python` sidecar 和 `mnote-cli host` 都只作为历史/兼容路径，不再代表页面 AI 长期主入口；`mnote-cli` 只可作为 mnote plugin 内部适配器或调试入口。E27 第一刀已完成的 sidecar / `/api/ai-agent/run` 路径只作为过渡基线，不宣称是长期主线。
|
||||
- E27 AI agent 入口与写入闭环：2026-05-02 已完成历史主路径纠偏，修正此前把 `/api/hermes/bridge` 当作 E27 主入口的误导口径。块菜单 `AI 助理` 当时从当前 `leptos-tiptap` editor 读取 `documentId`、`workspaceId`、Rust `blockId`、selection state、selected text 与 `tiptapDocument` 快照，发起 `/api/ai-agent/run` 请求，payload 固定 `scope=document`、`stream=true`、`options.ai.provider=online`，并显示 `mnote-leptos-tiptap-ai-status` 的 `idle/pending/ready/error` 状态；请求上下文标记 `source=leptos-tiptap-island`、`action=ask_ai`，Next sidecar adapter 已透传 `workspaceId / selectedBlockId / selection / tiptapDocument` 等 block 级上下文给 `openai-agents-python`。本地 smoke `node scripts/task155-e27-ai-edit-smoke.js` 和 `node scripts/task156-e27-ai-writeback-smoke.js` 是历史执行命令，脚本现已迁入本机 gitignored `recycle/scripts/retired-ai-agent-run-smokes/`，只保留显式环境变量下的历史对照；截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task156-e27-ai-writeback-local-smoke`。2026-05-14 起，页面 AI 主入口改为 Hermes client proxy、上下文进入 Hermes run/session context、写入工具注册为 mnote Hermes plugin 的部分已由 `7-4` 完成；剩余为 Wolai AI 菜单视觉基线、slash AI/selection toolbar AI、Improve/continue/regenerate/summarize/translate 子命令、`doc_insert_blocks` 多块插入和标题写入等细分入口如何复用同一条 Hermes tool chain。
|
||||
- E27 Auth 真源纠偏：2026-05-02 补充确认，AI 编辑和在线 smoke 的用户身份必须以真实 Convex Auth 为主线；不同账号的数据隔离依赖 Convex `getAuthUserId(ctx)` 解析真实 identity subject，并由 workspace/member 权限链校验。`/auth` 复用既有 Convex Auth 页面和统一测试账号 `test@example.com` / `Test123456`；`/api/auth/session`、`/api/auth/whoami`、AI orchestrator 转发和 Convex transport 均应真实 token / forwarded actor 优先。`DEV_USER_ID` / admin acting identity 只允许作为本地底层 fallback 或显式 `MNOTE_DEV_AUTH=1` 联调模式，不能作为 E27 在线验收、多账号隔离或正式数据真源。
|
||||
- E27 Auth 真源纠偏：2026-05-22 补充确认，AI 编辑和在线 smoke 的用户身份默认以 Rust SQLite control-plane session / actor 为主线；不同账号的数据隔离依赖 control-plane 解析真实用户与 workspace/share grant 权限链校验。`/auth` 复用当前 `mnote-web` 登录页和默认测试账号 `mnote.e2e@example.com` / `MnoteE2E123!`；`/api/session`、AI orchestrator 转发和 source-specific transport 均应真实 session / forwarded actor 优先。旧 Convex Auth 只作为历史在线 / compat / cloud source 验证边界。`DEV_USER_ID` / admin acting identity 只允许作为本地底层 fallback 或显式 `MNOTE_DEV_AUTH=1` 联调模式，不能作为 E27 在线验收、多账号隔离或正式数据真源。
|
||||
- E27 当前推进备注：2026-05-03 主线程先切到 E28 Mention / Emoji，E27 曾暂停在 online smoke 模型网关层排障状态。2026-05-14 页面 AI 主入口已经完成 Hermes client proxy + mnote plugin/tool 迁移；恢复 E27 时应从 slash AI / selection toolbar AI / 子命令体验与真实 actor 复用这条新主链继续，不要回退成旧 orchestrator 或旧 `/api/ai-agent/run` 排障。
|
||||
- E28/E29 暂停与 E30 先行口径：2026-05-03 主线程先暂停 E28 Mention / Emoji 与 E29 Comment / History，转入 E30 Menu / Floating 状态机能力包。E28 已有 Wolai Hermes baseline 显示正文输入 `@` 当前弹出提醒/会议/成员候选，并可插入成员 mention，不是页面引用搜索；证据目录为 `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task157-e28-wolai-mention-baseline/`，恢复 E28 时需先重新定 `@mention` 口径，不要按“页面引用第一刀”继续。E29 在评论/历史后端边界未重新确认前保持暂停。E30 第一刀只收敛已有 slash、块菜单、二级菜单、selection/image/table floating toolbar 的打开互斥、Esc、外部点击、方向键、Enter 与层级收起，不扩新业务命令。
|
||||
- E30 Menu / Floating 状态机第一刀：2026-05-03 已参考 `use-floating-element`、`use-menu-navigation`、`use-floating-toolbar-visibility` 的集中可见性/键盘/关闭模型，把本地已有 slash、块菜单、selection toolbar、image toolbar、table toolbar/options 的关闭与互斥收口到 `close_editor_floating_overlays*` 与 `open_*_overlay` 入口；`task158-e30-menu-state-smoke.js` 覆盖 slash `ArrowDown` active、Esc 关闭、块菜单二级菜单、selection color panel、image toolbar、table options、slash 打开关闭 selection toolbar、块菜单打开关闭 image toolbar。Wolai 基线目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-wolai-baseline/`；本地主线程截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-menu-state-local-smoke-main3`；本地 subagent 复测目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-local-postfix-subagent`。剩余：Wolai slash / 块菜单二级菜单在只读条件下未稳定验证，Enter 选中、外部点击和更多三级菜单收起需后续 editable-test 小切片继续补。
|
||||
- E31 Auth 入口回收：2026-05-04 已把 `3000` 的 `/auth` 收回为本地 `mnote-web` SSR 登录页，不再代理 3100；未登录访问 `/` 现在 303 到 `/auth`，已登录（forwarded actor / Convex Auth cookie）才进入工作区。`task159-auth-entry-smoke.js` 覆盖 `/auth` 本地 200、`/` 未登录 303、已登录 200、无第三方快捷登录/隐私政策文案，`task114-rust-web-gateway-entry-smoke.js` 与 `task117-next-retirement-guard.js` 已同步更新。截图待复核：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task159-auth-entry-baseline/`。
|
||||
- E31 Auth 入口回收：2026-05-04 已把 `3000` 的 `/auth` 收回为本地 `mnote-web` SSR 登录页，不再代理 3100；2026-05-22 起未登录访问 `/` 仍 303 到 `/auth`，已登录以 Rust control-plane session / actor 为准进入工作区，旧 Convex cookie 仅作为历史 compat 输入。`task159-auth-entry-smoke.js` 覆盖 `/auth` 本地 200、`/` 未登录 303、已登录 200、无第三方快捷登录/隐私政策文案，`task114-rust-web-gateway-entry-smoke.js` 与 `task117-next-retirement-guard.js` 已同步更新。截图待复核：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task159-auth-entry-baseline/`。
|
||||
|
||||
|
||||
| ID | 状态 | 任务 | 验收要点 |
|
||||
@@ -422,7 +422,7 @@ GREEN：
|
||||
| E24 | PARTIAL | Image / Media 能力包 | 已完成图片 `/tp` 最小真源闭环与图片 toolbar 小闭环：slash `媒体与附件` 分组入口调用 `leptos-tiptap` 官方 `set_image(TiptapImageResource)`，启用 `TiptapExtension::Image`，保存链新增 `EditorBlockType::Image` / `TiptapNode::Image` 并保留 `props.tiptapImage`，`mnote-web` reload 恢复 `<img>`；点击图片后出现 `image-floating-toolbar`，删除入口本切片保持禁用，左/中/右对齐通过官方 Image 扩展 `addAttributes("data-align")` + `updateAttributes("image")` 持久化，同源下载通过隐藏 `<a download>` 触发且不改文档；`task152-e24-image-smoke.js` 覆盖入口、实际图片加载、toolbar、同源下载、删除入口禁用态、居中对齐、保存请求、content API 和刷新恢复；剩余上传、最近上传、caption、resize、replace、跨源下载 fallback、删除保存链、移动端 toolbar、失败态 |
|
||||
| E25 | PARTIAL | TOC 能力包 | 已完成 `/toc` 最小真源闭环：`leptos-tiptap` 新增真实 `tocNode` schema/command，slash `页面目录 /toc` 插入真实节点，NodeView 从当前 headings 派生目录项，支持点击定位、标题显示开关、保存请求、content API 与 reload 恢复；`task153-e25-toc-smoke.js` 覆盖入口、动态 heading 更新、hash 定位和 `props.tiptapTocNode`。剩余 TOC sidebar、active heading 高亮、完整块菜单入口、官方 TableOfContents v3 数据源评估、移动端与像素级视觉 |
|
||||
| E26 | PARTIAL | UniqueID / Anchor 能力包 | 已完成最小真源闭环：Rust `EditorBlock.block_id` -> Tiptap `attrs.blockId` -> DOM `data-block-id` + `id` -> 复制链接 hash -> `page.body.save` / `/api/documents/content` -> reload 后 `:target` 定位；`task154-e26-anchor-smoke.js` 覆盖保存、复制、reload/hash 和截图。Tiptap `UniqueID` 仍只作为参考/辅助口径，不作为正式块 id；剩余更多块类型 anchor 覆盖、Wolai 视觉细节、引用预览和移动端行为。 |
|
||||
| E27 | PARTIAL | AI 编辑能力包 | 已完成历史块菜单 `AI 助理` 主路径与最小写入闭环：点击后曾发起 `/api/ai-agent/run`，payload 使用 `scope=document`、`stream=true`、`options.ai.provider=online`，携带 `documentId`、`workspaceId`、Rust `blockId`、selection、selected text、Tiptap 快照和 `action=ask_ai`；`task155-e27-ai-edit-smoke.js` 与 `task156-e27-ai-writeback-smoke.js` 已默认退役为 historical smoke，当前只保留显式环境变量下的历史对照。2026-05-14 起页面 AI 主链已调用 Hermes client proxy，Hermes session/message/tool event/usage/model 是会话真相，mnote 通过 Hermes skill/plugin 执行 `page.body.save`、标题、页面设置、artifact、edge 等业务工具；`mnote-cli` 仅可作为 plugin 内部适配器。Auth 验收必须复用 Convex Auth 测试账号，真实 token / actor 优先，`dev identity` 仅为本地 fallback。剩余 slash AI/selection toolbar AI、Improve/continue/regenerate/summarize/translate、Wolai 视觉基线、`doc_insert_blocks` 多块插入与标题写入等细分入口。 |
|
||||
| E27 | PARTIAL | AI 编辑能力包 | 已完成历史块菜单 `AI 助理` 主路径与最小写入闭环：点击后曾发起 `/api/ai-agent/run`，payload 使用 `scope=document`、`stream=true`、`options.ai.provider=online`，携带 `documentId`、`workspaceId`、Rust `blockId`、selection、selected text、Tiptap 快照和 `action=ask_ai`；`task155-e27-ai-edit-smoke.js` 与 `task156-e27-ai-writeback-smoke.js` 已默认退役为 historical smoke，当前只保留显式环境变量下的历史对照。2026-05-14 起页面 AI 主链已调用 Hermes client proxy；2026-05-22 起产品层运行态索引、权限和审计默认落 SQLite control-plane，Hermes/Reasonix runtime 的内部 session/message/tool event/usage/model 不等同于 MNote 产品层会话真相；mnote 通过 Hermes skill/plugin 执行 `page.body.save`、标题、页面设置、artifact、edge 等业务工具；`mnote-cli` 仅可作为 plugin 内部适配器。Auth 验收必须复用当前 SQLite control-plane 测试账号，真实 session / actor 优先，`dev identity` 仅为本地 fallback；Convex Auth 只作为历史 compat / cloud source 对照。剩余 slash AI/selection toolbar AI、Improve/continue/regenerate/summarize/translate、Wolai 视觉基线、`doc_insert_blocks` 多块插入与标题写入等细分入口。 |
|
||||
|
||||
2026-05-14 追加说明：E27 行中的 “Hermes client proxy 接入、mnote plugin tool 注册” 已由 `design/07-ai/done/7-4-page-ai-hermes-panel-execution-checklist-v1.md` 对应的 7-5 / 7-6 合同和 mnote-web 实现推进到 GREEN：页面 AI 主链已走 Hermes session/run/events，mnote tool surface 已覆盖 `mnote.page.get`、`mnote.page.save`、`mnote.page.update_title`、`mnote.page.update_options`、`mnote.artifact.create_summary`、`mnote.artifact.create_ai_note`，旧 `/api/ai-agent/run` 已改为 `legacy_ai_agent_run_retired` guard。本文件后续只保留 Wolai-aline 体验、slash/selection toolbar AI 子命令和视觉/交互对标；页面 AI 长期主链完成状态以 `7-4` 为准。
|
||||
| E28 | PAUSED | Mention / Emoji 能力包 | 2026-05-03 暂停；Wolai baseline 已纠偏：正文 `@` 当前是提醒/会议/成员候选入口，不是页面引用搜索，恢复时先重定 mention/emoji 口径，再决定 Tiptap JSON 与 mnote 保存链 |
|
||||
|
||||
@@ -12,6 +12,9 @@
|
||||
> - local-first 下，本地 `.md` 文件是正文真相；Page Aggregate / EditorBlockDocument / tiptap state 都是投影或工作副本。
|
||||
> - `documents/save` 只能作为 compat adapter，不能继续承担长期写侧仲裁。AI 后台写入、tiptap 保存、外部编辑器修改必须统一到本地文件版本冲突模型。
|
||||
>
|
||||
> 2026-05-22 口径补充：
|
||||
> - 默认控制面已由 Rust SQLite `control-plane` 承接；本文中“Convex 作为控制面 / 可选同步协作 source”的表述仅代表 2026-05-18 阶段性背景。当前 Convex 只保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
>
|
||||
> 关联文档：
|
||||
> - `/mnt/Data1T/mnote/design/05-editor-mainline/done/5-4-leptos-tiptap-mainline-correction-v1.md`
|
||||
> - `/mnt/Data1T/mnote/design/old/05-editor-mainline/process/5-3-tiptap-leptos-rust-migration-checklist-v1.md`
|
||||
@@ -89,13 +92,13 @@
|
||||
|
||||
- 要不要 `Tiptap`
|
||||
- 要不要 `leptos-tiptap`
|
||||
- 要不要继续保留 Convex 作为控制面和可选同步协作 source
|
||||
- 要不要继续保留 Convex 作为显式 cloud/compat/sync replica source
|
||||
|
||||
这些结论都已经足够明确：
|
||||
|
||||
- `Tiptap` 继续作为浏览器输入 runtime
|
||||
- `leptos-tiptap` 继续作为 Leptos 内正式 editor island 接缝
|
||||
- `local_folder` 作为默认页面数据真相，Convex / 服务端退居控制面和可选同步协作 source
|
||||
- `local_folder` 作为默认页面数据真相，SQLite control-plane 持有默认控制面，Convex / 服务端退居显式 cloud/compat/sync replica source
|
||||
|
||||
当前真正要收口的是：
|
||||
|
||||
@@ -451,7 +454,7 @@ Rust 侧需要提供一个统一的页面聚合投影，至少包含：
|
||||
|
||||
而是：
|
||||
|
||||
- **Rust 持有语义单一真源，local-first workspace 持有默认数据真相，Convex 只作为控制面和可选同步协作 source。**
|
||||
- **Rust 持有语义单一真源，local-first workspace 持有默认数据真相，SQLite control-plane 持有默认控制面；Convex 只作为历史迁移源、显式 cloud source / compat / sync replica。**
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
>
|
||||
> 当前状态：`DONE`
|
||||
>
|
||||
> 2026-05-22 口径补充：本文是页面块编辑运行时 Actor 的历史设计记录，当时仍以 Convex-backed 写入为默认持久化底座。当前默认数据面已切到 local-first `.md` / Page Aggregate，默认控制面已由 Rust SQLite control-plane 承接；Convex 只保留历史迁移源、显式 cloud source / compat / sync replica 边界。下文中的 Convex 持久化描述仅按历史阶段理解。
|
||||
>
|
||||
> 本稿目的：在 7-12 已排除第二套 AI runtime 的前提下，补上 Hermes tool execution → Convex 持久化之间缺失的 Rust 编辑运行时中继层，实现「内存态 apply → 编辑器就地 patch → Convex 异步持久化 → 事件增量通知」的四步闭环。
|
||||
>
|
||||
> 关联文档：
|
||||
@@ -25,7 +27,7 @@
|
||||
- 编辑器只能全量 reload snapshot，不能就地 patch
|
||||
- tree event stream 收到 `resync_required` 而非增量 delta
|
||||
|
||||
**正确方向不是绕开 Convex（禁止项，Convex 保留为自托管存储底座），而是在 Rust mnote-web 进程中新增一个轻量 EditorRuntimeActor，作为写操作的本地缓冲层。**
|
||||
**历史阶段的正确方向不是绕开当时的 Convex-backed 持久化，而是在 Rust mnote-web 进程中新增一个轻量 EditorRuntimeActor，作为写操作的本地缓冲层。当前默认持久化已经继续演进为 local-first `.md` / SQLite control-plane；Convex 不再是默认底座。**
|
||||
|
||||
EditorRuntimeActor 不是 agent runtime（遵从 7-12 禁止项），它只负责：
|
||||
|
||||
@@ -79,9 +81,9 @@ EditorRuntimeActor 不维护：
|
||||
|
||||
它只是 Rust-owned 的命令执行 + diff 分发层。
|
||||
|
||||
### 3.2 Convex 仍是唯一的持久化底座
|
||||
### 3.2 历史阶段：Convex-backed 持久化
|
||||
|
||||
EditorRuntimeActor 的内存态允许异步写入 Convex，但不绕过 Convex。进程重启后从 Convex 恢复。
|
||||
EditorRuntimeActor 的内存态在本文历史阶段允许异步写入 Convex，但不绕过当时的 Convex-backed 持久化。当前默认恢复源已改为本地 `.md` / Rust SQLite control-plane；Convex 只用于显式 cloud / compat source。
|
||||
|
||||
### 3.3 编辑器 patch 是增量，非全量
|
||||
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
> 更新时间：2026-05-17
|
||||
> 参考：`hermes-vscode-main` (ACP client) / `hermes-web-ui-0.5.18` (HTTP API)
|
||||
>
|
||||
> 2026-05-22 口径补充：本文是 ACP session runtime 增强的历史执行记录，当时曾选择根 `convex/` 作为 ACP-local runtime store。后续 `2-8` 已把默认 auth / ACP-Hermes runtime session / share / sync / AI policy 控制面替换为 Rust SQLite `control-plane`；根 `convex/` functions 源码已软删除到 `recycle/20260522-convex-runtime-retirement/convex/`，`scripts/run-convex-deploy.js` 已归档到同批 recycle 目录。下文中的 Convex store / 根 `convex/` 部署描述仅作为历史记录，不再是当前实现方向。
|
||||
|
||||
## 1. 当前状态
|
||||
|
||||
@@ -34,7 +36,7 @@
|
||||
- mnote 自己产生的 tool audit、业务写入结果、artifact / page / tree 事实；
|
||||
- 经单独架构决策确认后的 ACP 会话缓存或索引。
|
||||
|
||||
如果要把 mnote 的存储升级为跨 Hermes HTTP / ACP 的长期会话真源，必须先更新 `7-5` / `7-8` 的边界，而不能作为本计划的隐含前提。并且 mnote 是多用户系统，AI session 必须按用户、workspace、document 进行隔离；需要数据库时使用当前 Convex 底座，不新增 SQLite。
|
||||
如果要把 mnote 的存储升级为跨 Hermes HTTP / ACP 的长期会话真源，必须先更新 `7-5` / `7-8` 的边界，而不能作为本计划的隐含前提。并且 mnote 是多用户系统，AI session 必须按用户、workspace、document 进行隔离；当前默认数据库边界已改为 Rust SQLite control-plane，不再新增 Convex functions 作为默认 runtime store。
|
||||
|
||||
## 2. 参考实现分析
|
||||
|
||||
@@ -83,7 +85,7 @@
|
||||
|
||||
1. **会话持久化存储**
|
||||
- 默认先建设 ACP-local runtime store / TTL cache，不改 Hermes HTTP 会话真相归属
|
||||
- 持久化如需数据库，必须落到 Convex；不在 mnote-web 内新增 SQLite
|
||||
- 持久化如需数据库，默认落到 Rust SQLite control-plane；不新增根 Convex functions 作为默认 runtime store
|
||||
- 表结构先服务 `ACP_RUN_PAYLOADS` / `ACP_ACTIVE_RUNS` 的可靠生命周期，并且所有记录必须带 `userId` / `workspaceId` / `documentId` 作用域
|
||||
- `sessions/messages` 如要保存完整聊天历史，必须先完成架构决策并标明只覆盖 ACP 路径还是统一覆盖 Hermes HTTP + ACP
|
||||
|
||||
@@ -157,20 +159,20 @@
|
||||
|
||||
## 4. 技术方案
|
||||
|
||||
### 4.0 当前 Convex 源目录口径
|
||||
### 4.0 历史 Convex 源目录口径
|
||||
|
||||
当前仓库状态下：
|
||||
|
||||
- `infra/convex/` 只承载自托管 Convex backend/dashboard 的 Docker 与说明，不是 functions/schema 源目录；
|
||||
- `wolai-frontend/convex/` 已不在当前工作区可读路径中，不能作为新的实现落点；
|
||||
- `recycle/wolai-frontend/convex/` 只作为历史参考；
|
||||
- 本轮执行已在仓库根 `convex/` 建立 ACP-local runtime store 的最小 functions/schema，并让 `scripts/run-convex-deploy.js` 优先以仓库根作为 Convex CLI cwd。
|
||||
- 本轮历史执行曾在仓库根 `convex/` 建立 ACP-local runtime store 的最小 functions/schema，并让 `scripts/run-convex-deploy.js` 优先以仓库根作为 Convex CLI cwd；当前这些源码和脚本已退役到 `recycle/20260522-convex-runtime-retirement/`。
|
||||
|
||||
后续若要恢复完整业务 Convex functions，需要把历史 `recycle/wolai-frontend/convex/` 中仍需要的 documents/workspaces/media 等 functions 正式迁移到根 `convex/`，不能继续依赖已删除的 `wolai-frontend/` 路径。
|
||||
后续若要恢复 Convex cloud / compat source，必须先明确新的 cloud/compat 部署边界，再从 recycle 恢复必要 functions；不能把根 `convex/` 重新作为默认 active deploy source。
|
||||
|
||||
### 4.1 存储方案
|
||||
|
||||
注意：以下结构是 Convex-backed ACP-local store 候选形状，不默认推翻 Hermes 持有聊天真相的既有边界。mnote-web 不新增 SQLite；多用户隔离字段是硬要求。
|
||||
注意：以下结构是历史 Convex-backed ACP-local store 候选形状，不默认推翻 Hermes 持有聊天真相的既有边界。当前默认 store 已转向 Rust SQLite control-plane；多用户隔离字段仍是硬要求。
|
||||
|
||||
```rust
|
||||
// sessions 记录
|
||||
@@ -208,11 +210,11 @@ struct MessageRow {
|
||||
|
||||
### 4.2 现有代码改动范围
|
||||
|
||||
- **新增/修改** 根 `convex/` 相关 schema / functions — ACP-local session/runtime 记录、用户隔离查询、TTL 清理；`infra/convex/` 只负责自托管服务部署
|
||||
- **历史项**：曾新增/修改根 `convex/` 相关 schema / functions，承接 ACP-local session/runtime 记录、用户隔离查询、TTL 清理；当前默认应改 Rust SQLite control-plane schema/API，`infra/convex/` 只负责显式 cloud / compat 服务部署
|
||||
- **修改** `acp_session_manager.rs` — 按架构决策写入 ACP-local 消息或只写 runtime/event 索引
|
||||
- **修改** `hermes_client.rs` — 新增 session 管理 route handlers
|
||||
- **修改** `routes/mod.rs` — 注册新 route
|
||||
- **修改** Convex bridge / transport 调用点 — mnote-web 通过已有 Convex 底座读写 session/runtime 索引
|
||||
- **修改** control-plane / compat transport 调用点 — mnote-web 默认通过 SQLite control-plane 读写 session/runtime 索引，Convex 只作为显式 legacy compat
|
||||
|
||||
### 4.3 与现有 bug 的关系
|
||||
|
||||
@@ -269,11 +271,11 @@ Phase C（P2 用户体验）
|
||||
|
||||
### 6.2 先做后端持久化骨架
|
||||
|
||||
- [x] 为 ACP-local session/runtime store 设计 Convex schema，不新增 SQLite。
|
||||
- [x] 在 Convex 中建 `sessions`、`messages` 或更小的 `runtimeRuns` / `runtimeEvents` 记录，补齐索引和权限过滤。
|
||||
- 当前实现为根 `convex/schema.ts` 的 `acp_runtime_runs` / `acp_runtime_events`，以及 `convex/aiSessions.ts` 的 `upsertRuntimeRun/getRuntimeRun/listRuntimeRuns`。
|
||||
- [x] 历史阶段曾为 ACP-local session/runtime store 设计 Convex schema；当前默认已改为 SQLite control-plane。
|
||||
- [x] 历史阶段曾在 Convex 中建 `sessions`、`messages` 或更小的 `runtimeRuns` / `runtimeEvents` 记录，补齐索引和权限过滤。
|
||||
- 历史实现为根 `convex/schema.ts` 的 `acp_runtime_runs` / `acp_runtime_events`，以及 `convex/aiSessions.ts` 的 `upsertRuntimeRun/getRuntimeRun/listRuntimeRuns`；当前根 `convex/` 已退役。
|
||||
- [x] 把 `ACP_RUN_PAYLOADS` / `ACP_ACTIVE_RUNS` 中必须保留的数据拆到持久化层或短 TTL 层。
|
||||
- 当前 `create_run` 会把 ACP payload/runtime 写入 Convex；内存 map 仍作为热路径保留，`stream_events` 不再消费删除 payload。
|
||||
- 历史阶段 `create_run` 会把 ACP payload/runtime 写入 Convex；当前默认写入 SQLite control-plane，旧 Convex store 仅在显式 legacy compat 下使用。
|
||||
- [x] 把 `create_run` 产出的 `sessionId`、`profile`、`traceId`、`runtime` 写入 `sessions` 记录。
|
||||
- 当前写入目标为更小的 `acp_runtime_runs`，而不是完整聊天 `sessions` 真相表。
|
||||
- [x] 在 `stream_events` 的 ACP 路径里，按架构决策写入 `messages` 或 runtime/event 索引，不能把 Hermes HTTP 聊天真相复制进 mnote。
|
||||
@@ -334,18 +336,18 @@ Phase C（P2 用户体验）
|
||||
|
||||
### 2026-05-18
|
||||
|
||||
- 新增根 `convex/schema.ts`：`acp_runtime_runs` / `acp_runtime_events` 表和索引。
|
||||
- 新增根 `convex/aiSessions.ts`：`upsertRuntimeRun`、`getRuntimeRun`、`listRuntimeRuns`，按 `userId` 校验 identity 作用域。
|
||||
- 修改 `scripts/run-convex-deploy.js`：优先以仓库根 `convex/` 作为 Convex deploy cwd，避免继续指向已不存在的 `wolai-frontend/`。
|
||||
- 后续修正：根 `convex/` 当前只包含 ACP session runtime store，不能直接覆盖完整本地 Convex 部署；`scripts/run-convex-deploy.js` 已改为只有根 `convex/` 具备完整 schema 时才用根目录，否则继续使用现有完整 Convex 源。为保持本机 `3210` 部署完整，已将 `aiSessions.ts` 与 `acp_runtime_*` schema 同步到现有完整 Convex 源并重新部署。
|
||||
- 新增根 `convex/schema.ts`：`acp_runtime_runs` / `acp_runtime_events` 表和索引。（历史记录；当前已退役到 recycle）
|
||||
- 新增根 `convex/aiSessions.ts`：`upsertRuntimeRun`、`getRuntimeRun`、`listRuntimeRuns`，按 `userId` 校验 identity 作用域。（历史记录；当前已退役到 recycle）
|
||||
- 修改 `scripts/run-convex-deploy.js`：优先以仓库根 `convex/` 作为 Convex deploy cwd，避免继续指向已不存在的 `wolai-frontend/`。（历史记录；当前脚本已退役到 recycle，`desktop:hot` / `dev:hot` 不部署 Convex）
|
||||
- 后续历史修正：根 `convex/` 当时只包含 ACP session runtime store，不能直接覆盖完整本地 Convex 部署；`scripts/run-convex-deploy.js` 曾改为只有根 `convex/` 具备完整 schema 时才用根目录，否则继续使用现有完整 Convex 源。当前根 `convex/` 和该 deploy 脚本均已退役到 recycle。
|
||||
- 修改 `rust/crates/mnote-web/src/routes/hermes_client.rs`：
|
||||
- ACP `create_run` 写入 `aiSessions:upsertRuntimeRun`；
|
||||
- ACP `GET /client/sessions` 读取 `aiSessions:listRuntimeRuns`；
|
||||
- ACP `create_run` 写入 `aiSessions:upsertRuntimeRun`（历史 Convex store；当前默认 SQLite）；
|
||||
- ACP `GET /client/sessions` 读取 `aiSessions:listRuntimeRuns`（历史 Convex store；当前默认 SQLite）；
|
||||
- ACP `GET /client/sessions/{session_id}` 读取 runs/events；
|
||||
- ACP `POST /client/sessions/{session_id}/resume` 返回 Convex runtime history 恢复来源；
|
||||
- ACP `DELETE /client/sessions/{session_id}`、`rename`、`auto-title` 写入 Convex store；
|
||||
- ACP `GET /client/sessions/search` 返回 Convex store 搜索摘要和 snippet；
|
||||
- ACP `stream_events` 将 SSE event 写入 `aiSessions:appendRuntimeEvent`；
|
||||
- ACP `POST /client/sessions/{session_id}/resume` 返回 runtime history 恢复来源；
|
||||
- ACP `DELETE /client/sessions/{session_id}`、`rename`、`auto-title` 写入 runtime store；
|
||||
- ACP `GET /client/sessions/search` 返回 runtime store 搜索摘要和 snippet；
|
||||
- ACP `stream_events` 将 SSE event 写入 runtime event store；
|
||||
- `stream_events` 使用 clone lookup 保留 ACP payload，不再 `.remove(run_id)`。
|
||||
- 验证：
|
||||
- `cd rust && cargo test -p mnote-web hermes_client_acp -- --nocapture`：10 passed。
|
||||
@@ -353,8 +355,8 @@ Phase C（P2 用户体验）
|
||||
- `cd rust && cargo test -p mnote-web acp_permission -- --nocapture`：1 passed。
|
||||
- `cd rust && cargo test -p mnote-web page_ai_uses_backend_acp_session_runtime_store -- --nocapture`：1 passed。
|
||||
- `cd rust && cargo test -p mnote-web acp_thought_delta_does_not_emit_message_delta -- --nocapture`：1 passed。
|
||||
- `node -c scripts/run-convex-deploy.js`：通过。
|
||||
- `node scripts/run-convex-deploy.js`：部署入口已避免用根最小 `convex/` 覆盖完整本地 Convex schema；`aiSessions.ts` 同步补到完整 Convex 源并部署到 `http://127.0.0.1:3210`，最终脚本验证为 `No indexes are deleted by this push`。
|
||||
- `node -c scripts/run-convex-deploy.js`：历史验证通过；当前脚本已退役到 recycle。
|
||||
- `node scripts/run-convex-deploy.js`：历史验证通过；当时部署入口已避免用根最小 `convex/` 覆盖完整本地 Convex schema。当前默认启动链路不再部署 Convex。
|
||||
- `node` 提取并 `new Function(SIDEBAR_TREE_JS)`：通过。
|
||||
- `npx convex --version`：1.39.1。
|
||||
- `CONVEX_TMPDIR=/mnt/Data1T/mnote/.convex-tmp npx convex codegen --dry-run --typecheck try`：通过。
|
||||
|
||||
@@ -198,7 +198,7 @@ MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-tool-sm
|
||||
执行步骤：
|
||||
|
||||
- [x] 启动当前前后端，确保测试入口可访问。
|
||||
- [x] 用真实 Convex Auth 测试账号登录。
|
||||
- [x] 用真实测试账号登录。历史执行时使用旧 Auth 后端；当前默认应使用 SQLite control-plane Auth / session。
|
||||
- [x] 打开任意测试页面，点击右下角页面 AI。
|
||||
- [x] 发送一条只读问题，例如“概括当前页面标题和第一段”。
|
||||
- [x] 记录当前请求是否仍命中旧 `/api/ai-agent/run`。
|
||||
@@ -763,7 +763,7 @@ MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-tool-sm
|
||||
总体验收标准：
|
||||
|
||||
- [x] 所有 smoke 在真实 `http://127.0.0.1:3000` 上通过。
|
||||
- [x] 使用默认 Convex Auth 测试账号，不使用 `MNOTE_DEV_AUTH=1` 伪登录作为正式验收。
|
||||
- [x] 使用默认真实测试账号，不使用 `MNOTE_DEV_AUTH=1` 伪登录作为正式验收。历史执行时使用旧 Auth 后端；当前默认应使用 SQLite control-plane Auth / session。
|
||||
- [x] smoke 只操作本轮新建测试数据，测试数据前缀统一为 `TEST-HERMES-AI-<timestamp>`。
|
||||
- [x] 测试结束后可定位创建的页面、artifact、edge、audit。
|
||||
- [x] 任一 smoke 失败时，必须记录到 `bugs/` 对应分类，而不是在 checklist 中直接标 GREEN。
|
||||
@@ -1054,7 +1054,7 @@ MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-tool-sm
|
||||
|
||||
### M1：把正式 `3000` 的 E2E smoke 跑成最终验收矩阵
|
||||
|
||||
**目标：** 临时 `3019` 证据不能作为最终完成；必须在正式 `3000` + 真实 Convex Auth 上复跑全矩阵。
|
||||
**目标：** 临时 `3019` 证据不能作为最终完成；必须在正式 `3000` + 真实 SQLite control-plane Auth / session 上复跑全矩阵。历史记录中的 Convex Auth 只作为当时验收背景。
|
||||
|
||||
**必须参考 Hermes Web UI 的位置：**
|
||||
|
||||
@@ -1068,7 +1068,7 @@ MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-tool-sm
|
||||
**顺序执行 checklist：**
|
||||
|
||||
- [x] M1.1 确认主入口 `http://127.0.0.1:3000` 运行的是包含本轮改动的 `mnote-web`，不是旧进程。
|
||||
- [x] M1.2 使用默认 Convex Auth 测试账号 `mnote.e2e@example.com` 登录，不使用 `MNOTE_DEV_AUTH=1` 伪登录作为正式验收。
|
||||
- [x] M1.2 使用默认 SQLite control-plane 测试账号 `mnote.e2e@example.com` 登录，不使用 `MNOTE_DEV_AUTH=1` 伪登录作为正式验收；旧 Convex Auth 仅作 compat 回归。
|
||||
- [x] M1.3 运行 `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-smoke.js`。
|
||||
- [x] M1.4 运行 `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-tool-smoke.js`。
|
||||
- [x] M1.5 运行 `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task-hermes-page-ai-writeback-smoke.js`。
|
||||
|
||||
@@ -6,6 +6,8 @@
|
||||
>
|
||||
> 归档说明（2026-05-21）：本文冻结 ACP session 与控制面分享/账号作用域远期合同；当前只作为 future reference，不作为 MVP 后阶段 active implementation checklist。
|
||||
>
|
||||
> 2026-05-22 口径补充：本文标题中的 Convex 是历史控制面语境。当前默认控制面已由 Rust SQLite `control-plane` 承接；ACP/Hermes runtime session、auth、share grants、AI policy 默认不再依赖 Convex。下文涉及 Convex store 的内容只作为历史 / compat / sync replica 对照。
|
||||
>
|
||||
> 本稿目的：
|
||||
> 1. 明确 ACP session 必须绑定当前账号权限与控制面作用域，不能以内存态绕过权限。
|
||||
> 2. 冻结后续“复制会话 / 只读分享 / 多人共同会话”的产品语义，避免当前实现误扩。
|
||||
@@ -26,7 +28,7 @@ ACP 默认主链已经替代旧 Hermes HTTP 主链，但这不意味着 ACP runt
|
||||
|
||||
当前必须成立的规则：
|
||||
|
||||
- **控制面持有产品层 AI session 的账号作用域真相；在当前实现里它可以暂时落在 Convex，但长期不应把“Convex”写死成唯一真相。**
|
||||
- **Rust SQLite control-plane 持有产品层 AI session 的账号作用域真相；Convex 只作为历史 / compat / sync replica 对照，不应被写死成唯一真相。**
|
||||
- **ACP runtime session 只是执行层会话**，可以被控制面 session 绑定或索引，但不能直接作为跨用户共享对象。
|
||||
- **ACP session 记录必须带 `userId / workspaceId / documentId / sessionId / runId / actorId / acpRuntime / profile`**。
|
||||
- **写入控制面 session store 失败时，不允许静默降级为可继续写入的内存 session**。这会破坏账号隔离、审计和后续分享语义。
|
||||
@@ -38,7 +40,7 @@ ACP 默认主链已经替代旧 Hermes HTTP 主链，但这不意味着 ACP runt
|
||||
|
||||
### 1.1 MNote AI Session
|
||||
|
||||
MNote AI Session 是产品层会话对象，长期应该由控制面持有；当前实现可以暂存在 Convex，但目标不是把消息全文和权限真相永久绑死在 Convex。
|
||||
MNote AI Session 是产品层会话对象，长期应该由控制面持有；当前默认控制面是 Rust SQLite control-plane，目标不是把消息全文和权限真相永久绑死在 Convex。
|
||||
|
||||
它回答：
|
||||
|
||||
@@ -77,8 +79,8 @@ Tool Audit 是 mnote 侧工具执行与写入结果的审计记录，必须以
|
||||
|
||||
当前代码可接受的最小边界：
|
||||
|
||||
- `POST /api/hermes/client/sessions` 在 ACP 默认路径下创建 Convex 侧 runtime session 索引。
|
||||
- `POST /api/hermes/client/runs` 创建 run 并持久化到 Convex runtime store。
|
||||
- `POST /api/hermes/client/sessions` 在 ACP 默认路径下创建 SQLite control-plane runtime session 索引；Convex 仅保留显式 legacy compat。
|
||||
- `POST /api/hermes/client/runs` 创建 run 并默认持久化到 SQLite control-plane runtime store。
|
||||
- `GET /api/hermes/client/events/{runId}` 将 ACP event 转成页面 SSE，并追加 runtime event。
|
||||
- `GET /api/hermes/client/gateway/health` 在 ACP 默认路径下返回 `transport=acp`，不再探测旧 Hermes HTTP gateway。
|
||||
|
||||
@@ -209,7 +211,7 @@ Runtime event 和 tool event 应保留原始结构，但查询时必须做权限
|
||||
|
||||
规则：
|
||||
|
||||
- 创建 session 时使用当前 Convex Auth 解析出的真实 user id。
|
||||
- 创建 session 时使用当前 SQLite control-plane auth/session 解析出的真实 user / actor id。
|
||||
- `userId` 只可作为服务端派生字段，不可由浏览器任意指定。
|
||||
- run / event / tool audit 都必须与同一 actor 绑定。
|
||||
- 当前请求无法解析用户时，应返回 `401` 或稳定错误，而不是创建匿名共享 session。
|
||||
@@ -410,7 +412,7 @@ DELETE /api/hermes/client/sessions/{sessionId}/members/{userId}
|
||||
状态：当前主线。
|
||||
|
||||
- ACP 默认主链可用。
|
||||
- session/run/event 必须账号作用域写入 Convex。
|
||||
- session/run/event 必须账号作用域写入 Rust SQLite control-plane；Convex 只作为显式 compat / sync replica。
|
||||
- 旧 Hermes HTTP 主链进入 `recycle`。
|
||||
- 不实现复制、分享、多人会话。
|
||||
- 文档与测试明确禁止内存降级绕过权限。
|
||||
@@ -421,7 +423,7 @@ DELETE /api/hermes/client/sessions/{sessionId}/members/{userId}
|
||||
|
||||
- 增加 `ai_sessions` / `ai_session_members` / `ai_runtime_bindings`。
|
||||
- 将现有 `acp_runtime_runs` 从“运行态索引”升级为 session 下的 run 记录。
|
||||
- UI 从 localStorage 历史逐步迁到 Convex session 列表。
|
||||
- UI 从 localStorage 历史逐步迁到 Rust control-plane session 列表。
|
||||
|
||||
### Phase C：复制与只读分享
|
||||
|
||||
|
||||
@@ -209,7 +209,7 @@
|
||||
|
||||
- `tree-first graph kernel` 是长期对象语义真相层
|
||||
- local-first workspace 与本地 `.md` 是早期产品默认数据面和正文真相
|
||||
- `Convex` / 服务端降级为鉴权、分享、同步、协作、cloud source、compat 和 sync replica 控制面
|
||||
- Rust SQLite control-plane 承接鉴权、分享、同步、协作和 AI policy 默认控制面；`Convex` / 服务端仅保留历史迁移源、显式 cloud source、compat 和 sync replica 边界
|
||||
- `mnote-web` 与 Rust kernel 持有主执行语义
|
||||
|
||||
因此后续不能照搬思源 `.sy` 对象格式，也不能把：
|
||||
@@ -270,7 +270,7 @@
|
||||
|
||||
而 `mnote` 当前仍保留：
|
||||
|
||||
- Convex 自托管底座
|
||||
- Convex 历史迁移 / 显式 cloud source / compat / sync replica 边界
|
||||
- realtime 协作链
|
||||
- Rust Web `3000` 主入口
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@ MNote 当前已进入 local-first MVP 后阶段：
|
||||
- 本地 `.md` 是页面正文真相。
|
||||
- Rust kernel / projection / command 持有树、页面、资源和权限语义。
|
||||
- `mnote-web` 是 3000 主 Web 执行面。
|
||||
- Convex / 服务端降级为 auth、membership、share grants、sync state、AI policy、cloud source、compat 和 sync replica 控制面。
|
||||
- Rust SQLite control-plane 承接 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 等默认控制面；Convex / 服务端仅保留历史迁移源、显式 cloud source、compat 和 sync replica 边界。
|
||||
- 旧 Next / React / wolai-frontend、BlockNote 默认主链、Convex 默认正文/附件/AI 会话全文主存储口径均为 legacy / recycle / compat 背景。
|
||||
|
||||
## 2. 本轮整理原则
|
||||
|
||||
@@ -30,9 +30,9 @@
|
||||
|
||||
- Rust `AcpSessionManager` 已有 `session/new`、`session/prompt`、`session/cancel`、streaming dedup、typed event 和 usage / thought / tool / plan / session info 解析雏形。
|
||||
- `acp_bridge.rs` 已把 TextDelta、ThoughtDelta、ToolCall、ToolCallUpdate、UsageUpdate、PermissionRequest 转成 SSE，但 `SessionInfoUpdate` 和 `PlanUpdate` 当前仍被丢弃。
|
||||
- `layout.rs` Page AI 已有 session list/detail/search/resume/rename/delete、localStorage cache、Convex/local ACP runtime store、permission dialog、tool event UI、profile/skills 控制面和 usage summary。
|
||||
- `routes/hermes_client.rs` 已有 local-first AI session JSONL、Convex ACP runtime store、run queue、abort 和 local agent audit。
|
||||
- 当前 `resume_session` 只恢复 MNote/Convex/local 会话历史，不等同于对 ACP adapter 调用 `session/load` 注册底层 ACP session。
|
||||
- `layout.rs` Page AI 已有 session list/detail/search/resume/rename/delete、localStorage cache、SQLite control-plane / local AI session store、permission dialog、tool event UI、profile/skills 控制面和 usage summary；旧 Convex ACP runtime store 仅属 legacy compat。
|
||||
- `routes/hermes_client.rs` 已有 local-first AI session JSONL、SQLite control-plane ACP runtime store、run queue、abort 和 local agent audit；旧 Convex ACP runtime store 仅属 legacy compat。
|
||||
- 当前 `resume_session` 只恢复 MNote SQLite/local 或显式 legacy Convex 会话历史，不等同于对 ACP adapter 调用 `session/load` 注册底层 ACP session。
|
||||
- 当前 `AcpClient` 对 incoming `session/request_permission` 仍立即返回 unsupported/deny，前端按钮没有真正回传 ACP 决策。
|
||||
- 当前 `SessionUpdate::ToolCall` 类型未保留 `locations`，因此无法像 Hermes VSCode 一样把 read/edit 工具结果联动到主编辑器 tab。
|
||||
|
||||
@@ -80,7 +80,7 @@ MNote 已在 `AcpSessionManager` 解析 `SessionInfoUpdate` 和 `PlanUpdate`，
|
||||
## 7. 不建议照搬
|
||||
|
||||
- 不照搬 VSCode Webview 的 DOM/CSS 结构；MNote 仍使用 Wolai 主题 Page AI drawer。
|
||||
- 不把 VSCode `workspaceState` 当作 MNote 会话真相；local-first 下本地 JSONL / Convex control-plane / runtime registry 各自职责不变。
|
||||
- 不把 VSCode `workspaceState` 当作 MNote 会话真相；local-first 下本地 JSONL / SQLite control-plane / runtime registry 各自职责不变，Convex 只保留显式 legacy compat / sync replica。
|
||||
- 不把 Hermes 插件中的自动打开文件行为做成不可控跳转；MNote 应默认在 main editor resource tab 打开，并保留显式新窗口入口。
|
||||
- 不在 UI 层新增第二套文件权限真相；权限和 allowed roots 仍由 Rust Web / local-first scope 决定。
|
||||
- 不把 Page AI block-edit workflow 扩成普通 Markdown 主路径；local folder 继续走文件引用 + agent 原生 patch/diff + watcher 同步。
|
||||
|
||||
+4
-3
@@ -1,13 +1,14 @@
|
||||
# design 设计稿索引
|
||||
|
||||
> 更新时间：2026-05-21
|
||||
> 更新时间：2026-05-22
|
||||
>
|
||||
> 当前产品口径：`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Hermes/Reasonix agent + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
|
||||
>
|
||||
> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Convex / 服务端只作为控制面、cloud source、compat 和 sync replica。入口设计见：
|
||||
> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面；Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见：
|
||||
> `/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`
|
||||
>
|
||||
> 后续新增设计默认以 MVP 后阶段为基线：优先推进 `WorkspacePath/ObjectIdentity`、`DocumentBuffer/BufferStore`、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化；不要再把旧 Convex / Next / BlockNote 主链当作新增能力默认方向。
|
||||
> 后续新增设计默认以 MVP 后阶段为基线：优先推进 `WorkspacePath/ObjectIdentity`、`DocumentBuffer/BufferStore`、Page Aggregate compat 瘦身、tree command context、live cache 统一、agent diff / 冲突合并 / 本地索引 / 分享同步产品化；不要再把旧 Convex / Next / BlockNote 主链、根 `convex/` functions 源码或 Convex Auth 默认控制面当作新增能力默认方向。
|
||||
>
|
||||
> 状态口径以当前仓库真实代码为准：
|
||||
> - `[done]`：对应阶段或收口目标已经在当前主线代码中成立
|
||||
|
||||
+3
-3
@@ -4,8 +4,8 @@
|
||||
>
|
||||
> 2026-05-18 口径更新：
|
||||
> - 本文保留为历史过渡判断：它解释“不要在没有替代控制面、迁移工具和兼容策略时硬拆 Convex”。
|
||||
> - 当前新增能力的上位方向已由 `design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md` 覆盖：本地文件夹是早期产品默认数据真相，Rust kernel 是唯一语义真相，Convex / 服务端降级为账号、分享、同步、协作和 AI 隔离控制面。
|
||||
> - 因此，本文中“Convex 作为默认存储 / 实时 / 文件底座”的表述只代表旧代码过渡态和历史决策背景，不再作为新增功能默认方向。
|
||||
> - 当前新增能力的上位方向先由 `design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md` 覆盖，后续又由 `design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md` 继续替换控制面：本地文件夹是早期产品默认数据真相，Rust kernel 是唯一语义真相，Rust SQLite control-plane 是默认账号、分享、同步、协作和 AI 隔离控制面。
|
||||
> - 因此，本文中“Convex 作为默认存储 / 实时 / 文件底座 / 控制面”的表述只代表旧代码过渡态和历史决策背景，不再作为新增功能默认方向；Convex 只保留历史迁移源、显式 cloud source / compat / sync replica 边界。
|
||||
>
|
||||
> 当前优先级入口：
|
||||
> - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
|
||||
@@ -499,7 +499,7 @@ Rust Web 不是第二套业务内核。
|
||||
|
||||
截至 2026-05-18，当前新增能力的上位口径已调整为：
|
||||
|
||||
> **mnote 的早期产品路线是 local-first workspace：本地文件夹是默认数据真相，Rust kernel 是唯一语义真相，Convex / 服务端降级为账号、分享、同步、协作和 AI 隔离控制面。**
|
||||
> **mnote 的早期产品路线是 local-first workspace：本地文件夹是默认数据真相，Rust kernel 是唯一语义真相，Rust SQLite control-plane 是默认账号、分享、同步、协作和 AI 隔离控制面；Convex 只保留历史迁移源、显式 cloud source / compat / sync replica 边界。**
|
||||
|
||||
当前已经完成的是：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user