mnote/skills/mnote-lightrag-bridge/SKILL.md

name, description

name	description
mnote_lightrag_bridge	Use when an agent must query MNote's LightRAG-backed knowledge library through MNote source registry, or convert LightRAG references/file_path/chunk_id into clickable MNote locators.

MNote LightRAG Bridge

2026-06-28 口径：LightRAG bridge 已退为 legacy fallback / 历史调试工具。普通资料库问答默认走 WeKnora / OpenHub，不再优先使用本 skill。

用途：把 agent 的资料库查询稳定路由到 MNote knowledge_rag facade，并把引用映射成 MNote 可点击、可打开、可定位的 locator。

工具分层

• mnote_lightrag_bridge.mnote_knowledge_rag_query：首选资料库问答入口，调用 MNote /api/knowledge-rag/query，返回已映射的 references/citations。
• mnote_lightrag_bridge.mnote_knowledge_rag_section_context：按 documentStructureIndex 中的 section range 拉取有限 sidecar blocks/chunks，用于大书/长文档二次阅读，不做召回或重排。
• mnote_lightrag_bridge.mnote_knowledge_rag_open_reference / open_mnote_reference：把 file_path/chunk_id 映射为 citationUrl、openAction。
• lightrag_native：只在需要 LightRAG 原生 graph/documents/pipeline 管理时使用；普通资料库问答优先走 MNote bridge，避免绕过 source registry 和 citation contract。

使用流程

1. 资料库问答直接调用 mnote_lightrag_bridge.mnote_knowledge_rag_query；大书/长文档问题传 source_paths 并设置 include_document_structure_index=true。
2. 回答依据必须来自返回的 references[] / citations[]；documentStructureIndex 只作章节导航，不单独当证据。
3. 需要阅读某章节时，调用 mnote_knowledge_rag_section_context，传 source_path 以及 start_block_ordinal/end_block_ordinal 或 start_paragraph_ordinal/end_paragraph_ordinal，并限制 max_blocks/max_chars。
4. 如已有 LightRAG 原生 file_path/chunk_id，调用 mnote_lightrag_bridge.open_mnote_reference 或 mnote_knowledge_rag_open_reference 转成 MNote locator。
5. 最终回答引用 bridge 返回的 citationMarkdown 或让 MNote UI 渲染 citation；不要手写 /documents、file://、LightRAG dashboard URL。

边界

• file_path 是 LightRAG provider 内部文件名，不等于用户本地相对路径。
• 普通问答不要直接调用 lightrag_native.query_* 绕过 MNote；否则 citations 可能没有 source registry 和定位信息。
• 只有 MNote registry 命中的 reference 才能映射回本地资源和页面。
• locatorDegraded=true 时必须说明“来源定位降级”，不能伪造页码、bbox、段落或坐标。
• 不要用 bridge 做召回、重排、全文 fallback 或资料管理。