local-knowledge-graph 1.10.4 → 1.11.0

package/public/index.html

@@ -20,7 +20,9 @@
     <button id="btn-undo" title="撤销最近一次操作（按快照还原，快捷键Ctrl+Z）">撤销</button>
     <button id="btn-export" title="导出标准RDF(Turtle)格式文件">导出RDF</button>
     <button id="btn-relayout" title="重新进行力导向布局">重新布局</button>
+    <button id="btn-multisel" title="多选模式：点击节点加入/移出选区，然后提取子图或导出">多选</button>
     <button id="btn-resetview" title="重置相机视角">重置视角</button>
+    <button id="btn-screenshot" title="将当前3D视图截图为PNG图片（2倍分辨率）">截图</button>
     <button id="btn-style" title="自定义实体/关系的颜色、大小与线型">视图设置</button>
     <button id="btn-help" title="帮助：查看版本现状、检查更新与使用指南">帮助</button>
     <button id="btn-inference" title="叠加显示推理得到的隐性关系（虚线，OWL传递/对称/逆规则），点击推理边可查看推导依据">推理</button>
@@ -33,6 +35,7 @@
         <div data-tab="entity" class="active">实体</div>
         <div data-tab="relation">关系</div>
         <div data-tab="search">检索</div>
+        <div data-tab="stats">统计</div>
         <div data-tab="mcp">MCP</div>
         <div data-tab="log">日志</div>
         <div data-tab="version">版本</div>
@@ -88,6 +91,23 @@
       </div>
 
       <div class="tabbody" id="tab-search">
+        <div class="card">
+          <h3>属性过滤（按实体属性筛选图上显示）</h3>
+          <div class="row">
+            <div style="flex:1.4"><label>属性键</label><input id="af-key" placeholder="例如：朝代"></div>
+            <div style="width:100px"><label>条件</label>
+              <select id="af-op">
+                <option value="eq">等于</option>
+                <option value="contains">包含</option>
+                <option value="gt">大于</option>
+                <option value="lt">小于</option>
+                <option value="exists">存在该键</option>
+              </select>
+            </div>
+            <div style="flex:1"><label>值</label><input id="af-value" placeholder="大于/小于需填数字"></div>
+          </div>
+          <div class="row"><button class="primary" id="af-apply">应用到图上</button><button id="af-clear">清除过滤</button><span id="af-status" style="font-size:11px;color:#8fa3c0;align-self:center"></span></div>
+        </div>
         <div class="card">
           <h3>智能提问（自然语言关系查找）</h3>
           <label>用一句话描述要找的关系</label>
@@ -110,6 +130,15 @@
           </div>
           <div class="row"><button class="primary" id="s-save">保存配置</button><button id="s-test">测试连接</button><button id="s-build">构建全量向量</button><span id="s-status" style="font-size:11px;color:#8fa3c0;align-self:center"></span></div>
         </div>
+        <div class="card" id="oc-install-card" style="display:none">
+          <h3>OpenCode 一键安装（AI 对话建图依赖）</h3>
+          <div class="row">
+            <button class="primary" id="oc-install-btn">下载并安装 OpenCode</button>
+            <span id="oc-install-status" style="font-size:11px;color:#8fa3c0;align-self:center">未检测到 opencode，点击按钮自动完成安装</span>
+          </div>
+          <pre id="oc-install-log" class="mcp-snippet" style="display:none;max-height:160px;overflow:auto"></pre>
+          <div class="hint-text">将通过 npm 全局安装 opencode-ai（约几十MB，需 1-3 分钟）。安装后自动配置模型：优先接入本机 Ollama / LM Studio 已有模型，否则使用 OpenCode Zen 免费模型（无需登录）。完成后立即可在右侧 AI 对话使用，无需重启本应用。</div>
+        </div>
         <div class="card">
           <h3>混合检索（语义+关键词 RRF 融合）</h3>
           <label>查询</label>
@@ -143,6 +172,19 @@
         </div>
       </div>
 
+      <div class="tabbody" id="tab-stats">
+        <div class="card">
+          <h3>图统计（度分布与枢纽节点）</h3>
+          <div class="row"><button class="primary" id="st-refresh">刷新统计</button><span id="st-status" style="font-size:11px;color:#8fa3c0;align-self:center"></span></div>
+          <div id="st-overview"></div>
+          <h3 style="margin-top:14px">度分布</h3>
+          <div id="st-dist"></div>
+          <h3 style="margin-top:14px">枢纽节点 Top10（点击飞行定位）</h3>
+          <div id="st-hubs"></div>
+          <h3 style="margin-top:14px">实体大类分布</h3>
+          <div id="st-cats"></div>
+        </div>
+      </div>
       <div class="tabbody" id="tab-log">
         <div class="card">
           <h3>操作日志（手工与OpenCode共用）</h3>
@@ -240,6 +282,22 @@
         <button id="ego-exit">退出中心</button>
         <div class="ego-hint">清空层数输入框 = 显示全部层级；层级光圈颜色随跳数递进</div>
       </div>
