收口 Rust Web 入口与 AI 写入链

- 将 3000 主入口继续收口到 mnote-web，补齐 /favicon.ico、/api/auth、session alias、AI run 等 Rust Web 路由边界。 - 更新登录页与 Convex Auth 代理，支持测试账号快速登录写入真实 Convex Auth cookie。 - 推进页面设置、Wolai 对齐、Phase 7 AI kernel/CLI-first 设计文档与相关 smoke 脚本。 - 更新 leptos-tiptap 生成资产、mnote-cli/bridge-runtime、前端依赖和 dev/prod 启动脚本。
2026-05-06 21:44:20 +08:00
parent 98b6360595
commit e8ba12e461
86 changed files with 8872 additions and 1716 deletions
@@ -0,0 +1,541 @@
+# 5-10 [process] Wolai 页面设置与 AI 交互壳对齐方案 v1
+
+> 更新时间：2026-05-06
+>
+> 关联文档：
+> - `/mnt/Data1T/mnote/ARCHITECTURE.md`
+> - `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md`
+> - `/mnt/Data1T/mnote/design/07-ai/process/7-phase7-ai-kernel-projection-plan-v4.md`
+> - `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`
+
+## 1. 文档目的
+
+这份文档只回答一个问题：
+
+> **在不制造第二份页面真相、不重开一条 AI 执行面的前提下，如何把 `3000` 文档页的“页面设置”和“AI 界面”收口成更接近 Wolai 的交互壳。**
+
+这次不处理整条文档页体验复刻，也不把评论、协作、演示模式一起打包推进。
+
+本轮优先级固定为：
+
+1. 页面设置入口与面板形态
+2. 页面级 AI 入口与右侧抽屉
+3. 两者与现有 `Page Aggregate` / `mnote-cli` 主线的接线方式
+
+一句话收口：
+
+> **先把“入口和容器”做对，再逐项把内部动作接到现有正式命令链。**
+
+---
+
+## 2. 当前判断
+
+### 2.1 当前 `3000` 的问题不是“没有能力”，而是“能力挂错了壳”
+
+当前仓库里已经有可复用能力：
+
+- 页面设置 UI 已存在：`PageOptionsSidebar`
+- 页面设置写链已存在：`page.layout.updateOptions`
+- 页面 AI host 已存在：`DocumentAiAgentPanel`
+- AI 执行面已收口到 `mnote-cli` host / client
+- 评论 drawer、历史 drawer、分享 dialog 都已有各自最小实现
+
+但当前现网文档页仍然存在两个明显错位：
+
+- 页面设置还是“右侧整块 inspector”思路，不是 Wolai 的右上角 `...` 贴边 popover
+- 页面 AI 主要还是顶栏“页面AI”按钮思路，不是 Wolai 的右下角浮动入口 + 右侧抽屉
+
+因此本轮不应重写一套新产品，而应优先做：
+
+> **现有能力重新编排到正确交互壳。**
+
+### 2.2 当前不该做的事
+
+本轮明确不做：
+
+- 不新造第二套页面设置数据结构
+- 不新造第二套页面 AI runtime
+- 不把 Web AI 面板重新升格成独立 AI 编排主线
+- 不为了像 Wolai 而把评论、协作、成员、演示模式一并拉进首批实现
+- 不在 Rust SSR 和 React compat 层同时各做一套相同按钮逻辑
+
+---
+
+## 3. Wolai 基线
+
+2026-05-06 已通过 `wolai-aline` 基线取证得到当前 Wolai 行为证据，截图目录：
+
+- `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/`
+
+关键结论如下。
+
+### 3.1 页面设置
+
+- 入口位于右上角 `...`
+- hover tooltip 为“页面选项和全局选项”
+- 点击后打开右侧贴边 `popover`，不是 modal，也不是新页面
+- URL 保持不变
+- 没有遮罩，不压暗背景
+- 关闭方式为：
+  - `Esc`
+  - 点击页面空白处
+  - 再次点击同一入口
+- 顶部为 `页面选项 / 自定义页面 / 全局选项` 三个 tab
+- 可见开关为 checkbox 形态
+- 当前主 tab 内有：
+  - `自适应宽度`
+  - `小字体`
+  - `标题目录`
+  - `标题自动编号`
+  - `编辑保护`
+- 下方还有动作项：
+  - `删除页面`
+  - `移动到...`
+  - `嵌入到...`
+  - `页面历史...`
+  - `公开分享页面...`
+
+### 3.2 AI 界面
+
+- 入口位于右下角浮动 `AI` 按钮
+- 点击后打开右侧抽屉，不改 URL
+- 抽屉没有遮罩，不压暗背景
+- 当前关闭方式只有右上角 `X`
+- `Esc` 无效
+- 点击页面空白处无效
+- 入口按钮在抽屉打开后被覆盖，不承担 toggle 关闭语义
+- 抽屉标题为“智能问答”
+- 中部存在推荐问题/快捷入口
+- 底部存在会话区、模型入口、输入框和发送按钮
+
+这说明本轮对齐的最小行为合同已经足够明确：
+
+> **页面设置是“顶栏入口 + 贴边 popover”；页面 AI 是“右下角入口 + 右侧抽屉”。**
+
+---
+
+## 4. 设计原则
+
+### 4.1 页面设置继续服从 `Page Aggregate`
+
+页面设置只能是：
+
+- `pageOptions`
+- `editorRuntimePageOptions`
+- 对应的 `page.layout.updateOptions`
+
+不能变成：
+
+- 某个单独 UI 组件内部维护的临时配置真相
+- 一套只在文档页壳层生效、却不进入主编辑器 runtime 的新设置体系
+
+因此，页面设置改造的重点不是多做几个开关，而是：
+
+> **把现有设置项放进更接近 Wolai 的容器，同时继续显式区分“已正式接通”和“仅保存字段/待接通”。**
+
+### 4.2 页面 AI 继续服从 `CLI-first`
+
+页面 AI 界面可以继续做产品壳，但它不能重新变成独立执行面。
+
+当前长期方向已经明确：
+
+- `mnote-cli` 是唯一长期 agent 执行面
+- Web AI 面板只是 host / client
+
+因此本轮 AI 界面改造只处理：
+
+- 入口位置
+- 抽屉壳形态
+- 页面级上下文绑定
+- 与现有 `DocumentAiAgentPanel` 的挂载方式
+
+本轮不处理：
+
+- AI runtime 重写
+- 新模型编排
+- 新工具协议
+- 第二套全局 AI 路由
+
+### 4.3 先对齐容器语义，再推进动作项
+
+Wolai 里页面设置和 AI 的第一感受，首先是：
+
+- 从哪里打开
+- 打开成什么容器
+- URL 是否变化
+- 如何关闭
+
+这四项比内部是否一开始就全部可用更重要。
+
+因此本轮优先级必须是：
+
+1. 入口位置和按钮密度对齐
+2. 容器形态和开关语义对齐
+3. 内部动作项逐项复用现有能力
+
+---
+
+## 5. 本轮范围
+
+### 5.1 范围内
+
+- 文档页 owner 态右上角 `...` 页面设置入口
+- 页面设置 `popover` 容器
+- 页面设置 `tablist` 和最小项分组
+- 页面设置最小动作项接线策略
+- 文档页右下角浮动 `AI` 入口
+- 页面 AI 右侧抽屉容器
+- 页面 AI 与现有 `DocumentAiAgentPanel` 的页面级绑定
+- 相应 smoke、截图和差异矩阵
+
+### 5.2 暂不进入本轮
+
+- 演示模式
+- 页面评论
+- 页面协作
+- 成员邀请
+- 完整公开分享体验重做
+- 全局 AI 面板收口
+- 帮助中心浮动入口的完整 Wolai 化
+- AI 内部推荐内容、模型文案、提示词体系大改
+
+补充：
+
+- `页面历史...` 和 `公开分享页面...` 因为当前已有最小能力，可以作为本轮页面设置动作项的优先复用对象
+- 评论、协作、成员这类能力虽然在 Wolai 顶栏可见，但当前不进入首批实现
+
+---
+
+## 6. 目标交互合同
+
+## 6.1 页面设置
+
+### 6.1.1 入口
+
+- 入口继续位于文档页右上角操作区
+- 视觉上以 `...` 弱按钮承载
+- tooltip 调整为“页面选项和全局选项”
+- 不再把“页面设置”理解成常驻右侧栏
+
+### 6.1.2 容器
+
+- 使用右侧贴边 `popover`
+- 不使用全屏 modal
+- 不使用带遮罩的 `Sheet`
+- 打开后 URL 不变
+- 面板宽度以 Wolai 的紧凑设置面板为准，不沿用当前宽侧栏比例
+
+### 6.1.3 关闭语义
+
+- `Esc` 关闭
+- 点击空白关闭
+- 再次点击入口关闭
+
+### 6.1.4 内容结构
+
+顶部固定三 tab：
+
+- `页面选项`
+- `自定义页面`
+- `全局选项`
+
+页面选项首批保留并对齐的设置项：
+
+- `wideLayout`
+- `smallText`
+- `showToc`
+- `showHeadingNumbers`
+- `protectEditing`
+
+自定义页面首批保留：
+
+- `pageFont`
+- `layoutDensity`
+- `collapseBacklinks`
+- `hideChildPages`
+- `showBlockRefCount`
+- `embedDefaultBlockId`
+
+全局选项首批只保留当前已有全局偏好中与文档体验直接相关的最小项，不在本轮扩面。
+
+### 6.1.5 动作项
+
+页面设置面板中的动作项分三类：
+
+1. 本轮直接接线
+   - `页面历史...`
+   - `公开分享页面...`
+
+2. 本轮保留入口但延后落地
+   - `移动到...`
+   - `嵌入到...`
+   - `删除页面`
+
+3. 本轮不放入页面设置面板
+   - 评论
+   - 协作
+   - 成员邀请
+   - 演示模式
+
+设计原因：
+
+- `历史` 和 `分享` 当前已有组件可复用
+- `移动到 / 嵌入到 / 删除` 与树命令、确认流和 picker 交互更深，应拆成后续小任务
+- 评论/协作不在本轮优先级内
+
+## 6.2 页面 AI
+
+### 6.2.1 入口
+
+- 文档页主入口改为右下角浮动 `AI` 按钮
+- 顶栏“页面AI”不再作为主入口
+- 首批可以先去掉顶栏 `页面AI`，或把它降为 debug/临时入口，不再作为默认视觉路径
+
+### 6.2.2 容器
+
+- 使用右侧抽屉
+- 不使用遮罩
+- 打开后 URL 不变
+- 抽屉属于“页面级 AI”，不是全局 AI
+
+### 6.2.3 关闭语义
+
+- 右上角 `X` 关闭
+- `Esc` 不关闭
+- 点击页面空白不关闭
+- 不要求入口按钮承担 toggle 关闭
+
+### 6.2.4 内容结构
+
+抽屉内部继续复用现有 `DocumentAiAgentPanel` 与其 runtime。
+
+本轮只改：
+
+- 外层 chrome
+- 标题区与关闭按钮
+- 页面级容器布局
+- 文档页入口位置和打开方式
+
+本轮不改：
+
+- `mnote-cli` 执行链
+- 工具注册表
+- 页面 AI 读写命令族
+- AI 输出协议
+
+### 6.2.5 页面级与全局级边界
+
+页面文档内优先展示“页面级 AI”。
+
+全局 AI 继续保留其现有能力，但不在本轮文档页里抢主入口。长期关系应为：
+
+- 文档页浮动 AI：页面上下文优先
+- 全局 AI：跨页面/全局工作区能力
+
+---
+
+## 7. 实现落点
+
+## 7.1 顶栏与入口层
+
+当前文档页右上角操作主入口仍由：
+
+- `wolai-frontend/src/components/breadcrumb.tsx`
+
+负责。
+
+因此本轮入口层优先落在 React compat 主路径，而不是先去大改 Rust SSR 占位按钮。
+
+首批调整建议：
+
+- `Breadcrumb` 负责右上角 `...` 入口
+- `Breadcrumb` 不再突出“页面AI”主按钮
+- 浮动 AI 入口改由文档页内容壳或页面级 host 提供
+
+理由：
+
+- 当前现网入口真正在这里
+- 直接改这里可以最小改动验证体验
+- 先把交互壳对齐，再决定 Rust SSR 侧是否同步收口
+
+## 7.2 页面设置面板组件
+
+当前 `PageOptionsSidebar` 是一个“常驻侧栏”组件，形态上不适合直接复用为 Wolai popover。
+
+建议拆成两层：
+
+1. `PageOptionsPanelContent`
+   - 只负责 tab、设置项、动作项内容
+   - 不假设自己是 `aside`
+
+2. `PageOptionsPopover`
+   - 负责定位、宽度、开关语义、关闭语义
+   - 作为文档页 owner 态页面设置入口的正式容器
+
+同时保留：
+
+- `PageOptionsSidebar`
+
+作为兼容/开发容器，避免 dev playground 与旧测试全部失效。
+
+### 7.2.1 页面设置状态
+
+当前 `usePageLayoutStore.showInspector` 语义过于偏“右侧常驻 inspector”。
+
+本轮建议把它改造成更接近“页面 chrome 状态”的命名，例如：
+
+- `pageSettingsOpen`
+
+或等价 surface state，但不要把 AI 和页面设置混成一个大 store。
+
+最小原则：
+
+- 页面设置开关状态独立
+- 不影响 AI drawer store
+- 不重新发明 `pageOptions` 数据真相
+
+## 7.3 页面设置动作项接线
+
+动作项接线优先复用现有能力：
+
+- `页面历史...` -> `DocumentHistoryDrawer`
+- `公开分享页面...` -> `DocumentShareDialog`
+
+本轮延后：
+
+- `移动到...`
+- `嵌入到...`
+- `删除页面`
+
+这些项可以先作为 disabled/coming soon，或只在 checklist 中保留为后续项，但不要假装完成。
+
+## 7.4 页面 AI host
+
+页面 AI 的正式 runtime 继续使用：
+
+- `DocumentAiAgentPanel`
+- `DocumentAiAgentPanel.runtime`
+
+本轮只需要把“谁来打开它、以什么容器打开它”改对。
+
+建议：
+
+- 页面级浮动 AI 入口挂在 `DocumentContent` 这一层
+- 页面 AI 打开状态继续用 `useAiAgentUiStore.documentAgentOpen`
+- 页面 AI 可用态继续由 `DocumentAiAgentPanel` mount 生命周期维护
+
+需要避免：
+
+- 再新增一份 `PageAiDrawer` 独立 runtime
+- 把页面 AI 又接回 `GlobalAiAgentHost`
+
+## 7.5 与 Rust SSR 的关系
+
+Rust `mnote-web` 当前在文档壳中已有顶栏占位按钮与右下角浮动按钮。
+
+本轮不把 Rust SSR 作为首批真实交互 owner，原因是：
+
+- 当前现网文档页真实入口仍由 React compat 壳主导
+- 先在 React compat 层做对入口与容器，风险更低
+- 等行为稳定后，再决定是否把 Rust SSR 占位按钮收口到同一 contract
+
+这意味着本轮的正确做法是：
+
+> **先统一产品行为合同，再决定是否让 Rust SSR 与 React compat 共用同一套入口渲染。**
+
+---
+
+## 8. 分阶段实施建议
+
+## 8.1 Phase A：设计与基线冻结
+
+- 固定 Wolai 页面设置和 AI 抽屉的动作链基线
+- 新增专属 checklist
+- 明确哪些页面设置项本轮保留、隐藏、降级
+- 明确页面 AI 与全局 AI 的入口边界
+
+## 8.2 Phase B：页面设置交互壳
+
+- 把 `PageOptionsSidebar` 抽成可复用内容组件
+- 文档页顶栏 `...` 接入 `PageOptionsPopover`
+- 对齐关闭语义、URL 不变、无遮罩
+- 最小接线 `历史` 与 `分享`
+
+## 8.3 Phase C：页面 AI 交互壳
+
+- 增加右下角浮动 `AI` 入口
+- 让页面 AI 通过右侧抽屉打开
+- 去掉顶栏“页面AI”主入口地位
+- 对齐 AI drawer 的关闭语义
+
+## 8.4 Phase D：动作项与回归补齐
+
+- 页面设置中逐步接通 `移动到 / 嵌入到 / 删除`
+- 评估是否追加帮助浮动入口对齐
+- 为 owner/published 两种状态补差异 smoke
+
+---
+
+## 9. 风险与约束
+
+### 9.1 双 owner 风险
+
+当前 `3000` 仍有：
+
+- Rust SSR 产品壳
+- React compat 真正交互壳
+
+如果同时在两边各自补交互，容易再次分裂。
+
+本轮约束：
+
+> **入口行为先只认一套真实 owner。**
+
+### 9.2 页面设置“看起来能改，实际没生效”的风险
+
+这仍是页面设置线的核心风险。
+
+本轮约束：
+
+- 未接通项继续显式降级
+- 不因为换成 Wolai 容器就把所有项都宣称正式可用
+
+### 9.3 页面 AI 重复造轮子的风险
+
+如果为了像 Wolai 而新做一层 AI drawer runtime，会直接偏离 `CLI-first`。
+
+本轮约束：
+
+> **页面 AI 只换壳，不换执行面。**
+
+### 9.4 范围失控风险
+
+页面设置一旦带上评论、成员、协作、演示模式，很容易从“交互壳对齐”膨胀成“整页顶栏重做”。
+
+本轮约束：
+
+- 优先做页面设置
+- 优先做页面 AI
+- 其他项延后
+
+---
+
+## 10. 验收标准
+
+只有同时满足以下条件，才可以说这条线进入实现阶段：
+
+- 页面设置入口、容器、关闭语义已和 Wolai 基线一致
+- 页面 AI 入口、容器、关闭语义已和 Wolai 基线一致
+- 页面设置仍继续走 `page.layout.updateOptions`
+- 页面 AI 仍继续走 `DocumentAiAgentPanel -> mnote-cli`
+- 没有新增第二套页面设置真相
+- 没有新增第二套页面 AI 执行面
+- 评论、协作、成员、演示模式没有被混入首批范围
+
+本轮完成后的正确口径应是：
+
+> **文档页“页面设置”和“AI 界面”的交互壳开始按 Wolai 收口，但页面域单一真源与 CLI-first AI 的主线保持不变。**
@@ -0,0 +1,359 @@
+# 5-11 [process] Wolai 页面设置与 AI 交互壳连续执行 checklist v1
+
+> 更新时间：2026-05-06
+>
+> 本清单服务于：
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-10-wolai-page-settings-and-ai-surface-alignment-v1.md`
+>
+> 执行口径继续统一服从：
+> - `/home/lix/.codex/skills/wolai-aline/SKILL.md`
+> - `/mnt/Data1T/mnote/design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`
+
+## 1. 使用方式
+
+每次只领取一个最小行为，按下面闭环推进：
+
+1. 用一句话定义行为，例如“右上角 `...` 打开页面设置 popover 且 URL 不变”。
+2. 派 subagent 先取 Wolai 基线。
+3. 主线程复核截图并填写差异矩阵。
+4. 新增或更新本地 smoke，先让当前实现失败。
+5. 小范围实现，不新造第二份页面真相或 AI 执行面。
+6. 运行本地 smoke 和相关单测。
+7. 再派 subagent 对 Wolai 与本地复测。
+8. 主线程复核最终截图。
+9. 更新本清单状态、证据路径和剩余差异。
+
+状态标记：
+
+- `TODO`：未开始
+- `BASELINE`：Wolai 基线已取
+- `RED`：本地失败 smoke 已存在
+- `GREEN`：本地实现与 smoke 已通过
+- `PARITY`：subagent 复测和主线程截图复核通过
+- `BLOCKED`：存在阻塞
+
+---
+
+## 2. 当前基线证据
+
+2026-05-06 已完成 Wolai 页面设置与 AI 界面的只读基线取证，目录：
+
+- `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/`
+
+当前已确认事实：
+
+| 项 | Wolai 证据 | 当前结论 |
+| --- | --- | --- |
+| 页面设置入口 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/10-page-settings-open.png` | 右上角 `...` 打开右侧贴边 popover，URL 不变 |
+| 页面设置关闭 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/11-page-settings-after-esc.png` `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/13-page-settings-after-outside-click.png` `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/15-page-settings-after-reclick.png` | `Esc`、点击空白、再次点击入口都可关闭 |
+| 页面设置结构 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/10-page-settings-open.json` | 3 个 tab，内部主控件是 checkbox 形态 |
+| AI 入口 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/20-ai-open.png` | 右下角浮动 `AI` 按钮打开右侧抽屉，URL 不变 |
+| AI 关闭 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/21-ai-after-esc.png` `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/23-ai-after-outside-click.png` `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/27-ai-after-close-button.png` | `Esc` 和点击空白无效，只能点右上角 `X` |
+| AI 结构 | `/mnt/Data1T/mnote/tmp/wolai-editor-parity/page-settings-ai-baseline/20-ai-open.json` | 标题“智能问答”，有会话区、模型区、输入框和发送按钮 |
+
+### 2.1 用户追加截图复核（2026-05-06）
+
+用户追加的当前 `3000` 截图：
+
+- `/mnt/Data1T/mnote/tmp/image copy 44.png`
+- `/mnt/Data1T/mnote/tmp/image copy 45.png`
+
+当前补充判断：
+
+- `image copy 44.png` 和 `image copy 45.png` 暴露的是三类真实问题：页面设置 tab-panel 混显、页面设置保存后回退、页面 AI 抽屉没有真实文本返回。
+- 这三类问题已经在本轮代码修复中逐项落地：
+  - `styles.rs`：补 `[hidden]` surface 样式，修复 `页面选项 / 自定义页面 / 全局选项` 混显。
+  - `documents.rs + bridge-runtime + document.rs + layout.rs`：修复页面设置写链、读链和 SSR 首屏注入，解决“闪一下又复原”。
+  - `compat.rs + layout.rs`：修复真实 `/api/ai-agent/run` 返回文本，页面 AI 默认 provider 对齐为 `hermes`。
+
+---
+
+## 3. 通用证据矩阵
+
+每项必须记录下列字段：
+
+| 字段 | 要求 |
+| --- | --- |
+| Wolai 截图 | 绝对路径，保存在 `/mnt/Data1T/mnote/tmp/wolai-editor-parity/<task>/` |
+| 本地截图 | 同视口、同动作链截图 |
+| 入口 | 按钮、菜单、浮动入口、快捷键 |
+| 关闭路径 | `Esc`、点击空白、再次点击入口、关闭按钮 |
+| URL | 操作前后是否变化 |
+| 容器类型 | `popover`、`drawer`、`sheet`、`modal` |
+| 控件类型 | `checkbox`、`button`、`tab`、`textarea` 等 |
+| 控件状态 | `checked`、`selected`、`focused`、`disabled`、`active` |
+| DOM/ARIA | `role`、`aria-*`、`data-testid`、可聚焦性 |
+| smoke | 对应 `scripts/task*-smoke.js` 或测试文件 |
+| 剩余差异 | 不允许只写“基本一致” |
+
+---
+
+## 4. Phase A：页面设置基线与壳层
+
+| ID | 状态 | 任务 | 验收要点 |
+| --- | --- | --- | --- |
+| A1 | BASELINE | Wolai 页面设置基线 | 已有 2026-05-06 Wolai 基线截图和 JSON |
+| A2 | GREEN | 本地页面设置入口现状基线 | `task160` 已记录并复测当前文档页右上角 `更多` 打开页面设置容器，URL 不变 |
+| A3 | GREEN | 页面设置入口 tooltip | `task160` 已断言入口 `title="页面选项和全局选项"` |
+| A4 | GREEN | 页面设置容器类型 | `task160` 已断言本地打开右侧贴边 `popover`，不再是空按钮 active |
+| A5 | GREEN | 页面设置 URL 合同 | `task160` 已断言打开和关闭页面设置时 URL 不变化 |
+| A6 | GREEN | 页面设置关闭语义 | `task160` 已断言 `Esc`、点击空白、再次点击入口全部有效 |
+| A7 | GREEN | 页面设置 3 tab | `task160` 已在真实后端端口上断言 `页面选项 / 自定义页面 / 全局选项` 的 tab-panel 隔离行为 |
+| A8 | GREEN | 页面选项主控件形态 | `task160` 已断言首 tab 使用 checkbox 行，而不是旧 inspector 大块按钮 |
+| A9 | GREEN | 最小设置项保留清单 | `task160` 已断言 `wideLayout / smallText / showToc / showHeadingNumbers / protectEditing` 出现在首 tab |
+| A10 | GREEN | 未接通项显式降级 | `task160` 已断言 `showToc / protectEditing` 当前 disabled 且带“待接线”说明 |
+
+### 4.1 本阶段 smoke 建议
+
+- `scripts/task160-wolai-page-settings-shell-smoke.js`
+
+首轮最小断言建议：
+
+- 点击右上角 `...` 后 URL 不变
+- 出现页面设置 `popover`
+- 出现三 tab
+- `Esc` 可关闭
+- 点击页面空白可关闭
+- 再次点击入口可关闭
+
+### 4.2 task160 页面设置壳执行记录
+
+2026-05-06 已新增并执行 `scripts/task160-wolai-page-settings-shell-smoke.js`，用于固化 A2-A7 的本地 RED 基线。
+
+RED：
+
+- 命令：`node scripts/task160-wolai-page-settings-shell-smoke.js`
+- 结果：失败
+- 失败信息：`页面设置入口必须打开右侧贴边 popover`
+- 当前本地状态：
+  - 点击右上角 `更多` 后 URL 保持文档页不变
+  - 顶栏 `更多` 获得焦点，但没有打开页面设置容器
+  - 当前页面中未出现页面设置 popover；探测到的唯一 `tablist` 仍是左侧 `我的页面 / Explorer / +`
+
+证据路径：
+
+- 本地点击后截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/01-after-click-more.png`
+- 本地点击后状态：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/01-after-click-more.json`
+- 本地失败截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/failure.png`
+- 本地失败状态：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/failure-state.json`
+
+当前判断：
+
+- A2 已有本地基线
+- A4 已形成真实 RED
+- A5 目前从 failure-state 可见点击后 URL 未变化，但完整打开/关闭合同仍待容器实现后继续验证
+- A6-A7 仍待容器出现后继续验证
+
+GREEN：
+
+- 命令：`node scripts/task160-wolai-page-settings-shell-smoke.js`
+- 结果：通过
+- 当前通过行为：
+  - 右上角 `更多` 打开页面设置 `popover`
+  - URL 保持不变
+  - `Esc`、点击空白、再次点击入口均可关闭
+  - 顶部存在 `页面选项 / 自定义页面 / 全局选项`
+  - 页面设置首 tab 使用 checkbox 行
+  - `showToc / protectEditing` 当前显式降级
+
+新增证据：
+
+- `task160` 最终截图：
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/01-after-click-more.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/02-after-esc.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/03-after-outside-click.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task160-page-settings-shell/04-after-reclick.png`
+
+修复补充（2026-05-06）：
+
+- 在 `styles.rs` 中补了 `.wolai-page-settings-section[hidden] { display: none !important; }`
+- `task160` 随后已在真实后端端口 `41327` 上验证 `页面选项` 不再混出 `自定义页面` 字段，`自定义页面 / 全局选项` 的 panel 行为恢复正常
+
+---
+
+## 5. Phase B：页面设置动作项与现有能力接线
+
+| ID | 状态 | 任务 | 验收要点 |
+| --- | --- | --- | --- |
+| B1 | GREEN | `页面历史...` 接线 | `task160` 已断言页面设置动作项可打开 Rust Web 页面历史抽屉 |
+| B2 | GREEN | `公开分享页面...` 接线 | `task160` 已断言页面设置动作项可打开 Rust Web 公开分享对话框 |
+| B3 | GREEN | `移动到...` 入口策略 | `task160` 已断言当前显式为 disabled/placeholder |
+| B4 | GREEN | `嵌入到...` 入口策略 | `task160` 已断言当前显式为 disabled/placeholder |
+| B5 | GREEN | `删除页面` 入口策略 | `task160` 已断言当前显式为 disabled/placeholder |
+| B6 | GREEN | 统计信息布局 | `task160` 已断言底部存在紧凑统计信息区 |
+| B7 | GREEN | 页面设置项真实生效 | `task160` 已在真实后端端口上断言 `wideLayout`、`layoutDensity` 持久化并在刷新后回读成功 |
+
+### 5.1 本阶段 smoke 建议
+
+- 在 `task160` 基础上扩展动作项断言
+- 新增针对已接通选项的可见结果断言
+
+最低要求：
+
+- 历史入口可打开现有历史抽屉
+- 分享入口可打开现有分享对话框
+- `wideLayout`、`smallText`、`layoutDensity` 这类已接通项能在页面可见变化中被捕获
+
+### 5.2 task160 Phase B 执行记录
+
+2026-05-06 `task160` 已继续覆盖 B1-B7，当前通过：
+
+- `页面历史...` 可打开 `data-testid="wolai-page-history-drawer"`
+- `公开分享页面...` 可打开 `data-testid="wolai-page-share-dialog"`
+- `移动到... / 嵌入到... / 删除页面` 当前显式 disabled
+- 页面设置底部显示字数、字符、块数、待办统计
+- `wideLayout` 写链真实命中 `/api/documents/options`
+- `layoutDensity` 写链真实命中 `/api/documents/options`
+- `wideLayout` 打开后 `.document-shell` 宽度真实增大
+
+修复补充（2026-05-06）：
+
+- 先修了 `mnote-web` 页面设置 route payload 与 `bridge-runtime` command plan：不再把 `workspaceId` 和一组 `null` 选项继续下发到 `documents:updateOptions`
+- 再修了 `DocumentPage` 的 SSR `data-page-*` 首屏注入，以及 `SIDEBAR_TREE_JS` 初始化顺序，避免在 `__MNOTE_PAGE_AGGREGATE__` 还未进入 DOM 时把默认 page options 缓存死
+- 之后通过真实后端端口 `41327` 验证：
+  - `/api/documents/options` 返回 200
+  - `/api/page-aggregate/:id` 能读回 `wideLayout=true`、`layoutDensity=compact`
+  - `task160` 刷新后 checkbox 和壳层 attr 不再回退
+
+---
+
+## 6. Phase C：页面 AI 入口与抽屉壳
+
+| ID | 状态 | 任务 | 验收要点 |
+| --- | --- | --- | --- |
+| C1 | BASELINE | Wolai 页面 AI 基线 | 已有 2026-05-06 Wolai 基线截图和 JSON |
+| C2 | GREEN | 本地页面 AI 入口现状基线 | `task161` 已记录并复测右下角 AI 可打开页面 AI 抽屉，URL 不变 |
+| C3 | GREEN | 页面 AI 主入口迁到右下角 | `task161` 已断言页面级 AI 主入口为右下角浮动按钮 |
+| C4 | GREEN | 顶栏 `页面AI` 降级 | `task161` 已断言顶栏不再保留 `页面AI` 主入口 |
+| C5 | GREEN | 页面 AI 容器类型 | `task161` 已断言页面 AI 以右侧抽屉打开、无遮罩、不跳新页面 |
+| C6 | GREEN | 页面 AI 关闭语义 | `task161` 已断言 `Esc`、点击空白无效，右上角 `X` 有效 |
+| C7 | GREEN | 页面 AI 页面级绑定 | `task161` 已断言 `/api/ai-agent/run` 请求体携带当前 `documentId` 与 `pageOptions` |
+| C8 | GREEN | 页面 AI 执行面不分裂 | 真实 `/api/ai-agent/run` 已改为 `Next 兼容优先 -> 本地 mnote-cli fallback -> 旧 orchestrator 兜底`；`task162` 已验证真实页面可返回文本结果 |
+| C9 | GREEN | AI chrome 与 Wolai 接近 | `task161` 已断言标题、输入区、`新会话 / 历史会话 / mnote-cli` chrome 可见 |
+
+### 6.1 本阶段 smoke 建议
+
+- `scripts/task161-wolai-page-ai-shell-smoke.js`
+
+首轮最小断言建议：
+
+- 点击右下角 AI 后 URL 不变
+- 打开右侧抽屉
+- 抽屉无遮罩
+- `Esc` 不关闭
+- 点击页面空白不关闭
+- 点右上角关闭按钮可关闭
+
+### 6.2 task161 页面 AI 壳执行记录
+
+2026-05-06 已新增并执行 `scripts/task161-wolai-page-ai-shell-smoke.js`，用于固化 C2-C6 的本地 RED 基线。
+
+RED：
+
+- 命令：`node scripts/task161-wolai-page-ai-shell-smoke.js`
+- 结果：失败
+- 失败信息：`页面 AI 入口必须打开右侧抽屉`
+- 当前本地状态：
+  - 点击右下角 `AI 助手` 后 URL 保持文档页不变
+  - 浮动 AI 按钮没有打开抽屉
+  - 当前页面中未出现页面 AI 容器、关闭按钮、标题或输入框
+
+证据路径：
+
+- 本地点击后截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/01-after-click-ai.png`
+- 本地点击后状态：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/01-after-click-ai.json`
+- 本地失败截图：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/failure.png`
+- 本地失败状态：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/failure-state.json`
+
+当前判断：
+
+- C2 已有本地基线
+- C5 已形成真实 RED
+- C6 仍待抽屉出现后继续验证
+- C7-C8 仍待实现阶段继续验证
+
+GREEN：
+
+- 命令：`node scripts/task161-wolai-page-ai-shell-smoke.js`
+- 结果：通过
+- 当前通过行为：
+  - 右下角 AI 入口打开页面级右侧抽屉
+  - URL 保持不变
+  - `Esc` 和点击空白不会关闭
+  - 右上角关闭按钮可关闭
+  - 抽屉标题、输入区、会话/模型 chrome 可见
+  - 发送动作继续命中 `/api/ai-agent/run`
+- 请求体继续携带当前 `documentId` 与 `pageOptions`
+
+新增证据：
+
+- `task161` 最终截图：
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/01-after-click-ai.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/02-after-esc.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/03-after-outside-click.png`
+  - `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task161-page-ai-shell/04-after-close-button.png`
+
+修复补充（2026-05-06）：
+
+- `compat.rs` 的 `/api/ai-agent/run` 已改为：
+  - 先尝试代理到 Next 的 `/api/ai-agent/run`
+  - 失败时本地直接 `mnote-cli` host fallback
+  - 再失败才走旧 orchestrator
+- 同时补了认证头显式转发，避免被 Next 侧 307 `/auth` 拦截
+- 页面 AI drawer 默认 provider 改为 `hermes`
+- 新增 `task162-wolai-page-ai-real-response-smoke.js`，并在真实后端端口 `41327` 上验证：页面 AI 不再显示 `page_ai_failed_502` / “没有返回文本结果”，而是会回填真实文本
+
+### 6.3 task162 页面 AI 真实返回执行记录
+
+2026-05-06 已新增并执行 `scripts/task162-wolai-page-ai-real-response-smoke.js`，用于补齐 C8 的真实返回验证。
+
+- 命令：`MNOTE_UI_BASE_URL=http://127.0.0.1:41327 node scripts/task162-wolai-page-ai-real-response-smoke.js`
+- 结果：通过
+- 当前通过行为：
+  - 页面 AI 不再出现 `page_ai_failed_502`
+  - 不再显示“当前页面 AI 已接通 \`mnote-cli\`，但这次没有返回文本结果。”
+  - 页面 AI 会回填真实 `mnote-cli` 输出文本
+
+---
+
+## 7. Phase D：页面 AI 与页面设置的集成护栏
+
+| ID | 状态 | 任务 | 验收要点 |
+| --- | --- | --- | --- |
+| D1 | GREEN | 不新造页面设置真相 | 页面设置继续围绕 `currentPageOptions -> /api/documents/options -> page.layout.updateOptions` |
+| D2 | GREEN | 不新造 AI 执行面 | 页面 AI 继续围绕 `/api/ai-agent/run -> mnote-cli` |
+| D3 | GREEN | 文档页 owner 行为合同固定 | `task160/task161` 已断言 owner 态页面设置和 AI 都不跳新页面、不改 URL |
+| D4 | GREEN | mobile / 窄屏退化 | `task160/task161` 已断言移动视口下 popover / drawer 不超出视口 |
+| D5 | GREEN | React compat 与 Rust SSR 边界 | 本轮实现仅落在 `mnote-web` Rust SSR 壳、脚本与样式；未再把入口回接 React compat |
+| D6 | GREEN | checklist 与失败模式回填 | 已向 `wolai-aline/references/failure-patterns.md` 新增“本地 3000 进程未重启，smoke 误打旧实现” |
+
+---
+
+## 8. Deferred 清单
+
+以下项当前明确延后，不混入首批验收：
+
+| ID | 状态 | 任务 | 说明 |
+| --- | --- | --- | --- |
+| X1 | TODO | 演示模式 | 不是本轮页面设置与 AI 壳的主线 |
+| X2 | TODO | 页面评论 | 用户已明确可延后 |
+| X3 | TODO | 页面协作 | 用户已明确可延后 |
+| X4 | TODO | 成员邀请 | 顶栏 owner 态能力，后续单拆 |
+| X5 | TODO | 全局 AI 入口重构 | 本轮只做页面级 AI |
+| X6 | TODO | 帮助浮动入口完全对齐 | 本轮优先 AI，不把帮助入口一起扩面 |
+
+---
+
+## 9. 完成判定
+
+本清单只有在以下条件同时成立时，才可以视为本轮设计进入可实现状态：
+
+- 页面设置 `popover` 行为已通过本地 smoke 和 Wolai 基线复核
+- 页面 AI 抽屉行为已通过本地 smoke 和 Wolai 基线复核
+- 页面设置仍然围绕 `page.layout.updateOptions`
+- 页面 AI 仍然围绕 `/api/ai-agent/run -> mnote-cli`
+- deferred 项没有被误报为已完成
+
+本轮完成后的正确口径：
+
+> **页面设置与页面 AI 的交互壳已开始对齐 Wolai，但评论、协作、成员、演示模式仍是后续独立任务。**
@@ -390,6 +390,16 @@ GREEN：
 - E24 图片最小真源闭环：2026-05-01 已按 Wolai E13 slash 基线确认 `媒体与附件` 分组存在 `图片 /tp` 与 `最近上传图片 /tp`；第一段实现 `图片 /tp` 最小切片，参考 `leptos-tiptap` 官方 `TiptapImageResource` / `set_image` bridge（`src/api/types/extensions/image.rs`、`src/api/commands.rs`、`tiptap/src/extensions/tiptap_image.ts`）与 template `components/tiptap-node/image-node/*`、`image-upload-node/*`，不手写 image JSON。当前本地 `SLASH_ACTIONS` 已补 `图片 /tp` 和 `媒体与附件` 分组，`p0_extensions()` 显式启用 `TiptapExtension::Image`，点击后调用 `editor.set_image(TiptapImageResource { ... })` 插入真实 Tiptap `image` 节点；`core-protocol` 新增 `EditorBlockType::Image` / `TiptapNode::Image`，`bridge-runtime` 保存为 legacy `image` 且保留 `props.tiptapImage`，`mnote-web` bootstrap 从 content API 恢复为 `<img>`；本地只读占位资源走 `/api/editor/image-placeholder.svg`，避免 smoke 依赖外网或破图。第二段补图片点击选中态与图片专用 floating toolbar，参考 `tiptap-notion-like-registry/materialized/tiptap-node/image-node/image-node-floating.tsx`、`image-node-extension.ts`、`tiptap-ui/image-align-button/use-image-align.ts`、`tiptap-ui/image-download-button/use-image-download.ts`：本地点击 `<img>` 后展示 `image-floating-toolbar`，提供左/中/右对齐和同源图片下载，删除入口本切片保持禁用；图片对齐通过 `Image.extend({ addAttributes: { "data-align" } })` 扩展官方 Image schema 后调用 `editor.update_attributes(TiptapSchemaTarget::Node(TiptapNodeName::Image), ...)`，不是 UI 伪样式；同源下载只读当前 NodeSelection 图片 DOM 的 `src/title/alt`，用隐藏 `<a download>` 触发，不触发保存链。`task152-e24-image-smoke.js` 覆盖 slash 入口、DOM `<img>`、图片实际加载、图片 toolbar、同源下载事件、删除入口禁用态、居中对齐 `data-align`、保存请求 `tiptapDocument`、`/api/documents/content` image 真源与 reload 恢复；通过截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task152-e24-image-download-green`。剩余：真实上传、最近上传图片、caption、resize、replace、跨源下载 fallback、删除保存链、移动端 toolbar、上传失败态另拆后续。

 - E25 TOC 最小真源闭环：2026-05-01 已按 Wolai slash 基线确认 `页面目录 /toc`，并参考 `tiptap-notion-like-template/src/components/tiptap-node/toc-node/*`、`toc-show-title-button/*`、`toc-sidebar/*` 与 `notion-like-editor.tsx` 中 `TableOfContents.configure({ onUpdate })` 的数据链路。当前本地先完成第一段：`leptos-tiptap` 新增 `toc_node` bridge 扩展，真实 Tiptap schema 名为 `tocNode`，slash `页面目录 /toc` 调用 `editor.insert_toc_node(TiptapTocNodeAttrs { top_offset: 0, max_show_count: 20, show_title: true })`，不是普通 div 或手写 spike JSON；NodeView 从当前 Tiptap doc 的 heading 节点派生目录项，支持点击目录项定位并更新 hash，支持标题显示开关并通过 `updateAttributes("tocNode", { showTitle })` 持久化。保存链新增 `EditorBlockType::Toc` / `TiptapNode::TocNode`，`bridge-runtime` legacy content 保留 `props.tiptapTocNode`，`mnote-web` reload 恢复 `tocNode`；`task153-e25-toc-smoke.js` 覆盖 `/toc` 入口、真实 tocNode DOM、heading 列表派生、动态 heading 更新、点击定位、标题开关、保存请求、content API 和 reload 恢复。截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task153-e25-toc-local-smoke`。剩余：接入 Tiptap 官方 `@tiptap/extension-table-of-contents` v3 数据源或完成等价 bridge 评估、TOC sidebar、active heading 高亮、完整块菜单标题开关入口、Wolai 像素级视觉、移动端行为、UniqueID/anchor 统一化。
+- E26 执行前口径纠偏：2026-05-02 已按 `5-2`、`5-4`、`5-5`、`5-6` 和 `5-7` 设计确认，E26 不是“前端引入 Tiptap UniqueID 即完成”。正式块身份必须来自 Rust `EditorBlock.block_id`，经 Tiptap bridge 映射为 `data-block-id` 供浏览器 runtime 使用，再通过 `page.body.save` 写回 Convex-backed 持久化底座；复制锚点和 hash 定位只能消费这个真源 id。Tiptap `UniqueID` 可以参考其节点身份策略，但不得生成长期块 id、不得绕过 Rust `EditorBlockDocument`、不得绕过 Page Aggregate / `page.body.save`。
+- E26 执行边界：实现与 smoke 必须把 `EditorBlockDocument -> Tiptap attrs.blockId/data-block-id -> DOM 锚点 -> page.body.save -> /api/documents/content -> reload/hash 定位` 串成一条链。允许在浏览器 runtime 内用 `UniqueID` 或等价插件帮助定位节点，但只能读取/补齐已有 Rust block id；若某块缺少正式 id，应通过 Rust/保存适配链生成并持久化，而不是让前端临时 id 成为长期合同。Convex 只验证持久化结果可读可刷新，不作为语义真源。
+- E26 最小真源闭环：2026-05-02 已完成第一段 anchor 切片。`leptos-tiptap` paragraph/heading/blockquote/codeBlock/image/table 的 `blockId` 渲染同时输出 `data-block-id` 与 DOM `id`，浏览器 hash 命中走 `id=:blockId` + CSS `:target`，不是手工给 ProseMirror DOM 写临时 class；Rust runtime 复制链接和 hash 滚动继续只消费 `EditorBlock.block_id` 派生的 `attrs.blockId`。`mnote-web` 保存 payload 不再发送空 `content: []`，而是派生 `editorDocument`、legacy `content`、`tiptapDocument` 和 `blockCount` 写回 Convex-backed 持久化底座；reload 侧 legacy block 恢复继续补 `attrs.blockId`。本地 smoke `node scripts/task154-e26-anchor-smoke.js` 已覆盖保存请求、`/api/documents/content`、复制链接、DOM `id/:target` 和 reload/hash 定位，截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task154-e26-anchor-local-smoke`。剩余：列表项/分割线等更多块类型的统一 anchor attr 覆盖、Wolai 视觉细节、块引用/页面引用预览与移动端行为另拆后续。
+- E27 执行前口径纠偏：AI 编辑能力包不是“补 AI 菜单文案”或“点击后显示 feedback”。最小闭环必须从 `leptos-tiptap` 的 slash / 块菜单入口出发，携带当前 `documentId`、`workspaceId`、Rust `blockId`、selection 摘要和 Tiptap JSON 快照，调用 mnote 现有 AI 真源边界。2026-05-05 起长期口径进一步修正：`/api/ai-agent/run` 不应长期绑定 `openai-agents-python` sidecar，而应收口为 `mnote-cli` 唯一长期 agent 执行面上的 host / adapter；`openai-agents-python`、`Hermes`、`Codex` 只允许作为可插拔外置 agent。结构化写入仍必须回到 Rust tool / `page.body.save` / Convex-backed content 链。E27 第一刀已完成的 sidecar 路径只作为过渡基线，不宣称是长期主线。
+- E27 AI agent 入口与写入闭环：2026-05-02 已完成主路径纠偏，修正此前把 `/api/hermes/bridge` 当作 E27 主入口的误导口径。块菜单 `AI 助理` 现在从当前 `leptos-tiptap` editor 读取 `documentId`、`workspaceId`、Rust `blockId`、selection state、selected text 与 `tiptapDocument` 快照，发起 `/api/ai-agent/run` 请求，payload 固定 `scope=document`、`stream=true`、`options.ai.provider=online`，并显示 `mnote-leptos-tiptap-ai-status` 的 `idle/pending/ready/error` 状态；请求上下文标记 `source=leptos-tiptap-island`、`action=ask_ai`，Next sidecar adapter 已透传 `workspaceId / selectedBlockId / selection / tiptapDocument` 等 block 级上下文给 `openai-agents-python`。本地 smoke `node scripts/task155-e27-ai-edit-smoke.js` 已先 RED 于 Hermes 主入口，再 GREEN 覆盖请求 URL、payload 真源字段和 ready 状态；`node scripts/task156-e27-ai-writeback-smoke.js` 已先 RED 于只返回不写入，再 GREEN 覆盖 SSE `doc_replace_range` tool_result -> 编辑器改写 -> `/api/documents/save` -> `/api/documents/content` 真源读回 -> reload 后页面读回。截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task156-e27-ai-writeback-local-smoke`。剩余：Wolai AI 菜单视觉基线断流未完成、slash AI/selection toolbar AI、Improve/continue/regenerate/summarize/translate 子命令、SSE 分段 UI 状态、`doc_insert_blocks` 多块插入和标题 `slash_run` 应用另拆后续。
+- E27 Auth 真源纠偏：2026-05-02 补充确认，AI 编辑和在线 smoke 的用户身份必须以真实 Convex Auth 为主线；不同账号的数据隔离依赖 Convex `getAuthUserId(ctx)` 解析真实 identity subject，并由 workspace/member 权限链校验。`/auth` 复用既有 Convex Auth 页面和统一测试账号 `test@example.com` / `Test123456`；`/api/auth/session`、`/api/auth/whoami`、AI orchestrator 转发和 Convex transport 均应真实 token / forwarded actor 优先。`DEV_USER_ID` / admin acting identity 只允许作为本地底层 fallback 或显式 `MNOTE_DEV_AUTH=1` 联调模式，不能作为 E27 在线验收、多账号隔离或正式数据真源。
+- E27 当前推进备注：2026-05-03 主线程先切到 E28 Mention / Emoji，E27 暂停在 online smoke 模型网关层排障状态。当前已确认 `3000 -> 8000` orchestrator 主链可达，本地 `task155/task156` 通过；剩余在线阻塞点在 `20128 /v1/responses` 上游模型/渠道可用性，以及后续真实 actor 收口。恢复 E27 时应从这两点继续，不要回退成“主入口未迁完”。
+- E28/E29 暂停与 E30 先行口径：2026-05-03 主线程先暂停 E28 Mention / Emoji 与 E29 Comment / History，转入 E30 Menu / Floating 状态机能力包。E28 已有 Wolai Hermes baseline 显示正文输入 `@` 当前弹出提醒/会议/成员候选，并可插入成员 mention，不是页面引用搜索；证据目录为 `/mnt/Data1T/mnote/tmp/wolai-editor-parity/task157-e28-wolai-mention-baseline/`，恢复 E28 时需先重新定 `@mention` 口径，不要按“页面引用第一刀”继续。E29 在评论/历史后端边界未重新确认前保持暂停。E30 第一刀只收敛已有 slash、块菜单、二级菜单、selection/image/table floating toolbar 的打开互斥、Esc、外部点击、方向键、Enter 与层级收起，不扩新业务命令。
+- E30 Menu / Floating 状态机第一刀：2026-05-03 已参考 `use-floating-element`、`use-menu-navigation`、`use-floating-toolbar-visibility` 的集中可见性/键盘/关闭模型，把本地已有 slash、块菜单、selection toolbar、image toolbar、table toolbar/options 的关闭与互斥收口到 `close_editor_floating_overlays*` 与 `open_*_overlay` 入口；`task158-e30-menu-state-smoke.js` 覆盖 slash `ArrowDown` active、Esc 关闭、块菜单二级菜单、selection color panel、image toolbar、table options、slash 打开关闭 selection toolbar、块菜单打开关闭 image toolbar。Wolai 基线目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-wolai-baseline/`；本地主线程截图目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-menu-state-local-smoke-main3`；本地 subagent 复测目录：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task158-e30-local-postfix-subagent`。剩余：Wolai slash / 块菜单二级菜单在只读条件下未稳定验证，Enter 选中、外部点击和更多三级菜单收起需后续 editable-test 小切片继续补。
+- E31 Auth 入口回收：2026-05-04 已把 `3000` 的 `/auth` 收回为本地 `mnote-web` SSR 登录页，不再代理 3100；未登录访问 `/` 现在 303 到 `/auth`，已登录（forwarded actor / Convex Auth cookie）才进入工作区。`task159-auth-entry-smoke.js` 覆盖 `/auth` 本地 200、`/` 未登录 303、已登录 200、无第三方快捷登录/隐私政策文案，`task114-rust-web-gateway-entry-smoke.js` 与 `task117-next-retirement-guard.js` 已同步更新。截图待复核：`/mnt/Data1T/mnote/tmp/wolai-editor-parity/task159-auth-entry-baseline/`。


 | ID | 状态 | 任务 | 验收要点 |
@@ -409,11 +419,11 @@ GREEN：
 | E23 | PARTIAL | TableKit 能力包 | 已完成简单表格可验收切片：`leptos-tiptap` 增加 table/tableRow/tableCell/tableHeader schema，slash `简单表格 /jdbg` 按 Wolai 基线插入 `4x3` 真实 `<table>`，本地 table toolbar 支持下方插入行、右侧插入列、清空当前单元格、删除当前行/列/表格，并补 `选项` 菜单的标题行、标题列、隐藏边框线 switch；已补行侧/列顶 aux controls 和最小 TableSelectionOverlay，点击行/列 aux 会插入行/列并显示对应淡红选择覆盖层，toolbar 保持可用；`core-protocol`/`bridge-runtime`/`mnote-web` 保存与刷新恢复保留 `table` Tiptap 快照、`tableHeader` 和 `attrs.hiddenBorders`；本地 smoke `task151-e23-table-smoke.js` 覆盖入口、DOM、row/column aux 插入、selection overlay、列宽拖拽、switch 语义/状态、保存请求、content API、reload 和删除。剩余表格对齐、fit、数据表格入口，以及 Wolai 选项菜单图标/toolbar 视觉细节另拆后续 |
 | E24 | PARTIAL | Image / Media 能力包 | 已完成图片 `/tp` 最小真源闭环与图片 toolbar 小闭环：slash `媒体与附件` 分组入口调用 `leptos-tiptap` 官方 `set_image(TiptapImageResource)`，启用 `TiptapExtension::Image`，保存链新增 `EditorBlockType::Image` / `TiptapNode::Image` 并保留 `props.tiptapImage`，`mnote-web` reload 恢复 `<img>`；点击图片后出现 `image-floating-toolbar`，删除入口本切片保持禁用，左/中/右对齐通过官方 Image 扩展 `addAttributes("data-align")` + `updateAttributes("image")` 持久化，同源下载通过隐藏 `<a download>` 触发且不改文档；`task152-e24-image-smoke.js` 覆盖入口、实际图片加载、toolbar、同源下载、删除入口禁用态、居中对齐、保存请求、content API 和刷新恢复；剩余上传、最近上传、caption、resize、replace、跨源下载 fallback、删除保存链、移动端 toolbar、失败态 |
 | E25 | PARTIAL | TOC 能力包 | 已完成 `/toc` 最小真源闭环：`leptos-tiptap` 新增真实 `tocNode` schema/command，slash `页面目录 /toc` 插入真实节点，NodeView 从当前 headings 派生目录项，支持点击定位、标题显示开关、保存请求、content API 与 reload 恢复；`task153-e25-toc-smoke.js` 覆盖入口、动态 heading 更新、hash 定位和 `props.tiptapTocNode`。剩余 TOC sidebar、active heading 高亮、完整块菜单入口、官方 TableOfContents v3 数据源评估、移动端与像素级视觉 |
-| E26 | TODO | UniqueID / Anchor 能力包 | 参考 UniqueID/anchor/copy anchor link 相关实现；每个块需要稳定 id，复制链接应指向可恢复的页面/块锚点，刷新后仍可定位 |
-| E27 | TODO | AI 编辑能力包 | 参考 `ai-context`、AI icons、Improve/Ask AI/continue/regenerate/summarize/translate；先接 mnote 现有 AI command/tool 真源，再做 Wolai 菜单入口和流式状态 |
-| E28 | TODO | Mention / Emoji 能力包 | 参考 mention trigger 与 emoji menu；实现 `@`、emoji 搜索、键盘导航、插入后的 Tiptap JSON 和 mnote 保存链，不作为纯文本占位 |
-| E29 | TODO | Comment / History 能力包 | 参考评论入口、块历史入口的菜单形态，结合 mnote 后端能力决定先做 smoke 占位还是真实存储；`Ctrl/Cmd+Alt+M`、评论气泡数量、块历史恢复需单列对标 |
-| E30 | TODO | Menu / Floating 状态机能力包 | 参考 `use-floating-element`、`use-menu-navigation`、`use-floating-toolbar-visibility`；统一 Esc、外部点击、鼠标移出、方向键、Enter、层级菜单收起逻辑，避免每个菜单各写一套状态机 |
+| E26 | PARTIAL | UniqueID / Anchor 能力包 | 已完成最小真源闭环：Rust `EditorBlock.block_id` -> Tiptap `attrs.blockId` -> DOM `data-block-id` + `id` -> 复制链接 hash -> `page.body.save` / `/api/documents/content` -> reload 后 `:target` 定位；`task154-e26-anchor-smoke.js` 覆盖保存、复制、reload/hash 和截图。Tiptap `UniqueID` 仍只作为参考/辅助口径，不作为正式块 id；剩余更多块类型 anchor 覆盖、Wolai 视觉细节、引用预览和移动端行为。 |
+| E27 | PARTIAL | AI 编辑能力包 | 已完成块菜单 `AI 助理` 主路径与最小写入闭环：点击后发起 `/api/ai-agent/run`，payload 使用 `scope=document`、`stream=true`、`options.ai.provider=online`，携带 `documentId`、`workspaceId`、Rust `blockId`、selection、selected text、Tiptap 快照和 `action=ask_ai`；历史基线里 `Hermes` 只作为 `/api/ai-agent/run` 内部 fallback。2026-05-05 起长期口径改为：`/api/ai-agent/run` 后续应收口为 `mnote-cli` 唯一长期 agent 执行面上的 host / adapter，`Hermes`、`Codex`、`openai-agents-python` 仅为可插拔外置 agent；`task155-e27-ai-edit-smoke.js` 与 `task156-e27-ai-writeback-smoke.js` 保留为过渡主链行为基线。Auth 验收必须复用 Convex Auth 测试账号，真实 token / actor 优先，`dev identity` 仅为本地 fallback。当前主线程已于 2026-05-03 先切 E28；E27 暂停在 online smoke 的 `20128 /v1/responses` 模型网关排障与真实 actor 收口。剩余 slash AI/selection toolbar AI、Improve/continue/regenerate/summarize/translate、Wolai 视觉基线、SSE 分段 UI、`doc_insert_blocks` 多块插入与标题写入。 |
+| E28 | PAUSED | Mention / Emoji 能力包 | 2026-05-03 暂停；Wolai baseline 已纠偏：正文 `@` 当前是提醒/会议/成员候选入口，不是页面引用搜索，恢复时先重定 mention/emoji 口径，再决定 Tiptap JSON 与 mnote 保存链 |
+| E29 | PAUSED | Comment / History 能力包 | 2026-05-03 暂停；评论/历史入口仍需后端边界和 Wolai 基线复核，待 E30 统一菜单状态机后再接入，避免继续复制独立弹层逻辑 |
+| E30 | PARTIAL | Menu / Floating 状态机能力包 | 2026-05-03 第一刀已完成本地统一状态机 smoke：`task158` 覆盖 slash、块菜单/二级菜单、selection toolbar/color panel、image floating toolbar、table toolbar/options 的互斥打开、Esc 统一关闭、方向键 active，以及打开块菜单时关闭 image toolbar；Wolai 只读基线已确认 selection/type menu 和 table popper 的 Esc/外部点击/URL 不变，slash 与块菜单二级菜单在只读条件下不稳定，后续仍需 editable-test 复核 Enter、外部点击和更多层级收起 |
 | E31 | PARTIAL | Tiptap 参考对标 smoke 矩阵 | `task137-wolai-phase-e-smoke.js` 已覆盖 E13 分割线的 DOM `<hr>`、`/api/documents/content` `divider`、刷新恢复和页面转换 `_self` 打开；后续每完成一个能力包仍必须同时断言 Tiptap JSON/schema、mnote 真源保存、Wolai 视觉/交互截图、刷新恢复；截图差异未复核不得标 DONE |

 ## 9. Phase F：Page Aggregate 和命令边界