feat(rag): harden post-LightRAG runtime

Retire legacy OCR/media/evidence fallbacks, add local-folder event bus and Page Aggregate guards, and archive completed design checklists.

Validation: cargo test -p mnote-web -- --test-threads=1; cargo test --workspace -- --test-threads=1; git diff --check; codegraph sync .; codegraph_status.

design/07-ai/process/7-47-mnote-public-capability-plugin-registry-v1.md

@@ -3,13 +3,22 @@
 > 状态：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 维持现状，不纳入统一注册表迁移范围。
+>
+> 2026-06-07 口径更新：7-50 后资料库问答主线已切到 LightRAG，第一批能力包试点从旧 `mnote-local-index` 改为 `mnote-knowledge-rag`。`mnote-document-evidence` / `mnote-local-index` 只作为兼容 alias 映射到 `mnote-knowledge-rag`，不再恢复 `mnote.evidence.*` / `mnote.index.*` 作为 active tool。
+
+## 当前实施状态
+
+- Phase A 已落地：`rust/crates/mnote-web/src/hermes_tools/skill.rs` 已有 `MnoteCapabilityPack` / `CAPABILITY_PACKS`，`manifest.rs` 已输出 `capabilities[]` 并给 tools 标注 `capabilityId` / `capabilityIds`。
+- Phase B 已落地：`/api/hermes/client/capabilities` 已存在，Page AI `runtime=mnote` 技能目录优先请求 capabilities，能力 payload 内含 tools、readOnly、contextRefs、enabled/status。
+- Phase C 已落地：`/api/hermes/client/capabilities/toggle` 会同步 capability skill preference 和 profile tool disabled policy；直接调用被关闭 tool 会走 `mnote_tool_disabled` 硬拒绝。
+- Phase D 已完成 Reasonix 侧最小收口：`scripts/reasonix-acp-wrapper.mjs` 启动时优先读取 `/api/hermes/tools/mnote/manifest` 动态注册 MNote tool specs，mnote-web 不可用时才回落到静态 fallback；Hermes Python plugin 生成仍作为后续独立收口。
 
 ## 0. 用户口径
 
 用户不需要理解 skill、plugin、tool 的区别。Page AI 设置中统一展示为“AI 能力”：
 
 - `当前页读取`
-- `本地索引与证据检索`
+- `资料库问答`
 - `本地文件编辑`
 - `思维导图`
 - `ONLYOFFICE 实时编辑`
@@ -35,7 +44,7 @@
 现有内置 skill：
 
 - `mnote-current-page`
-- `mnote-local-index`
+- `mnote-knowledge-rag`
 - `mnote-local-file`
 - `mnote-onlyoffice-live`
 - `mnote-mindmap`
@@ -46,7 +55,7 @@
 - skill 是 Rust 静态注册，正文来自 `skills/*/SKILL.md`。
 - `/api/hermes/client/skills?runtime=mnote&agentId=...` 通过 `mnote_builtin_skills_payload()` 输出到 UI。
 - 每个 skill 现在已经带 `toolNames` 和 `requiresContextRefs`，但这些只是弱引用，不是一个正式 capability/plugin 合同。
-- `mnote.skill.read` 能懒加载正文；旧 `mnote-document-evidence` 已作为兼容别名映射到 `mnote-local-index`。
+- `mnote.skill.read` 能懒加载正文；旧 `mnote-document-evidence` / `mnote-local-index` 只作为兼容别名映射到 `mnote-knowledge-rag`，不恢复旧 evidence / index 工具。
 
 ### 1.2 MNote tools
 
@@ -55,7 +64,8 @@
 现有工具大类：
 
 - skill/context：`mnote.skill.read`、`mnote.context.*`
-- evidence/index：`mnote.evidence.*`、`mnote.index.*`
+- knowledge-rag：`mnote.knowledge_rag.status`、`mnote.knowledge_rag.query`、`mnote.knowledge_rag.open_reference`
+- retired evidence/index：`mnote.evidence.*`、`mnote.index.*` 只保留历史对照，不作为 active manifest / capability 示例
 - doc/block/page/artifact：`mnote.doc.*`、`mnote.block.*`、`mnote.page.*`、`mnote.artifact.*`
 - mindmap：`mnote.mindmap.*`
 - office/onlyoffice：`mnote.office.*`、`mnote.onlyoffice.*`