+      <div id="ms-bar">
+        <span>多选:</span><span class="ego-name" id="ms-count">已选 0 个</span>
+        <button id="ms-extract">提取子图</button>
+        <button id="ms-export-json">导出JSON</button>
+        <button id="ms-export-csv">导出CSV</button>
+        <button id="ms-clear">清空</button>
+        <button id="ms-exit">退出多选</button>
+        <div class="ego-hint">点击图上节点加入/移出选区（金色光圈标记），完成后提取子图或直接导出</div>
+      </div>
+      <div id="sub-bar">
+        <span>子图:</span><span class="ego-name" id="sub-name"></span>
+        <button id="sub-export-json">导出JSON</button>
+        <button id="sub-export-csv">导出CSV</button>
+        <button id="sub-exit">退出子图</button>
+        <div class="ego-hint">子图模式：仅显示所选实体及其之间的关联关系，可随时导出</div>
+      </div>
       <div id="info-card"></div>
       <div id="style-panel"></div>
       <div id="help-panel">
@@ -308,8 +366,12 @@
   <button id="fm-saveas">另存为图谱</button>
   <button id="fm-savehtml">另存为图谱网页</button>
   <button id="fm-rdf">导出 RDF</button>
+  <button id="fm-export-json">导出三元组 JSON</button>
+  <button id="fm-export-csv">导出三元组 CSV</button>
+  <button id="fm-import-triples">导入三元组（JSON/CSV）</button>
 </div>
 <input type="file" id="db-file-input" accept=".db,.sqlite,.sqlite3" style="display:none">
+<input type="file" id="triples-file-input" accept=".json,.csv" style="display:none">
 <div id="lightbox">
   <button class="lb-close" id="lb-close" title="关闭">x</button>
   <figure>

package/public/style.css

@@ -133,10 +133,23 @@
   #ego-bar label { margin: 0; color: #8fa3c0; }
   #ego-bar input { width: 76px; }
   #ego-bar .ego-hint { color: #5c6f92; font-size: 10.5px; width: 100%; text-align: center; }
+  /* 多选条与子图条：布局/配色与中心条一致 */
+  #ms-bar, #sub-bar {
+    position: absolute; top: 10px; left: 50%; transform: translateX(-50%);
+    display: none; align-items: center; gap: 8px; flex-wrap: wrap; justify-content: center;
+    background: rgba(13,20,36,.92); border: 1px solid #2a3a5c; border-radius: 8px;
+    padding: 7px 12px; z-index: 12; max-width: calc(100% - 24px); font-size: 12px;
+  }
+  #ms-bar.show, #sub-bar.show { display: flex; }
+  #ms-bar .ego-name, #sub-bar .ego-name { color: #ffd75f; font-weight: 600; }
+  #ms-bar .ego-hint, #sub-bar .ego-hint { color: #5c6f92; font-size: 10.5px; width: 100%; text-align: center; }
+  #btn-multisel.active { border-color: #ffd75f; color: #ffd75f; }
   @media (max-width: 768px) {
     #ego-bar { top: 8px; padding: 6px 8px; gap: 6px; }
     #ego-bar .ego-name { max-width: 110px; }
     #ego-bar button { min-height: 30px; padding: 5px 9px; font-size: 11px; }
+    #ms-bar, #sub-bar { top: 8px; padding: 6px 8px; gap: 6px; }
+    #ms-bar button, #sub-bar button { min-height: 30px; padding: 5px 9px; font-size: 11px; }
   }
 
   /* ================= 实体图片 ================= */

package/server.js

@@ -8,6 +8,8 @@ const db = require('./lib/db');
 const git = require('./lib/git');
 const rdf = require('./lib/rdf');
 const agent = require('./lib/agent');
+const ocbin = require('./lib/ocbin');
+const ocinstall = require('./lib/ocinstall');
 const V = require('./lib/validator');
 const inference = require('./lib/inference');
 const recommend = require('./lib/recommend');
@@ -58,6 +60,7 @@ api.get('/meta', (req, res) => {
     counts: db.counts(),
     version: db.getVersion(),
     agent_available: agentAvailable,
+    agent_path: agentBin ? agentBin.path : null,
     agent_session: agentSessionInfo(),
   });
 });
@@ -572,6 +575,60 @@ api.get('/export/html', (req, res) => {
   res.send(html);
 });
 
