local-knowledge-graph 1.6.1 → 1.8.0

package/public/app.js

@@ -13,9 +13,38 @@ const state = {
   imageCounts: new Map(),  // entityId -> 图片数量
   entityImages: new Map(), // entityId -> [图片行]
   meta: null,              // /api/meta 缓存（图例与下拉框用）
+  aliases: {},             // entityId -> [别名]（/api/graph 附带）
+  confFilter: '',          // 关系置信度过滤：''=全部 | 确证 | 推测 | 存疑
+  pathHi: null,            // 画布路径高亮 { nodes:Set, rels:Set }
+  lastAsk: null,           // 最近一次智能提问响应（证据路径高亮用）
+  ingViewId: null,         // 文档入图：当前审核任务id
+  ingSel: null,            // 文档入图：审核勾选状态
 };
 
+// 置信度三档的展示色
+const CONF_STYLE = { '确证': '#7ee787', '推测': '#e0a768', '存疑': '#8b949e' };
+function confBadge(r) {
+  const c = r.confidence || '确证';
+  const tip = r.source_ref ? ` title="来源：${escapeHtml(r.source_ref)}"` : '';
+  return `<span class="conf-badge" style="color:${CONF_STYLE[c]};border-color:${CONF_STYLE[c]}66"${tip}>${c}</span>`;
+}
+
 const $ = (id) => document.getElementById(id);
+async function copyText(text) {
+  try {
+    await navigator.clipboard.writeText(text);
+    toast('已复制到剪贴板');
+  } catch (_) {
+    const ta = document.createElement('textarea');
+    ta.value = text;
+    ta.style.position = 'fixed';
+    ta.style.opacity = '0';
+    document.body.appendChild(ta);
+    ta.select();
+    try { document.execCommand('copy'); toast('已复制到剪贴板'); } catch (e) { toast('复制失败，请手动选择复制', true); }
+    ta.remove();
+  }
+}
 function toast(msg, isErr) {
   const t = $('toast');
   t.textContent = msg;
@@ -256,7 +285,9 @@ function rebuildGraph() {
   // 中心层级模式：仅构建子图；全图模式：构建全部
   const sub = state.ego ? calcEgo(state.ego.centerId, state.ego.depth) : null;
   const ents = sub ? sub.entities : state.entities;
-  const rels = sub ? sub.relations : state.relations;
+  const allRels = sub ? sub.relations : state.relations;
+  const rels = allRels.filter((r) => !state.confFilter || (r.confidence || '确证') === state.confFilter);
+  state.pathHi = null;
 
   state.entityMap.clear();
   const N = ents.length;
@@ -311,13 +342,17 @@ function rebuildGraph() {
     const b = simNodes.find((n) => n.id === r.target_id);
     if (!a || !b) return;
     const st = RELATION_STYLE[r.category] || { color: 0x999999, dashed: false };
+    const conf = r.confidence || '确证';
+    const baseOp = st.opacity === undefined ? 0.9 : st.opacity;
+    const op = conf === '存疑' ? Math.min(baseOp, 0.35) : baseOp; // 存疑降不透明度
+    const dashed = st.dashed || conf === '推测';                  // 推测强制虚线
     const geo = new THREE.BufferGeometry().setFromPoints([a.pos, b.pos]);
-    const op = st.opacity === undefined ? 0.9 : st.opacity;
-    const mat = st.dashed
+    const mat = dashed
       ? new THREE.LineDashedMaterial({ color: st.color, dashSize: st.dashSize || 6, gapSize: st.gapSize || 4, transparent: true, opacity: op })
       : new THREE.LineBasicMaterial({ color: st.color, transparent: true, opacity: op });
     const line = new THREE.Line(geo, mat);
     line.userData.relationId = r.id;
+    line.userData.baseOpacity = op;
     linkGroup.add(line);
     const mid = a.pos.clone().add(b.pos).multiplyScalar(0.5);
     // 线标注显示具体关系名（如"父子"），线型/颜色仍由大类规定
@@ -325,7 +360,7 @@ function rebuildGraph() {
     lbl.userData.text = r.name;
     lbl.position.copy(mid);
     labelGroup.add(lbl);
-    simLinks.push({ id: r.id, a, b, line, label: lbl, dashed: st.dashed });
+    simLinks.push({ id: r.id, a, b, line, label: lbl, dashed, confidence: conf });
   });
 
   // 推理关系叠加：虚化虚线 + "(推)"标注，负数id与库中显式关系区分；仅显示两端均在当前视图的边
@@ -520,19 +555,42 @@ function renderInfoCard() {
         (rows.length ? '' : '<span class="kv">加载中…</span>') + '</div></div>';
     }
     const levelHtml = m.level !== null && m.level !== undefined ? `<div class="kv">层级: <b style="color:${levelColor(m.level)}">L${m.level}</b>${m.level === 0 ? '（中心）' : ''}</div>` : '';
+    // 别名区
+    const als = state.aliases[e.id] || [];
+    const aliasHtml = `<div class="kv"><b>别名</b>：${als.length
+      ? als.map((a) => `<span class="alias-chip">${escapeHtml(a)}<i onclick="delAlias(${e.id},'${escapeHtml(a).replace(/'/g, "\\'")}')">×</i></span>`).join('')
+      : '（无）'} <input id="alias-new" placeholder="加别名" style="width:88px"><button class="ghost" onclick="addAlias(${e.id})">添</button></div>`;
+    // 同名实体互链
+    const twins = state.entities.filter((x) => x.name === e.name && x.id !== e.id);
+    const twinHtml = twins.length ? `<div class="kv">同名实体：${twins.map((t) => `<span style="color:#7fd1ff;cursor:pointer" onclick="focusEntity(${t.id})">#${t.id}</span>`).join('、')}</div>` : '';
+    // 关系预览（带置信度）
+    const myRels = relsInScope.filter((r) => r.source_id === e.id || r.target_id === e.id).slice(0, 12);
+    const relNameOf = (id) => { const mm = state.entityMap.get(id); return mm ? escapeHtml(mm.entity.name) : '#' + id; };
+    const relPreview = myRels.length
+      ? `<div class="kv" style="margin-top:4px"><b>关系明细</b></div>` + myRels.map((r) => {
+          const dir = r.source_id === e.id;
+          const other = dir ? r.target_id : r.source_id;
+          return `<div class="kv" style="padding-left:6px">${dir ? '' : relNameOf(other) + ' ←'}「${escapeHtml(r.name)}」${dir ? '→ ' + relNameOf(other) : ''} ${confBadge(r)}</div>`;
+        }).join('')
+      : '';
     card.innerHTML = `
       <h4>${escapeHtml(e.name)} <span class="tag" style="color:${ENTITY_STYLE[e.category].css};border-color:${ENTITY_STYLE[e.category].css}55">${e.category} · ${ENTITY_STYLE[e.category].shape}</span></h4>
       <div class="kv">id: ${e.id}　来源: ${e.source}</div>
       <div class="kv">创建: ${e.created_at}</div>
       ${levelHtml}
