lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
af92c4b149cd483719c9a891d66ab14cddfdf3bf
mnote/design/wolai_help_center_page_ops_gap_report.md
T
liaibo af92c4b149 0.4.0 convex及界面修改
2026-02-01 08:47:40 +08:00

9.0 KiB
Raw Blame History

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（文本/结构化语料）：
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 兜底下载：

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、验收用例），我可以继续基于本报告细化成一份实现清单（并标注建议改哪些文件/组件）。

Reference in New Issue View Git Blame Copy Permalink