chore: align ai stack with openhub weknora

2026-06-28 18:35:56 +08:00
parent 3b0e12455e
commit ee6612028d
22 changed files with 154 additions and 95 deletions
@@ -4,7 +4,9 @@
 >
 > 当前状态：`DONE`
 >
-> 2026-05-22 口径补充：本文完成的是“local-first workspace + Convex 降级控制面”的阶段性方案；后续 `2-8` 已继续把默认控制面从 Convex 替换为 Rust SQLite `control-plane`。因此本文中“Convex / 服务端控制面”的表述只作为阶段性历史背景理解；当前默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 已由 SQLite control-plane 承接，Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
+> 2026-05-22 口径补充：本文完成的是“local-first workspace + Convex 降级控制面”的阶段性方案；后续 `2-8` 已继续把默认控制面从 Convex 替换为 Rust SQLite `control-plane`。因此本文中“Convex / 服务端控制面”的表述只作为阶段性历史背景理解；当前默认 auth、membership、share grants、sync state、AI policy、Page AI runtime session 已由 SQLite control-plane 承接，Convex 仅保留历史迁移源、显式 cloud source / compat / sync replica 边界。
+>
+> 2026-06-28 口径补充：Hermes / Reasonix / LightRAG 已退出当前新增主线；当前 Page AI 与知识库融合方向按 OpenHub / opencode / WeKnora 理解，旧名称只作为历史命名、legacy route 或迁移对照。
 >
 > 本稿目的：
 > 1. 固定早期产品形态：10 人以内、用户笔记默认独立、可分享、AI 隔离且可共享。
@@ -79,13 +81,13 @@ User

 更准确的产品定义是：

-> **MNote = VSCode 简化版工作区内核 + tiptap markdown 编辑器 + Hermes / Reasonix agent + simplemindmap / office 插件 + Wolai 风格 web 壳 + 鉴权控制面。**
+> **MNote = VSCode 简化版工作区内核 + tiptap markdown 编辑器 + OpenHub / opencode agent + WeKnora 知识库融合 + simplemindmap / office 插件 + Wolai 风格 web 壳 + 鉴权控制面。**

 拆开看：

 - **VSCode 简化版工作区内核**：本地文件夹、目录树、页面树、资源树、拖拽、重命名、移动、回收站、导入导出。
 - **tiptap markdown 编辑器**：页面正文的前端显示与交互层，消费本地文件投影，不承担 agent 主编辑面职责。
- **Hermes / Reasonix agent**：在授权目录白名单内直接读写本地文件，尽量复用它们已有的权限和文件编辑能力。
+- **OpenHub / opencode agent**：在 MNote 宿主授权 scope 内处理 Page AI 对话、文件引用和 WeKnora 知识库引用；旧 Hermes / Reasonix 只作为 legacy/debug 对照。
 - **simplemindmap / office 插件**：作为资源型编辑器或附件打开器存在，不把它们重新降格成 markdown 文本块。
 - **Wolai 风格 web 壳**：提供统一导航、主题、页面壳、AI 面板、侧边栏和分享入口。
 - **鉴权控制面**：负责登录、用户隔离、目录授权、分享授权、同步状态和审计，而不是默认正文存储。
@@ -898,7 +900,7 @@ local-first 下，AI 的长期主路径不是继续发明一套 MNote 专用编

 #### A. 防走偏护栏与口径同步

- [x] A1. 固定主路径口径：`MNote = VSCode 简化版工作区 + tiptap markdown 显示/编辑层 + Hermes/Reasonix agent + 插件 + Wolai web 壳 + 鉴权控制面`。
+- [x] A1. 固定主路径口径：`MNote = VSCode 简化版工作区 + tiptap markdown 显示/编辑层 + OpenHub/opencode agent + WeKnora 知识库融合 + 插件 + Wolai web 壳 + 鉴权控制面`。
  - 文档：本稿第 2.1、2.4、5、6 节。
  - 验收：普通 local-first Markdown 编辑不再被描述为必须走 `mnote.block.*`、`mnote.doc.markdown_edit` 或 Convex documents。
 - [x] A2. 建立 Convex 主存储新增检查。
@@ -1,5 +1,7 @@
 # 7-18 [process] local-first agent 文件编辑控制面 v1

+> 2026-06-28 覆盖说明：本文中的 Hermes / Reasonix 主路径口径已退为历史参考。当前 Page AI / agent runtime 主线以 OpenHub / opencode / WeKnora 融合设计为准，见 `7-68-openhub-weknora-mnote-deep-fusion-v1.md` 与 `7-69-weknora-native-embed-mnote-openhub-governance-v1.md`。本文仅保留 local-first 文件授权、watcher 同步和冲突模型的参考价值。
+
 > 创建时间：2026-05-22
 >
 > 当前状态：`PROCESS`
@@ -245,7 +245,7 @@ PPT：
   - 必须保存截图并检查 `pageErrors=[]`

 3. Tool API smoke
-   - 通过 `/api/hermes/tools/mnote/call`
+   - 通过 `/api/mnote/tools/call`；旧 `/api/hermes/tools/mnote/call` 只作为 legacy alias 验证
   - 验证 agent 实际可调用

 完成标准：
