lix-2026
9551d4c1dc
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.
18 lines
1.4 KiB
Markdown
18 lines
1.4 KiB
Markdown
# 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。
|