local-knowledge-graph 1.10.3 → 1.11.0

package/lib/ocinstall.js

@@ -0,0 +1,229 @@
+'use strict';
+
+// OpenCode 一键安装与模型配置：
+// - 安装：npm 全局安装 opencode-ai。本应用本身即 npm 包，npm 必然可用，
+//   且全程无交互，Windows/macOS/Linux 通用（curl 脚本在 Windows 不可用）。
+// - 模型配置（写入 opencode 全局配置 ~/.config/opencode/opencode.json）：
+//   1) 已有认证(auth.json)或已设默认模型 → 尊重现有配置，不改动
+//   2) 本机 Ollama (127.0.0.1:11434) → 自动写入 provider 与默认模型
+//   3) 本机 LM Studio (127.0.0.1:1234) → 同上
+//   4) 兜底：OpenCode Zen 免费模型 opencode/grok-code（官方源码确认免费模型无需登录）
+// - 完成后通过 onDone 钩子通知调用方重新检测，无需重启应用即可使用。
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const NPM_PKG = 'opencode-ai';
+const FREE_MODEL = 'opencode/grok-code';
+const INSTALL_TIMEOUT_MS = 10 * 60 * 1000;
+const LOG_KEEP = 300;
+
+// phase: idle | installing | configuring | done | error
+const state = {
+  phase: 'idle',
+  step: '',
+  log: [],
+  error: null,
+  model: null, // { source: existing|ollama|lmstudio|free|error, model, detail }
+  started_at: null,
+  ended_at: null,
+};
+let running = false;
+let onDone = null; // 安装完成后的回调（server 用它重新 checkAgent）
+
+function pushLog(line) {
+  const t = new Date().toISOString().slice(11, 19);
+  state.log.push(`[${t}] ${line}`);
+  if (state.log.length > LOG_KEEP) state.log.splice(0, state.log.length - LOG_KEEP);
+}
+
+// npm 与 node 同目录（官方安装/nvm 均如此），GUI 启动 PATH 缺失时也能找到
+function npmCommand() {
+  const dir = path.dirname(process.execPath);
+  if (process.platform === 'win32') {
+    const local = path.join(dir, 'npm.cmd');
+    return { file: fs.existsSync(local) ? local : 'npm.cmd', shell: true };
+  }
+  const local = path.join(dir, 'npm');
+  return { file: fs.existsSync(local) ? local : 'npm', shell: false };
+}
+
+function runNpmInstall() {
+  return new Promise((resolve) => {
+    const npm = npmCommand();
+    let child;
+    try {
+      // --no-audit/--no-fund：跳过审计与赞助提示，大包安装明显提速
+      child = spawn(npm.file, ['install', '-g', NPM_PKG, '--no-audit', '--no-fund'], { env: process.env, stdio: ['ignore', 'pipe', 'pipe'], shell: npm.shell });
+    } catch (e) {
+      return resolve({ ok: false, error: `无法启动 npm: ${e.message}` });
+    }
+    // npm 非 TTY 运行时几乎没有中间输出，用心跳日志证明进程仍在下载
+    const t0 = Date.now();
+    const heartbeat = setInterval(() => pushLog(`下载安装中… 已耗时 ${Math.round((Date.now() - t0) / 1000)}s（首次需下载较大二进制，请耐心等待）`), 15000);
+    const timer = setTimeout(() => {
+      try { child.kill('SIGKILL'); } catch (_) { /* 已退出 */ }
+      resolve({ ok: false, error: `npm 安装超时(${INSTALL_TIMEOUT_MS / 60000}分钟)，已终止` });
+    }, INSTALL_TIMEOUT_MS);
+    const finish = (r) => { clearInterval(heartbeat); clearTimeout(timer); resolve(r); };
+    child.stdout.on('data', (d) => String(d).split('\n').forEach((l) => { if (l.trim()) pushLog(l.trim()); }));
+    child.stderr.on('data', (d) => String(d).split('\n').forEach((l) => { if (l.trim()) pushLog(l.trim()); }));
+    child.on('error', (e) => finish({ ok: false, error: `npm 启动失败: ${e.message}` }));
+    child.on('close', (code) => {
+      finish(code === 0 ? { ok: true } : { ok: false, error: `npm 退出码 ${code}（详见日志，可检查网络后重试）` });
+    });
+  });
+}
+
+// ---- opencode 配置文件 ----
+
+function xdgConfigHome() { return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config'); }
+function xdgDataHome() { return process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share'); }
+function globalConfigPath() { return path.join(xdgConfigHome(), 'opencode', 'opencode.json'); }
+function authFilePath() { return path.join(xdgDataHome(), 'opencode', 'auth.json'); }
+
+function readJsonSafe(p) {
+  try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch (_) { return null; }
+}
+
+function existingSetup() {
+  const auth = readJsonSafe(authFilePath());
+  if (auth && typeof auth === 'object' && Object.keys(auth).length) return { configured: true, where: 'auth' };
+  const cfg = readJsonSafe(globalConfigPath());
+  if (cfg && typeof cfg === 'object' && cfg.model) return { configured: true, where: 'config' };
+  return { configured: false, where: null };
+}
+
+// 合并写入全局配置；原文件不可解析（如 jsonc 带注释）时先备份再重写
+function writeGlobalConfig(mutate) {
+  const p = globalConfigPath();
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  let cfg = readJsonSafe(p);
+  if (!cfg || typeof cfg !== 'object' || Array.isArray(cfg)) {
+    if (fs.existsSync(p)) {
+      try { fs.copyFileSync(p, `${p}.bak-${Date.now()}`); } catch (_) { /* 备份失败也继续 */ }
+    }
+    cfg = {};
+  }
+  mutate(cfg);
+  if (!cfg.$schema) cfg.$schema = 'https://opencode.ai/config.json';
+  fs.writeFileSync(p, JSON.stringify(cfg, null, 2) + '\n');
+  return p;
+}
+
+function fetchJson(url, timeoutMs = 2000) {
+  return fetch(url, { signal: AbortSignal.timeout(timeoutMs) })
+    .then((r) => (r.ok ? r.json() : null))
+    .catch(() => null);
+}
+
+const EMBED_RE = /embed|bge|clip|rerank|minilm|nomic|e5[-_]|jina|gte/i;
+
+async function detectLocalModels() {
+  const ollama = await fetchJson('http://127.0.0.1:11434/api/tags');
+  const oModels = ((ollama && Array.isArray(ollama.models)) ? ollama.models : [])
+    .map((m) => m && m.name).filter((n) => n && !EMBED_RE.test(n));
+  if (oModels.length) {
+    return { provider: 'ollama', baseURL: 'http://localhost:11434/v1', label: 'Ollama', models: oModels, pick: oModels[0] };
+  }
+  const lms = await fetchJson('http://127.0.0.1:1234/v1/models');
+  const lModels = ((lms && Array.isArray(lms.data)) ? lms.data : [])
+    .map((m) => m && m.id).filter((n) => n && !EMBED_RE.test(n));
+  if (lModels.length) {
+    return { provider: 'lmstudio', baseURL: 'http://127.0.0.1:1234/v1', label: 'LM Studio', models: lModels, pick: lModels[0] };
+  }
+  return null;
+}
+
+function applyLocalProvider(local) {
+  const models = {};
+  for (const id of local.models) models[id] = { name: id };
+  writeGlobalConfig((cfg) => {
+    cfg.provider = cfg.provider || {};
+    cfg.provider[local.provider] = {
+      npm: '@ai-sdk/openai-compatible',
+      name: `${local.label} (local)`,
+      options: { baseURL: local.baseURL },
+      models,
+    };
+    cfg.model = `${local.provider}/${local.pick}`;
+  });
+  return { source: local.provider, model: `${local.provider}/${local.pick}`, detail: `检测到本机 ${local.label}，已接入 ${local.models.length} 个模型，默认使用 ${local.pick}` };
+}
+
+function applyFreeModel() {
+  writeGlobalConfig((cfg) => { cfg.model = FREE_MODEL; });
+  return { source: 'free', model: FREE_MODEL, detail: '未检测到本机模型，已设置 OpenCode Zen 免费模型（无需登录，可在 opencode 配置中更换）' };
+}
+
+async function configureModel() {
+  const existing = existingSetup();
+  if (existing.configured) {
+    return { source: 'existing', model: null, detail: existing.where === 'auth' ? '检测到已有 opencode 认证，保留现有模型配置' : '检测到已设置默认模型，保留现有配置' };
+  }
+  const local = await detectLocalModels();
+  return local ? applyLocalProvider(local) : applyFreeModel();
+}
+
+// ---- 主流程 ----
+
+async function installFlow() {
+  running = true;
+  Object.assign(state, { phase: 'installing', step: `正在通过 npm 安装 ${NPM_PKG}…`, error: null, model: null, started_at: Date.now(), ended_at: null });
+  pushLog(`开始安装 ${NPM_PKG}`);
+
+  const inst = await runNpmInstall();
+  if (!inst.ok) {
+    Object.assign(state, { phase: 'error', step: '', error: inst.error, ended_at: Date.now() });
+    pushLog(`安装失败: ${inst.error}`);
+    running = false;
+    return;
+  }
+  pushLog('npm 安装完成，正在识别 opencode…');
+  state.phase = 'configuring';
+  state.step = '正在检测安装结果与配置模型…';
+
+  const ocbin = require('./ocbin');
+  const bin = ocbin.findOpenCodeBin({ refresh: true });
+  const version = bin && ocbin.probeVersion(bin);
+  if (!version) {
+    const msg = `安装完成但未能识别 opencode${bin ? `（${bin.path} 探测失败）` : ''}，可用环境变量 KG_OPENCODE_PATH 指定可执行文件路径后重试`;
+    Object.assign(state, { phase: 'error', step: '', error: msg, ended_at: Date.now() });
+    pushLog(msg);
+    running = false;
+    return;
+  }
+  pushLog(`已识别 opencode: ${bin.path}（${version}）`);
+
+  try {
+    state.model = await configureModel();
+    pushLog(`模型配置: ${state.model.detail}${state.model.model ? `，默认模型 ${state.model.model}` : ''}`);
+  } catch (e) {
+    state.model = { source: 'error', model: null, detail: `模型配置失败: ${e.message}（opencode 本体已可用，可手动在其配置中设置模型）` };
+    pushLog(state.model.detail);
+  }
+
+  Object.assign(state, { phase: 'done', step: '', ended_at: Date.now() });
+  pushLog('全部完成，OpenCode 已就绪');
+  running = false;
+  if (typeof onDone === 'function') { try { onDone(); } catch (_) { /* 回调异常不影响状态 */ } }
+}
+
+function startInstall(force = false) {
+  if (running) return { started: false, reason: '安装正在进行中' };
+  if (state.phase === 'done' && !force) return { started: false, reason: '已安装完成，无需重复安装（强制重装请带 force）' };
+  if (force) Object.assign(state, { phase: 'idle', log: [], error: null, model: null });
+  installFlow().catch((e) => {
+    Object.assign(state, { phase: 'error', step: '', error: e.message, ended_at: Date.now() });
+    running = false;
+  });
+  return { started: true };
+}
+
+function status() {
+  return { ...state, running, log: state.log.slice(-40) };
+}
+
+module.exports = { startInstall, status, FREE_MODEL, set onDone(fn) { onDone = fn; }, _internal: { configureModel, existingSetup, detectLocalModels, globalConfigPath, authFilePath } };

package/lib/triples_io.js

@@ -0,0 +1,229 @@
+'use strict';
+
+// 三元组批量导入/导出（CSV / JSON）：
+// - JSON 格式：{ entities:[{name,category,attributes}], relations:[{source,target,name,category,...}] }
+//   导出时附带 id 与 confidence/source_ref；导入按 name 引用（纯数字优先按 id 解析）。
+// - CSV 格式：中文表头 kind,name,category,source,target,relation,relation_category,confidence,source_ref,attributes
+//   实体行：kind=实体；关系行：kind=关系。attributes 列为 JSON 字符串。
+// - 导入语义：同名实体自动复用（不存在才创建）；关系去重校验与手工添加完全一致；
+//   单行失败不中断整批，错误逐条收集返回。
+
+const V = require('./validator');
+
+const CSV_HEADERS = ['kind', 'name', 'category', 'source', 'target', 'relation', 'relation_category', 'confidence', 'source_ref', 'attributes'];
+const CSV_HEADERS_CN = '种类,名称,大类,起点,终点,关系,关系大类,置信度,来源引用,属性';
+
+// ---- CSV 序列化（RFC4180）----
+function csvCell(v) {
+  const s = v === null || v === undefined ? '' : String(v);
+  return /[",\r\n]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s;
+}
+
+function parseAttributesCell(raw, errors, where) {
+  if (raw === undefined || raw === null || String(raw).trim() === '') return {};
+  try {
+    const v = JSON.parse(raw);
+    if (v && typeof v === 'object' && !Array.isArray(v)) return v;
+    errors.push(`${where}: 属性列必须是JSON对象`);
+  } catch (_) {
+    errors.push(`${where}: 属性列不是合法JSON`);
+  }
+  return {};
+}
+
+// 属性规范化：db 行的 attributes 可能是 JSON 字符串（getGraph 原样）或对象，统一为对象再序列化
+function normAttrs(a) {
+  if (a && typeof a === 'object') return a;
+  return safeParse(a);
+}
+
+function entitiesToCsvRows(entities) {
+  return entities.map((e) => ([
+    '实体', e.name, e.category, '', '', '', '', '', '',
+    JSON.stringify(normAttrs(e.attributes)),
+  ]));
+}
+
+function relationsToCsvRows(relations, nameOf) {
+  return relations.map((r) => ([
+    '关系', '', r.category || '', nameOf(r.source_id), nameOf(r.target_id), r.name, r.category, r.confidence || '确证', r.source_ref || '',
+    JSON.stringify(normAttrs(r.attributes)),
+  ]));
+}
+
+function exportCsv(graph) {
+  const nameOf = (id) => {
+    const e = graph.entities.find((x) => x.id === id);
+    return e ? e.name : '#' + id;
+  };
+  const rows = [CSV_HEADERS_CN];
+  for (const r of entitiesToCsvRows(graph.entities)) rows.push(r.map(csvCell));
+  for (const r of relationsToCsvRows(graph.relations, nameOf)) rows.push(r.map(csvCell));
+  return rows.join('\r\n') + '\r\n';
+}
+
+function exportJson(graph) {
+  return JSON.stringify({
+    format: 'knowledge-graph-triples',
+    version: 1,
+    exported_at: new Date().toISOString(),
+    entities: graph.entities.map((e) => ({ id: e.id, name: e.name, category: e.category, attributes: safeParse(e.attributes) })),
+    relations: graph.relations.map((r) => ({
+      source_id: r.source_id,
+      target_id: r.target_id,
+      source: (graph.entities.find((x) => x.id === r.source_id) || {}).name || '#' + r.source_id,
+      target: (graph.entities.find((x) => x.id === r.target_id) || {}).name || '#' + r.target_id,
+      name: r.name,
+      category: r.category,
+      confidence: r.confidence || '确证',
+      source_ref: r.source_ref || '',
+      attributes: safeParse(r.attributes),
+    })),
+  }, null, 2) + '\n';
+}
+
+function safeParse(s) {
+  try { return JSON.parse(s || '{}') || {}; } catch (_) { return {}; }
+}
+
+// ---- CSV 解析（支持引号内逗号/换行/转义引号）----
+function parseCsvText(text) {
+  const rows = [];
+  let row = [];
+  let cell = '';
+  let inQuotes = false;
+  const src = String(text).replace(/^\uFEFF/, '');
+  for (let i = 0; i < src.length; i++) {
+    const c = src[i];
+    if (inQuotes) {
+      if (c === '"') {
+        if (src[i + 1] === '"') { cell += '"'; i++; }
+        else inQuotes = false;
+      } else cell += c;
+    } else if (c === '"') {
+      inQuotes = true;
+    } else if (c === ',') {
+      row.push(cell); cell = '';
+    } else if (c === '\r') {
+      /* 跳过 */
+    } else if (c === '\n') {
+      row.push(cell); rows.push(row); row = []; cell = '';
+    } else cell += c;
+  }
+  if (cell !== '' || row.length) { row.push(cell); rows.push(row); }
+  return rows.filter((r) => r.some((c) => String(c).trim() !== ''));
+}
+
+// 统一解析入口：返回 {entities:[{name,category,attributes}], relations:[{source,target,name,category,confidence,source_ref,attributes}], warnings[]}
+function parseImport(content, format) {
+  const errors = [];
+  const warnings = [];
+  const entities = [];
+  const relations = [];
+  const fmt = String(format || '').toLowerCase();
+
+  if (fmt === 'json') {
+    let data;
+    try {
+      data = JSON.parse(content);
+    } catch (e) {
+      return { ok: false, error: `JSON 解析失败: ${e.message}` };
+    }
+    const entList = Array.isArray(data) ? data : data.entities;
+    const relList = Array.isArray(data) ? [] : (data.relations || []);
+    if (!Array.isArray(entList)) return { ok: false, error: 'JSON 需包含 entities 数组（或顶层数组）' };
+    for (const e of entList) {
+      if (!e || typeof e !== 'object') continue;
+      entities.push({
+        name: e.name, category: e.category || '抽象实体',
+        attributes: e.attributes && typeof e.attributes === 'object' ? e.attributes : {},
+        fromId: Number.isInteger(e.id) ? e.id : null,
+      });
+    }
+    for (const r of relList) {
+      if (!r || typeof r !== 'object') continue;
+      relations.push({
+        source: r.source !== undefined ? r.source : r.source_id,
+        target: r.target !== undefined ? r.target : r.target_id,
+        name: r.name, category: r.category || '互动',
+        confidence: r.confidence, source_ref: r.source_ref || '',
+        attributes: r.attributes && typeof r.attributes === 'object' ? r.attributes : {},
+      });
+    }
+  } else if (fmt === 'csv') {
+    const rows = parseCsvText(content);
+    if (!rows.length) return { ok: false, error: 'CSV 为空' };
+    let idx = kindIdx(headers(rows[0]));
+    // 首行是合法表头则从第2行起读数据；否则整份内容按默认列序解析（首行也是数据）
+    const start = idx ? 1 : 0;
+    if (!idx) idx = defaultIdx();
+    for (let i = start; i < rows.length; i++) {
+      const c = rows[i];
+      const get = (n) => (idx[n] < c.length ? String(c[idx[n]]).trim() : '');
+      const where = `第${i + 1}行`;
+      const kind = get('kind');
+      if (kind === '实体' || kind === 'entity') {
+        entities.push({ name: get('name'), category: get('category') || '抽象实体', attributes: parseAttributesCell(get('attributes'), errors, where), fromId: null });
+      } else if (kind === '关系' || kind === 'relation') {
+        relations.push({
+          source: get('source') || get('name'),
+          target: get('target'),
+          name: get('relation'),
+          category: get('relation_category') || get('category') || '互动',
+          confidence: get('confidence') || undefined,
+          source_ref: get('source_ref'),
+          attributes: parseAttributesCell(get('attributes'), errors, where),
+        });
+      } else if (kind) {
+        warnings.push(`${where}: 未知种类"${kind}"，已跳过`);
+      }
+    }
+  } else {
+    return { ok: false, error: '格式必须为 csv 或 json' };
+  }
+
+  // 基础合法性过滤（深度校验在入库时进行，逐行收集错误）
+  const validEntities = [];
+  for (const e of entities) {
+    if (!e.name) { errors.push(`实体缺少名称: ${JSON.stringify(e.name)}`); continue; }
+    if (!V.ENTITY_CATEGORIES.includes(e.category)) {
+      warnings.push(`实体"${e.name}"大类"${e.category}"非法，已按"抽象实体"导入`);
+      e.category = '抽象实体';
+    }
+    validEntities.push(e);
+  }
+  const validRelations = [];
+  for (const r of relations) {
+    if (!r.source || !r.target || !r.name) { errors.push(`关系缺少起点/终点/名称: ${JSON.stringify(r)}`); continue; }
+    if (!V.RELATION_CATEGORIES.includes(r.category)) {
+      warnings.push(`关系"${r.name}"大类"${r.category}"非法，已按"互动"导入`);
+      r.category = '互动';
+    }
+    validRelations.push(r);
+  }
+  return { ok: true, entities: validEntities, relations: validRelations, errors, warnings };
+}
+
+function headers(row) { return row.map((c) => String(c).trim()); }
+function kindIdx(cols) {
+  const map = {};
+  cols.forEach((c, i) => { map[c] = i; });
+  if (map['种类'] === undefined && map['kind'] === undefined) return null;
+  return {
+    kind: map['种类'] !== undefined ? map['种类'] : map['kind'],
+    name: map['名称'] !== undefined ? map['名称'] : (map['name'] !== undefined ? map['name'] : 1),
+    category: map['大类'] !== undefined ? map['大类'] : (map['category'] !== undefined ? map['category'] : 2),
+    source: map['起点'] !== undefined ? map['起点'] : (map['source'] !== undefined ? map['source'] : 3),
+    target: map['终点'] !== undefined ? map['终点'] : (map['target'] !== undefined ? map['target'] : 4),
+    relation: map['关系'] !== undefined ? map['关系'] : (map['relation'] !== undefined ? map['relation'] : 5),
+    relation_category: map['关系大类'] !== undefined ? map['关系大类'] : 6,
+    confidence: map['置信度'] !== undefined ? map['置信度'] : (map['confidence'] !== undefined ? map['confidence'] : 7),
+    source_ref: map['来源引用'] !== undefined ? map['来源引用'] : (map['source_ref'] !== undefined ? map['source_ref'] : 8),
+    attributes: map['属性'] !== undefined ? map['属性'] : (map['attributes'] !== undefined ? map['attributes'] : 9),
+  };
+}
+function defaultIdx() {
+  return { kind: 0, name: 1, category: 2, source: 3, target: 4, relation: 5, relation_category: 6, confidence: 7, source_ref: 8, attributes: 9 };
+}
+
+module.exports = { exportCsv, exportJson, parseImport, CSV_HEADERS_CN };

package/lib/validator.js

@@ -24,6 +24,23 @@ function isPrimitive(v) {
   return v === null || ['string', 'number', 'boolean'].includes(typeof v);
 }
 
+// 扁平属性校验（实体与关系共用）：键为非空字符串，值为原始类型，禁止嵌套
+function checkFlatAttributes(attributes, label, errors) {
+  if (attributes === undefined) return {};
+  if (attributes === null || typeof attributes !== 'object' || Array.isArray(attributes)) {
+    errors.push(`${label}(attributes)必须为JSON对象`);
+    return null;
+  }
+  for (const [k, v] of Object.entries(attributes)) {
+    if (typeof k !== 'string' || k.trim().length === 0) errors.push(`属性键"${k}"必须为非空字符串`);
+    if (!isPrimitive(v)) {
+      errors.push(`属性"${k}"的值必须为字符串/数值/布尔/空值(扁平三元组结构)，禁止嵌套对象或数组`);
+    }
+  }
+  if (Object.keys(attributes).length > 100) errors.push(`${label}键数量不得超过100`);
+  return attributes;
+}
+
 // 实体校验：三元组结构 (subject=实体, predicate=属性键, object=原子值)
 // 属性必须是扁平JSON对象，键为非空字符串，值为原始类型；禁止嵌套与冗余字段
 function validateEntityInput(input) {
@@ -44,13 +61,7 @@ function validateEntityInput(input) {
     errors.push('属性(attributes)必须为JSON对象');
     attributes = null;
   } else {
-    for (const [k, v] of Object.entries(attributes)) {
-      if (typeof k !== 'string' || k.trim().length === 0) errors.push(`属性键"${k}"必须为非空字符串`);
-      if (!isPrimitive(v)) {
-        errors.push(`属性"${k}"的值必须为字符串/数值/布尔/空值(扁平三元组结构)，禁止嵌套对象或数组`);
-      }
-    }
-    if (Object.keys(attributes).length > 100) errors.push('属性键数量不得超过100');
+    checkFlatAttributes(attributes, '属性', errors);
   }
 
   if (errors.length) return { ok: false, errors, value: null };
@@ -116,8 +127,18 @@ function validateRelationInput(input, db) {
   if (typeof source_ref !== 'string') errors.push('来源引用(source_ref)必须为字符串');
   else if (source_ref.length > 500) errors.push('来源引用长度不得超过500字符');
 
+  const attributes = checkFlatAttributes(input.attributes === undefined ? {} : input.attributes, '关系属性', errors);
+
   if (errors.length) return { ok: false, errors, value: null };
-  return { ok: true, errors: [], value: { source_id: sid, target_id: tid, name: name.trim(), category, confidence, source_ref } };
+  return { ok: true, errors: [], value: { source_id: sid, target_id: tid, name: name.trim(), category, confidence, source_ref, attributes } };
+}
+
+// 重复三元组检测：同起点+终点+关系名视为重复；excludeId 供更新时排除自身
+function findDuplicateRelation(value, db, excludeId) {
+  const row = db.prepare(
+    'SELECT id, source_id, target_id, name FROM relations WHERE source_id = ? AND target_id = ? AND name = ? AND id != ? LIMIT 1'
+  ).get(value.source_id, value.target_id, value.name, excludeId || 0);
+  return row || null;
 }
 
 function validateRelationPatch(patch, existing, db) {
@@ -129,6 +150,7 @@ function validateRelationPatch(patch, existing, db) {
     category: existing.category,
     confidence: existing.confidence || '确证',
     source_ref: existing.source_ref || '',
+    attributes: JSON.parse(existing.attributes || '{}'),
   };
   if (patch.source_id !== undefined) merged.source_id = patch.source_id;
   if (patch.target_id !== undefined) merged.target_id = patch.target_id;
@@ -151,6 +173,10 @@ function validateRelationPatch(patch, existing, db) {
     else if (patch.source_ref.length > 500) errors.push('来源引用长度不得超过500字符');
     else merged.source_ref = patch.source_ref;
   }
+  if (patch.attributes !== undefined) {
+    checkFlatAttributes(patch.attributes, '关系属性', errors);
+    if (!errors.length) merged.attributes = patch.attributes;
+  }
   const check = validateRelationInput(merged, db);
   if (errors.length || !check.ok) return { ok: false, errors: [...errors, ...check.errors], value: null };
   return check;
@@ -167,4 +193,5 @@ module.exports = {
   validateEntityPatch,
   validateRelationInput,
   validateRelationPatch,
+  findDuplicateRelation,
 };

package/lib/viewer_template.html

@@ -166,18 +166,38 @@ function buildNodeMesh(category) {
     const a = simNodes.find(n => n.id === r.source_id), 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 op0 = st.opacity===undefined?0.9:st.opacity;
+    const op = conf === '存疑' ? Math.min(op0, 0.35) : op0;
+    const dashed = st.dashed || conf === '推测';
     const geo = new THREE.BufferGeometry().setFromPoints([a.pos, b.pos]);
-    const mat = st.dashed
-      ? new THREE.LineDashedMaterial({ color: st.color, dashSize: st.dashSize||6, gapSize: st.gapSize||4, transparent: true, opacity: st.opacity===undefined?0.9:st.opacity })
-      : new THREE.LineBasicMaterial({ color: st.color, transparent: true, opacity: st.opacity===undefined?0.9:st.opacity });
+    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;
     linkGroup.add(line);
     const lbl = makeLabelSprite(r.name, st.css, 24);
     lbl.position.copy(a.pos).add(b.pos).multiplyScalar(0.5);
     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 });
   });
+  // 平行边标签错开：同节点对多条关系时标签沿垂直方向交替偏移，避免文字重叠
+  (() => {
+    const pairCount = new Map(), pairSeen = new Map();
+    for (const r of GRAPH.relations) {
+      const k = r.source_id < r.target_id ? r.source_id+'|'+r.target_id : r.target_id+'|'+r.source_id;
+      pairCount.set(k, (pairCount.get(k)||0)+1);
+    }
+    for (const l of simLinks) {
+      const r = GRAPH.relations.find(x => x.id === l.id);
+      if (!r) continue;
+      const k = r.source_id < r.target_id ? r.source_id+'|'+r.target_id : r.target_id+'|'+r.source_id;
+      const n = pairCount.get(k)||1, i = pairSeen.get(k)||0;
+      pairSeen.set(k, i+1);
+      l.arcIdx = n > 1 ? i - (n-1)/2 : 0;
+    }
+  })();
 })();
 
 document.getElementById('legend').innerHTML =