@@ -1,5 +1,7 @@
 # 7-47 MNote 公共 capability/plugin 注册表设计 v1

+> 2026-06-28 覆盖说明：本文的 Hermes / Reasonix / LightRAG 能力注册口径已退为 legacy 参考。当前能力模型应围绕 OpenHub / opencode / WeKnora，旧 `mnote-knowledge-rag` 与 `mnote_lightrag_bridge` 仅保留兼容映射和迁移对照。
+
 > 状态：process
 >
 > 目标：把当前分裂的 MNote builtin skill、mnote tool manifest、Hermes plugin、Reasonix wrapper 和 Page AI UI 开关收口为同一个“AI 能力”模型。对用户来说 skill / plugin / tool 都是“授予 AI 的能力”，UI 不应暴露实现层分类；实现层再把一个能力映射到说明书、工具、runtime adapter 和权限策略。本轮只整理 MNote 公共能力；Reasonix / Hermes 自带的 skills/plugins 维持现状，不纳入统一注册表迁移范围。
@@ -72,8 +74,10 @@

 执行入口：

- `/api/hermes/tools/mnote/manifest`
- `/api/hermes/tools/mnote/call`
+- 当前中性入口：`/api/mnote/tools/manifest`
+- 当前中性入口：`/api/mnote/tools/call`
+- legacy alias：`/api/hermes/tools/mnote/manifest`
+- legacy alias：`/api/hermes/tools/mnote/call`
 - `execute_mnote_tool_call()` 统一做认证、profile 禁用检查、workspace 校验、capabilityScope 校验、写入 guard、audit、idempotency。

 问题：
@@ -94,7 +98,7 @@
 - 这是 Hermes 用户插件，不在 mnote repo 内。
 - `plugin.yaml` 只列出旧批次工具：`mnote_page_get/save/update_title/update_options`、`mnote_doc_*`、`mnote_block_*`、artifact 等。
 - 没有 `mnote_evidence_*`、`mnote_index_*`、mindmap、onlyoffice live 等新工具。
- `__init__.py` 手写 Python wrapper，把 Hermes tool call 转发到 `/api/hermes/tools/mnote/call`。
+- `__init__.py` 手写 Python wrapper，把 Hermes tool call 转发到 legacy `/api/hermes/tools/mnote/call`；OpenHub/WeKnora 主线应使用 `/api/mnote/tools/call`。

 问题：

@@ -1,5 +1,7 @@
 # 7-54 RAG-Anything 对照后的多模态检索设计 v1

+> 2026-06-28 覆盖说明：本文围绕 LightRAG 增强撰写，已被 WeKnora / OpenHub 知识库主线覆盖。保留为多模态检索参考材料，不作为当前实施依据。
+
 > 创建时间：2026-06-08
 >
 > 当前状态：`process`
@@ -1,5 +1,7 @@
 # 7-61 [process] Yuxi reference: middleware tool composition, extensions entry, knowledge settings UI, and local dashboard v1

+> 2026-06-28 覆盖说明：本文中 Hermes / LightRAG 相关实现口径已部分退为 legacy。仍可参考 Yuxi 的 middleware、extensions 入口和 dashboard 信息架构，但当前 MNote 知识库 / agent 主线以 OpenHub / opencode / WeKnora 为准。
+
 > 创建时间：2026-06-13
 >
 > 当前状态：`PROCESS`
@@ -490,4 +492,3 @@ def resolve_virtual_path(thread_id, virtual_path, *, uid):
 - 新增 smoke：`scripts/task561-extensions-settings-smoke.js`（Batch B+C）
 - 新增 smoke：`scripts/task561-dashboard-smoke.js`（Batch E）
 - 登录态浏览器验证：settings 扩展 tab、知识库详情页、Dashboard 页面均可正常访问
-
@@ -1,10 +1,10 @@
 # design 设计稿索引

-> 更新时间：2026-05-26
+> 更新时间：2026-06-28
 >
-> 当前产品口径：`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + Hermes/Reasonix agent + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
+> 当前产品口径：`VSCode 简化版工作区 + tiptap 的 Markdown 前端编辑器 + OpenHub/opencode agent + WeKnora 知识库融合 + simplemindmap/office 插件 + Wolai 主题 Web 壳 + 鉴权控制面`。
 >
-> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、ACP/Hermes runtime session 控制面；Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见：
+> 当前上位主线：local-first MVP 已初步完成；local-first workspace 是默认数据形态，本地 `.md` 是页面正文真相，Rust kernel / projection / command 持有语义，Rust SQLite control-plane 持有默认 auth、membership、share grants、sync state、AI policy、Page AI runtime session 控制面；Convex / 服务端只作为历史迁移源、显式 cloud source、compat 和 sync replica。入口设计见：
 > `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-2-local-first-workspace-convex-control-plane-v1.md`
 > `/mnt/Data1T/mnote/design/02-convex-rust-long-term-architecture/done/2-8-convex-replace-with-rust-sqlite-control-plane-v1.md`
 >