feat(rag): align LightRAG native citations and MCP bridge

rust/crates/mnote-web/browser/document-editor-adapter-runtime.js

@@ -352,6 +352,10 @@ import {
       bbox: url.searchParams.get('bbox') || undefined,
       sourceMapPath: String(url.searchParams.get('sourceMapPath') || '').trim(),
       blockId: String(url.searchParams.get('blockId') || '').trim(),
+      paragraphOrdinal: String(url.searchParams.get('paragraphOrdinal') || '').trim(),
+      paraIdStart: String(url.searchParams.get('paraIdStart') || '').trim(),
+      paraIdEnd: String(url.searchParams.get('paraIdEnd') || '').trim(),
+      textFingerprint: String(url.searchParams.get('textFingerprint') || '').trim(),
       evidenceText: String(url.searchParams.get('evidenceText') || '').trim(),
       lineRange: url.searchParams.get('lineRange') || null,
       charRange: url.searchParams.get('charRange') || null,

rust/crates/mnote-web/browser/document-resource-tab-runtime.js

@@ -988,7 +988,11 @@ export const createResourceTabRuntime = (dependencies = {}) => {
     const searchQuery = String(input.searchQuery || locator?.searchQuery || params.searchQuery || '').trim();
     const lineRange = input.lineRange || locator?.lineRange || params.lineRange || null;
     const charRange = input.charRange || locator?.charRange || params.charRange || null;
-    if (!locator && !Number.isFinite(page) && !bbox && !sourceMapPath && !blockId && !evidenceText && !lineRange && !charRange) return null;
+    const paragraphOrdinal = String(input.paragraphOrdinal ?? locator?.paragraphOrdinal ?? params.paragraphOrdinal ?? '').trim();
+    const paraIdStart = String(input.paraIdStart || locator?.paraIdStart || params.paraIdStart || '').trim();
+    const paraIdEnd = String(input.paraIdEnd || locator?.paraIdEnd || params.paraIdEnd || '').trim();
+    const textFingerprint = String(input.textFingerprint || locator?.textFingerprint || params.textFingerprint || '').trim();
+    if (!locator && !Number.isFinite(page) && !bbox && !sourceMapPath && !blockId && !evidenceText && !lineRange && !charRange && !paragraphOrdinal && !paraIdStart && !textFingerprint) return null;
     return {
       schema: 'mnote.evidence_locator.v1',
       ...(locator || {}),
@@ -1000,6 +1004,10 @@ export const createResourceTabRuntime = (dependencies = {}) => {
       searchQuery,
       lineRange,
       charRange,
+      paragraphOrdinal,
+      paraIdStart,
+      paraIdEnd,
+      textFingerprint,
     };
   };
 
@@ -1017,6 +1025,10 @@ export const createResourceTabRuntime = (dependencies = {}) => {
       if (bbox) url.searchParams.set('bbox', bbox);
       if (locator.sourceMapPath) url.searchParams.set('sourceMapPath', String(locator.sourceMapPath));
       if (locator.blockId) url.searchParams.set('blockId', String(locator.blockId));
+      if (locator.paragraphOrdinal) url.searchParams.set('paragraphOrdinal', String(locator.paragraphOrdinal));
+      if (locator.paraIdStart) url.searchParams.set('paraIdStart', String(locator.paraIdStart));
+      if (locator.paraIdEnd) url.searchParams.set('paraIdEnd', String(locator.paraIdEnd));
+      if (locator.textFingerprint) url.searchParams.set('textFingerprint', String(locator.textFingerprint));
       if (locator.evidenceText) url.searchParams.set('evidenceText', String(locator.evidenceText));
       if (locator.searchQuery) url.searchParams.set('searchQuery', String(locator.searchQuery));
       if (url.pathname === '/office-preview' && frame.contentWindow) {
@@ -1038,6 +1050,10 @@ export const createResourceTabRuntime = (dependencies = {}) => {
           bbox,
           sourceMapPath: locator.sourceMapPath || '',
           blockId: locator.blockId || '',
+          paragraphOrdinal: locator.paragraphOrdinal || '',
+          paraIdStart: locator.paraIdStart || '',
+          paraIdEnd: locator.paraIdEnd || '',
+          textFingerprint: locator.textFingerprint || '',
           evidenceText: locator.evidenceText || '',
           searchQuery: locator.searchQuery || '',
         }, window.location.origin);

rust/crates/mnote-web/browser/sidebar-page-ai-runtime.js

@@ -2038,6 +2038,22 @@ export function createSidebarPageAiRuntime(context) {
     });
   }
 
+  function pageAiKnowledgeRagFallbackQuery(prompt) {
+    var text = searchText(prompt);
+    if (!text) return '';
+    var afterColon = text.split(/[：:]/).slice(1).join('：').trim();
+    var candidate = afterColon || text;
+    candidate = candidate
+      .replace(/^(请|请用|帮我|帮忙|用)?(资料库|知识库|lightrag|rag)?(搜索|检索|查找|查询|回答|说明|解释|总结)?/i, '')
+      .replace(/(请)?(给出|给我|附上|提供)?(链接|引用|来源|出处|证据|定位).*$/i, '')
+      .trim();
+    var stopIndex = candidate.search(/(在|的|是|有哪些|有什么|如何|怎么|用于|用途|作用|资料|文献|论文)/);
+    if (stopIndex > 0) candidate = candidate.slice(0, stopIndex).trim();
+    var cjkMatch = candidate.match(/[A-Za-z0-9\u4e00-\u9fff·α-ωΑ-Ω\-]{2,24}/);
+    if (cjkMatch && cjkMatch[0]) return cjkMatch[0];
+    return text;
+  }
+
   function pageAiCleanDegradedCitationNotes(content) {
     return String(content || '')
       .split('\n')
@@ -2050,38 +2066,92 @@ export function createSidebarPageAiRuntime(context) {
       .trim();
   }
 
-  function pageAiCollectKnowledgeRagApiCitations(payload) {
-    var references = pageAiNormalizeArray(payload && payload.references);
-    var citations = references.map(function(reference) {
-      return String(reference && reference.citationMarkdown || '').trim();
-    }).filter(Boolean);
-    var hasPreciseCitation = references.some(function(reference) {
-      return String(reference && reference.citationMarkdown || '').trim() && reference && reference.locatorDegraded !== true;
+  function pageAiCitationPrecisionLabel(value) {
+    var precision = searchText(value || '').toLowerCase();
+    if (precision === 'bbox') return '精确定位';
+    if (precision === 'paragraph') return '段落级';
+    if (precision === 'file') return '文件级';
+    return '';
+  }
+
+  function pageAiCitationSourceTitle(citation) {
+    if (!citation || typeof citation !== 'object') return '';
+    var path = searchText(citation.sourceRootRelativePath || citation.sourcePath || citation.filePath || citation.lightRagFilePath || '');
+    if (path) {
+      var parts = path.split('/').filter(Boolean);
+      return parts[parts.length - 1] || path;
+    }
+    var markdown = searchText(citation.citationMarkdown || '');
+    var labelMatch = markdown.match(/^\[([^\]]+)\]/);
+    return labelMatch ? labelMatch[1] : '';
+  }
+
+  function pageAiCitationDisplayMarkdown(value) {
+    if (typeof value === 'string') return value.trim();
+    if (!value || typeof value !== 'object') return '';
+    var markdown = searchText(value.citationMarkdown || '');
+    var citationId = searchText(value.citationLabel || (value.citationId ? '[' + value.citationId + ']' : ''));
+    var title = pageAiCitationSourceTitle(value);
+    var headingPath = pageAiNormalizeArray(value.headingPath).map(function(item) {
+      return searchText(item);
+    }).filter(Boolean).join(' > ');
+    var precisionLabel = pageAiCitationPrecisionLabel(value.locatorPrecision);
+    var quote = searchText(value.displayQuote || value.quote || '');
+    if (quote.length > 120) quote = quote.slice(0, 117) + '...';
+    var head = markdown || title;
+    if (citationId && head.indexOf(citationId) < 0) head = citationId + ' ' + head;
+    var details = [];
+    if (precisionLabel) details.push(precisionLabel);
+    if (headingPath) details.push(headingPath);
+    if (quote) details.push(quote);
+    return [head].concat(details).filter(Boolean).join(' · ').trim();
+  }
+
+  function pageAiFilterCitationCards(values) {
+    var cards = pageAiNormalizeArray(values);
+    var hasPreciseCitation = cards.some(function(value) {
+      if (typeof value === 'string') return value.indexOf('来源定位降级') < 0;
+      return value && typeof value === 'object' && searchText(value.citationMarkdown || '') && value.locatorDegraded !== true;
     });
     var seen = {};
-    return citations.filter(function(citation) {
-      if (seen[citation]) return false;
-      if (hasPreciseCitation && citation.indexOf('来源定位降级') >= 0) return false;
-      seen[citation] = true;
+    return cards.map(pageAiCitationDisplayMarkdown).filter(function(card, index) {
+      var source = cards[index];
+      if (!card || seen[card]) return false;
+      if (hasPreciseCitation) {
+        if (typeof source === 'string' && source.indexOf('来源定位降级') >= 0) return false;
+        if (source && typeof source === 'object' && source.locatorDegraded === true) return false;
+      }
+      seen[card] = true;
       return true;
     }).slice(0, 5);
   }
 
+  function pageAiCollectKnowledgeRagApiCitations(payload) {
+    var structuredCitations = pageAiNormalizeArray(payload && payload.citations);
+    if (structuredCitations.length) {
+      return pageAiFilterCitationCards(structuredCitations);
+    }
+    var references = pageAiNormalizeArray(payload && payload.references);
+    return pageAiFilterCitationCards(references);
+  }
+
   async function pageAiAppendKnowledgeRagFallbackCitations(runId, promptText) {
     if (!pageAiPromptNeedsKnowledgeRagCitations(promptText)) return;
     var rootUri = currentRootUri();
     if (!rootUri) return;
+    var fallbackQuery = pageAiKnowledgeRagFallbackQuery(promptText);
+    if (!fallbackQuery) return;
     try {
-      var response = await fetch('/api/knowledge-rag/query', {
+      var response = await fetch('/api/knowledge-rag/search', {
         method: 'POST',
         headers: { 'content-type': 'application/json', 'accept': 'application/json' },
         body: JSON.stringify({
           workspaceId: resolveWorkspaceId(document.body) || undefined,
           rootUri: rootUri,
-          query: String(promptText || '').trim(),
+          query: fallbackQuery,
           mode: 'mix',
-          topK: 8,
-          chunkTopK: 8,
+          topK: 12,
+          chunkTopK: 24,
           includeChunkContent: true
         })
       });
@@ -2193,10 +2263,11 @@ export function createSidebarPageAiRuntime(context) {
         return;
       }
       if (typeof node !== 'object') return;
-      if (typeof node.citationMarkdown === 'string') add(node.citationMarkdown);
+      if (typeof node.citationMarkdown === 'string') add(pageAiCitationDisplayMarkdown(node));
       if (Array.isArray(node.citationMarkdowns)) {
         node.citationMarkdowns.forEach(function(value) {
           if (typeof value === 'string') add(value);
+          else if (value && typeof value === 'object') add(pageAiCitationDisplayMarkdown(value));
           else visit(value);
         });
       }

rust/crates/mnote-web/browser/sidebar-page-settings-runtime.js

@@ -1342,9 +1342,21 @@ export function createSidebarPageSettingsRuntime(context) {
       var config = healthBody.configuration && typeof healthBody.configuration === 'object' ? healthBody.configuration : {};
       var llmModel = String(config.llm_model || config.llmModel || '');
       var vlmModel = String(config.vlm_model || config.vlmModel || '');
+      var rerank = status.rerank && typeof status.rerank === 'object' ? status.rerank : {};
+      var rerankStatus = String(rerank.status || 'unknown');
+      var rerankBinding = searchText(rerank.binding || '');
+      var rerankModel = searchText(rerank.model || '');
+      var rerankLabel = rerankStatus === 'disabled'
+        ? 'disabled'
+        : rerankStatus === 'available'
+          ? 'available'
+          : rerankStatus === 'unavailable'
+            ? 'unavailable'
+            : 'unknown';
       metaNode.innerHTML = '' +
         '<div><span>Dashboard</span><code>' + escapeHtml(dashboardUrl || '未配置') + '</code></div>' +
         '<div><span>Model</span><code>' + escapeHtml(llmModel || '未上报') + (vlmModel ? ' / VLM ' + escapeHtml(vlmModel) : '') + '</code></div>' +
+        '<div><span>Rerank</span><code>' + escapeHtml(rerankLabel + (rerankBinding ? ' · ' + rerankBinding : '') + (rerankModel ? ' · ' + rerankModel : '')) + '</code></div>' +
         '<div><span>Input</span><code>' + escapeHtml(inputDir || '未配置') + '</code></div>' +
         '<div><span>Storage</span><code>' + escapeHtml(workingDir || '未上报') + '</code></div>';
     }

rust/crates/mnote-web/browser/sidebar-tree-runtime.js

@@ -2135,6 +2135,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
           '<div class="wolai-search-options-left">' +
             '<span class="wolai-search-switch-control"><span>仅匹配标题</span><button type="button" class="wolai-search-switch" data-search-switch="title" role="switch" aria-checked="false" aria-label="仅匹配标题"></button></span>' +
             '<span class="wolai-search-switch-control"><span>精确匹配</span><button type="button" class="wolai-search-switch" data-search-switch="exact" role="switch" aria-checked="false" aria-label="精确匹配"></button></span>' +
+            '<span class="wolai-search-sort-control"><span>资料库模式</span><select class="wolai-search-sort-value" data-search-knowledge-mode aria-label="资料库检索模式"><option value="mix">综合</option><option value="hybrid">图谱混合</option><option value="naive">向量</option><option value="local">实体</option><option value="global">关系</option><option value="exact">关键词</option></select></span>' +
             '<span class="wolai-search-sort-control"><span>按编辑时间</span><button type="button" class="wolai-search-sort-value" data-search-sort="updated" aria-label="按编辑时间范围">所有</button></span>' +
             '<span class="wolai-search-sort-control"><span>按创建时间</span><button type="button" class="wolai-search-sort-value" data-search-sort="created" aria-label="按创建时间范围">所有</button></span>' +
           '</div>' +
@@ -2170,6 +2171,13 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
         scheduleSearchResultsRender();
       });
     });
+    var knowledgeModeSelect = overlay.querySelector('[data-search-knowledge-mode]');
+    if (knowledgeModeSelect) {
+      knowledgeModeSelect.addEventListener('change', function() {
+        searchUiState.hasRendered = false;
+        scheduleSearchResultsRender();
+      });
+    }
     if (closeButton) closeButton.addEventListener('click', closeSearchModal);
     overlay.addEventListener('click', function(event) {
       if (event.target === overlay) closeSearchModal();
@@ -2186,6 +2194,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
     metaHtml: '',
     resultsHtml: '',
     items: [],
+    knowledgeMode: 'mix',
     sourceCollapsed: {},
     scrollTop: 0,
     signature: '',
@@ -2236,6 +2245,27 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
     return button instanceof HTMLElement && button.getAttribute('aria-checked') === 'true';
   }
 
+  function searchKnowledgeModeValue(overlay) {
+    var select = overlay.querySelector('[data-search-knowledge-mode]');
+    var value = select && 'value' in select ? searchText(select.value).toLowerCase() : '';
+    if (['mix', 'hybrid', 'naive', 'local', 'global', 'exact'].indexOf(value) >= 0) return value;
+    return 'mix';
+  }
+
+  function knowledgeSearchRequestMode(overlay) {
+    if (searchSwitchValue(overlay, 'exact')) return 'exact';
+    return searchKnowledgeModeValue(overlay);
+  }
+
+  function knowledgeSearchModeLabel(mode) {
+    if (mode === 'exact') return '关键词';
+    if (mode === 'naive') return '向量';
+    if (mode === 'local') return '实体';
+    if (mode === 'global') return '关系';
+    if (mode === 'hybrid') return '图谱混合';
+    return '综合';
+  }
+
   function readSearchCollapseSourcesDefault() {
     try {
       var stored = window.localStorage && window.localStorage.getItem(SEARCH_COLLAPSE_SOURCES_KEY);
@@ -2284,6 +2314,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
       title: Boolean(switches.title),
       exact: Boolean(switches.exact),
       collapseSource: Boolean(switches.collapseSource),
+      knowledgeMode: searchKnowledgeModeValue(overlay),
       workspaceId: resolveWorkspaceId(document.body) || '',
       rootUri: currentRootUri() || ''
     });
@@ -2297,6 +2328,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
     var query = input && 'value' in input ? searchText(input.value) : searchUiState.query;
     searchUiState.query = query;
     searchUiState.switches = collectSearchSwitchState(overlay);
+    searchUiState.knowledgeMode = searchKnowledgeModeValue(overlay);
     searchUiState.metaHtml = meta ? meta.innerHTML : searchUiState.metaHtml;
     searchUiState.resultsHtml = results ? results.innerHTML : searchUiState.resultsHtml;
     searchUiState.items = Array.isArray(window.__mnoteSearchResults) ? window.__mnoteSearchResults.slice() : searchUiState.items;
@@ -2312,6 +2344,8 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
     var results = overlay.querySelector('[data-testid="wolai-search-results"]');
     if (input && 'value' in input) input.value = searchUiState.query || '';
     applySearchSwitchState(overlay, searchUiState.switches);
+    var knowledgeModeSelect = overlay.querySelector('[data-search-knowledge-mode]');
+    if (knowledgeModeSelect && 'value' in knowledgeModeSelect) knowledgeModeSelect.value = searchUiState.knowledgeMode || 'mix';
     if (options instanceof HTMLElement) options.hidden = !searchText(searchUiState.query);
     if (meta && searchUiState.metaHtml) meta.innerHTML = searchUiState.metaHtml;
     if (results && searchUiState.resultsHtml) {
@@ -2421,7 +2455,8 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
 
   function renderSearchResultButton(item, index, query, exact, grouped) {
     var title = searchText(item.title || item.name || item.documentTitle || '无标题');
-    var snippet = cleanSearchDisplayText(item.snippet || item.evidence && item.evidence.quote || (Array.isArray(item.evidence) && item.evidence[0] && (item.evidence[0].quote || item.evidence[0].snippet)) || '');
+    var snippet = searchText(item.displayQuote || item.snippet || item.evidence && item.evidence.displayQuote || item.evidence && item.evidence.quote || (Array.isArray(item.evidence) && item.evidence[0] && (item.evidence[0].displayQuote || item.evidence[0].quote || item.evidence[0].snippet)) || '');
+    if (!item.displayQuote) snippet = cleanSearchDisplayText(snippet);
     var path = searchText(item.path || item.parentTitle || item.workspaceName || currentWorkspaceName());
     var resourceType = searchText(item.resourceType || item.resourceKind || 'page');
     var locator = searchResultEvidenceLocator(item);
@@ -2545,10 +2580,11 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
     var resourceKind = evidenceLocatorResourceKind(locator, item && item.resourceType);
     var overlay = document.querySelector('[data-testid="wolai-search-modal"]');
     var searchInput = overlay instanceof HTMLElement ? overlay.querySelector('[data-testid="wolai-search-input"]') : null;
-    var searchQueryText = searchText(item && (item.query || item.searchQuery))
+    var searchQueryText = searchText(item && (item.searchQuery || item.query) || locator && locator.openAction && locator.openAction.params && locator.openAction.params.searchQuery)
       || searchText(searchInput && 'value' in searchInput ? searchInput.value : '')
       || searchText(searchUiState.query);
-    var locatorEvidenceText = searchText(locator.evidenceText || locator.query || locator.openAction && locator.openAction.params && locator.openAction.params.query || '');
+    var locatorEvidenceText = searchText(item && item.locatorEvidenceText || locator.evidenceText || locator.query || locator.openAction && locator.openAction.params && (locator.openAction.params.evidenceText || locator.openAction.params.query) || '');
+    var locatorParams = locator && locator.openAction && locator.openAction.params && typeof locator.openAction.params === 'object' ? locator.openAction.params : {};
     var openTarget = event && event.altKey ? 'side' : 'active-tab';
     if (resourcePath && resourceKind) {
       var fileName = resourcePath.split('/').filter(Boolean).pop() || resourcePath;
@@ -2573,6 +2609,10 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
         bbox: locator.bbox,
         sourceMapPath: searchText(locator.sourceMapPath || locator.source_map_path),
         blockId: evidenceLocatorBlockId(locator),
+        paragraphOrdinal: searchText(locator.paragraphOrdinal || locatorParams.paragraphOrdinal),
+        paraIdStart: searchText(locator.paraIdStart || locatorParams.paraIdStart),
+        paraIdEnd: searchText(locator.paraIdEnd || locatorParams.paraIdEnd),
+        textFingerprint: searchText(locator.textFingerprint || locatorParams.textFingerprint),
         evidenceText: locatorEvidenceText,
         query: searchQueryText,
         searchQuery: searchQueryText,
@@ -2593,6 +2633,10 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
       var bbox = evidenceLocatorBbox(locator);
       if (bbox) target.searchParams.set('bbox', bbox);
       if (sourceMapPath) target.searchParams.set('sourceMapPath', sourceMapPath);
+      if (locatorParams.paragraphOrdinal != null) target.searchParams.set('paragraphOrdinal', searchText(locatorParams.paragraphOrdinal));
+      if (locatorParams.paraIdStart) target.searchParams.set('paraIdStart', searchText(locatorParams.paraIdStart));
+      if (locatorParams.paraIdEnd) target.searchParams.set('paraIdEnd', searchText(locatorParams.paraIdEnd));
+      if (locatorParams.textFingerprint) target.searchParams.set('textFingerprint', searchText(locatorParams.textFingerprint));
       window.location.assign(target.pathname + target.search + target.hash);
     } catch (_) {
       window.location.assign(url);
@@ -2643,6 +2687,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
       return;
     }
     var requestId = ++activeSearchRequestId;
+    var knowledgeRequestMode = knowledgeMode ? knowledgeSearchRequestMode(overlay) : '';
     meta.innerHTML = '<span>搜索中…</span><span>Ctrl + Enter 新窗口打开 / Alt + Enter 右侧边栏打开</span>';
     results.innerHTML = '<div class="wolai-search-empty" data-search-loading="true">搜索中…</div>';
     try {
@@ -2653,7 +2698,7 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
           workspaceId: resolveWorkspaceId(document.body),
           rootUri: currentRootUri() || null,
           query: query,
-          mode: 'hybrid',
+          mode: knowledgeRequestMode,
           topK: 12,
           chunkTopK: 24,
           includeChunkContent: true
@@ -2677,7 +2722,8 @@ import { createSidebarPageSettingsRuntime } from './sidebar-page-settings-runtim
       var payload = await response.json();
       if (requestId !== activeSearchRequestId) return;
       var items = Array.isArray(payload.results) ? payload.results : [];
-      meta.innerHTML = '<span>' + (knowledgeMode ? '资料库检索' : '工作区搜索') + ' · 共 ' + items.length + ' 条匹配结果</span><span>Ctrl + Enter 新窗口打开 / Alt + Enter 右侧边栏打开</span>';
+      var ownerLabel = knowledgeMode ? ('资料库检索 · ' + knowledgeSearchModeLabel(payload.retrievalMode || knowledgeRequestMode)) : '工作区搜索';
+      meta.innerHTML = '<span>' + ownerLabel + ' · 共 ' + items.length + ' 条匹配结果</span><span>Ctrl + Enter 新窗口打开 / Alt + Enter 右侧边栏打开</span>';
       if (!items.length) {
         results.innerHTML = '<div class="wolai-search-empty" data-search-empty="true">没有搜索结果</div>';
         window.__mnoteSearchResults = [];