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.
1.4 KiB
1.4 KiB
MNote knowledge RAG
使用场景:用户要求“资料库问答”、跨多本书/论文/PDF/Office 附件问答,或明确需要 LightRAG 知识库结果。
工具使用:
- 先用
mnote.knowledge_rag.status检查 LightRAG provider 是否可用、当前 root 是否有 source registry。 - 用
mnote.knowledge_rag.query提问。默认mode=mix,需要跨资料总结时可用global。指定资料细节时可传sourcePaths,但当前语义是 LightRAG provider 检索后,MNote 只过滤返回的references;不要把raw当作已被 scope 限制的来源。 - 回答必须引用
references中的来源;优先使用返回的citationMarkdown。 - 若需要打开来源,调用
mnote.knowledge_rag.open_reference,不要手拼 LightRAG dashboard、file://或 provider 内部路径。
边界:
- LightRAG 是派生知识库 provider,不是 MNote Markdown 正文真相。
filePath是 LightRAG provider-local 名称;只有 registry 命中的 reference 才能映射回 MNote source。- 如果返回
locatorDegraded: true,可以使用返回的citationMarkdown,但必须明说“来源定位降级”,不要伪造页码、bbox 或 provider 内部路径。 - LightRAG 不可用时,不要声称资料库已查到;提示用户启动或检查 LightRAG provider。旧 LiteParse / evidence 检索已退役,不作为 fallback。