local-knowledge-graph 1.10.4 → 1.12.0

package/public/index.html

@@ -18,13 +18,10 @@
     <button id="m-right" class="m-btn" title="打开AI对话">AI</button>
     <button id="btn-savepoint" title="将当前合规数据提交为Git保存点（仅存差异）">打保存点</button>
     <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-resetview" title="重置相机视角">重置视角</button>
-    <button id="btn-style" title="自定义实体/关系的颜色、大小与线型">视图设置</button>
+    <button id="btn-multisel" title="多选模式：点击节点加入/移出选区，然后提取子图或导出">多选</button>
     <button id="btn-help" title="帮助：查看版本现状、检查更新与使用指南">帮助</button>
-    <button id="btn-inference" title="叠加显示推理得到的隐性关系（虚线，OWL传递/对称/逆规则），点击推理边可查看推导依据">推理</button>
-    <button id="m-file" class="m-btn" title="文件：打开/保存/另存">文件</button>
+    <button id="m-view" class="m-btn" title="视图：布局/视角/主题/推理/截图">视图</button>
+    <button id="m-file" class="m-btn" title="文件：打开/保存/另存/导入导出">文件</button>
   </header>
 
   <main>
@@ -33,6 +30,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 +86,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 +125,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 +167,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>
@@ -172,7 +209,16 @@
           <div class="row"><button class="primary" id="v-save">打保存点</button></div>
           <div class="hint-text">数据文件 data/kg.db 由本地Git仓库托管，仅存差异版本；恢复前会自动备份当前状态。</div>
         </div>
-        <div class="card"><h3>提交历史（与操作日志双向绑定）</h3><div id="v-list"></div></div>
+        <div class="card"><h3>提交历史（与操作日志双向绑定）</h3>
+          <div class="hint-text">勾选两个保存点可对比版本差异（Diff）。</div>
+          <div id="diff-bar" style="display:none;align-items:center;gap:8px;flex-wrap:wrap;margin:8px 0">
+            <span id="diff-bar-text" style="font-size:12px;color:#8fa3c0"></span>
+            <button class="primary" id="btn-diff-run" style="padding:4px 10px;font-size:12px">对比所选版本</button>
+            <button id="btn-diff-clear" style="padding:4px 10px;font-size:12px">清除选择</button>
+          </div>
+          <div id="diff-result" style="display:none"></div>
+          <div id="v-list"></div>
+        </div>
       </div>
 
       <div class="tabbody" id="tab-mcp">
@@ -240,6 +286,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">
@@ -249,6 +311,7 @@
           <p class="hp-p">本地知识图谱整合器 —— 把文档与联网信息整理成可导航的 3D 知识图谱。全流程本地运行，数据存于本机 data/ 目录（独立 Git 仓库托管，可回溯）。</p>
           <h3>版本与更新</h3>
           <div id="help-upd"></div>
+          <div class="hp-line">想先看看效果？<button id="btn-load-demo" class="ghost" style="padding:3px 10px;font-size:12px;margin:0 4px">载入演示数据</button>（太阳系示例，现有数据会先自动打保存点备份）</div>
           <div class="hp-line">详细帮助文档：项目目录下 <b>HELP.md</b></div>
           <div class="hp-line">发布记录：<a href="https://github.com/iamsamyiok/local-knowledge-graph/releases" target="_blank" rel="noopener">GitHub Releases</a></div>
           <h3>快速上手</h3>
@@ -308,8 +371,20 @@
   <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>
+<div id="view-menu">
+  <button id="btn-relayout">重新布局</button>
+  <button id="btn-resetview">重置视角</button>
+  <button id="btn-style">视图设置（颜色/线型/主题）</button>
+  <button id="btn-inference">推理关系叠加</button>
+  <button id="btn-share-link" title="复制当前视图的URL链接，打开即恢复同一视图">复制视图链接</button>
+  <button id="btn-screenshot">截图（PNG）</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; }
   }
 
   /* ================= 实体图片 ================= */
