lix-2026
e8ba12e461
- 将 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 启动脚本。
4.5 KiB
4.5 KiB
7-1 [done] Phase 7 文档页 AI 最小闭环执行清单 v1
更新时间：2026-04-22
上位依据：
/mnt/Data1T/mnote/design/07-ai/process/7-phase7-ai-kernel-projection-plan-v2.md/mnt/Data1T/mnote/ARCHITECTURE.md/mnt/Data1T/mnote/design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md状态说明：
- 本稿对应
Phase 7 v2的“文档页 AI 最小闭环”已完成，故迁入done/- 本稿完成不等于整个
Phase 7 v2已完成；结构化知识写链仍以后续阶段继续推进- 2026-05-05 追加说明：本稿记录的是
openai-agents-pythonsidecar 作为过渡主链的完成状态，不代表当前长期方向；长期口径已由/mnt/Data1T/mnote/design/07-ai/process/7-phase7-ai-kernel-projection-plan-v4.md收口为mnote-cli是唯一长期 agent 执行面
1. 本轮范围
本轮只执行 Phase 7 v2 的第一轮最小闭环：
- 文档页 AI 读取当前页 page aggregate 上下文
- 编排层切入
openai-agents-python - 正文插入 / 改写继续沿
page.body.save回写 - 标题改名继续沿
page.head.updateTitle回写 - 前端默认在线主路径先走新 sidecar，失败时 fallback 到 Hermes
- 页面 AI 配置开始收口到
model_key / profile / tool registry
本轮明确不做：
summary nodeai_note nodereference edgePDF / Book -> kernel index- mindmap / OnlyOffice AI 主链
2. 当前基线
- 文档页主编辑区已经是页面内
leptos-tiptapisland - 文档页 AI 已开始消费 page aggregate snapshot
- 页面写命令面已开始收口到
page.head.updateTitle/page.body.save - 前端
/api/ai-agent/run已承载online -> sidecar / fallback -> Hermes分流 openai-agents-pythonsidecar 已接入- 前端在线主路径已切到新 sidecar
3. 执行项
A. 语义面冻结
- 第一批正式写动作只覆盖：改标题 / 插入正文 / 改写正文
- 正式命令语义固定为：
page.head.updateTitle/page.body.save - 过渡工具面固定为：
doc_get/doc_find/doc_insert_blocks/doc_replace_range/slash_run - 不新增第三套 AI 专用产品命名面
B. 上下文装配冻结
- sidecar 请求体固定包含：
documentId/documentBlocks/pageOptions/subtree/outline/evidence - 不再新增新的 AI 私有页面 getter
- 会话上下文裁剪规则先冻结到文档页最小字段集
C. openai-agents-python sidecar
- 在
wolai-backend新增文档页 AI sidecar route - 接入
openai-agents-python - 接入 OpenAI
Responses API - 最小 tools 只注册：
doc_get/doc_find/doc_insert_blocks/doc_replace_range/slash_run - tool 执行统一桥接到
mnote-web /api/hermes/bridge - 建立最小 session / tracing
- 建立最小 guardrail / fallback 边界
D. 前端主路径接线
/api/ai-agent/run新增 sidecar adapteronlineprovider 默认先走openai-agents-python- 新 sidecar 失败时自动 fallback Hermes
- 继续输出兼容当前 panel 的 SSE 事件：
assistant_message/tool_call/tool_result/completion/error - 文档页 AI 回写链继续复用
page.head.updateTitle/page.body.save
E. 配置真源与可见性
- 页面 AI 模型配置真源切到
model_key model_key -> resolved_combo -> resolved_runtime_model分层可见- 页面 AI 不再把 combo 名或 provider model 作为产品主键
profile前端可设，但由后端 registry 持有真源- 页面 AI 设置页能显示当前
profile - 后端提供当前 scope 的真实 tool registry
- 页面 AI 设置页能显示当前 scope 的已注册工具
F. 验证
- route 测试覆盖 sidecar 主路径与 Hermes fallback
- 后端最小 smoke / 单测覆盖文档页 run route
- 验证在线主路径下标题改名与正文改写都能完成结构化回写
说明：
task111-phase7-document-ai-online-smoke.js已验证doc_insert_blocks -> slash_run -> doc_replace_range在线主路径闭环
4. 本轮完成判定
当以下条件同时成立，才可以宣称本轮完成：
- 文档页 AI 在线主路径不再默认依赖 Hermes 主编排
- 文档页 AI 仍只围绕当前页主编辑区最小闭环工作
- 标题改名与正文改写仍沿正式页面命令语义回写
- Hermes 已退回 fallback / 对照链
- 页面 AI 的模型 / 设定 / 工具状态已进入正式可见配置面