+      ${aliasHtml}
+      ${twinHtml}
       <div class="kv">关联关系: ${relCount} 条</div>
       ${attrHtml || '<div class="kv">（无属性）</div>'}
+      ${relPreview}
       ${imgHtml}
       <div class="btns">
         <button onclick="focusEgo(${e.id})">以此为中心</button>
         <button onclick="askPath(${e.id}, '${escapeHtml(e.name).replace(/'/g, "\\'")}')">查路径</button>
+        <button onclick="loadSimilar(${e.id})">相似实体</button>
         <button onclick="$('entity-img-input').click()">绑图片</button>
       </div>
+      <div id="similar-box"></div>
       <div class="btns"><button onclick="editEntity(${e.id})">编辑</button><button class="danger" onclick="delEntity(${e.id})">删除</button></div>`;
     card.style.display = 'block';
     if (imgCount > 0 && !imgs) loadEntityImages(e.id);
@@ -566,10 +624,15 @@ function renderInfoCard() {
     if (!r) { card.style.display = 'none'; return; }
     const s = state.entityMap.get(r.source_id), t = state.entityMap.get(r.target_id);
     card.innerHTML = `
-      <h4>${escapeHtml(r.name)} <span class="tag" style="color:${RELATION_STYLE[r.category].css};border-color:${RELATION_STYLE[r.category].css}55">${r.category}关系</span></h4>
+      <h4>${escapeHtml(r.name)} <span class="tag" style="color:${RELATION_STYLE[r.category].css};border-color:${RELATION_STYLE[r.category].css}55">${r.category}关系</span> ${confBadge(r)}</h4>
       <div class="kv"><b>${s ? escapeHtml(s.entity.name) : '?'}</b> --&gt; <b>${t ? escapeHtml(t.entity.name) : '?'}</b></div>
       <div class="kv">id: ${r.id}　来源: ${r.source}</div>
-      <div class="btns"><button class="danger" onclick="delRelation(${r.id})">删除</button></div>`;
+      <div class="kv"><b>置信度</b>：
+        <select id="rel-conf" style="font-size:11px">
+          ${['确证', '推测', '存疑'].map((c) => `<option value="${c}"${(r.confidence || '确证') === c ? ' selected' : ''}>${c}</option>`).join('')}
+        </select></div>
+      <div class="kv"><b>来源引用</b>：<input id="rel-sref" value="${escapeHtml(r.source_ref || '')}" placeholder="URL/文献+页码" style="width:150px"></div>
+      <div class="btns"><button onclick="saveRelMeta(${r.id})">保存标注</button><button class="danger" onclick="delRelation(${r.id})">删除</button></div>`;
     card.style.display = 'block';
   }
 }
