dsh-memory-engine 0.6.1 → 0.7.0-beta.2b

package/lib/client.js

@@ -1,3 +1,4 @@
+// 由 scripts/build-client.mjs 生成，别直接改这个文件
 window.__ModuleLoader__.load({
   id: "dsh-memory-engine",
   factory: function (require) {
@@ -12,26 +13,565 @@ window.__ModuleLoader__.load({
     // 不同 DSH 版本暴露的插槽名不一样：新版本用 header.actions，
     // 老版本没有这个槽时退回 views.actions（会出现在「更多视图」菜单里，虽然不显眼但能用）。
     var SLOT_FALLBACKS = ["conversation.session.header.actions", "conversation.session.header.views.actions"];
-    var VIEW_URL = "http://127.0.0.1:18886/index.html";
 
-    function MemoryButton() {
+    function createRenderer(canvas, data, options = {}) {
+  const document = canvas.ownerDocument;
+  const window = document.defaultView;
+  const performance = window.performance;
+  const ctx = canvas.getContext('2d', { alpha: false });
+  if (!ctx) throw new Error('Canvas 2D 不可用');
+  const colors = { '人格':[255,215,106], '印象':[143,216,255], '知识':[126,231,178], '日记':[190,160,255], '对话':[255,160,140], '情绪':[255,90,90] };
+  const fallback = [145,205,255];
+  let nodes = [], links = [], hubs = [];
+  const byId = new Map(), adjacency = new Map(), sprites = new Map();
+  const pulses = [], firing = new Map(), selections = new Set();
+  if (typeof options.onSelect === 'function') selections.add(options.onSelect);
+  let seed = 987654321;
+  const random = () => ((seed = seed * 16807 % 2147483647) - 1) / 2147483646;
+  let width=0,height=0,dpr=1,rotX=0.3,rotY=0.15,zoom=data.nodes.length<50?1.6:1,autoSpin=true;
+  let drag=null,nextFire=0,lastTime=0,rafId=null,running=false,destroyed=false,generation=0,observer=null;
+
+function glowSprite(rgb) {
+  const off = document.createElement('canvas');
+  off.width = off.height = 96;
+  const brush = off.getContext('2d');
+  const gradient = brush.createRadialGradient(48,48,1,48,48,48);
+  gradient.addColorStop(0,'rgba('+rgb.join(',')+',0.7)');
+  gradient.addColorStop(0.4,'rgba('+rgb.join(',')+',0.19)');
+  gradient.addColorStop(1,'rgba('+rgb.join(',')+',0)');
+  brush.fillStyle = gradient; brush.fillRect(0,0,96,96);
+  return off;
+}
+
+  function setData(nextData) {
+    if (destroyed) return;
+    nodes = nextData.nodes.map(node => ({ ...node, pos: { ...node.pos } }));
+    links = nextData.links.map(link => [...link]);
+    byId.clear(); adjacency.clear(); sprites.clear(); pulses.length = 0; firing.clear();
+    seed = 987654321; nextFire = 0;
+    for (const node of nextData.nodes) byId.set(node.id, node);
+    for (const node of nodes) adjacency.set(node.id, []);
+    for (const [left,right] of links) {
+      if (adjacency.has(left) && adjacency.has(right)) { adjacency.get(left).push(right); adjacency.get(right).push(left); }
+    }
+    hubs = nodes.filter(star => star.degree > 0).sort((left,right) => right.degree-left.degree).slice(0,6);
+for (const star of nodes) {
+  star._rgb = colors[star.kind] || fallback;
+  const count = Math.min(9, 4 + Math.round(Math.sqrt(star.degree) * 1.2));
+  star._dendrites = Array.from({length:count},(_,index) => ({
+    angle:index/count*Math.PI*2+random()*0.7,
+    length:0.9+random()*1.5, bend:(random()-0.5)*0.9, width:0.5+random()*0.7,
+    fork:random()<0.55 ? (random()-0.5)*1.5 : null
+  }));
+}
+for (const star of nodes) {
+  const key = star._rgb.join(',');
+  if (!sprites.has(key)) sprites.set(key,glowSprite(star._rgb));
+  star._glow = sprites.get(key);
+}
+
+  }
+
+  function resize() {
+    if (destroyed) return;
+    const bounds = canvas.getBoundingClientRect();
+    width=bounds.width; height=bounds.height; dpr=Math.min(1.5,window.devicePixelRatio||1);
+    canvas.width=Math.round(width*dpr); canvas.height=Math.round(height*dpr);
+    ctx.setTransform(dpr,0,0,dpr,0,0);
+  }
+
+function project(pos) {
+  const cy=Math.cos(rotY),sy=Math.sin(rotY),cx=Math.cos(rotX),sx=Math.sin(rotX);
+  const x=pos.x*cy-pos.z*sy,z=pos.x*sy+pos.z*cy;
+  const y=pos.y*cx-z*sx,depth=pos.y*sx+z*cx+250;
+  if (depth<=12) return null;
+  const scale=760/depth*zoom;
+  return {x:width/2+x*scale,y:height/2+y*scale,scale,depth};
+}
+function fire(id,now) {
+  firing.set(id,1);
+  for (const other of adjacency.get(id)||[]) {
+    firing.set(other,Math.max(0.65,firing.get(other)||0));
+    pulses.push({from:id,to:other,born:now,life:900+Math.random()*700});
+  }
+}
+
+  function select(x,y) {
+  let best=null,bestScore=Infinity;
+  for (const star of nodes) {
+    if (!star._screen) continue;
+    const value=Math.hypot(star._screen.x-x,star._screen.y-y);
+    const tolerance=Math.max(14,star._screen.r*1.15);
+    if (value>tolerance) continue;
+    const score=value-star._screen.r*0.22;
+    if (score<bestScore) {bestScore=score;best=star;}
+  }
+  if (!best) return;
+  fire(best.id,performance.now());
+    for (const callback of selections) callback(byId.get(best.id));
+  }
+
+  function onPointerDown(event) {
+    autoSpin=false; drag={x:event.clientX,y:event.clientY,moved:0,pointerId:event.pointerId};
+    canvas.setPointerCapture(event.pointerId);
+  }
+  function onPointerMove(event) {
+    if (!drag) return;
+    const dx=event.clientX-drag.x,dy=event.clientY-drag.y;
+    drag.x=event.clientX; drag.y=event.clientY; drag.moved+=Math.abs(dx)+Math.abs(dy);
+    rotY+=dx*0.006; rotX=Math.max(-1.5,Math.min(1.5,rotX+dy*0.006));
+  }
+  function releaseDrag() {
+    if (drag && canvas.hasPointerCapture(drag.pointerId)) canvas.releasePointerCapture(drag.pointerId);
+    drag=null;
+  }
+  function onPointerUp(event) {
+    const clicked = drag && drag.moved<6;
+    releaseDrag();
+    if (clicked) {
+      const bounds = canvas.getBoundingClientRect();
+      select(event.clientX-bounds.left,event.clientY-bounds.top);
+    }
+  }
+  function onWheel(event) {
+    event.preventDefault();
+    zoom=Math.max(0.3,Math.min(4.5,zoom*(event.deltaY>0?0.92:1.08)));
+  }
+
+function frame(now) {
+  const delta=Math.min(50,now-lastTime||16.7); lastTime=now;
+  if (autoSpin) rotY+=0.0011*delta/16.7;
+  if (now>nextFire) { nextFire=now+1000+Math.random()*1500; if (hubs.length) fire(hubs[Math.floor(Math.random()*hubs.length)].id,now); }
+  ctx.globalCompositeOperation='source-over'; ctx.fillStyle='#03060c'; ctx.fillRect(0,0,width,height);
+  ctx.strokeStyle='rgba(40,90,140,0.055)';ctx.lineWidth=1;
+  for (let index=0;index<20;index++) {
+    const y=index/20*height;
+    ctx.beginPath();ctx.moveTo(0,y);ctx.bezierCurveTo(width*.3,y+Math.sin(now*.0003+index)*30,width*.7,y-Math.cos(now*.00025+index)*30,width,y);ctx.stroke();
+  }
+  const points=[];
+  for (const star of nodes) {
+    const p=project(star.pos);
+    if (!p || p.x< -100 || p.x>width+100 || p.y< -100 || p.y>height+100) {star._screen=null;continue;}
+    points.push({star,p});
+  }
+  points.sort((left,right)=>right.p.depth-left.p.depth);
+  const screen=new Map(points.map(point=>[point.star.id,point]));
+  ctx.globalCompositeOperation='lighter';
+  for (const [left,right] of links) {
+    const first=screen.get(left),second=screen.get(right);
+    if (!first||!second) continue;
+    const act=Math.max(firing.get(left)||0,firing.get(right)||0);
+    const alpha=Math.min(.85,.1*Math.min(first.star.retention,second.star.retention)+.35*act);
+    if (alpha<.01) continue;
+    const mx=(first.p.x+second.p.x)/2+(first.p.y-second.p.y)*.18;
+    const my=(first.p.y+second.p.y)/2+(second.p.x-first.p.x)*.18;
+    ctx.strokeStyle='rgba(110,190,255,'+alpha+')';ctx.lineWidth=.7+act*1.6;
+    ctx.beginPath();ctx.moveTo(first.p.x,first.p.y);ctx.quadraticCurveTo(mx,my,second.p.x,second.p.y);ctx.stroke();
+  }
+  for (let index=pulses.length-1;index>=0;index--) {
+    const pulse=pulses[index],fraction=(now-pulse.born)/pulse.life;
+    if (fraction>=1) {pulses.splice(index,1);continue;}
+    const first=screen.get(pulse.from),second=screen.get(pulse.to);
+    if (!first||!second) continue;
+    const mx=(first.p.x+second.p.x)/2+(first.p.y-second.p.y)*.18,my=(first.p.y+second.p.y)/2+(second.p.x-first.p.x)*.18;
+    const inverse=1-fraction;
+    const x=inverse*inverse*first.p.x+2*inverse*fraction*mx+fraction*fraction*second.p.x;
+    const y=inverse*inverse*first.p.y+2*inverse*fraction*my+fraction*fraction*second.p.y;
+    ctx.fillStyle='rgba(205,245,255,'+(.9*inverse)+')';ctx.beginPath();ctx.arc(x,y,2.5+2*inverse,0,Math.PI*2);ctx.fill();
+  }
+  for (const {star,p} of points) {
+    const act=firing.get(star.id)||0,ret=Math.max(.05,Math.min(1.2,star.retention));
+    const intensity=Math.min(1,.22+ret*.72)*(1+act*1.1);
+    const radius=Math.max(2,star.radius*p.scale*.55)*(1+Math.sin(now*.0016+(star.pos.x+star.pos.z)*.3)*.06)*(1+act*.5);
+    const rgb=star._rgb.join(',');
+    ctx.strokeStyle='rgba('+rgb+','+Math.min(1,.3*intensity)+')';
+    if (radius>2.5) for (const branch of star._dendrites) {
+      const length=radius*2.2*branch.length,dx=Math.cos(branch.angle),dy=Math.sin(branch.angle);
+      const ex=p.x+dx*length,ey=p.y+dy*length;
+      const cx=p.x+dx*length*.55-dy*length*branch.bend*.5;
+      const cy=p.y+dy*length*.55+dx*length*branch.bend*.5;
+      ctx.lineWidth=branch.width;ctx.beginPath();ctx.moveTo(p.x,p.y);ctx.quadraticCurveTo(cx,cy,ex,ey);ctx.stroke();
+      if (branch.fork!==null) {
+        const angle=branch.angle+branch.fork;
+        ctx.lineWidth=branch.width*.65;ctx.beginPath();ctx.moveTo(cx,cy);ctx.quadraticCurveTo(cx+Math.cos(angle)*length*.2,cy+Math.sin(angle)*length*.2,cx+Math.cos(angle)*length*.34,cy+Math.sin(angle)*length*.34);ctx.stroke();
+      }
+    }
+    const glowRadius=radius*3.6;
+    ctx.globalAlpha=Math.min(1,.4+intensity*.7);ctx.drawImage(star._glow,p.x-glowRadius,p.y-glowRadius,glowRadius*2,glowRadius*2);ctx.globalAlpha=1;
+    ctx.fillStyle='rgba('+rgb+','+Math.min(1,.42*intensity)+')';ctx.beginPath();ctx.arc(p.x,p.y,radius,0,Math.PI*2);ctx.fill();
+    ctx.strokeStyle='rgba('+rgb+','+Math.min(1,.75*intensity)+')';ctx.lineWidth=1;ctx.stroke();
+    ctx.fillStyle='rgba(255,255,255,'+Math.min(1,.6*intensity)+')';ctx.beginPath();ctx.arc(p.x,p.y,radius*.42,0,Math.PI*2);ctx.fill();
+    if (star.retention<.25) {
+      ctx.strokeStyle='rgba(255,110,110,'+Math.max(0,.45-star.retention)+')';ctx.setLineDash([3,4]);
+      ctx.beginPath();ctx.arc(p.x,p.y,radius*3.2,0,Math.PI*2);ctx.stroke();ctx.setLineDash([]);
+    }
+    star._screen={x:p.x,y:p.y,r:Math.max(8,radius*2.6)};
+  }
+  for (const [id,value] of firing) {
+    const next=value*Math.pow(.965,delta/16.7);
+    if (next<.02) firing.delete(id); else firing.set(id,next);
+  }
+  ctx.globalCompositeOperation='source-over';
+  const vignette=ctx.createRadialGradient(width/2,height/2,Math.min(width,height)*.34,width/2,height/2,Math.max(width,height)*.8);
+  vignette.addColorStop(0,'rgba(0,0,0,0)');vignette.addColorStop(1,'rgba(0,0,0,.78)');
+  ctx.fillStyle=vignette;ctx.fillRect(0,0,width,height);
+}
+  function start() {
+    if (running || destroyed) return;
+    running=true; lastTime=0; nextFire=0;
+    const currentGeneration = ++generation;
+    canvas.addEventListener('pointerdown',onPointerDown);
+    canvas.addEventListener('pointermove',onPointerMove);
+    canvas.addEventListener('pointerup',onPointerUp);
+    canvas.addEventListener('pointercancel',releaseDrag);
+    canvas.addEventListener('wheel',onWheel,{passive:false});
+    window.addEventListener('resize',resize);
+    if (window.ResizeObserver) {
+      observer = new window.ResizeObserver(resize);
+      observer.observe(canvas);
+    }
+    resize();
+    function tick(now) {
+      if (!running || destroyed || currentGeneration !== generation) return;
+      rafId=null;
+      frame(now);
+      if (running && !destroyed && currentGeneration === generation) rafId=window.requestAnimationFrame(tick);
+    }
+    rafId=window.requestAnimationFrame(tick);
+  }
+
+  function stop() {
+    running=false; generation++;
+    if (rafId !== null) window.cancelAnimationFrame(rafId);
+    rafId=null;
+    observer?.disconnect(); observer=null;
+    canvas.removeEventListener('pointerdown',onPointerDown);
+    canvas.removeEventListener('pointermove',onPointerMove);
+    canvas.removeEventListener('pointerup',onPointerUp);
+    canvas.removeEventListener('pointercancel',releaseDrag);
+    canvas.removeEventListener('wheel',onWheel);
+    window.removeEventListener('resize',resize);
+    releaseDrag();
+    pulses.length=0; firing.clear(); lastTime=0; nextFire=0;
+  }
+
+  function destroy() {
+    if (destroyed) return;
+    stop(); destroyed=true;
+    selections.clear(); byId.clear(); adjacency.clear(); sprites.clear();
+    nodes=[]; links=[]; hubs=[];
+  }
+
+  setData(data);
+  return {
+    start, stop, resize, setData, destroy,
+    fireNeuron(id) { if (!destroyed && byId.has(id)) fire(id,performance.now()); },
+    onSelect(callback) {
+      if (!destroyed) selections.add(callback);
+      return () => selections.delete(callback);
+    },
+  };
+}
+
+
+
+    var defaultSettings = { hideButton: false, showGuideOnEmpty: true };
+    var actionStyle = { padding: "7px 12px", borderRadius: "8px", border: "1px solid #6999b8", background: "#102236", color: "#e2f4ff", font: "inherit", cursor: "pointer" };
+
+    function readApi(url, signal) {
+      return fetch(url, { cache: "no-store", signal: signal }).then(function (response) {
+        if (!response.ok) throw new Error("HTTP " + response.status);
+        return response.json();
+      }).then(function (result) {
+        if (!result || result.ok !== true || !result.data || typeof result.data !== "object") throw new Error("接口返回格式无效");
+        return result.data;
+      });
+    }
+
+    function loadSettings() {
+      var controller = new AbortController();
+      var timer = setTimeout(function () { controller.abort(); }, 5000);
+      return Promise.resolve().then(function () {
+        return readApi("/memory-engine/api/config", controller.signal);
+      }).then(function (settings) {
+        if (typeof settings.hideButton !== "boolean" || typeof settings.showGuideOnEmpty !== "boolean") throw new Error("按钮配置格式无效");
+        return settings;
+      }).finally(function () { clearTimeout(timer); });
+    }
+
+    function copyText(text) {
+      function fallback() {
+        var area = document.createElement("textarea");
+        var active = document.activeElement;
+        area.value = text;
+        area.style.cssText = "position:fixed;left:-9999px;top:0";
+        document.body.appendChild(area);
+        area.select();
+        try {
+          if (!document.execCommand("copy")) throw new Error("复制失败");
+        } finally {
+          area.remove();
+          if (active && typeof active.focus === "function") active.focus();
+        }
+      }
+      return Promise.resolve().then(function () {
+        if (navigator.clipboard && navigator.clipboard.writeText) return navigator.clipboard.writeText(text);
+        return fallback();
+      }).catch(function () { return fallback(); });
+    }
+
+    function GuideCard(props) {
+      var copiedState = React.useState("复制这段提示词");
+      var copyLabel = copiedState[0];
+      var setCopyLabel = copiedState[1];
+      var card = React.useRef(null);
+      React.useEffect(function () { if (card.current) card.current.focus(); }, []);
+      function trapTab(event) {
+        if (event.key !== "Tab" || !card.current) return;
+        var buttons = Array.from(card.current.querySelectorAll("button"));
+        var position = buttons.indexOf(document.activeElement);
+        if (event.shiftKey && position <= 0) { event.preventDefault(); buttons[buttons.length - 1].focus(); }
+        else if (!event.shiftKey && (position === -1 || position === buttons.length - 1)) { event.preventDefault(); buttons[0].focus(); }
+      }
+      var data = props.data;
+      return React.createElement("div", {
+        "data-memory-engine-guide-layer": "true",
+        style: { position: "absolute", inset: 0, zIndex: 2, display: "grid", placeItems: "center", padding: "16px", background: "rgba(3,6,12,.7)" },
+      }, React.createElement("section", {
+        ref: card, role: "dialog", "aria-modal": "true", "aria-label": "使用指南", tabIndex: -1,
+        "data-memory-engine-guide": "true", onKeyDown: trapTab,
+        style: { boxSizing: "border-box", width: "min(620px,100%)", maxHeight: "calc(100vh - 32px)", overflow: "auto", padding: "24px", border: "1px solid #3976a0", borderRadius: "16px", background: "#07111f", color: "#dbeaf8", font: "14px/1.65 system-ui,sans-serif", boxShadow: "0 16px 80px #0008" },
+      }, React.createElement("h2", { style: { margin: "0 0 16px", fontSize: "22px", color: "#b7e9ff" } }, "怎么用"),
+      props.error ? React.createElement("div", { role: "alert" },
+        React.createElement("p", null, "引导加载失败，请重试。"),
+        React.createElement("button", { type: "button", onClick: props.onRetry, style: actionStyle }, "重试"))
+        : !data ? React.createElement("p", { role: "status" }, "正在加载使用指南……")
+        : React.createElement(React.Fragment, null,
+          data.empty ? React.createElement("p", { style: { color: "#9fb7ce" } }, "还没有记忆，从下面任一步开始。") : null,
+          data.steps.map(function (step, index) {
+            return React.createElement("div", { key: index, style: { borderLeft: "3px solid #28577e", paddingLeft: "14px", marginBottom: "18px" } },
+              React.createElement("h3", { style: { fontSize: "15px", color: "#9fd0f5", margin: "0 0 6px" } }, "第 " + (index + 1) + " 步  " + step.title),
+              React.createElement("p", { style: { margin: "0 0 8px" } }, step.body),
+              index === 0 ? React.createElement(React.Fragment, null,
+                React.createElement("pre", { style: { whiteSpace: "pre-wrap", overflowWrap: "anywhere", maxHeight: "180px", overflow: "auto", margin: "8px 0", padding: "12px", background: "#030a13", borderRadius: "8px", font: "12px/1.6 ui-monospace,Consolas,monospace" } }, data.prompt),
+                React.createElement("button", { type: "button", "data-memory-engine-copy": "true", style: actionStyle,
+                  onClick: function () { copyText(data.prompt).then(function () { setCopyLabel("已复制 ✓"); }, function () { setCopyLabel("复制失败，请手动复制"); }); },
+                }, copyLabel)) : null,
+              index === 2 ? React.createElement("button", { type: "button", onClick: props.onRefresh, style: actionStyle }, "刷新图谱") : null);
+          }),
+          React.createElement("p", { style: { fontSize: "12px", color: "#9fb7ce", overflowWrap: "anywhere" } }, "数据目录：", data.dataDir)),
+      React.createElement("div", { style: { display: "flex", justifyContent: "flex-end", marginTop: "16px" } },
+        React.createElement("button", { type: "button", onClick: props.onClose, style: actionStyle }, "知道了"))));
+    }
+
+    function MemoryDetails(props) {
+      var node = props.node;
+      var text = typeof node.text === "string" ? node.text : "";
+      var title = String(node.title || "").trim() || Array.from(text).slice(0, 20).join("");
+      var date = new Date(node.ts);
+      var day = Number.isFinite(date.getTime()) ? date.getFullYear() + "-" + String(date.getMonth() + 1).padStart(2, "0") + "-" + String(date.getDate()).padStart(2, "0") : "未知";
+      var heat = { 1: "热", 2: "温", 3: "冷" }[node.heat];
+      var rows = [
+        ["重要度", heat ? heat + "（" + node.heat + "）" : "未知"],
+        ["留存", Number.isFinite(node.retention) ? node.retention.toFixed(2) : "—"],
+        ["连接数", node.degree == null ? 0 : node.degree],
+        ["时间", day],
+      ];
+      var emotion = Array.isArray(node.emotion) ? node.emotion.filter(function (item) { return item && item.tag; }).map(function (item) { return item.tag; }).join(" / ") : "";
+      if (emotion) rows.push(["情绪", emotion]);
+      var copiedState = React.useState("复制正文");
+      var copyLabel = copiedState[0];
+      var setCopyLabel = copiedState[1];
+      var timer = React.useRef(null);
+      var copyVersion = React.useRef(0);
+      var body = React.useRef(null);
+      React.useEffect(function () {
+        copyVersion.current++;
+        clearTimeout(timer.current);
+        timer.current = null;
+        setCopyLabel("复制正文");
+        if (body.current) body.current.scrollTop = 0;
+        return function () { copyVersion.current++; clearTimeout(timer.current); timer.current = null; };
+      }, [node.id, text]);
+      function copyBody() {
+        var version = ++copyVersion.current;
+        clearTimeout(timer.current);
+        copyText(text).then(function () {
+          if (version !== copyVersion.current) return;
+          setCopyLabel("已复制 ✓");
+          timer.current = setTimeout(function () {
+            if (version === copyVersion.current) setCopyLabel("复制正文");
+            timer.current = null;
+          }, 1800);
+        }, function () {
+          if (version === copyVersion.current) setCopyLabel("复制失败，请重试");
+        });
+      }
+      return React.createElement("section", {
+        role: "region", "aria-label": "记忆详情", "data-memory-engine-detail": "true", "data-memory-engine-node": node.id,
+        style: { position: "absolute", top: "72px", right: "18px", zIndex: 1, width: "min(350px,calc(100% - 36px))", maxHeight: "calc(100% - 96px)", boxSizing: "border-box", display: "flex", flexDirection: "column", overflow: "hidden", padding: "18px", border: "1px solid #3976a0", borderRadius: "14px", background: "#07111fee", color: "#dbeaf8", font: "14px/1.6 system-ui,sans-serif", boxShadow: "0 0 40px #1763a033", backdropFilter: "blur(8px)", animation: "dsh-memory-detail-in 180ms ease-out" },
+      }, React.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: "12px", flexShrink: 0 } },
+        React.createElement("span", { "data-memory-engine-detail-kind": "true", style: { color: "#a4e6ff", background: "#15344b", borderRadius: "6px", padding: "2px 8px", overflowWrap: "anywhere" } }, node.kind || "未分类"),
+        React.createElement("button", { type: "button", "aria-label": "关闭记忆详情", onClick: props.onClose, style: { border: 0, padding: "2px 6px", background: "transparent", color: "#a4bad0", fontSize: "22px", cursor: "pointer" } }, "×")),
+      React.createElement("h2", { "data-memory-engine-detail-title": "true", style: { margin: "10px 0", fontSize: "18px", color: "#b7e9ff", overflowWrap: "anywhere", whiteSpace: "normal", maxHeight: "18vh", overflowY: "auto", flexShrink: 0 } }, title),
+      React.createElement("dl", { style: { display: "grid", gridTemplateColumns: "64px minmax(0,1fr)", gap: "5px 10px", margin: "0 0 12px", fontSize: "12px", color: "#9fb7ce", maxHeight: "25vh", overflowY: "auto", flexShrink: 0 } },
+        rows.map(function (row) { return React.createElement(React.Fragment, { key: row[0] },
+          React.createElement("dt", { style: { margin: 0 } }, row[0]),
+          React.createElement("dd", { style: { margin: 0, overflowWrap: "anywhere" } }, row[1])); })),
+      React.createElement("div", { ref: body, "data-memory-engine-detail-text": "true", style: { minHeight: 0, flex: "1 1 auto", overflowY: "auto", whiteSpace: "pre-wrap", overflowWrap: "anywhere", borderTop: "1px solid #3976a055", borderBottom: "1px solid #3976a055", padding: "12px 0" } }, text),
+      React.createElement("div", { style: { display: "flex", flexWrap: "wrap", gap: "8px", marginTop: "12px", flexShrink: 0 } },
+        React.createElement("button", { type: "button", "data-memory-engine-highlight": "true", style: actionStyle, onClick: props.onHighlight }, "在图里高亮它"),
+        React.createElement("button", { type: "button", "data-memory-engine-copy-body": "true", style: actionStyle, onClick: copyBody }, copyLabel)));
+    }
+
+    function MemoryCanvas(props) {
+      var canvas = React.useRef(null);
+      var dataState = React.useState(null);
+      var data = dataState[0];
+      var setData = dataState[1];
+      var errorState = React.useState("");
+      var error = errorState[0];
+      var setError = errorState[1];
+      var retryState = React.useState(0);
+      var retry = retryState[0];
+      var setRetry = retryState[1];
+      React.useEffect(function () {
+        var controller = new AbortController();
+        var active = true;
+        var renderer;
+        setError("");
+        readApi("/memory-engine/api/map", controller.signal).then(function (nextData) {
+          if (!active) return;
+          renderer = createRenderer(canvas.current, nextData);
+          props.rendererRef.current = renderer;
+          renderer.onSelect(function (node) { props.selectionVersion.current++; props.onSelect(node); });
+          renderer.start();
+          setData(nextData);
+        }).catch(function (failure) {
+          if (!active) return;
+          if (renderer) renderer.destroy();
+          if (props.rendererRef.current === renderer) props.rendererRef.current = null;
+          console.error("[dsh-memory-engine] Canvas 图谱加载失败：", failure);
+          setError(failure.message);
+        });
+        return function () {
+          active = false;
+          controller.abort();
+          if (renderer) renderer.destroy();
+          if (props.rendererRef.current === renderer) props.rendererRef.current = null;
+        };
+      }, [retry, props.rendererRef, props.selectionVersion, props.onSelect]);
+      return React.createElement(React.Fragment, null,
+        React.createElement("canvas", {
+          ref: canvas, "data-memory-engine-canvas": "true", "aria-label": "记忆神经网络",
+          style: { display: "block", width: "100%", height: "100%", touchAction: "none", cursor: "grab" },
+        }),
+        React.createElement("div", {
+          "data-memory-engine-summary": "true",
+          style: { position: "absolute", top: "16px", left: "18px", pointerEvents: "none", color: "#d8e9f8", font: "13px/1.65 system-ui,sans-serif", textShadow: "0 0 12px #3388bb88" },
+        }, React.createElement("strong", { style: { color: "#a4e6ff", fontSize: "16px" } }, "记忆神经网络"),
+        React.createElement("div", null, data ? data.nodes.length + " 个神经元 · " + data.links.length + " 条突触" : "正在加载图谱……"),
+        React.createElement("div", { style: { color: "#7491a8", fontSize: "12px" } }, "大小＝重要度和连接数 · 亮度＝留存")),
+        data ? React.createElement("section", {
+          "aria-label": "复习清单",
+          style: { position: "absolute", bottom: "16px", left: "18px", width: "min(400px,calc(100% - 36px))", boxSizing: "border-box", maxHeight: "32%", overflow: "auto", padding: "15px", background: "#07111fee", border: "1px solid #3976a055", borderRadius: "14px", boxShadow: "0 0 40px #1763a033", backdropFilter: "blur(8px)", font: "12px/1.65 system-ui,sans-serif", color: "#b1c6d9" },
+        }, React.createElement("h2", { style: { fontSize: "14px", color: "#ffdb82", margin: "0 0 8px" } }, "复习清单 · 留存最低的记忆"),
+        data.review.map(function (item, index) {
+          return React.createElement("div", { key: item.id || index, style: { display: "flex", gap: "7px", alignItems: "center", margin: "5px 0" } },
+            React.createElement("span", { style: { flex: 1, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, (index + 1) + ". [" + item.kind + "] " + item.title),
+            React.createElement("span", { style: { width: "52px", height: "5px", borderRadius: "5px", background: "#335066", overflow: "hidden" } },
+              React.createElement("i", { style: { display: "block", height: "100%", background: "#6bc9fa", width: Math.min(100, Math.max(0, item.retention * 100)) + "%" } })));
+        })) : null,
+        React.createElement("div", { style: { position: "absolute", right: "18px", bottom: "18px", pointerEvents: "none", color: "#7b99ad", font: "13px system-ui,sans-serif" } }, "拖拽旋转 · 滚轮缩放 · 点击选中神经元"),
+        error ? React.createElement("div", { role: "alert", style: { position: "absolute", inset: "40% 20% auto", textAlign: "center", color: "#d8e9f8" } },
+          React.createElement("p", null, "图谱加载失败：" + error),
+          React.createElement("button", { type: "button", style: actionStyle, onClick: function () { setRetry(function (value) { return value + 1; }); } }, "重试")) : null);
+    }
+
+    function MemoryButton(props) {
+      var settings = props.settings;
       var state = React.useState(false);
       var open = state[0];
       var setOpen = state[1];
-      var frame = React.useRef(null);
+      var guideState = React.useState(false);
+      var guideOpen = guideState[0];
+      var setGuideOpen = guideState[1];
+      var dataState = React.useState(null);
+      var guideData = dataState[0];
+      var setGuideData = dataState[1];
+      var errorState = React.useState("");
+      var guideError = errorState[0];
+      var setGuideError = errorState[1];
+      var retryState = React.useState(0);
+      var retry = retryState[0];
+      var setRetry = retryState[1];
+      var selectedState = React.useState(null);
+      var selected = selectedState[0];
+      var setSelected = selectedState[1];
+      var renderer = React.useRef(null);
+      var selectionVersion = React.useRef(0);
+      var pointer = React.useRef(null);
+      var help = React.useRef(null);
+      var dismissed = React.useRef(false);
+      function closeGuide() {
+        dismissed.current = true;
+        setGuideOpen(false);
+        if (help.current) help.current.focus();
+      }
+      function openMap() {
+        dismissed.current = false;
+        setGuideOpen(false);
+        setSelected(null);
+        setOpen(Date.now());
+      }
+      function closeMap() { setSelected(null); setOpen(false); }
+      function startPointer(event) {
+        if (event.target.closest("[data-memory-engine-detail], [data-memory-engine-guide-layer], [data-memory-engine-controls]")) { pointer.current = null; return; }
+        pointer.current = { x: event.clientX, y: event.clientY, moved: 0, version: selectionVersion.current };
+      }
+      function movePointer(event) {
+        if (!pointer.current) return;
+        pointer.current.moved += Math.abs(event.clientX - pointer.current.x) + Math.abs(event.clientY - pointer.current.y);
+        pointer.current.x = event.clientX; pointer.current.y = event.clientY;
+      }
+      function dismissOutside() {
+        var gesture = pointer.current;
+        pointer.current = null;
+        if (gesture && gesture.moved < 6 && gesture.version === selectionVersion.current) setSelected(null);
+      }
       React.useEffect(function () {
         if (!open) return undefined;
-        function onKey(event) { if (event.key === "Escape") setOpen(false); }
-        function onMessage(event) {
-          if (event.source === (frame.current && frame.current.contentWindow) && event.data && event.data.type === "dsh-memory-engine-close") setOpen(false);
+        var controller = new AbortController();
+        var active = true;
+        setGuideData(null);
+        setGuideError("");
+        readApi("/memory-engine/api/onboard", controller.signal).then(function (data) {
+          if (typeof data.empty !== "boolean" || typeof data.prompt !== "string" || typeof data.dataDir !== "string"
+              || !Array.isArray(data.steps) || data.steps.length !== 3
+              || data.steps.some(function (step) { return !step || typeof step.title !== "string" || typeof step.body !== "string"; })) throw new Error("引导数据格式无效");
+          if (!active) return;
+          setGuideData(data);
+          if (data.empty && settings.showGuideOnEmpty && !dismissed.current) setGuideOpen(true);
+        }).catch(function (error) {
+          if (active) setGuideError(error.message);
+        });
+        return function () { active = false; controller.abort(); };
+      }, [open, retry, settings.showGuideOnEmpty]);
+      React.useEffect(function () {
+        if (!open) return undefined;
+        function onEscape() { if (guideOpen) closeGuide(); else if (selected) setSelected(null); else closeMap(); }
+        function onKey(event) {
+          if (event.key !== "Escape") return;
+          event.preventDefault();
+          event.stopPropagation();
+          if (!event.repeat) onEscape();
         }
-        window.addEventListener("keydown", onKey);
-        window.addEventListener("message", onMessage);
-        return function () { window.removeEventListener("keydown", onKey); window.removeEventListener("message", onMessage); };
-      }, [open]);
+        window.addEventListener("keydown", onKey, true);
+        return function () { window.removeEventListener("keydown", onKey, true); };
+      }, [open, guideOpen, selected]);
       var button = React.createElement("button", {
         type: "button",
-        onClick: function () { setOpen(Date.now()); },
+        onClick: openMap,
         "data-memory-engine-map": "true",
         "aria-label": "打开记忆图谱",
         title: "记忆图谱",
@@ -42,24 +582,33 @@ window.__ModuleLoader__.load({
         role: "dialog",
         "aria-modal": "true",
         "aria-label": "记忆图谱",
-        style: { position: "fixed", inset: 0, zIndex: 9999, background: "#03060c" },
-      }, React.createElement("iframe", {
-        src: VIEW_URL + "?v=" + open,
-        ref: frame,
-        title: "记忆神经网络",
-        sandbox: "allow-scripts",
-        referrerPolicy: "no-referrer",
-        style: { display: "block", width: "100%", height: "100%", border: 0 },
-      }), React.createElement("button", {
+        onPointerDownCapture: startPointer, onPointerMoveCapture: movePointer,
+        onPointerCancelCapture: function () { pointer.current = null; }, onClick: dismissOutside,
+        style: { position: "fixed", inset: 0, maxWidth: "none", maxHeight: "none", zIndex: 9999, background: "#03060c" },
+      }, React.createElement(MemoryCanvas, { key: open, rendererRef: renderer, selectionVersion: selectionVersion, onSelect: setSelected }),
+      React.createElement("style", null, "@keyframes dsh-memory-detail-in{from{opacity:0;transform:translateX(24px)}to{opacity:1;transform:translateX(0)}}@media(prefers-reduced-motion:reduce){[data-memory-engine-detail]{animation:none!important}}"),
+      React.createElement("div", {
+        "data-memory-engine-controls": "true",
+        style: { position: "absolute", top: "16px", right: "18px", zIndex: 1, display: "flex", gap: "8px" },
+      }, React.createElement("button", {
+        ref: help, type: "button", onClick: function () { setGuideOpen(true); },
+        "aria-label": "查看使用指南", title: "使用指南", style: actionStyle,
+      }, "?"), React.createElement("button", {
         type: "button",
-        onClick: function () { setOpen(false); },
+        onClick: closeMap,
         "aria-label": "关闭记忆图谱",
-        style: { position: "absolute", top: "16px", right: "18px", zIndex: 1, padding: "7px 12px", borderRadius: "8px", border: "1px solid #6999b8", background: "#102236", color: "#e2f4ff", font: "inherit", cursor: "pointer" },
-      }, "关闭 ×"));
+        style: actionStyle,
+      }, "关闭 ×")), selected ? React.createElement(MemoryDetails, {
+        node: selected, onClose: function () { setSelected(null); },
+        onHighlight: function () { if (renderer.current) renderer.current.fireNeuron(selected.id); },
+      }) : null, guideOpen ? React.createElement(GuideCard, {
+        data: guideData, error: guideError, onClose: closeGuide, onRefresh: openMap,
+        onRetry: function () { setRetry(function (value) { return value + 1; }); },
+      }) : null);
       return React.createElement(React.Fragment, null, button, ReactDOM.createPortal(overlay, document.body));
     }
 
-    function registerOn(slots, name) {
+    function registerOn(slots, name, settings) {
       var disposable = null;
       slots.inject(name, function () {
         try {
@@ -68,7 +617,7 @@ window.__ModuleLoader__.load({
             id: "memory-engine-map",
             order: 50,
             label: function () { return "记忆图谱"; },
-          }, MemoryButton);
+          }, function ConfiguredMemoryButton() { return React.createElement(MemoryButton, { settings: settings }); });
         } catch (error) {
           try { console.error("[dsh-memory-engine] 注册到 " + name + " 失败：", error); } catch (ignored) {}
         }
@@ -87,7 +636,15 @@ window.__ModuleLoader__.load({
         var target = ctx.slots && typeof ctx.slots.has === "function" && !ctx.slots.has(SLOT_FALLBACKS[0])
           ? SLOT_FALLBACKS[1]
           : SLOT_NAME;
-        registerOn(ctx.slots, target);
+        function mount(settings) {
+          if (!settings.hideButton) registerOn(ctx.slots, target, settings);
+        }
+        function fallback(error) {
+          try { console.warn("[dsh-memory-engine] 配置读取失败，按默认显示按钮：", error); } catch (ignored) {}
+          mount(defaultSettings);
+        }
+        try { loadSettings().then(mount, fallback); }
+        catch (error) { fallback(error); }
       } catch (error) {
         try { console.error("[dsh-memory-engine] 插槽注册失败：", error); } catch (ignored) {}
       }