@@ -209,7 +229,19 @@ function simStep() {
     pa.setXYZ(1, l.b.pos.x, l.b.pos.y, l.b.pos.z);
     pa.needsUpdate = true;
     if (l.dashed) l.line.computeLineDistances();
-    l.label.position.copy(l.a.pos).add(l.b.pos).multiplyScalar(0.5);
+    // 标签置于边中点；平行边按序号沿垂直方向错开（n = dir × up）
+    const dx = l.b.pos.x-l.a.pos.x, dy = l.b.pos.y-l.a.pos.y, dz = l.b.pos.z-l.a.pos.z;
+    const len = Math.max(Math.sqrt(dx*dx+dy*dy+dz*dz), 0.01);
+    let nx, ny, nz;
+    if (Math.abs(dy) / len > 0.92) { nx = 0; ny = dz; nz = -dy; }
+    else { nx = -dz; ny = 0; nz = dx; }
+    const nl = Math.max(Math.sqrt(nx*nx+ny*ny+nz*nz), 0.01);
+    const off = (l.arcIdx || 0) * len * 0.16;
+    l.label.position.set(
+      (l.a.pos.x+l.b.pos.x)/2 + nx/nl*off,
+      (l.a.pos.y+l.b.pos.y)/2 + ny/nl*off + (l.arcIdx ? 0 : 18),
+      (l.a.pos.z+l.b.pos.z)/2 + nz/nl*off
+    );
   }
   for (const nd of simNodes) { nd.mesh.position.copy(nd.pos); nd.label.position.set(nd.pos.x, nd.pos.y+18, nd.pos.z); }
 }
