lix-2026
4a7efd4a30
- ACP client/session manager: Reasonix desktop live session context - Hermes tools: knowledge_rag tool manifest and skill updates - Browser runtime: sidebar page AI permission/profile/render/session/tree modules - Routes: hermes_client, hermes_tools, knowledge_rag, web_shell - Scripts: reasonix ACP wrapper, LightRAG MCP, smoke tasks 159/558/559/561/562 - Skills: mnote-knowledge-rag and mnote-lightrag-bridge SKILL.md updates
2.5 KiB
2.5 KiB
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
用途：把 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。
使用流程
- 资料库问答直接调用
mnote_lightrag_bridge.mnote_knowledge_rag_query；大书/长文档问题传source_paths并设置include_document_structure_index=true。 - 回答依据必须来自返回的
references[]/citations[]；documentStructureIndex只作章节导航，不单独当证据。 - 需要阅读某章节时，调用
mnote_knowledge_rag_section_context，传source_path以及start_block_ordinal/end_block_ordinal或start_paragraph_ordinal/end_paragraph_ordinal，并限制max_blocks/max_chars。 - 如已有 LightRAG 原生
file_path/chunk_id，调用mnote_lightrag_bridge.open_mnote_reference或mnote_knowledge_rag_open_reference转成 MNote locator。 - 最终回答引用 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 或资料管理。