+// ---------- 三元组 JSON/CSV 导出（可选 ids 参数用于子图导出） ----------
+function filteredGraph(idsParam) {
+  if (!idsParam) return db.getGraph();
+  const ids = new Set(String(idsParam).split(',').map((s) => Number(s.trim())).filter((n) => Number.isInteger(n) && n > 0));
+  const g = db.getGraph();
+  return {
+    entities: g.entities.filter((e) => ids.has(e.id)),
+    relations: g.relations.filter((r) => ids.has(r.source_id) && ids.has(r.target_id)),
+    image_counts: g.image_counts,
+    aliases: g.aliases,
+  };
+}
+
+api.get('/export/json', (req, res) => {
+  const triples = require('./lib/triples_io');
+  const body = triples.exportJson(filteredGraph(req.query.ids));
+  res.setHeader('Content-Type', 'application/json; charset=utf-8');
+  res.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodeURIComponent(req.query.name || 'kg-backup.json')}`);
+  res.send(body);
+});
+
+api.get('/export/csv', (req, res) => {
+  const triples = require('./lib/triples_io');
+  const body = '\uFEFF' + triples.exportCsv(filteredGraph(req.query.ids));
+  res.setHeader('Content-Type', 'text/csv; charset=utf-8');
+  res.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodeURIComponent(req.query.name || 'kg-backup.csv')}`);
+  res.send(body);
+});
+
+// ---------- 三元组 CSV/JSON 批量导入 ----------
+api.post('/import/triples', (req, res) => {
+  const { content, format, dry_run } = req.body || {};
+  if (!content || typeof content !== 'string') return res.status(400).json({ error: '必须提供 content（CSV/JSON 文本）' });
+  if (content.length > 20 * 1024 * 1024) return res.status(400).json({ error: '内容超过20MB上限' });
+  const triples = require('./lib/triples_io');
+  const parsed = triples.parseImport(content, format || (content.trim().startsWith('{') || content.trim().startsWith('[') ? 'json' : 'csv'));
+  if (!parsed.ok) return res.status(400).json({ error: parsed.error });
+  if (dry_run) {
+    return res.json({ ok: true, dry_run: true, entities: parsed.entities.length, relations: parsed.relations.length, warnings: parsed.warnings.slice(0, 20) });
+  }
+  try {
+    const r = db.applyTriplesImport(parsed, '手工');
+    r.entity_ids = undefined;
+    bus.emit('graph-changed', { via: 'import' });
+    git.savepoint(`三元组导入：实体+${r.entities_added} 关系+${r.relations_added}`, '系统');
+    res.json({ ok: true, ...r, warnings: parsed.warnings.slice(0, 20), counts: db.counts(), version: db.getVersion() });
+  } catch (e) {
+    res.status(e.status || 500).json({ error: e.message });
+  }
+});
+
+// ---------- 图统计（度分布与枢纽节点） ----------
+api.get('/stats', (req, res) => res.json(db.graphStats()));
+
 // ---------- Git保存点与回溯 ----------
 api.get('/git/history', (req, res) => res.json(git.history(Number(req.query.limit) || 100)));
 api.post('/git/savepoint', (req, res) => {
@@ -814,16 +871,33 @@ app.use((err, req, res, next) => {
 
 // ---------- 启动流程：异常兜底 + 自动拉起OpenCode ----------
 let agentAvailable = false;
+let agentBin = null;
 
 function checkAgent() {
-  try {
-    require('child_process').execFileSync('opencode', ['--version'], { encoding: 'utf8', timeout: 15000 });
-    agentAvailable = true;
-  } catch (_) {
-    agentAvailable = false;
+  // 多路径解析：PATH 扫描 + 常见安装位置 + npm 垫片还原（详见 lib/ocbin.js）
+  const bin = ocbin.findOpenCodeBin({ refresh: true });
+  agentBin = bin;
+  const version = bin && ocbin.probeVersion(bin);
+  agentAvailable = Boolean(version);
+  if (bin && !version) {
+    console.warn(`[OpenCode] 已定位到 ${bin.path} 但版本探测失败`);
   }
 }
 
+// ---------- OpenCode 一键安装（未检测到时前端可触发） ----------
+app.post('/api/agent/install', (req, res) => {
+  const force = !!(req.body && req.body.force);
+  const r = ocinstall.startInstall(force);
+  if (!r.started) return res.status(409).json({ error: r.reason, install: ocinstall.status() });
+  res.json({ ok: true, install: ocinstall.status() });
+});
+app.get('/api/agent/install', (req, res) => {
+  res.json({ ...ocinstall.status(), agent_available: agentAvailable });
+});
+ocinstall.onDone = checkAgent;
+
+app.use('/api', api);
+
 function bootstrap() {
   require('./lib/paths').ensureLegacyMigration();
   git.ensureRepo();
@@ -851,7 +925,9 @@ function bootstrap() {
   }
   seedIfEmpty();
   checkAgent();
-  console.log(agentAvailable ? '[OpenCode] 进程已就绪，可在前端输入自然语言指令' : '[OpenCode] 未检测到 opencode CLI，自然语言补全不可用（其余功能不受影响）');
+  console.log(agentAvailable
+    ? `[OpenCode] 进程已就绪（${agentBin.path}，来源:${agentBin.via}），可在前端输入自然语言指令`
+    : '[OpenCode] 未检测到 opencode CLI，自然语言补全不可用（其余功能不受影响）。已安装时可用环境变量 KG_OPENCODE_PATH 指定可执行文件路径');
 }
 
 function seedIfEmpty() {