@@ -264,8 +296,14 @@ function renderCard() {
     const r = GRAPH.relations.find(x => x.id === selected.obj.id);
     if (!r) { card.style.display = 'none'; return; }
     const s = entityMap.get(r.source_id), t = entityMap.get(r.target_id);
+    let attrs = {};
+    try { attrs = JSON.parse(r.attributes || '{}'); } catch (_) {}
+    let attrHtml = '';
+    for (const [k, v] of Object.entries(attrs)) attrHtml += '<div class="kv"><b>'+esc(k)+'</b>: '+esc(String(v))+'</div>';
     card.innerHTML = '<h4>'+esc(r.name)+' <span class="tag" style="color:'+RELATION_STYLE[r.category].css+';border-color:'+RELATION_STYLE[r.category].css+'55">'+r.category+'关系</span></h4>' +
-      '<div class="kv"><b>'+(s ? esc(s.entity.name) : '?')+'</b> --&gt; <b>'+(t ? esc(t.entity.name) : '?')+'</b></div><div class="kv">id: '+r.id+'　来源: '+esc(r.source)+'</div>';
+      '<div class="kv"><b>'+(s ? esc(s.entity.name) : '?')+'</b> --&gt; <b>'+(t ? esc(t.entity.name) : '?')+'</b></div>' +
+      '<div class="kv">id: '+r.id+'　置信度: '+esc(r.confidence||'确证')+(r.source_ref ? '　来源: '+esc(r.source_ref) : '')+'</div>' +
+      (attrHtml || '');
     card.style.display = 'block';
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-knowledge-graph",
-  "version": "1.10.3",
+  "version": "1.11.0",
   "description": "本地知识图谱整合器：3D可视化 + AI对话建图 + 智能检索 + Git回溯 + RDF合规，全流程本地运行",
   "main": "server.js",
   "bin": {