0.4.0 convex及界面修改
This commit is contained in:
liaibo
@@ -0,0 +1,133 @@
|
||||
# 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、验收用例），我可以继续基于本报告细化成一份实现清单（并标注建议改哪些文件/组件）。
|
||||
Reference in New Issue
Block a user