28 lines
1.6 KiB
Markdown
28 lines
1.6 KiB
Markdown
---
|
||
name: mnote_lightrag_bridge
|
||
description: Use when an agent has LightRAG references or file_path/chunk_id and must convert them into MNote clickable citation links or openable local resource locators. Pair with lightrag_native for retrieval, but use this bridge for MNote source registry and citation/open-reference mapping.
|
||
---
|
||
|
||
# MNote LightRAG Bridge
|
||
|
||
用途：把 LightRAG 原生检索结果映射成 MNote 可点击、可打开、可定位的引用。它不是检索系统本身。
|
||
|
||
## 工具分层
|
||
|
||
- `lightrag_native`：LightRAG 原生 MCP，负责 `query_text`、`query_data`、graph、documents、pipeline。
|
||
- `mnote_lightrag_bridge`：MNote bridge，负责 source registry、`file_path/chunk_id` 映射、`citationUrl`、`openAction`。
|
||
|
||
## 使用流程
|
||
|
||
1. 先用 `lightrag_native.query_text` 或 `lightrag_native.query_data` 做资料库检索。
|
||
2. 从返回的 `references[]` 里取 `file_path`，有 `chunk_id` 时一并保留。
|
||
3. 调用 `mnote_lightrag_bridge.open_mnote_reference`，输入 `file_path` / `chunk_id` / `workspace_id` / `root_uri`。
|
||
4. 最终回答引用 bridge 返回的 `citationMarkdown` 或让 MNote UI 渲染 citation；不要手写 `/documents`、`file://`、LightRAG dashboard URL。
|
||
|
||
## 边界
|
||
|
||
- `file_path` 是 LightRAG provider 内部文件名，不等于用户本地相对路径。
|
||
- 只有 MNote registry 命中的 reference 才能映射回本地资源和页面。
|
||
- `locatorDegraded=true` 时必须说明“来源定位降级”，不能伪造页码、bbox、段落或坐标。
|
||
- 不要用 bridge 做召回、重排、全文 fallback 或资料管理。
|