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

package/lib/render/canvas.js

@@ -0,0 +1,259 @@
+export 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);
+    },
+  };
+}
+

package/lib/render/render.mjs

@@ -1,3 +1,8 @@
+import fs from 'node:fs';
+import { stripRendererExport } from '../../scripts/lib/strip-export.mjs';
+
+const rendererSource = stripRendererExport(fs.readFileSync(new URL('./canvas.js', import.meta.url), 'utf8'));
+
 function escapeHtml(value) {
   return String(value).replace(/[&<>"']/g, (character) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[character]);
 }
@@ -14,7 +19,7 @@ export function renderHtml(data, title = '记忆神经网络') {
 <style>
   :root{color-scheme:dark}*{box-sizing:border-box}html,body{margin:0;width:100%;height:100%}
   body{overflow:hidden;background:#03060c;color:#d8e9f8;font:13px/1.65 system-ui,"Microsoft YaHei",sans-serif}
-  canvas{display:block;touch-action:none;cursor:grab}canvas:active{cursor:grabbing}
+  canvas{display:block;width:100%;height:100%;touch-action:none;cursor:grab}canvas:active{cursor:grabbing}
   .hud{position:fixed;top:16px;left:18px;pointer-events:none;text-shadow:0 0 12px #3388bb88}
   .hud strong{color:#a4e6ff;font-size:16px}.sub{color:#7491a8;font-size:12px}
   .panel,.review{position:fixed;background:#07111fee;border:1px solid #3976a055;border-radius:14px;box-shadow:0 0 40px #1763a033;padding:15px;backdrop-filter:blur(8px)}
@@ -37,64 +42,8 @@ export function renderHtml(data, title = '记忆神经网络') {
 <script>
 const DATA = ${embedded};
 const canvas = document.getElementById('map');
-const ctx = canvas.getContext('2d', { alpha: false });
-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];
-const byId = new Map(DATA.stars.map(star => [star.id, star]));
-const adjacency = new Map(DATA.stars.map(star => [star.id, []]));
-for (const [left,right] of DATA.links) {
-  if (adjacency.has(left) && adjacency.has(right)) { adjacency.get(left).push(right); adjacency.get(right).push(left); }
-}
-const hubs = DATA.stars.filter(star => star.degree > 0).sort((left,right) => right.degree-left.degree).slice(0,6);
-const pulses = [];
-const firing = new Map();
-let seed = 987654321;
-const random = () => ((seed = seed * 16807 % 2147483647) - 1) / 2147483646;
-for (const star of DATA.stars) {
-  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
-  }));
-}
-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;
-}
-const sprites = new Map();
-for (const star of DATA.stars) {
-  const key = star._rgb.join(',');
-  if (!sprites.has(key)) sprites.set(key,glowSprite(star._rgb));
-  star._glow = sprites.get(key);
-}
-let width=0,height=0,dpr=1,rotX=0.3,rotY=0.15,zoom=DATA.stars.length<50?1.6:1,autoSpin=true;
-function resize() {
-  width=innerWidth; height=innerHeight; dpr=Math.min(1.5,devicePixelRatio||1);
-  canvas.width=Math.round(width*dpr); canvas.height=Math.round(height*dpr);
-  canvas.style.width=width+'px'; canvas.style.height=height+'px';
-  ctx.setTransform(dpr,0,0,dpr,0,0);
-}
-addEventListener('resize',resize); resize();
-let drag=null;
-canvas.addEventListener('pointerdown',event => { autoSpin=false; drag={x:event.clientX,y:event.clientY,moved:0}; canvas.setPointerCapture(event.pointerId); });
-canvas.addEventListener('pointermove',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));
-});
-canvas.addEventListener('pointerup',event => { if (drag && drag.moved<6) select(event.clientX,event.clientY); drag=null; });
-canvas.addEventListener('pointercancel',() => { drag=null; });
-canvas.addEventListener('wheel',event => { event.preventDefault(); zoom=Math.max(0.3,Math.min(4.5,zoom*(event.deltaY>0?0.92:1.08))); },{passive:false});
+${rendererSource}
+const renderer = createRenderer(canvas, { ...DATA, nodes: DATA.stars });
 document.getElementById('close').onclick=() => { document.getElementById('panel').style.display='none'; };
 document.getElementById('total').textContent=DATA.stats.total;
 document.getElementById('linkCount').textContent=DATA.links.length;
