mnote/design/old/08-legacy-rust-kernel/done/rust-single-repo-maintenance-boundary.md

[recycle] mnote 单仓维护边界约定

更新时间：2026-04-14

主仓：/mnt/Data1T/mnote

历史仓：/mnt/Data1T/mnote-rust

1. 主结论

• 只保留 /mnt/Data1T/mnote 作为启动、规划、保存、验证的唯一主仓。
• /mnt/Data1T/mnote-rust 只作为历史资产来源，不再承担主执行入口。
• 任何新设计、执行清单、架构说明都优先写入 /mnt/Data1T/mnote/design/ 或 /mnt/Data1T/mnote/rust/design/。

2. 主仓执行入口

• 根目录脚本入口只认 /mnt/Data1T/mnote/package.json 与 /mnt/Data1T/mnote/scripts/。
• 当前 package.json 仅通过 node scripts/*.js 暴露仓库级入口，没有任何脚本要求先进入 mnote-rust。
• 如需调用 Rust，统一使用 cargo --manifest-path /mnt/Data1T/mnote/rust/Cargo.toml ...，不从历史仓发起 Cargo 命令。
• 当前 scripts/desktop-hot.js 已固定从主仓根目录解析 .env.all，并以 wolai-frontend/、wolai-backend/ 作为唯一联调入口。

3. mnote-rust 历史资料分类

3.1 核心规范

这些内容可作为协议与设计参考，但主线副本以 /mnt/Data1T/mnote/rust/ 为准：

• design/blueprint/
• design/core/
• crates/core-domain/
• crates/core-protocol/
• crates/event-log/
• crates/storage-convex-bridge/
• crates/index-fts/

3.2 历史阶段

这些内容保留为阶段记录，不作为当前实现依据：

• design/phases/**
• design/execution/**
• design/UI/**
• design/mindmap/**

3.3 参考实现

这些内容可用于盘点边界、提取协议或核对交互，但不能整块复制覆盖主仓：

• app/**
• components/**
• lib/**
• convex/**
• infra/onlyoffice/**
• crates/mnote-cli/
• crates/adapter-onlyoffice/
• crates/adapter-mindmap/
• crates/adapter-legacy-mnote/

3.4 错误方向

以下内容明确不进入主仓主线：

• 对象页壳与试验页：app/page.tsx、app/onlyoffice/page.tsx、app/documents/**
• 第二套导航壳：components/sidebar/sidebar.tsx
• 诊断与构建产物：.next/diagnostics/**、.next/**、.tmp/**
• 仅用于历史 smoke/夹具的目录：.tmp/phase7-test-fixtures/**

4. 主仓默认不动目录

除非当前任务明确要求接线或修复，否则默认不扩写以下目录：

• /mnt/Data1T/mnote/wolai-frontend/
• /mnt/Data1T/mnote/wolai-backend/
• /mnt/Data1T/mnote/infra/convex/
• /mnt/Data1T/mnote/src/components/onlyoffice/
• /mnt/Data1T/mnote/recycle/

5. 最小维护约定

5.1 Workspace 责任面

• 入口文件：/mnt/Data1T/mnote/rust/Cargo.toml、/mnt/Data1T/mnote/rust/Cargo.lock
• 维护范围：/mnt/Data1T/mnote/rust/crates/*
• 要求：新增 crate、依赖调整、共享协议变更，必须先在主仓 workspace 内完成，不得回写到历史仓再反向复制。

5.2 Bridge 责任面

• 入口文件：/mnt/Data1T/mnote/wolai-frontend/src/lib/documents/bridge.ts
• 相关边界：
  • /mnt/Data1T/mnote/wolai-frontend/src/lib/documents/metadata-command-adapter.ts
  • /mnt/Data1T/mnote/wolai-frontend/src/lib/documents/save-command-adapter.ts
  • /mnt/Data1T/mnote/wolai-frontend/src/app/api/documents/**
  • /mnt/Data1T/mnote/wolai-frontend/src/app/api/sidebar/route.ts
  • /mnt/Data1T/mnote/wolai-frontend/convex/bridgeLogs.ts
• 要求：新 command/query 先收口协议边界，再决定是否继续下沉到 Rust crate。

5.3 接入链责任面

• C1 页面元信息：src/app/(app)/documents/[id]/page.tsx、src/components/editor/document-content.tsx
• C2 Sidebar 聚合：src/components/sidebar/**、src/hooks/use-convex-sidebar-data.ts、src/lib/sidebar-data.ts
• C3 正文保存：src/components/editor/blocknote-editor.tsx、src/app/api/documents/save/route.ts
• Phase D 边界：src/components/editor/blocks/MindmapBlock.tsx、src/app/onlyoffice/**、src/app/api/onlyoffice/**
• 要求：优先改主仓现有链路，不复制历史仓页面壳替换现实现。

6. 禁止误复制清单

• 不把 mnote-rust 当成新的主执行仓。
• 不复制第二套 Next 前端壳、对象页壳、diagnostics 页、smoke 页进入主线。
• 不通过软链接、硬链接、跨仓路径偷接来伪装“已迁移”。
• 不在主仓根目录散落多个 Rust 源码根。