@@ -258,19 +271,20 @@
   .log-filter input { flex: 1; }
 
   /* ================= 文件菜单（手机端） ================= */
-  #file-menu {
+  /* 文件菜单与视图菜单：同一套下拉样式，视图菜单锚点按钮在其左侧 */
+  #file-menu, #view-menu {
     position: fixed; top: 46px; right: 8px; z-index: 45; display: none;
     background: #101a30; border: 1px solid #2a3a5c; border-radius: 8px;
     box-shadow: 0 8px 24px rgba(0,0,0,.5); min-width: 172px; overflow: hidden;
   }
-  #file-menu.show { display: block; }
-  #file-menu button {
+  #file-menu.show, #view-menu.show { display: block; }
+  #file-menu button, #view-menu button {
     display: block; width: 100%; text-align: left; background: transparent;
     border: none; border-bottom: 1px solid #16213a; border-radius: 0;
     padding: 11px 14px; font-size: 13px; color: #cfe2ff; min-height: 42px;
   }
-  #file-menu button:last-child { border-bottom: none; }
-  #file-menu button:active { background: #1b2b4d; }
+  #file-menu button:last-child, #view-menu button:last-child { border-bottom: none; }
+  #file-menu button:active, #view-menu button:active { background: #1b2b4d; }
 
   /* ================= 平板/小屏桌面适配（769px-1100px） ================= */
   @media (min-width: 769px) and (max-width: 1100px) {
@@ -286,7 +300,6 @@
   /* ================= 手机端适配 ================= */
   @media (max-width: 768px) {
     .m-btn { display: inline-block; background: #16233f; }
-    #btn-inference { display: none; }
     /* 主题设置移动端可达：按钮保留，面板收窄为屏幕内浮层 */
     #style-panel { max-width: calc(100vw - 16px); width: 288px; top: 8px; right: 8px; }
 
@@ -299,7 +312,6 @@
     header::-webkit-scrollbar { display: none; }
     header h1 { display: none; }
     header button { padding: 5px 6px; font-size: 11px; flex-shrink: 0; min-width: 0; }
-    #btn-export { display: none; } /* 导出RDF移入文件菜单 */
     #stat-badge, #agent-badge { display: none; }
 
     /* 左右面板变为抽屉 */
@@ -491,9 +503,9 @@
   html[data-theme="light"] .log-filter select, html[data-theme="light"] .log-filter input {
     background: #ffffff; border-color: #c9d6ea; color: #22304c;
   }
-  html[data-theme="light"] #file-menu { background: #ffffff; border-color: #c9d6ea; box-shadow: 0 8px 24px rgba(30, 50, 80, 0.18); }
-  html[data-theme="light"] #file-menu button { color: #22304c; border-bottom-color: #edf2f9; }
-  html[data-theme="light"] #file-menu button:active { background: #eaf3ff; }
+  html[data-theme="light"] #file-menu, html[data-theme="light"] #view-menu { background: #ffffff; border-color: #c9d6ea; box-shadow: 0 8px 24px rgba(30, 50, 80, 0.18); }
+  html[data-theme="light"] #file-menu button, html[data-theme="light"] #view-menu button { color: #22304c; border-bottom-color: #edf2f9; }
+  html[data-theme="light"] #file-menu button:active, html[data-theme="light"] #view-menu button:active { background: #eaf3ff; }
   html[data-theme="light"] .m-btn { background: #eaf3ff; }
   html[data-theme="light"] #m-legend { background: rgba(255, 255, 255, 0.92); }
 

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,75 @@ 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('/demo/load', (req, res) => {
+  try {
+    const parsed = require('./lib/demo').demoData();
+    const sp = git.savepoint(`载入演示数据前自动备份`, '系统');
+    const r = db.applyTriplesImport(parsed, '手工');
+    r.entity_ids = undefined;
+    bus.emit('graph-changed', { via: 'demo' });
+    git.savepoint(`载入演示数据：实体+${r.entities_added} 关系+${r.relations_added}`, '系统');
+    res.json({ ok: true, backup: sp && sp.hash ? sp.hash : null, ...r, counts: db.counts(), version: db.getVersion() });
+  } catch (e) {
+    res.status(e.status || 500).json({ error: e.message });
+  }
+});
+
+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) => {
@@ -586,6 +658,22 @@ api.post('/git/restore', (req, res) => {
   res.json(r);
 });
 
+// ---------- 保存点 Diff（Archify Before/Delta/After 式对比） ----------
+api.get('/git/diff', (req, res) => {
+  const from = String(req.query.from || '').trim();
+  const to = String(req.query.to || '').trim();
+  if (!from || !to) return res.status(400).json({ error: '必须提供 from 与 to 两个保存点hash' });
+  if (from === to) return res.status(400).json({ error: '两个保存点相同，无差异可比' });
+  try {
+    const differ = require('./lib/diff');
+    const a = git.exportSnapshot(from);
+    const b = git.exportSnapshot(to);
+    res.json({ from, to, ...differ.diffSnapshots(a, b) });
+  } catch (e) {
+    res.status(e.status || 500).json({ error: e.message });
+  }
+});
+
 // ---------- MCP 外部接入设置 ----------
 api.get('/mcp/settings', (req, res) => {
   const s = embeddings.loadSettings();
@@ -650,19 +738,38 @@ api.post('/agent', async (req, res) => {
 
     let applied = [];
     let applyError = null;
-    if (result.ops && result.ops.length) {
-      try {
-        applied = db.applyAgentOps(result.ops);
-        // Agent批次写入后自动打保存点，与日志双向绑定
-        const title = `OpenCode: ${String(instruction).slice(0, 60).replace(/\n/g, ' ')}`;
-        let sp = null;
-        try { sp = git.savepoint(title, 'OpenCode'); } catch (e) { sp = { committed: false, message: e.message }; }
-        result.savepoint = sp;
-      } catch (e) {
-        applyError = e.message; // 违规操作被拦截，数据库保持上一个合规版本
+    let receipts = [];
+    let repair_rounds = 0;
+    let repaired = false;
+    let curOps = result.ops;
+    let curReply = result.reply;
+    if (curOps && curOps.length) {
+      // 修复回路：写入被回执拦截时，带结构化回执让AI修正，最多2轮（Archify式 repair receipt）
+      for (let round = 0; round <= 2; round++) {
+        try {
+          applied = db.applyAgentOps(curOps);
+          // Agent批次写入后自动打保存点，与日志双向绑定
+          const title = `OpenCode: ${String(instruction).slice(0, 60).replace(/\n/g, ' ')}`;
+          let sp = null;
+          try { sp = git.savepoint(title, 'OpenCode'); } catch (e) { sp = { committed: false, message: e.message }; }
+          result.savepoint = sp;
+          if (round > 0) repaired = true;
+          applyError = null;
+          receipts = [];
+          break;
+        } catch (e) {
+          applyError = e.message;
+          receipts = e.receipts || [];
+          if (round === 2 || !receipts.length) break;
+          const rep = await agent.runRepair(curOps, receipts);
+          repair_rounds++;
+          if (!rep.ok || !rep.ops || !rep.ops.length) { applyError += '（AI修复未返回有效操作）'; break; }
+          curOps = rep.ops;
+          curReply = rep.reply;
+        }
       }
     }
-    res.json({ reply: result.reply, ops_found: (result.ops || []).length, applied, apply_error: applyError, parse_error: result.parse_error, savepoint: result.savepoint || null, retried: result.retried || false, partial_reply: result.partial_reply || null, session: result.session ? { has_session: true } : null });
+    res.json({ reply: curReply, ops_found: (curOps || []).length, applied, apply_error: applyError, receipts, repair_rounds, repaired, parse_error: result.parse_error, savepoint: result.savepoint || null, retried: result.retried || false, partial_reply: result.partial_reply || null, session: result.session ? { has_session: true } : null });
   } finally { agentBusy = false; }
 });
 
@@ -814,16 +921,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 +975,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() {