lix/mnote
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

对齐 Wolai 编辑器搜索与文档画布

Browse Source
This commit is contained in:
lix-2026
2026-04-30 18:36:50 +08:00
parent afb2a5b8a0
commit 2b88ecb4b9
14 changed files with 317 additions and 138 deletions
Download Patch File Download Diff File Expand all files Collapse all files
design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md
+105 -19
View File
@@ -208,32 +208,118 @@ RED / GREEN：
| ID | 状态 | 任务 | 验收要点 |
| --- | --- | --- | --- |
| C1 | TODO | 顶栏高度与按钮密度 | 顶栏约 40px；按钮轻量 hover；右侧 icon/text 序列不重 |
| C2 | TODO | breadcrumb | 图标、分隔符、弱色文字、截断方式对齐；切页后与页面树同步 |
| C3 | TODO | owner/published 按钮分型 | owner 与 published 的按钮组合分开；不把 published 文案硬塞 owner 态 |
| C4 | TODO | 顶栏搜索入口 | 点击打开全局搜索 modal，URL 不变，焦点进入输入框 |
| C5 | TODO | 侧栏搜索入口 | 打开同一个全局搜索 modal 或明确的树过滤入口；不得误跳 `/search` |
| C6 | TODO | 搜索 modal 默认状态 | `仅匹配标题`、`页面内搜索` 为 switch 且默认开启；不是普通 pill button |
| C7 | TODO | 搜索 modal 关闭路径 | Esc、遮罩、再次 `Ctrl+P`、入口 toggle 按 Wolai 实测对齐 |
| C8 | TODO | 搜索结果行 | 匹配数量、命中高亮、快捷键提示、结果 icon、所在页面信息对齐 |
| C9 | TODO | 搜索空态/加载态 | 输入无结果和加载时的视觉与 DOM 状态可被 smoke 捕获 |
| C10 | TODO | 搜索入口/快捷键矩阵 | 分别验证 Wolai 左侧搜索、顶栏/侧栏入口、`Ctrl+P`、`Ctrl+K`；每个入口记录 URL、打开/关闭路径和阻塞 |
| C11 | TODO | 搜索结果 fixture | 固定本地 `Hermes` 或等价种子数据，避免用随机工作区数据对比 Wolai 结果态 |
| C1 | PARITY | 顶栏高度与按钮密度 | `task135` 覆盖顶栏约 40px、右侧按钮组无搜索入口、icon 不再渲染成黑色方块；`task119` 复核 topbarHeight=40 |
| C2 | PARITY | breadcrumb | `task135` 覆盖 breadcrumb 当前标题绑定、弱色分隔符改为 Wolai chevron；真实父路径数据仍依赖后续 Page Aggregate / tree projection |
| C3 | PARITY | owner/published 按钮分型 | `task135` 覆盖 owner 顶栏绿色 `全网公开`，右侧按钮组从本地 AI/搜索收敛为 Wolai owner 态常见按钮序列 |
| C4 | PARITY | 顶栏搜索入口基线纠偏 | 2026-04-30 Wolai owner 当前 viewport 顶栏无搜索入口；本地已移除顶栏搜索按钮，搜索统一走侧栏入口 / `Ctrl+P` |
| C5 | PARITY | 侧栏搜索入口 | `task135` 覆盖侧栏左上搜索打开同一个全局搜索 modal，URL 不变；modal 打开时再次点击侧栏搜索会关闭 |
| C6 | PARITY | 搜索 modal 默认状态 | `task135` 按最新 Wolai 实测修正：空 query 先显示最近浏览，不直接显示筛选；输入后 switch 出现，`仅匹配标题` / `页面内搜索` 为 switch 且默认关闭 |
| C7 | PARITY | 搜索 modal 关闭路径 | `task135` 覆盖 Esc、主区域遮罩、再次 `Ctrl+P`、侧栏入口 toggle；URL 均不变 |
| C8 | PARITY | 搜索结果行 | `task135` 覆盖后台 API 结果、匹配数量、红色命中高亮、快捷键提示、结果 icon、结果 owner 标记 |
| C9 | PARITY | 搜索空态/加载态 | `task135` 覆盖空 query 最近浏览、输入后 loading、无结果 `没有搜索结果`，DOM 可断言 `data-search-loading` / `data-search-empty` |
| C10 | PARITY | 搜索入口/快捷键矩阵 | `task135` 和 subagent baseline 确认：侧栏搜索 / `Ctrl+P` 是搜索入口；`Ctrl+K` 按当前 Wolai 实测不打开搜索 |
| C11 | PARITY | 搜索结果 fixture | `task135` 固定本地 `Rust` / `Hermes` fallback fixture，并断言 modal 调用 `/api/search/documents` 而不是 DOM 前端过滤 |
### 6.1 task135 Phase C 执行记录
2026-04-30 已完成 Phase C：顶栏、breadcrumb、owner/published、搜索入口与搜索 modal。执行口径按 `wolai-aline` skill：subagent 先取 Wolai / 本地基线，主线程复核截图后补 RED smoke；实现后本地 smoke 通过，并已派 subagent 做 post-fix 复测。
RED：
- 新增 `scripts/task135-wolai-aline-phase-c-smoke.js`，初始失败于顶栏高度 `44px`、公开态文案 `Public`、顶栏多搜索入口、搜索 modal 未调用 `/api/search/documents`。
- subagent 基线纠偏：当前 Wolai `Ctrl+K` 不打开搜索；空 query 不直接显示筛选控件；输入后 `仅匹配标题` / `页面内搜索` switch 本次实测为关闭态。
GREEN：
- `rust/crates/mnote-web/src/ssr/pages/layout.rs`：顶栏公开态改为 `全网公开`，移除顶栏搜索入口，右侧按钮组对齐 owner 态；侧栏搜索入口改为 toggle；搜索 modal 输入改为 `type=search`，空 query 显示最近浏览，输入后调用 `/api/search/documents`，结果区标记 `data-search-results-owner="rust-kernel"`。
- `rust/crates/mnote-web/src/ssr/styles.rs`：顶栏高度收敛到 40px；搜索遮罩支持侧栏入口穿透 toggle，同时保留主区域遮罩关闭；补齐右侧按钮与结果图标 mask，避免黑色方块；搜索高亮统一红色弱底。
- `rust/crates/mnote-web/src/routes/search.rs`：fallback 搜索数据补 `Hermes` / `技能知识图谱开发` fixture，避免本地结果态依赖随机工作区数据。
- `scripts/task128-rust-web-wolai-search-modal-smoke.js`：同步当前 Wolai 基线，改为侧栏 / `Ctrl+P` 入口和 switch 默认关闭。
验证命令：
- `cargo fmt -p mnote-web --check`
- `cargo check -p mnote-web`
- `cargo build -p mnote-web --bin mnote-web`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task135-wolai-aline-phase-c-smoke.js`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task128-rust-web-wolai-search-modal-smoke.js`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task125-rust-web-search-server-first-smoke.js`
- `node scripts/task119-rust-web-wolai-visual-regression-smoke.js`
证据路径：
- Phase C subagent 基线矩阵：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task135-phase-c-baseline/comparison-matrix.md`
- Wolai Hermes 搜索基线：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task135-phase-c-baseline/wolai-search-hermes.png`
- 本地 Phase C 最终截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task135-phase-c/local-phase-c-search.png`；post-fix subagent 本地复核：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task135-phase-c-postfix/local-10-query-hermes.png`
- 本地搜索 modal smoke 截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/local-search-modal/local-3000-search-modal.png`
主线程复核结论：
- 搜索不再只是 UI 壳：modal 输入会调用 `/api/search/documents`，请求体包含 query 和 switch filter，结果区有 `data-search-results-owner="rust-kernel"`。
- 当前 Wolai 基线推翻了旧 checklist 的两个假设：`Ctrl+K` 不是搜索入口；`仅匹配标题` / `页面内搜索` 在本次输入态实测为关闭态。
- 本地 `Hermes` fixture 只能证明结果态结构、后台链路和高亮；不代表本地已经有 Wolai 真实空间数据。
- 顶栏/breadcrumb 的父路径层级仍受本地 Page Aggregate / tree projection 数据限制；本阶段只完成控件、入口、状态和同步锚点的对标。
- post-fix subagent 复测矩阵：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task135-phase-c-postfix/comparison-matrix.md`；复核确认本地右上角不再有黑色方块，侧栏搜索 toggle、`Ctrl+P` toggle、`Ctrl+K` 不打开、空 query 最近浏览、后台搜索 API、结果 icon/高亮均通过。
## 7. Phase D：文档画布与阅读态
| ID | 状态 | 任务 | 验收要点 |
| --- | --- | --- | --- |
| D1 | TODO | 主内容列宽 | 普通文档列宽约 760px；大屏不贴左；移动端不溢出 |
| D2 | TODO | 标题位置与样式 | Hermes 标题 y 位置、`34px / 44px / 600`、颜色接近 Wolai |
| D3 | TODO | 默认隐藏 meta/debug 行 | 普通文档默认不显示不像 Wolai 的工作区 meta、横线、debug outline |
| D4 | TODO | 正文段落 | `16px / 24px`、段间距、弱色文本与 Wolai 对齐 |
| D5 | TODO | 任务块 | checkbox 尺寸、边框、文本 baseline、完成态接近 Wolai |
| D6 | TODO | 引用/列表/标题块 | 阅读态块样式不跳出 Wolai 密度；截图覆盖至少三类块 |
| D7 | TODO | 右下角浮动入口 | AI / 帮助入口减重，尺寸和位置接近 Wolai，不遮挡正文 |
| D8 | TODO | 阅读态和编辑态切换 | 切换时标题、正文列宽、scroll 位置不明显跳动 |
| D1 | PARITY | 主内容列宽 | `task136` 覆盖普通文档主列 `760px`，大屏居中不贴左；移动端沿既有 media query 保持不溢出 |
| D2 | PARITY | 标题位置与样式 | `task136` 按 Wolai 基线收敛到 y≈108、`34px / 44px / 600`、颜色接近 Wolai |
| D3 | PARITY | 默认隐藏 meta/debug 行 | `task136` 断言普通文档默认不显示 workspace/已同步 meta、大号页面 icon、debug 文案和横线 |
| D4 | PARITY | 正文段落 | `task136` 覆盖正文 `16px / 24px`，标题到正文间距按 Wolai 基线加大 |
| D5 | PARITY | 任务块 | `task136` 固定 Tiptap fixture 并断言渲染后存在 `input[type=checkbox]`，尺寸 16px；补齐 kernel `todo` 类型到 Tiptap taskList 的转换 |
| D6 | PARITY | 引用/列表/标题块 | `task136` 覆盖 heading、blockquote、bulletList；补齐 `bullet_list_item` / `numbered_list_item` 映射避免降级段落 |
| D7 | PARITY | 右下角浮动入口 | `task136` 覆盖 AI / 帮助入口 40px、AI 在上、间距约 16px、底部留白约 44px，不遮挡正文 |
| D8 | PARITY | 阅读态和编辑态切换 | `task136` 覆盖标题 focus、编辑器 focus 后标题 y/x 不跳动；subagent baseline 同样确认点击后布局稳定 |
| D9 | PARITY | 普通文档首屏入口语义 | `task130` 已覆盖 RED/GREEN，subagent 最终对标复核通过：根页不再停在“打开当前页面”入口，直接出现 document shell + editor island |
### 7.1 task136 Phase D 执行记录
2026-04-30 已完成 Phase D：文档画布与阅读态。执行口径按 `wolai-aline` skill：subagent 先取 Wolai / 本地只读基线，主线程复核截图后补 RED smoke；实现后本地 smoke 与相关回归通过，并已派 subagent 做 post-fix 复测。
RED：
- 新增 `scripts/task136-wolai-aline-phase-d-smoke.js`，初始失败于本地文档主列 `880px`，后续增强断言捕获标题 y 偏低、标题到正文间距偏小、右下浮动入口间距/底部位置旧基线。
- 基线截图确认 Wolai 标题为 y≈108、`34px / 44px / 600`；普通文档无 workspace/已同步 meta 行和大号页面 icon；右下入口为 40px，AI 在帮助上方，按钮间距约 16px，底部留白约 44px。
- smoke 还暴露后台链路差异：保存 Tiptap fixture 后，`/api/documents/content` 返回 `todo` / `bullet_list_item` 等 kernel 规范化类型，但浏览器 bootstrap 只识别旧类型，导致任务块和列表降级为普通段落。
GREEN：
- `rust/crates/mnote-web/src/ssr/styles.rs`：文档主列收敛到 760px；标题改为 `34px / 44px / 600` 且 y≈108；普通文档隐藏页面大 icon 与 meta/debug 行；正文行高 24px；补 task checkbox、blockquote、list 样式；右下浮动入口减重为 40px，AI 在上、帮助在下，间距 16px、底部留白 44px。
- `rust/crates/mnote-web/src/routes/web_shell.rs`：`legacyBlockToTiptap` 同时识别旧类型和 kernel 规范化类型：`todo`、`bullet_list_item`、`numbered_list_item`、`blockquote`。
- `rust/crates/mnote-web/src/routes/editor.rs`：runtime block 类型映射同步兼容 kernel 规范化类型，避免编辑器链路继续把任务/列表块当成 media 或段落。
- `scripts/task119-rust-web-wolai-visual-regression-smoke.js`：按本次 Wolai 基线更新右下浮动入口顺序、间距和底部留白断言，避免旧 Stitch 目标覆盖当前实测。
验证命令：
- `cargo fmt -p mnote-web --check`
- `cargo check -p mnote-web`
- `cargo build -p mnote-web --bin mnote-web`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task136-wolai-aline-phase-d-smoke.js`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task121-rust-web-editor-island-hydration-smoke.js`
- `node scripts/task119-rust-web-wolai-visual-regression-smoke.js`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task128-rust-web-wolai-search-modal-smoke.js`
- `MNOTE_UI_BASE_URL=http://127.0.0.1:3000 node scripts/task135-wolai-aline-phase-c-smoke.js`
证据路径：
- Phase D subagent 基线矩阵：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task136-phase-d-baseline2/comparison-matrix.md`
- Wolai Phase D 基线：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task136-phase-d-baseline2/wolai-01-first.png`
- 本地 Phase D 最终截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task136-phase-d/local-phase-d-document.png`
- Phase D subagent post-fix：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task136-phase-d-postfix/comparison-matrix.md`
主线程复核结论：
- 本地文档画布主列、标题字号/行高/字重、标题 y、meta/icon/debug 隐藏、正文行高、任务/引用/列表渲染、右下浮动入口尺寸/顺序/间距已被 smoke 固化。
- subagent post-fix 在根文档截图中复核标题 y=108、列宽 760、字号 34/字重 600、meta/icon/debug 不可见、浮动入口 40px/16px/44px、点击后不跳动。
- 当前本地 fixture smoke 能证明后台内容链路不再把任务块和列表降级为普通段落；post-fix 根文档缺少任务/引用/列表内容，因此这三类块的真实视觉细节仍以后续 Phase E editable-test 或专门 fixture 页面继续细化。
- 剩余差异：本地页面标题来自临时 fixture，文案与 Wolai Hermes 不同；Wolai 真实 per-page icon 数据仍未进入本地 projection，按 Phase B 结论不伪造。
## 8. Phase E：主编辑器块交互
| ID | 状态 | 任务 | 验收要点 |