@@ -178,25 +188,22 @@ pub struct MnoteCapabilityPack {
       "title": "MNote",
       "capabilities": [
         {
-          "id": "mnote-local-index",
-          "title": "MNote local index",
-          "description": "Search local documents with evidence locators and manage local index scopes.",
+          "id": "mnote-knowledge-rag",
+          "title": "资料库问答",
+          "description": "Ask the LightRAG-backed knowledge library and open returned MNote source references.",
           "enabled": true,
           "toggleable": true,
           "readOnly": false,
-          "skillId": "mnote-local-index",
+          "skillId": "mnote-knowledge-rag",
           "toolNames": [
-            "mnote.evidence.search",
-            "mnote.evidence.read",
-            "mnote.evidence.open",
-            "mnote.index.status",
-            "mnote.index.refresh",
-            "mnote.index.update_settings"
+            "mnote.knowledge_rag.status",
+            "mnote.knowledge_rag.query",
+            "mnote.knowledge_rag.open_reference"
           ],
           "tools": [
             {
-              "name": "mnote.index.update_settings",
-              "kind": "write",
+              "name": "mnote.knowledge_rag.query",
+              "kind": "read",
               "status": "available",
               "enabled": true,
               "requiresWritePermission": true
@@ -221,7 +228,7 @@ pub struct MnoteCapabilityPack {
 {
   "runtime": "mnote",
   "profile": "reasonix",
-  "id": "mnote-local-index",
+  "id": "mnote-knowledge-rag",
   "enabled": true
 }
 ```
@@ -240,16 +247,16 @@ pub struct MnoteCapabilityPack {
 {
   "capabilities": [
     {
-      "id": "mnote-local-index",
-      "skillId": "mnote-local-index",
-      "toolNames": ["mnote.evidence.search", "mnote.index.status"]
+      "id": "mnote-knowledge-rag",
+      "skillId": "mnote-knowledge-rag",
+      "toolNames": ["mnote.knowledge_rag.status", "mnote.knowledge_rag.query", "mnote.knowledge_rag.open_reference"]
     }
   ],
   "tools": [
     {
-      "name": "mnote.index.status",
-      "capabilityId": "mnote-local-index",
-      "capabilityScope": ["index.read", "evidence.read"]
+      "name": "mnote.knowledge_rag.query",
+      "capabilityId": "mnote-knowledge-rag",
+      "capabilityScope": ["knowledge_rag.read", "evidence.read"]
     }
   ]
 }
@@ -261,8 +268,8 @@ pub struct MnoteCapabilityPack {
 
 在 Page AI 的 Skills 页中，用户看到的是统一“AI 能力”列表，不再分 skill / plugin / tool：
 
-- 行标题：`MNote local index`
-- 副标题：`索引 / 证据检索 · 6 tools · 需要 folder`
+- 行标题：`资料库问答`
+- 副标题：`知识库 / LightRAG · 3 tools · 需要 folder`
 - 状态 chip：`只读` / `可写` / `部分工具关闭` / `只读上下文不可写`
 - 主开关：启用/关闭整个能力包
 - 展开项：列出 tools，显示 read/write、enabled、status
@@ -281,12 +288,12 @@ Runtime 页继续保留 `mnote tools`，但作为高级调试面：
 
 ### 4.3 索引面板与能力包关系
 
-Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；Page AI 的 `mnote-local-index` capability 是 agent 能力开关。
+Sidebar 的“资料库 / 知识库设置”仍是用户直接管理 LightRAG source、索引范围和服务状态的产品 UI；Page AI 的 `mnote-knowledge-rag` capability 是 agent 能力开关。
 
 两者职责不同：
 
-- 索引设置面板：用户手动新增/删除/刷新索引范围。
-- MNote local index capability：允许 agent 使用工具帮用户查看、新增、刷新、删除索引范围。
+- 知识库设置面板：用户手动新增/删除/刷新 source，查看 LightRAG 服务和 source registry 状态。
+- MNote knowledge-rag capability：允许 agent 使用工具查询资料库、查看状态和打开返回来源；sourcePaths 当前只过滤返回 references，不声称 provider 层预过滤 raw chunks。
 
 ## 5. Runtime 适配
 
@@ -302,8 +309,8 @@ Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；
 
 - 删除 `REASONIX_TOOL_TO_MNOTE_TOOL` 手写表。
 - 工具名转换统一由函数生成：
-  - `mnote.index.status` -> `mnote_index_status`
-  - `mnote.evidence.search` -> `mnote_evidence_search`
+  - `mnote.knowledge_rag.status` -> `mnote_knowledge_rag_status`
+  - `mnote.knowledge_rag.open_reference` -> `mnote_knowledge_rag_open_reference`
 
 ### 5.2 Hermes ACP
 
@@ -332,7 +339,7 @@ Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；
 
 验收：
 
-- `mnote-local-index` 在 `/client/skills?runtime=mnote` 可见。
+- `mnote-knowledge-rag` 在 `/client/skills?runtime=mnote` 与 `/client/capabilities?runtime=mnote` 可见，`mnote-local-index` 不再作为 active capability 暴露。
 - `/api/hermes/tools/mnote/manifest` 可看到 `capabilities[]`。
 - 旧 `mnote.skill.read` 不破。
 
@@ -345,8 +352,8 @@ Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；
 
 验收：
 
-- Page AI Skills 页中 `MNote local index` 像公共 skill 一样可见。
-- 展开能看到 `mnote.evidence.*` 和 `mnote.index.*`。
+- Page AI Skills / 能力页中 `资料库问答` 像公共 skill 一样可见。
+- 展开能看到 `mnote.knowledge_rag.*`，看不到 `mnote.evidence.*` / `mnote.index.*` active tools。
 - 开关 capability 后，下一次 run 的 `skillPreferences.mnote` 同步变化。
 
 ### Phase C：能力包开关驱动工具开关
@@ -357,8 +364,8 @@ Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；
 
 验收：
 
-- 关闭 `mnote-local-index` 后 agent 不再看到该 skill 摘要。
-- 关闭后直接调用 `mnote.index.status` 返回 `mnote_tool_disabled` 或 capability disabled。
+- 关闭 `mnote-knowledge-rag` 后 agent 不再看到该 skill 摘要。
+- 关闭后直接调用 `mnote.knowledge_rag.query` 返回 `mnote_tool_disabled` 或 capability disabled。
 - 再打开后恢复。
 
 ### Phase D：生成 Reasonix/Hermes adapters
@@ -373,22 +380,19 @@ Sidebar 的“索引设置”仍是用户直接管理索引范围的产品 UI；
 - `node scripts/reasonix-acp-wrapper.mjs` selftest 覆盖 manifest 动态注册。
 - `hermes plugins list` / Hermes tool list 显示与 Rust manifest 一致。
 
-## 7. 对 mnote-local-index 的落地形态
+## 7. 对 mnote-knowledge-rag 的落地形态
 
-`mnote-local-index` 是第一批公共能力包试点：
+`mnote-knowledge-rag` 是第一批公共能力包试点：
 
-- skill：`skills/mnote-local-index/SKILL.md`
+- skill：`skills/mnote-knowledge-rag/SKILL.md`
 - tools：
-  - `mnote.evidence.search`
-  - `mnote.evidence.read`
-  - `mnote.evidence.open`
-  - `mnote.index.status`
-  - `mnote.index.refresh`
-  - `mnote.index.update_settings`
+  - `mnote.knowledge_rag.status`
+  - `mnote.knowledge_rag.query`
+  - `mnote.knowledge_rag.open_reference`
 - requiresContextRefs：`folder`
-- readOnly：`false`
-- write guard：只 `mnote.index.update_settings` 写设置；必须 `dryRun/idempotencyKey`；共享只读禁止写。
-- UI 文案：`索引 / 证据检索 · 可管理索引范围`
+- readOnly：`true`
+- write guard：本能力包不写用户 source；source 管理 UI / API 另归知识库设置面，不通过 agent capability 暴露写入。
+- UI 文案：`知识库 / LightRAG · 可回跳来源`
 
 ## 8. 非目标