feat: align local-first workspace direction

Document the VSCode-like local-first product shape, demote Convex to a control-plane role, and retire stale architecture drafts.

Add local workspace migration/export references plus smoke coverage for no-Convex managed workspace startup, local markdown title/body/options persistence, asset upload behavior, and Convex fixture export.

Verification: git diff --cached --check; node scripts/check-local-first-convex-guard.js --staged; node scripts/task444-convex-workspace-export-local-fixture-smoke.js; node scripts/task166-local-first-managed-workspace-no-convex-smoke.js; node scripts/task167-local-markdown-title-body-options-no-convex-smoke.js
This commit is contained in:
lix-2026
2026-05-19 08:11:58 +08:00
parent 68d321e297
commit cdff672aa5
67 changed files with 5242 additions and 932 deletions
+131
View File
@@ -0,0 +1,131 @@
# Wolai 帮助中心 — 基础功能参考
> 来源:https://www.wolai.com/wolai/xhqeop8UHpVTMUSVmgz8nq
> 抓取时间:2026-05-19
> 用途:作为 mnote 产品功能对标的参考目录,仅记录基础功能/架构相关条目,跳过高级功能、团队协作、商业信息
## 基础操作
| 功能 | 说明 | mnote 现状 |
|------|------|------------|
| 基本编辑能力 | 文本输入、换行、拖拽块排序、缩进/取消缩进、Copy/Paste | ✅ leptos-tiptap island |
| 快捷命令菜单 | `/` 唤出块类型选择菜单 | ✅ Tiptap slash command |
| 使用模板创建页面 | 新建页面时选择模板 | ❌ 未实现 |
| 页面选项 | 页面设置:图标、封面、字体、宽度、评论、历史、分享 | Partial - Page Aggregate 设置链已通但未完全对齐 |
| 搜索工作空间 | 全局搜索,Ctrl+P/Cmd+P | ✅ Search modal 已有 smoke |
| 导入与导出 | 导入/导出数据 | ❌ 未实现(Local/Cloud 桥接仅 P3 candidate |
| 页面关系图 | 页面间引用关系可视化 | ❌ 未实现 |
| 个人设置 | 账号、主题(亮/暗)、语言、通知偏好 | Partial - 暗色模式存在 |
| 空间设置 | Workspace 级设置:名称、成员、权限 | ❌ 未实现 |
| 锁定屏幕 | 密码保护屏幕 | ❌ 未实现 |
| 垃圾桶 | 已删除页面/资源的恢复和永久删除 | ✅ 已实现(`tree.resource.*`),双浏览器 no-refresh 进行中 |
## 基础块类型
| 块类型 | 说明 | mnote 现状 |
|--------|------|------------|
| 文本 | 普通正文段落 | ✅ |
| 标题 | H1/H2/H3 | ✅ |
| 列表 | 无序列表(bullet list | ✅ |
| 数字列表 | 有序列表(numbered list | ✅ |
| 待办列表 | 复选框列表(todo/checkbox | ✅ |
| 折叠列表 | 可折叠/展开的列表项(toggle / details | ❌ 未实现 |
| 页面 | 嵌入子页面块(page block / subpage | Partial - Tiptap page block? |
| 引述文字 | Blockquote 引用块 | ✅ |
| 着重文字 | Callout / 高亮块 | ❌ 未实现 |
| 代码片段 | 代码块(code block | ✅ |
| 数学公式 | LaTeX 数学公式 | ✅ |
| 分割线 | Horizontal rule | ✅ |
## 进阶块类型(基础级引用)
| 块类型 | 说明 | mnote 现状 |
|--------|------|------------|
| 数据表格 | 数据库/表格视图(类似 Notion database | ❌ 未实现(Tiptap table 有,database 无) |
| 统计图表 | 图表可视化 | ❌ |
| 简单表格 | 普通二维表格 | ✅ Tiptap table |
| 页面目录 | Table of Contents 自动生成 | ❌ 未实现 |
| 按钮 | 可交互按钮 | ❌ |
| 进度条 | 进度显示 | ❌ |
| 仪表数字 | 数字计数器 | ❌ |
| Mermaid 绘图 | Mermaid 图表 | ❌ 未实现 |
| 思维导图 | Mindmap | ✅ 已实现(Phase 6 leptos-mindmap |
| 会议 | 会议记录块 | ❌ |
| 嵌入第三方应用 | Embed iframe | Partial - OnlyOffice, 其他待定 |
| 网址书签 | URL 书签预览 | ✅ |
## 媒体与文件
| 功能 | 说明 | mnote 现状 |
|------|------|------------|
| 图片 | 插入图片 | ✅ |
| 视频 | 插入视频 | ✅ |
| 音频 | 插入音频 | ❌ |
| 文件附件 | 上传文件作为附件 | ✅ OnlyOffice adapter |
| Emoji | 文本中插入 Emoji | ✅ |
| Font Awesome 图标 | 文本中插入图标 | ❌ 未实现 |
| 动态图标 | wolai 动态图标 | ❌ |
| 卡通头像 | 生成用户头像 | ❌ |
## 信息架构/页面结构(从目录推断)
```
工作空间 (Workspace)
├── 个人空间 (Personal)
│ ├── 侧栏 (Sidebar)
│ │ ├── 搜索入口
│ │ ├── 快捷方式 / 星标 (Starred / Quick Access)
│ │ ├── 我的页面 (My Pages) — 页面树
│ │ ├── 垃圾桶 (Trash)
│ │ └── 设置入口
│ └── 页面编辑器 (Page Editor)
│ ├── 标题 (Title / Icon / Cover)
│ ├── 正文 (Body — blocks)
│ ├── 页面设置 (Page Options)
│ ├── 评论 / 历史 / 分享
│ └── 右侧边栏
│ ├── 页面目录 (TOC)
│ ├── 引用关系
│ └── 属性
└── 团队空间 (Team Workspace)
├── 成员管理
├── 权限
└── 子空间
```
## 已抓取的详细页面
以下页面已从 Wolai 帮助中心抓取详细内容,保存在 `design/11-wolai/pages/` 下:
| 页面 | 文件 | 内容 |
|------|------|------|
| 基本编辑能力 | `basic-editing-skills.md` | 块概念、块操作(拖动/选中/插入)、分栏、块转换、文本样式、快捷键 |
| 快捷命令菜单 | `quick-command-menu.md` | 完整 `/` 命令列表(基础块/进阶块/行内元素/媒体/引用/快速输入/分栏)|
| 页面选项 | `page-options.md` | 自适应宽度、小字体、标题目录、编辑保护、自定义页面、全局选项 |
| 搜索工作空间 | (参考引用) | 搜索行为、模糊搜索、搜索选项、图片文字识别 |
| 折叠列表 | (参考引用) | `+ space` 创建、折叠标题 |
| 着重文字(Callout) | (参考引用) | 图标更换、子块、跑马灯模式、`!! space` / `!!! space` 创建 |
| 导入与导出 | `import-export.md` | 8 种导入格式、6 种导出格式、空间导出 |
| 页面引用 | `page-reference.md` | `[[` / `#` 创建、双向链接、预引用、别名 |
| 页面关系图 | `page-graph.md` | 图例说明、布局方式、操作(鼠标/触控板)、3D 视图 |
| 思维导图 | `mindmap.md` | 创建/转换、节点快捷键、7 种结构、6 种主题、导出 |
| 右侧边栏 | `right-sidebar.md` | 双栏编辑、跨栏拖拽、快捷键 |
| 今日速记 | `daily-note.md` | 日记行为、默认位置/模板、快捷键 |
| 垃圾桶 | `trash.md` | 恢复/彻底删除、操作确认 |
## 完整对照矩阵
详细逐项对照见 `comprehensive-feature-matrix.md`91 项,8 大类)。
**核心数字**:覆盖率 **55%**50✅ / 16🔧 / 25❌)
| 类别 | ✅ | 🔧 | ❌ | 覆盖率 |
|------|----|-----|-----|--------|
| 基础操作 | 11 | 3 | 4 | 61% |
| 页面选项 | 10 | 5 | 2 | 59% |
| 基础块类型 | 9 | 1 | 2 | 75% |
| 进阶块类型 | 2 | 2 | 8 | 17% |
| 媒体与文件 | 4 | 0 | 4 | 50% |
| 编辑器 UI/壳 | 6 | 2 | 2 | 60% |
| 键盘快捷键 | 8 | 3 | 3 | 57% |
| **总计** | **50** | **16** | **25** | **55%** |