local-knowledge-graph 1.6.0 → 1.7.0

package/public/app.js

@@ -13,8 +13,22 @@ 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);
 function toast(msg, isErr) {
   const t = $('toast');
@@ -121,20 +135,25 @@ let UI_THEME = 'dark';
 try { if (localStorage.getItem(UI_THEME_KEY) === 'light') UI_THEME = 'light'; } catch (_) {}
 document.documentElement.dataset.theme = UI_THEME;
 
-function applyTheme(mode) {
+function applyUiTheme(mode) {
   UI_THEME = UI_THEMES[mode] ? mode : 'dark';
   document.documentElement.dataset.theme = UI_THEME;
   try { localStorage.setItem(UI_THEME_KEY, UI_THEME); } catch (_) {}
   if (typeof scene !== 'undefined' && typeof grid !== 'undefined' && grid) {
     const t = UI_THEMES[UI_THEME];
     scene.remove(grid);
-    grid.dispose();
+    if (typeof grid.dispose === 'function') grid.dispose(); // three r128 GridHelper 无 dispose
     grid = new THREE.GridHelper(480, 48, t.grid1, t.grid2);
     grid.position.y = -60;
     scene.add(grid);
   }
 }
 
+/* 启动期兜底：任何未捕获异常立刻弹出提示，避免画布空白却无感知 */
+window.addEventListener('error', (e) => {
+  try { toast('脚本异常: ' + (e.message || '未知错误'), 6000); } catch (_) {}
+});
+
 /* ================= Three.js 场景 ================= */
 const wrap = $('canvas-wrap');
 const scene = new THREE.Scene();
@@ -156,7 +175,10 @@ scene.add(dirLight);
 let grid = new THREE.GridHelper(480, 48, 0x1c2a47, 0x141e35);
 grid.position.y = -60;
 scene.add(grid);
-applyTheme(UI_THEME); // 按存储的主题重建网格（CSS背景经 data-theme 生效）
+applyUiTheme(UI_THEME); // 按存储的主题重建网格（CSS背景经 data-theme 生效）
+
+const savedTheme = loadTheme();
+if (savedTheme && applyTheme(savedTheme)) { /* 启动时恢复用户保存的3D样式主题 */ }
 
 let nodeGroup = new THREE.Group();
 let linkGroup = new THREE.Group();
@@ -248,7 +270,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;
@@ -303,13 +327,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);
     // 线标注显示具体关系名（如"父子"），线型/颜色仍由大类规定
@@ -317,7 +345,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与库中显式关系区分；仅显示两端均在当前视图的边
@@ -512,19 +540,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);
@@ -558,10 +609,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';
   }
 }
@@ -822,7 +878,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() {
@@ -903,16 +961,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 {
@@ -940,19 +1054,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: '删除实体',
@@ -1102,6 +1227,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;
@@ -1113,39 +1239,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) {
@@ -1334,9 +1639,11 @@ function renderStylePanel() {
   $('style-close').addEventListener('click', () => $('style-panel').classList.remove('show'));
   const themeSel = $('ui-theme-select');
   themeSel.value = UI_THEME;
-  themeSel.addEventListener('change', () => { applyTheme(themeSel.value); toast(themeSel.value === 'light' ? '已切换浅色主题' : '已切换深色主题'); });
+  themeSel.addEventListener('change', () => { applyUiTheme(themeSel.value); toast(themeSel.value === 'light' ? '已切换浅色主题' : '已切换深色主题'); });
   $('style-save').addEventListener('click', () => {
-    localStorage.setItem(THEME_KEY, JSON.stringify(currentThemeJson()));
+    const t = currentThemeJson();
+    localStorage.setItem(THEME_KEY, JSON.stringify(t));
+    applyTheme(t);
     toast('主题已保存到本地');
   });
   $('style-reset').addEventListener('click', () => {
@@ -1572,6 +1879,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]));
   // 推理开关开启时同步刷新推理缓存，保证叠加边与新数据一致
@@ -1584,6 +1892,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'; }
@@ -1626,6 +1935,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' ? '⏱' : '✘';
@@ -1654,8 +1964,32 @@ 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) {

package/public/index.html

@@ -63,11 +63,27 @@
           <input id="r-name" placeholder="例如：位于">
           <label>大类（对应线型/颜色）</label>
           <select id="r-category"></select>
+          <label>置信度</label>
+          <select id="r-confidence">
+            <option value="确证">确证（有明确依据）</option>
+            <option value="推测">推测（合理推断）</option>
+            <option value="存疑">存疑（待核实）</option>
+          </select>
+          <label>来源引用（URL / 文献+页码，可选）</label>
+          <input id="r-source-ref" placeholder="例如：《明史》卷304">
           <label>终点实体</label>
           <select id="r-target"></select>
           <div class="row"><button class="primary" id="r-submit">添加</button></div>
         </div>
-        <div class="card"><h3>关系列表</h3><div id="r-list"></div></div>
+        <div class="card"><h3>关系列表</h3>
+          <div class="conf-filter" id="conf-filter">
+            <span class="cf-chip active" data-c="">全部</span>
+            <span class="cf-chip" data-c="确证">确证</span>
+            <span class="cf-chip" data-c="推测">推测</span>
+            <span class="cf-chip" data-c="存疑">存疑</span>
+          </div>
+          <div id="r-list"></div>
+        </div>
       </div>
 
       <div class="tabbody" id="tab-search">
@@ -103,6 +119,19 @@
           <div class="row"><button class="primary" id="c-run">执行</button><span id="c-hint" style="font-size:11px;color:#8fa3c0;align-self:center">支持 contains / = 与 类型:互动|归属</span></div>
           <div id="c-results"></div>
         </div>
+        <div class="card">
+          <h3>文档批量入图（md / txt / pdf）</h3>
+          <div class="row" style="gap:12px">
+            <button class="primary" id="ing-btn">选择文档</button>
+            <label style="display:flex;align-items:center;gap:4px;font-size:12px;cursor:pointer">
+              <input type="checkbox" id="ing-auto" style="width:auto"> 跳过审核直接入库
+            </label>
+            <span id="ing-status" style="font-size:11px;color:#8fa3c0;align-self:center"></span>
+          </div>
+          <div id="ing-tasks"></div>
+          <div class="hint-text">LLM逐片抽取候选三元组 → 审核勾选 → 确认入库（先自动打保存点）。新实体来源标记"文档"，关系自带来源引用"《文档》片段n"。勾选"跳过审核"后抽取完成即自动全量入库。</div>
+          <input type="file" id="ing-file" accept=".md,.markdown,.txt,.pdf" style="display:none">
+        </div>
       </div>
 
       <div class="tabbody" id="tab-log">