# Wolai 帮助中心对标：页面组成 / 页面操作缺陷项（MNOTE）

本文目的：基于 Wolai 帮助中心公开页面（含图片）做对标，把“页面组成、页面操作”相关能力整理成清单，并与当前仓库实现逐项比对，输出可落地的缺陷项与优先级。

## 1. 抓取与语料位置（可复现）

### 1.1 语料目录
- 语料根目录（最近一次抓取）：`artifacts/wolai-help-center-v5/`
- 页面（Markdown + JSON blocks）：`artifacts/wolai-help-center-v5/pages/`
- 图片（本地落盘）：`artifacts/wolai-help-center-v5/images/`
- 关键词命中：`artifacts/wolai-help-center-v5/analysis/keyword_hits.json`
- “页面相关帮助页”大纲：`artifacts/wolai-help-center-v5/analysis/outlines_页面.md`

### 1.2 复现命令
1) 导出 Wolai blocks（文本/结构化语料）：
```powershell
python scripts/wolai_help_center/export_wolai_help_center.py `
  --seed-file scripts/wolai_help_center/seeds.txt `
  --out artifacts/wolai-help-center-v5 `
  --max-pages 200 `
  --download-images
```

说明：若遇到图片 403（wostatic 缺少 `auth_key`），可使用 Playwright 兜底下载：
```powershell
node scripts/wolai_help_center/download_images_playwright.js --out artifacts/wolai-help-center-v5
```

## 2. Wolai（帮助中心）关于“页面组成 / 页面操作”的要点清单

说明：以下条目根据 `artifacts/wolai-help-center-v4/analysis/outlines_页面.md` 汇总（每项后附对标页）。

### 2.1 页面操作（Wolai：页面选项）
对标页：`pages/4TsNd1GmGB3RYbahUZy1bz__页面选项.md`

- 布局与显示：自适应宽度、小字体、标题目录（含快捷键/目录菜单/目录宽度自适应）、标题自动编号
- 安全与回退：编辑保护、撤回、页面历史
- 页面管理：删除页面、移动到…、嵌入到…
- 模板与链接：添加为空间公共模板、复制页面链接、复制页面链接（带标题）
- 引用：行内页面引用、嵌入页面引用
- 导出与统计：导出页面、字数统计、待办列表项统计
- 自定义页面：字体、布局、显示块引用数字、折叠引用页面列表、隐藏子页面、页面“嵌入到”默认位置
- 全局选项：显示块结构、拼写检查、Good Night 模式/跟随系统、导入…、飞行模式

### 2.2 页面基础与创建
对标页：`pages/iLJdcXJp8nByXA8KyWDCmN__页面.md`

- 创建页面
- 页面选项与自定义页面（入口与配置关系）

### 2.3 页面引用（双向链接）
对标页：`pages/doMqLaba4V76PByjJXacSc__页面引用.md`

- 创建页面引用入口：`[[`、`#`、文本样式工具条、快捷键
- 预引用 & 创建新页面
- 引用时创建页面的默认位置
- 复制页面引用链接
- 引用预览与别名
- 双向链接概念与常见问题

### 2.4 页面历史
对标页：`pages/6aAAjNB2E3oXiCQcCn7grX__页面历史.md`

### 2.5 页面权限与协作访客
对标页：
- `pages/rMnSw1JTt6EhRq5U6xmxYz__页面权限.md`
- `pages/8XtDuVgByhv7SDKAykmJDj__为页面添加协作访客进行协作.md`

- 权限：对象、类别、优先规则、最小规则、继承与覆盖、设定自己的权限
- 协作访客：添加/人数上限/权限调整/管理/移除/升级为空间成员/退出空间

### 2.6 页面关系图
对标页：`pages/ipygGPjLvTLMYYPyW2RDw6__页面关系图.md`

- 关系图说明、选项（布局方式/关系/最佳视图）
- 关系图操作（触控板/鼠标）
- 3D 关系图与操作
- 快捷键、单页面关系图

### 2.7 评论（页面/块）
对标页：`pages/urDEXF1q5AiBdqiqV6SYbX__对页面或块进行评论.md`

- 页面评论、块评论、选中文字评论、回复评论、页面评论聚合

## 3. 当前项目实现对照（基于仓库代码扫描）