@@ -830,7 +893,9 @@ function renderLegend() {
   $('legend').innerHTML = '<b>实体样式</b><br>' +
     meta.entity_categories.map((c) => `<span class="sw" style="background:${ENTITY_STYLE[c].css}"></span>${c} · ${ENTITY_STYLE[c].shape}`).join('<br>') +
     '<br><b>关系线型</b><br>' +
-    meta.relation_categories.map((c) => `<span class="ln ${RELATION_STYLE[c].dashed ? 'dash' : ''}" style="border-color:${RELATION_STYLE[c].css}"></span>${c}关系`).join('<br>');
+    meta.relation_categories.map((c) => `<span class="ln ${RELATION_STYLE[c].dashed ? 'dash' : ''}" style="border-color:${RELATION_STYLE[c].css}"></span>${c}关系`).join('<br>') +
+    '<br><b>置信度</b><br>' +
+    ['确证', '推测', '存疑'].map((c) => `<span class="sw" style="background:${CONF_STYLE[c]}"></span>${c}${c === '推测' ? '（虚线）' : c === '存疑' ? '（淡化）' : ''}`).join('<br>');
 }
 
 function refreshEntityOptions() {
@@ -911,16 +976,72 @@ async function submitRelation() {
       target_id: Number($('r-target').value),
       name: $('r-name').value.trim(),
       category: $('r-category').value,
+      confidence: $('r-confidence').value,
+      source_ref: $('r-source-ref').value.trim(),
     };
     if (!body.name) return toast('请输入关系名称', true);
     if (!body.source_id || !body.target_id) return toast('请先创建实体', true);
     await api('/api/relations', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
     $('r-name').value = '';
+    $('r-source-ref').value = '';
     toast('关系已添加');
     await refreshAll();
   } catch (e) { toast(e.message, true); }
 }
 