@@ -105,123 +54,14 @@ for (const [index,item] of DATA.review.entries()) {
   const fill=document.createElement('i'); fill.style.width=Math.min(100,Math.max(0,item.retention*100))+'%'; bar.append(fill);
   row.append(name,bar); document.getElementById('reviewList').append(row);
 }
-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 DATA.stars) {
-    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());
+renderer.onSelect(node => {
   document.getElementById('panel').style.display='block';
-  document.getElementById('kind').textContent=best.kind;
-  document.getElementById('title').textContent=best.title;
-  document.getElementById('meta').textContent='重要度 '+best.heat+' · 留存 '+best.retention.toFixed(2)+' · 连接数 '+best.degree+(best.emotion.length?' · '+best.emotion.map(item=>item.tag).join('/'):'');
-  document.getElementById('body').textContent=best.text;
-}
-let nextFire=0,lastTime=0;
-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 DATA.stars) {
-    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 DATA.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);
-  requestAnimationFrame(frame);
-}
-requestAnimationFrame(frame);
+  document.getElementById('kind').textContent=node.kind;
+  document.getElementById('title').textContent=node.title;
+  document.getElementById('meta').textContent='重要度 '+node.heat+' · 留存 '+node.retention.toFixed(2)+' · 连接数 '+node.degree+(node.emotion.length?' · '+node.emotion.map(item=>item.tag).join('/'):'');
+  document.getElementById('body').textContent=node.text;
+});
+renderer.start();
 </script>
 </body>
 </html>`;

package/lib/routes.js

@@ -0,0 +1,56 @@
+import path from 'node:path';
+import { computeMapData } from './map.js';
+import { renderHtml } from './render/render.mjs';
+import { ONBOARD_PROMPT, ONBOARD_STEPS } from './onboard.js';
+import { readUiConfig } from './config.js';
+
+const base = '/memory-engine';
+const paths = new Set([base, `${base}/`, `${base}/api/map`, `${base}/api/stats`, `${base}/api/onboard`, `${base}/api/config`]);
+const allowedMethods = new Set(['GET', 'POST', 'PUT', 'DELETE']);
+const escapeBridge = '<script>window.addEventListener("keydown",function(event){if(event.key==="Escape")parent.postMessage({type:"dsh-memory-engine-close"},"*")});</script>';
+
+export function createMemoryHandler({ store, warn = () => {} }) {
+  return async (request, response) => {
+    const reply = (status, payload, html = false) => {
+      response.writeHead(status, {
+        'Content-Type': html ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8',
+        'Cache-Control': 'no-store',
+        'X-Content-Type-Options': 'nosniff',
+        'Referrer-Policy': 'no-referrer',
+        ...(status === 405 ? { Allow: 'GET' } : {}),
+        ...(html ? { 'Content-Security-Policy': "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data:; base-uri 'none'; form-action 'none'; frame-ancestors 'self'" } : {}),
+      });
+      response.end(html ? payload : JSON.stringify(payload));
+    };
+    const fail = (status, error) => reply(status, { ok: false, error });
+    try {
+      const host = String(request.headers.host ?? '');
+      if (!/^(?:127\.0\.0\.1|localhost)(?::\d+)?$/.test(host)) return fail(403, '只允许本机访问记忆图谱');
+      const rawPath = (request.url ?? '/').split('?')[0];
+      let pathname;
+      try { pathname = decodeURIComponent(rawPath); }
+      catch { return fail(404, '找不到这个记忆接口'); }
+      if (pathname.includes('..') || pathname.includes('\\') || !paths.has(pathname)) return fail(404, '找不到这个记忆接口');
+      if (!allowedMethods.has(request.method) || request.method !== 'GET') return fail(405, '此接口仅支持 GET');
+      if (Number(request.headers['content-length']) > 1024 * 1024) return fail(413, '请求体不能超过 1MB');
+      if (request.headers['transfer-encoding'] || Number(request.headers['content-length']) > 0) return fail(400, '此只读接口不接受请求体');
+      if (pathname === `${base}/api/map`) return reply(200, { ok: true, data: computeMapData(store) });
+      if (pathname === `${base}/api/stats`) return reply(200, { ok: true, data: store.stats() });
+      if (pathname === `${base}/api/config`) return reply(200, { ok: true, data: readUiConfig(path.dirname(path.dirname(store.file))) });
+      if (pathname === `${base}/api/onboard`) return reply(200, { ok: true, data: {
+        empty: store.read().length === 0, prompt: ONBOARD_PROMPT, steps: ONBOARD_STEPS, dataDir: path.dirname(store.file),
+      } });
+      const { nodes, ...data } = computeMapData(store);
+      const html = renderHtml({ ...data, stars: nodes }, '我的记忆神经网络');
+      return reply(200, html.replace('</body>', escapeBridge + '</body>'), true);
+    } catch (error) {
+      warn(`图谱请求失败：${error.message}`);
+      return fail(500, '读取记忆失败，请检查本地插件日志');
+    }
+  };
+}
+
+export function registerMemoryRoutes(webServer, options) {
+  if (typeof webServer?.register !== 'function') throw new Error('宿主 webServer 服务不可用');
+  return webServer.register({ kind: 'prefix', path: base, handler: createMemoryHandler(options) });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-memory-engine",
-  "version": "0.6.1",
+  "version": "0.7.0-beta.2b",
   "description": "Local DSH memory engine with neuron network visualization and private file import",
   "keywords": [
     "dsh",
@@ -55,6 +55,7 @@
     }
   },
   "scripts": {
+    "build": "node scripts/build-client.mjs",
     "test": "node --test test/*.test.mjs"
   }
 }

package/scripts/build-client.mjs

@@ -0,0 +1,22 @@
+import fs from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { stripRendererExport } from './lib/strip-export.mjs';
+
+const template = fs.readFileSync(new URL('../lib/client.src.js', import.meta.url), 'utf8');
+const renderer = fs.readFileSync(new URL('../lib/render/canvas.js', import.meta.url), 'utf8');
+const marker = '/* __CANVAS_RENDERER__ */';
+if (template.split(marker).length !== 2) throw new Error('Expected exactly one renderer marker');
+const bundled = '// 由 scripts/build-client.mjs 生成，别直接改这个文件\n'
+  + template.replace(marker, () => stripRendererExport(renderer));
+const target = new URL('../lib/client.js', import.meta.url);
+if (process.argv.includes('--check')) {
+  if (fs.readFileSync(target, 'utf8') !== bundled) throw new Error('lib/client.js 已过期，请跑 pnpm build');
+} else {
+  const temporary = new URL(`../lib/.client-${randomUUID()}.tmp`, import.meta.url);
+  try {
+    fs.writeFileSync(temporary, bundled, { encoding: 'utf8', flag: 'wx' });
+    fs.renameSync(temporary, target);
+  } finally {
+    fs.rmSync(temporary, { force: true });
+  }
+}

package/scripts/lib/strip-export.mjs

@@ -0,0 +1,7 @@
+export function stripRendererExport(source) {
+  const declaration = /^export (?=function createRenderer\()/m;
+  if (!declaration.test(source)) throw new Error('Missing createRenderer export');
+  const stripped = source.replace(declaration, '');
+  if (/^\s*(?:import|export)\b/m.test(stripped)) throw new Error('Renderer must be a standalone browser function');
+  return stripped;
+}