### 3.1 已覆盖/已有雏形
- 页面选项（部分）：`wolai-frontend/src/components/editor/page-options-sidebar.tsx`
-  - 页面选项：自适应宽度、小字体、标题目录、标题编号、编辑保护、字数提示
-  - 页面操作：撤回/重做、移动/嵌入、添加为模板、复制页面链接（含标题）、行内/嵌入页面引用、删除页面、导出、历史、评论入口
- 标题目录：快捷键 `Ctrl/Cmd + Shift + L`；目录菜单（层级/完整标题/关闭）：`wolai-frontend/src/components/editor/document-toc.tsx`
- 待办统计：统计 `todoTotal/todoDone` 并展示：`wolai-frontend/src/components/editor/blocknote-editor.tsx`、`wolai-frontend/src/components/editor/page-options-sidebar.tsx`
- 自定义页面（部分）：折叠反向引用：`wolai-frontend/src/components/editor/page-backlinks-panel.tsx`
- 全局选项（个人环境）：显示块结构/拼写检查/主题/飞行模式：`wolai-frontend/src/store/app-preferences.ts`、`wolai-frontend/src/components/providers/app-preferences-hydrator.tsx`
- 评论（页面/块）：`wolai-frontend/convex/comments.ts`、`wolai-frontend/src/components/editor/document-comments-drawer.tsx`
- 页面历史（临时快照，非 Wolai“5 分钟服务器快照”）：`wolai-frontend/src/components/editor/document-history-drawer.tsx`
- 页面引用/反向链接（基础）：`wolai-frontend/src/components/editor/page-backlinks-panel.tsx`、`wolai-frontend/src/components/editor/blocks/PageReferenceBlock.tsx`
- 共享/权限（基础）：`wolai-frontend/src/components/sharing/document-share-dialog.tsx`
  - 公开/共享、只读/可编辑、禁止下载/禁止复制（存在“后端未更新”的提示分支）
- 删除/恢复/清空垃圾桶等：`wolai-frontend/src/app/api/documents/*` 与 `wolai-frontend/src/components/sidebar/sidebar.tsx`

### 3.2 缺陷项（与 Wolai 帮助中心对标）

#### P0：影响核心闭环（协作/数据安全/关键入口缺失）
- 评论（已新增模块，但能力未对齐）：Wolai 支持页面/块/选中文字评论、未解决数量气泡、关闭/重新打开、编辑/删除、评论聚合筛选；当前实现已覆盖“页面/块评论 + 回复 + 解决/未解决”，但缺少“选中文字评论/高亮样式/气泡计数/编辑删除/聚合筛选/快捷键 `Ctrl/Cmd + Alt/Opt + M`”。
- 页面关系图：Wolai 帮助中心定义了完整的 2D/3D 关系图与交互；按你的 P0 指令“暂不需要页面关系”，当前可保持缺口（建议仅保留入口一致性，避免误导）。
- 权限规则：按你的 P0 指令“暂不改变”，当前不动；但后续若统一 mindmap / luckysheet / 文件树共享，建议补齐“继承/覆盖/优先/最小规则”的产品说明与 UI（避免割裂）。

#### P1：对标体验差（入口分散/选项不全/统计缺口）
- “页面选项”仍有细节缺口：
  - “添加为空间公共模板”：当前为 `is_template`（模板区可见），但未区分“多人空间公共模板/权限限制/取消模板”。
  - “导出页面”：当前导出为 JSON 快照；缺少多格式导出（与“空间安全设置禁用导出”联动）。
  - “页面历史”：当前为前端临时快照；缺少 Wolai“每 5 分钟生成服务器快照 + 版本浏览 + 恢复此版本”。
  - “字数统计”：当前只有字/字符/块/待办；缺少悬浮展开的分类统计。
- “自定义页面”不完整：Wolai 自定义页面包含字体/布局/隐藏子页面/显示块引用数字/嵌入默认位置等；当前仅实现“折叠反向引用”。
- “标题目录”宽度自适应：当前已增加基础自适应宽度，但缺少 Wolai 的“极窄圆点竖线”样式与目录项层级折叠按钮。
- “全局选项”缺口：Wolai 全局含“导入…”入口；当前未对齐（功能可能在其它入口，需确认是否纳入 P1）。

#### P2：增强项（可后置，但建议纳入路线图）
- 协作访客：Wolai 有“协作访客”这一权限对象；当前未看到对应模型与入口（可能需要与群组/邀请体系结合重做）。
- 拼写检查 / Good Night / 跟随系统 / 飞行模式：已实现基础能力与快捷键（主题/块结构），但仍需补齐更多 Wolai 式入口与文案（例如：空间层默认开关）。

## 4. 对 mindmap / luckysheet / VSCode 文件树共享的统一建议（避免割裂）

当前项目已加入 mindmap、luckysheet 与 VSCode 文件树/共享能力；为了让“页面操作”一致，建议把以下能力抽象为跨类型统一的“文档资源操作层”（页面/表格/思维导图/文件 都走同一套）：

- 权限与共享：继承/覆盖规则与 UI 一致；“只读/可编辑/禁止复制/禁止下载”对所有资源类型都可用且可验证。
- 历史与回滚：页面、表格、思维导图、文件都能产生“可恢复历史”（至少保存点 + 恢复确认 + 只读保护）。
- 关系图与评论：关系图节点不仅是“页面”，也能包含表格/思维导图/文件；评论可挂载到“资源”或“块/节点/单元格”。

---

如果你希望我下一步直接把这些 P0/P1 缺陷项拆成可执行任务（每项：入口、数据模型、接口、UI、验收用例），我可以继续基于本报告细化成一份实现清单（并标注建议改哪些文件/组件）。