+// 保存关系标注（置信度+来源引用）
+async function saveRelMeta(id) {
+  try {
+    await api(`/api/relations/${id}`, {
+      method: 'PUT', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ confidence: $('rel-conf').value, source_ref: $('rel-sref').value.trim() }),
+    });
+    toast('标注已保存');
+    await refreshAll();
+  } catch (e) { toast(e.message, true); }
+}
+window.saveRelMeta = saveRelMeta;
+
+// 别名增删
+async function addAlias(entityId) {
+  const inp = $('alias-new');
+  const alias = inp ? inp.value.trim() : '';
+  if (!alias) return toast('请输入别名', true);
+  try {
+    await api('/api/aliases', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ entity_id: entityId, alias }) });
+    toast('别名已添加');
+    await refreshAll();
+  } catch (e) { toast(e.message, true); }
+}
+window.addAlias = addAlias;
+
+async function delAlias(entityId, alias) {
+  try {
+    const records = await api('/api/aliases/records');
+    const hit = records.find((x) => x.entity_id === entityId && x.alias === alias);
+    if (!hit) throw new Error('别名不存在或已删除');
+    await api(`/api/aliases/${hit.id}`, { method: 'DELETE' });
+    toast('别名已删除');
+    await refreshAll();
+  } catch (e) { toast(e.message, true); }
+}
+window.delAlias = delAlias;
+
+// 相似实体推荐
+async function loadSimilar(id) {
+  const box = $('similar-box');
+  if (!box) return;
+  box.innerHTML = '<div class="kv">相似度计算中…</div>';
+  try {
+    const r = await api(`/api/similar/${id}`);
+    if (!r.results.length) { box.innerHTML = '<div class="kv">暂无相似实体（可先构建全量向量提升效果）</div>'; return; }
+    const nameOf = (e2) => { const mm = state.entityMap.get(e2.id); return mm ? escapeHtml(mm.entity.name) : '#' + e2.id; };
+    box.innerHTML = `<div class="kv"><b>相似实体</b> <span class="tag">${r.mode === 'semantic' ? '语义' : '结构'}</span></div>` +
+      r.results.map((x) => `<div class="kv" style="cursor:pointer;padding-left:6px" onclick="focusEntity(${x.entity.id})">${nameOf(x.entity)} <span style="color:#8fa3c0">${(x.score * 100).toFixed(1)}%</span></div>`).join('');
+  } catch (e) { box.innerHTML = `<div class="kv" style="color:#e0a768">${escapeHtml(e.message)}</div>`; }
+}
+window.loadSimilar = loadSimilar;
+
 async function delRelation(id) {
   if (!confirm(`删除关系 #${id}？`)) return;
   try {
@@ -948,19 +1069,30 @@ function renderEntityList() {
 }
 
 function renderRelationList() {
-  $('r-list').innerHTML = state.relations.map((r) => {
+  const shown = state.relations.filter((r) => !state.confFilter || (r.confidence || '确证') === state.confFilter);
+  $('r-list').innerHTML = shown.map((r) => {
     const s = state.entityMap.get(r.source_id), t = state.entityMap.get(r.target_id);
     return `
     <div class="list-item">
       <div class="main">
-        <div class="name">${escapeHtml(r.name)}<span class="tag" style="color:${RELATION_STYLE[r.category].css};border-color:${RELATION_STYLE[r.category].css}55">${r.category}</span></div>
-        <div class="sub">#${r.id} · ${s ? escapeHtml(s.entity.name) : '?'} → ${t ? escapeHtml(t.entity.name) : '?'} · ${r.source}</div>
+        <div class="name">${escapeHtml(r.name)}<span class="tag" style="color:${RELATION_STYLE[r.category].css};border-color:${RELATION_STYLE[r.category].css}55">${r.category}</span>${confBadge(r)}</div>
+        <div class="sub">#${r.id} · ${s ? escapeHtml(s.entity.name) : '?'} → ${t ? escapeHtml(t.entity.name) : '?'} · ${r.source}${r.source_ref ? ' · ' + escapeHtml(r.source_ref) : ''}</div>
       </div>
       <button class="danger" onclick="delRelation(${r.id})">删</button>
     </div>`;
-  }).join('') || '<div class="sub" style="color:#5c6f92">暂无关系</div>';
+  }).join('') || '<div class="sub" style="color:#5c6f92">' + (state.confFilter ? `暂无「${state.confFilter}」关系` : '暂无关系') + '</div>';
 }
 
+// 置信度过滤条（事件委托）
+document.addEventListener('click', (e) => {
+  const chip = e.target.closest && e.target.closest('.cf-chip');
+  if (!chip) return;
+  state.confFilter = chip.dataset.c || '';
+  document.querySelectorAll('.cf-chip').forEach((x) => x.classList.toggle('active', x === chip));
+  renderRelationList();
+  rebuildGraph();
+});
+
 /* 日志人话渲染：op_type + snapshot JSON → 可读中文；已删实体名称回退#id */
 const OP_LABELS = {
   ADD_ENTITY: '新增实体', UPDATE_ENTITY: '更新实体', DELETE_ENTITY: '删除实体',
@@ -1110,6 +1242,7 @@ document.addEventListener('keydown', (e) => {
     }
     if ($('style-panel').classList.contains('show')) { $('style-panel').classList.remove('show'); return; }
     if ($('file-menu').classList.contains('show')) { $('file-menu').classList.remove('show'); return; }
+    if (state.pathHi) { clearCanvasHi(); return; }
     if (state.selected) { state.selected = null; renderInfoCard(); return; }
     if (state.ego) exitEgo();
     return;
@@ -1121,39 +1254,218 @@ document.addEventListener('keydown', (e) => {
   }
 });
 
-/* ================= 最短路径查询 ================= */
+/* ================= 路径查询（多路径枚举）与画布高亮 ================= */
 function renderPathPanel(r) {
   const panel = $('path-panel');
-  if (!r.found) {
-    $('path-body').innerHTML = '<div class="kv">两实体间在6层内无连通路径</div>';
+  // 兼容旧单路径格式
+  if (!r.paths) {
+    if (!r.found) {
+      $('path-body').innerHTML = '<div class="kv">两实体间在6层内无连通路径</div>';
+      panel.style.display = 'block';
+      return;
+    }
+    r = { found: true, paths: [{ hops: r.hops, entities: r.entities, relations: r.relations }] };
+  }
+  if (!r.found || !r.paths.length) {
+    $('path-body').innerHTML = `<div class="kv">${escapeHtml(r.hint || '两实体间无连通路径')}</div>`;
     panel.style.display = 'block';
     return;
   }
-  const rows = [];
-  r.entities.forEach((ent, i) => {
-    if (i > 0) {
-      const rel = r.relations[i - 1];
-      const dir = rel.source_id === r.entities[i - 1].id ? '→' : '←';
-      rows.push(`<div class="p-rel">—${dir} ${escapeHtml(rel.name)} ${dir === '→' ? '→' : '—'}—</div>`);
-    }
-    rows.push(`<div class="p-ent" onclick="focusEntity(${ent.id}); document.getElementById('path-panel').style.display='none'">${escapeHtml(ent.name)}<span class="tag">${escapeHtml(ent.category)}</span></div>`);
+  const nameOf = (ent) => escapeHtml(ent ? ent.name : '#' + ent);
+  let html = '';
+  r.paths.forEach((p, pi) => {
+    const rows = [];
+    p.entities.forEach((ent, i) => {
+      if (i > 0) {
+        const rel = p.relations[i - 1];
+        const conf = rel.confidence || '确证';
+        const dir = rel.source_id === p.entities[i - 1].id ? '→' : '←';
+        rows.push(`<div class="p-rel">—${dir} ${escapeHtml(rel.name)} <span style="color:${CONF_STYLE[conf]}">${conf}</span> ${dir === '→' ? '→' : '—'}—</div>`);
+      }
+      rows.push(`<div class="p-ent" onclick="focusEntity(${ent.id})">${nameOf(ent)}<span class="tag">${escapeHtml(ent.category)}</span></div>`);
+    });
+    html += `<div class="p-path"><div class="p-head2">路径${r.paths.length > 1 ? pi + 1 : ''}（${p.hops} 跳）<button class="ghost" onclick="highlightCanvasPath(${pi})">画布高亮</button></div>${rows.join('')}</div>`;
   });
-  $('path-title').textContent = `最短路径（${r.hops} 跳）`;
-  $('path-body').innerHTML = rows.join('');
+  state._lastPaths = r.paths;
+  $('path-title').textContent = `关系路径（共${r.paths.length}条）`;
+  $('path-body').innerHTML = html;
   panel.style.display = 'block';
 }
+
+// 画布路径高亮：路径元素保持原样，其余整体降为微透明
+function applyCanvasHi(nodes, rels) {
+  state.pathHi = { nodes, rels };
+  for (const n of simNodes) {
+    const on = nodes.has(n.id);
+    n.mesh.material.transparent = true;
+    n.mesh.material.opacity = on ? 1 : 0.06;
+    if (n.label) n.label.material.opacity = on ? 1 : 0.08;
+  }
+  for (const l of simLinks) {
+    const base = l.line.userData.baseOpacity === undefined ? 0.9 : l.line.userData.baseOpacity;
+    const on = rels.has(l.id);
+    l.line.material.opacity = on ? Math.max(base, 0.95) : 0.05;
+    if (l.label) l.label.material.opacity = on ? 1 : 0.06;
+  }
+}
+
+function clearCanvasHi() {
+  if (!state.pathHi) return;
+  state.pathHi = null;
+  for (const n of simNodes) {
+    n.mesh.material.opacity = 1;
+    if (n.label) n.label.material.opacity = 1;
+  }
+  for (const l of simLinks) {
+    l.line.material.opacity = l.line.userData.baseOpacity === undefined ? 0.9 : l.line.userData.baseOpacity;
+    if (l.label) l.label.material.opacity = 1;
+  }
+}
+
+// 路径面板/证据路径共用：按 路径对象 或 hops 数组高亮
+function highlightCanvasPath(pi) {
+  const p = state._lastPaths && state._lastPaths[pi];
+  if (!p) return;
+  applyCanvasHi(new Set(p.entities.map((e) => e.id)), new Set(p.relations.map((x) => x.id)));
+}
+window.highlightCanvasPath = highlightCanvasPath;
+
 async function askPath(fromId, fromName) {
-  const to = prompt(`查询「${fromName}」到哪位实体的最短路径？（输入名称或id，最多6层）`, '');
+  const to = prompt(`查询「${fromName}」到哪位实体的关系路径？（输入名称或id，2-6层，最多返回5条）`, '');
   if (to === null) return;
   const key = to.trim();
   if (!key) return;
   try {
-    const r = await api(`/api/graph/path?from=${fromId}&to=${encodeURIComponent(key)}`);
+    const r = await api(`/api/graph/paths?from=${fromId}&to=${encodeURIComponent(key)}`);
     renderPathPanel(r);
   } catch (e) { toast(e.message, true); }
 }
 window.askPath = askPath;
-$('path-close').addEventListener('click', () => { $('path-panel').style.display = 'none'; });
+$('path-close').addEventListener('click', () => { $('path-panel').style.display = 'none'; clearCanvasHi(); });
+
+/* ================= 文档批量入图 ================= */
+async function loadIngestTasks() {
+  try {
+    const ts = await api('/api/ingest/tasks');
+    if (state.ingViewId) {
+      const t = ts.find((x) => x.id === state.ingViewId);
+      if (t && (t.status === 'extracting' || t.status === 'parsing')) {
+        $('ing-tasks').innerHTML = `<div class="kv">任务 ${escapeHtml(t.display_name)} 抽取中…（${t.chunks_total || '?'} 片段）</div>`;
+        return;
+      }
+      if (t) { ingView(t.id); return; }
+      state.ingViewId = null;
+    }
+    $('ing-tasks').innerHTML = ts.map((t) => {
+      const st = t.status === 'review' ? '<span style="color:#7ee787">待审核</span>'
+        : t.status === 'committed' ? '<span style="color:#7fd1ff">已入库</span>'
+        : t.status === 'failed' ? `<span style="color:#f0883e">失败：${escapeHtml(t.error || '未知')}</span>`
+        : t.status === 'interrupted' ? '<span style="color:#f0883e">已中断</span>'
+        : '<span style="color:#e0a768">抽取中…</span>';
+      const acts = [];
+      if (t.status === 'review') acts.push(`<button onclick="ingView('${t.id}')">审核</button>`);
+      if (t.status === 'committed') acts.push(`<span class="tag">实体+${t.entity_count} 关系+${t.relation_count}</span>`);
+      if (t.status !== 'extracting' && t.status !== 'parsing') acts.push(`<button class="danger" onclick="ingDelete('${t.id}')">删</button>`);
+      return `<div class="list-item"><div class="main"><div class="name">${escapeHtml(t.display_name)}</div>
+        <div class="sub">${st} · 实体${t.entity_count}/关系${t.relation_count}${t.failed_chunks ? ` · 失败片段${t.failed_chunks}` : ''}</div></div>${acts.join('')}</div>`;
+    }).join('') || '<div class="sub" style="color:#5c6f92">暂无任务</div>';
+  } catch (_) { /* 服务暂不可用时静默 */ }
+}
+
+async function ingView(id) {
+  state.ingViewId = id;
+  const t = await api('/api/ingest/' + id);
+  if (t.status !== 'review') { state.ingViewId = null; loadIngestTasks(); return; }
+  state.ingSel = {
+    entities: new Set(t.candidates.entities.filter((c) => c.selected && !c.dupe_of_candidate).map((c) => c.name)),
+    relations: new Set(t.candidates.relations.filter((r) => r.selected && !r.unresolved).map((r) => r.from + '|' + r.name + '|' + r.to)),
+  };
+  const catCss = (c) => (ENTITY_STYLE[c] ? ENTITY_STYLE[c].css : '#ccc');
+  const entRows = t.candidates.entities.map((c) => {
+    if (c.dupe_of_candidate) return `<div class="kv" style="color:#5c6f92">· ${escapeHtml(c.name)}（候选内部重复，跳过）</div>`;
+    const on = state.ingSel.entities.has(c.name);
+    const match = c.existing_id !== null && c.existing_id !== undefined ? `<span class="tag" style="color:#7ee787;border-color:#7ee78755">并入已有#${c.existing_id}</span>` : '<span class="tag">新建</span>';
+    return `<label class="list-item" style="cursor:pointer"><input type="checkbox" ${on ? 'checked' : ''} onchange="ingToggle('e','${escapeHtml(c.name).replace(/'/g, "\\'")}',this.checked)">
+      <div class="main"><div class="name">${escapeHtml(c.name)}<span class="tag" style="color:${catCss(c.category)};border-color:${catCss(c.category)}55">${c.category}</span>${match}</div>
+      <div class="sub">${Object.keys(c.attributes || {}).length}属性${c.aliases.length ? ' · 别名:' + escapeHtml(c.aliases.join('/')) : ''}</div></div></label>`;
+  }).join('');
+  const relRows = t.candidates.relations.map((r) => {
+    const key = r.from + '|' + r.name + '|' + r.to;
+    if (r.unresolved) return `<div class="kv" style="color:#5c6f92">· ${escapeHtml(r.from)} —${escapeHtml(r.name)}→ ${escapeHtml(r.to)}（端点缺失，跳过）</div>`;
+    const on = state.ingSel.relations.has(key);
+    return `<label class="list-item" style="cursor:pointer"><input type="checkbox" ${on ? 'checked' : ''} onchange="ingToggle('r','${escapeHtml(key).replace(/'/g, "\\'")}',this.checked)">
+      <div class="main"><div class="name">${escapeHtml(r.from)} —${escapeHtml(r.name)}→ ${escapeHtml(r.to)}<span class="tag" style="color:${CONF_STYLE[r.confidence]};border-color:${CONF_STYLE[r.confidence]}66">${r.confidence}</span></div>
+      <div class="sub">${r.category} · ${escapeHtml(r.source_ref || '')}</div></div></label>`;
+  }).join('');
+  $('ing-tasks').innerHTML = `
+    <div class="kv"><b>审核：${escapeHtml(t.display_name)}</b>（${t.chunks_total}片段${t.failed_chunks.length ? '，失败' + t.failed_chunks.length : ''}）</div>
+    <div class="ask-sec">实体候选（${t.candidates.entities.length}）</div>${entRows || '<div class="kv">无</div>'}
+    <div class="ask-sec">关系候选（${t.candidates.relations.length}）</div>${relRows || '<div class="kv">无</div>'}
+    <div class="row" style="margin-top:8px">
+      <button class="primary" onclick="ingCommit('${t.id}')">确认入库（先打保存点）</button>
+      <button class="ghost" onclick="ingBack()">返回</button>
+    </div>`;
+}
+function ingToggle(kind, key, on) {
+  if (!state.ingSel) return;
+  const set = kind === 'e' ? state.ingSel.entities : state.ingSel.relations;
+  if (on) set.add(key); else set.delete(key);
+}
+function ingBack() { state.ingViewId = null; loadIngestTasks(); }
+async function ingCommit(id) {
+  if (!state.ingSel) return;
+  try {
+    const r = await api(`/api/ingest/${id}/commit`, {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ selected: { entities: [...state.ingSel.entities], relations: [...state.ingSel.relations] } }),
+    });
+    toast(`已入库：实体+${r.entities_added} 关系+${r.relations_added}${r.relations_skipped ? '（跳过' + r.relations_skipped + '）' : ''}，保存点已创建`);
+    state.ingViewId = null;
+    loadIngestTasks();
+    await refreshAll();
+  } catch (e) { toast(e.message, true); }
+}
+async function ingDelete(id) {
+  if (!confirm('删除该任务记录？（已入库数据不受影响）')) return;
+  try { await api('/api/ingest/' + id, { method: 'DELETE' }); loadIngestTasks(); } catch (e) { toast(e.message, true); }
+}
+$('ing-btn').addEventListener('click', () => $('ing-file').click());
+$('ing-auto').checked = localStorage.getItem('ing_auto_commit') === '1';
+$('ing-auto').addEventListener('change', () => { localStorage.setItem('ing_auto_commit', $('ing-auto').checked ? '1' : '0'); });
+$('ing-file').addEventListener('change', async () => {
+  const f = $('ing-file').files[0];
+  if (!f) return;
+  $('ing-file').value = '';
+  if (f.size > 10 * 1024 * 1024) return toast('文件超过10MB上限', true);
+  $('ing-status').textContent = '上传中…';
+  try {
+    const b64 = await new Promise((res, rej) => {
+      const rd = new FileReader();
+      rd.onload = () => res(String(rd.result).split(',')[1]);
+      rd.onerror = () => rej(new Error('读取失败'));
+      rd.readAsDataURL(f);
+    });
+    const autoCommit = $('ing-auto').checked;
+    const r = await api('/api/ingest', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ filename: f.name, content_b64: b64, auto_commit: autoCommit }) });
+    $('ing-status').textContent = `任务已创建（${r.id}），抽取中…`;
+    state.ingViewId = null;
+    const poll = setInterval(async () => {
+      const t = await api('/api/ingest/' + r.id).catch(() => null);
+      if (!t) { clearInterval(poll); return; }
+      if (t.status === 'review') { clearInterval(poll); if (autoCommit) { $('ing-status').textContent = '自动入库中…'; try { await api('/api/ingest/' + r.id + '/commit', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({}) }); $('ing-status').textContent = '已自动入库'; await refreshAll(); } catch (e) { toast(e.message, true); } loadIngestTasks(); } else { $('ing-status').textContent = '抽取完成，请审核'; loadIngestTasks(); } }
+      else if (t.status === 'failed') { clearInterval(poll); $('ing-status').textContent = '失败：' + (t.error || ''); loadIngestTasks(); }
+      else if (t.status === 'committed') { clearInterval(poll); $('ing-status').textContent = '已直接入库'; loadIngestTasks(); await refreshAll(); }
+    }, 3000);
+  } catch (e) {
+    $('ing-status').textContent = '';
+    toast(e.message, true);
+  }
+});
+window.ingView = ingView;
+window.ingToggle = ingToggle;
+window.ingCommit = ingCommit;
+window.ingDelete = ingDelete;
+window.ingBack = ingBack;
 
 /* ================= OpenCode 对话 ================= */
 function appendMsg(role, text, chips, chipWarn) {
@@ -1582,6 +1894,7 @@ async function refreshAll(rebuild = true) {
   const [graph, meta] = await Promise.all([api('/api/graph'), api('/api/meta')]);
   state.entities = graph.entities;
   state.relations = graph.relations;
+  state.aliases = graph.aliases || {};
   state.version = meta.version;
   state.imageCounts = new Map((graph.image_counts || []).map((x) => [Number(x.entity_id), x.count]));
   // 推理开关开启时同步刷新推理缓存，保证叠加边与新数据一致
@@ -1594,6 +1907,7 @@ async function refreshAll(rebuild = true) {
     updateEgoBar();
   }
   $('stat-badge').textContent = `实体 ${meta.counts.entities} / 关系 ${meta.counts.relations} / 日志 ${meta.counts.logs}`;
+  loadIngestTasks();
   const badge = $('agent-badge');
   if (meta.agent_available) { badge.textContent = 'OpenCode 已就绪'; badge.className = 'badge ok'; }
   else { badge.textContent = 'OpenCode 未安装'; badge.className = 'badge off'; }
@@ -1636,6 +1950,7 @@ async function askSubmit() {
 }
 
 function renderAskResult(r) {
+  state.lastAsk = r;
   const box = $('a-result');
   const chips = r.steps.map((s) => {
     const icon = s.status === 'ok' ? '✔' : s.status === 'timeout' ? '⏱' : '✘';
@@ -1664,9 +1979,33 @@ function renderAskResult(r) {
   if (r.synthesis) synth = `<div class="ask-synth">${renderSynthesis(r.synthesis, r.entities)}</div>`;
   else if (r.synth_error) synth = `<div class="kv" style="color:#e0a768">综述生成失败：${escapeHtml(r.synth_error)}</div>`;
 
-  box.innerHTML = `<div class="ask-steps">${chips}</div>${synth}<div class="ask-sec">实体（${r.entities.length}）</div>${ents}${cn}`;
+  // 证据路径：A —关系→ B 链条，可一键画布高亮
+  let ev = '';
+  if (r.evidence_paths && r.evidence_paths.length) {
+    const ename = (id) => { const e = r.entities.find((x) => x.id === id); return e ? escapeHtml(e.name) : '#' + id; };
+    const cname = (c) => `<span style="color:${CONF_STYLE[c] || '#8fa3c0'}">${c}</span>`;
+    ev = `<div class="ask-sec">证据路径（${r.evidence_paths.length}）</div>` + r.evidence_paths.map((p, pi) => {
+      const chain = p.hops.map((h) => `${ename(h.source_id)} —${escapeHtml(h.name)}${h.confidence && h.confidence !== '确证' ? '(' + cname(h.confidence) + ')' : ''}→ ${ename(h.target_id)}`).join('　⇒　');
+      return `<div class="kv ask-path-row">⛓ ${chain} <button class="ghost" onclick="highlightEvidencePath(${pi})">高亮</button></div>`;
+    }).join('');
+  }
+
+  box.innerHTML = `<div class="ask-steps">${chips}</div>${synth}${ev}<div class="ask-sec">实体（${r.entities.length}）</div>${ents}${cn}`;
 }
 
+// 证据路径一键高亮：以最近一次提问结果中的 hops 构建高亮集
+function highlightEvidencePath(pi) {
+  const r = state.lastAsk;
+  if (!r || !r.evidence_paths || !r.evidence_paths[pi]) return;
+  const p = r.evidence_paths[pi];
+  const nodes = new Set([p.hops[0].source_id, p.hops[p.hops.length - 1].target_id]);
+  const rels = new Set();
+  for (const h of p.hops) { rels.add(h.id); nodes.add(h.source_id); nodes.add(h.target_id); }
+  applyCanvasHi(nodes, rels);
+  toast('已在画布高亮该证据路径');
+}
+window.highlightEvidencePath = highlightEvidencePath;
+
 // 综述文本中的「名称#id」渲染为可点击引用
 function renderSynthesis(text, entities) {
   const ids = new Set(entities.map((e) => e.id));
@@ -1702,6 +2041,74 @@ $('a-synth').addEventListener('change', () => {
   api('/api/ask/settings', { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ synthesis: $('a-synth').checked }) }).catch(() => {});
 });
 
+/* ================= MCP 外部接入 ================= */
+let mcpState = { enabled: false, readonly: false, token: '', endpoint: '/mcp' };
+
+function mcpSnippets() {
+  const origin = location.origin;
+  const http = JSON.stringify({ mcpServers: { 'local-knowledge-graph': { url: `${origin}/mcp?token=${mcpState.token}` } } }, null, 2);
+  const desktop = JSON.stringify({ mcpServers: { 'local-knowledge-graph': { url: `${origin}/mcp`, headers: { Authorization: `Bearer ${mcpState.token}` } } } }, null, 2);
+  const stdio = JSON.stringify({ mcpServers: { 'local-knowledge-graph': { command: 'npx', args: ['-y', 'local-knowledge-graph', '--mcp'] } } }, null, 2);
+  $('mcp-snippet-http').textContent = http;
+  $('mcp-snippet-desktop').textContent = desktop;
+  $('mcp-snippet-stdio').textContent = stdio;
+  $('mcp-endpoint').textContent = `${origin}${mcpState.endpoint}`;
+  $('mcp-token').textContent = mcpState.token;
+}
+
+function renderMcp() {
+  $('mcp-toggle').checked = mcpState.enabled;
+  $('mcp-readonly').checked = mcpState.readonly;
+  $('mcp-cfg').style.display = mcpState.enabled ? '' : 'none';
+  $('mcp-status').textContent = mcpState.enabled
+    ? (mcpState.readonly ? '状态：已启用（只读）— 外部 Agent 仅可查询' : '状态：已启用（读写）— 外部 Agent 可查询与写入')
+    : '状态：已停用 — /mcp 端点关闭';
+  if (mcpState.enabled) mcpSnippets();
+}
+
+async function loadMcp() {
+  try {
+    mcpState = await api('/api/mcp/settings');
+    renderMcp();
+  } catch (_) { /* 服务未就绪时静默 */ }
+}
+
+async function saveMcp(patch) {
+  try {
+    mcpState = await api('/api/mcp/settings', { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(patch) });
+    renderMcp();
+  } catch (e) { toast(e.message, true); }
+}
+
+$('mcp-toggle').addEventListener('change', () => saveMcp({ enabled: $('mcp-toggle').checked }));
+$('mcp-readonly').addEventListener('change', () => saveMcp({ readonly: $('mcp-readonly').checked }));
+$('mcp-regen').addEventListener('click', async () => {
+  try {
+    const r = await api('/api/mcp/token/regen', { method: 'POST' });
+    mcpState.token = r.token;
+    renderMcp();
+    toast('令牌已重新生成，旧令牌立即失效');
+  } catch (e) { toast(e.message, true); }
+});
+$('mcp-copy-token').addEventListener('click', () => copyText(mcpState.token));
+$('mcp-copy-http').addEventListener('click', () => copyText($('mcp-snippet-http').textContent));
+$('mcp-copy-desktop').addEventListener('click', () => copyText($('mcp-snippet-desktop').textContent));
+$('mcp-copy-stdio').addEventListener('click', () => copyText($('mcp-snippet-stdio').textContent));
+loadMcp();
+
+/* ================= 实时同步：SSE + 外部变更提示 ================= */
+let syncTimer = null;
+let lastSyncToast = 0;
+try {
+  const es = new EventSource('/api/events');
+  es.addEventListener('graph-changed', () => {
+    clearTimeout(syncTimer);
+    syncTimer = setTimeout(() => { refreshAll().catch(() => {}); }, 800);
+    const now = Date.now();
+    if (now - lastSyncToast > 60000) { lastSyncToast = now; toast('图谱已被外部更新，已自动同步'); }
+  });
+} catch (_) { /* 浏览器不支持时依赖手动刷新 */ }
+
 $('s-save').addEventListener('click', async () => {
   const patch = { model: $('s-model').value.trim() || 'BAAI/bge-m3' };
   const key = $('s-key').value.trim();