dsh-prime-memory 0.26.33 → 0.26.34

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # 更新日志（Changelog）
 
+## [0.26.33] — 2026-11-04
+
+- **根治 3D 记忆海「闪一下变暗」：不是掉帧，是 `resize()` 清空 canvas 位图后，空帧被合成器取样**
+
+> 先说结论：前一轮「每帧重绘太贵 → 掉帧 → 分层缓存 + 空闲停摆」的修复方向是错的，`0.26.33-local.1..4` 的四次本地迭代都治的是另一个病。真正的机制是——给 `canvas.width` 赋值这个动作本身会清空整张位图（规范行为），而 `ResizeObserver` 回调落在渲染步骤的 **layout 之后、paint 之前**：此刻清空、本帧就 paint，擦白的那一帧必然上屏，下一 rAF 才补画回来。所以观感是「闪一下」，且只在外部尺寸事件触发时出现，与单帧耗时无关。
+
+- **像素级取证（推翻多模态观察）**：多模态逐帧描述前后三轮互相矛盾（有说 t=7s 黑屏的、有说全片无黑屏的），改用 `ffmpeg signalstats` 拉全片 **324 帧（30fps / 10.8s）** 客观统计——整片 YAVG 只有 **两个离散值**：`49.20` 与 `40.46`；**22 张暗帧完全同参**（YAVG=40.46 / SATAVG=7.29 / SATMAX=75），说明它们是**同一张图反复出现**，不是渐进掉元素。
+- **定位到「位图透明」而非「元素缺失」**：暗帧下画布三个区域全部塌到同一个纯色——黄簇 `28.69→22.00`、青簇 `26.13→22.00`、空白星空区 `30.95→22.89`，饱和全落到 `≈4.00`。Y=22 是 limited-range，换全范围 luma ≈ 7，而 canvas 元素 L779 的 inline background `#04070f` 实测 luma = **6.99**——对上了：看到的是 canvas 自己的背景色透出来，不是背景层或点层画了一半。
+- **排除合成器/GPU/整窗级问题**：同帧内左侧栏 `61.94→61.81`（-0.2%）、顶部图例条 `100.52→100.52`（**像素零差异**）。窗体重排、resize 抖动、掉驱动都会被这一条否掉。
+- **修复一（幂等 resize）**：`resize()` 改成返回布尔——尺寸与 DPR 都未变时整段跳过，不碰 `canvas.width`。RO 在布局抖动/滚动条出现时的重复触发从此是零成本，不再反复擦白。
+- **修复二（RO 内同步出帧）**：新增 `presentNow()`，RO 里 `if (resize()) presentNow()`——真擦了就**当场画完上屏**，把「清空 → paint 空帧 → 下一 rAF 补画」压成同一渲染步骤内的原子操作。原来那句 `wake()` 只排下一 rAF，本帧照旧 paint 空位图，这是闪烁的直接成因。
+- **修复三（帧句柄自清）**：`frame()` 入口 `raf = 0`。它现在会被 `presentNow()` 同步调用，留着旧句柄会让后续 `wake()` 以为还有链在跑而漏排帧。
+- **附带（非闪烁，每帧税）**：`getComputedStyle` 解色从「每帧 4 次」改为脏标记缓存（`refreshColors()`，仅 resize 与本 effect 重建时置脏）。原实现每帧强制同步样式重算，是纯白交的开销；语义不变——令牌解析时机仍是「主题/尺寸变化」。
+
+- **为什么分层缓存没能解决**：那套改动只降低单帧重绘成本、减少 rAF 次数，但闪烁发生在「可见 canvas 被清空」这条独立通路上，三层缓存（edgeCv / nodeCv / buffer）再快也救不了本帧已经 paint 出去的空位图。反过来说，分层缓存本身是有效的性能优化，保留。
+- **未改任何对外契约**：无新配置键、无端点变化、无默认值变化；仅 `client/src/explorer/Scene3D.tsx` 内部渲染调度。
+- **验证口径（可复现）**：重录 30s 后跑 `ffmpeg -i <rec> -vf "signalstats,metadata=print:file=signalstats.txt" -f null NUL`，**暗帧计数必须为 0**（修复前同一口径为 22/324 帧）。本机已核对：`desktop` profile 装的是 `v0.26.33-local.4`，`dist/client.js` 哈希 `A6879304…` 与源码构建一致——闪烁不是「没装上新代码」，是代码里还在。
+- **测试**：全量 **2048 passed / 1 skipped**（200 文件）；client typecheck 0、`eslint client/src/explorer/Scene3D.tsx` 0 error；`npm run build` 0。产物核对：`dist/client.js` 新哈希 `98DD1061…`，与装入 `desktop` profile 的副本逐字节一致（`v0.26.33-local.5`）。
+
 ## [0.26.31] — 2026-11-03
 
 - **回填 0.26.30 的测试缺口 + 让 npm 产物与 main 对齐（无运行时行为变更）**

package/dist/client.js

@@ -44864,6 +44864,7 @@ var __create = Object.create;
 		
 		// client/src/explorer/projection.ts
 		var FOCAL = 1100;
+		var LABEL_SKIP_DIST = 2600;
 		var CAM_DEFAULT = { yaw: 0.45, pitch: -0.3, dist: 1200, panX: 0, panY: 0 };
 		var DIST_MIN = 380;
 		var DIST_MAX = 3200;
@@ -45023,6 +45024,10 @@ var __create = Object.create;
 		  }
 		  return null;
 		}
+		var BREATH_PERIOD_MS = 260;
+		function phaseOf(id) {
+		  return hash322(id) % 6283 / 1e3;
+		}
 		function easeInOut(p) {
 		  const k = Math.min(1, Math.max(0, p));
 		  return k < 0.5 ? 2 * k * k : 1 - Math.pow(-2 * k + 2, 2) / 2;
@@ -45074,6 +45079,7 @@ var __create = Object.create;
 		  const [pointSize, setPointSize] = (0, import_react32.useState)(2.2);
 		  const [driftOn, setDriftOn] = (0, import_react32.useState)(false);
 		  const [starry, setStarry] = (0, import_react32.useState)(true);
+		  const [twinkleOn, setTwinkleOn] = (0, import_react32.useState)(true);
 		  const camRef = (0, import_react32.useRef)({ ...CAM_DEFAULT });
 		  const modeRef = (0, import_react32.useRef)("cluster");
 		  const focusRef = (0, import_react32.useRef)(null);
@@ -45084,7 +45090,7 @@ var __create = Object.create;
 		  const clickRef = (0, import_react32.useRef)(null);
 		  const emphasisRef = (0, import_react32.useRef)(emphasisId);
 		  emphasisRef.current = emphasisId;
-		  const dirtyRef = (0, import_react32.useRef)(true);
+		  const wakeRef = (0, import_react32.useRef)(null);
 		  const degree = (0, import_react32.useMemo)(() => degreeMapOf(full), [full]);
 		  const edgeList = (0, import_react32.useMemo)(
 		    () => full.edges.map((e) => ({ from: e.from, to: e.to, relation: e.relation, causal: e.causal })),
@@ -45126,6 +45132,7 @@ var __create = Object.create;
 		    camRef.current.dist = Math.min(3200, Math.max(380, EGO_HOPS_MAX2 * 300 * 1.55));
 		    camRef.current.panX = 0;
 		    camRef.current.panY = 0;
+		    wakeRef.current?.();
 		  }, [emphasisId, adj, clusterLayout]);
 		  const metasRef = (0, import_react32.useRef)(/* @__PURE__ */ new Map());
 		  const spritesRef = (0, import_react32.useRef)(/* @__PURE__ */ new Map());
@@ -45168,14 +45175,33 @@ var __create = Object.create;
 		    if (!host || !canvas) return;
 		    const ctx = canvas.getContext("2d");
 		    if (!ctx) return;
-		    dirtyRef.current = true;
 		    const buffer = document.createElement("canvas");
 		    const bctx = buffer.getContext("2d");
+		    const edgeCv = document.createElement("canvas");
+		    const ectx = edgeCv.getContext("2d");
+		    const nodeCv = document.createElement("canvas");
+		    const nctx = nodeCv.getContext("2d");
+		    let edgeDirty = true;
+		    let nodeDirty = true;
+		    let needsPresent = true;
+		    let lastActiveKey = "";
 		    let raf = 0;
+		    let running = false;
 		    let disposed = false;
 		    let vw = 0;
 		    let vh = 0;
 		    const dprRef = { current: 1 };
+		    let colEdge = "";
+		    let colCausal = "";
+		    let colText = "";
+		    let colStale = true;
+		    const refreshColors = () => {
+		      if (!colStale) return;
+		      colEdge = resolveColor2(host, "--dsh-mem-border-strong");
+		      colCausal = resolveColor2(host, "--dsh-mem-accent");
+		      colText = resolveColor2(host, "--dsh-mem-text-2");
+		      colStale = false;
+		    };
 		    const spriteFor = (color) => {
 		      const hit = spritesRef.current.get(color);
 		      if (hit) return hit;
@@ -45247,23 +45273,41 @@ var __create = Object.create;
 		      }
 		      return cv;
 		    };
+		    let sized = false;
 		    const resize = () => {
 		      const dpr = Math.min(2, window.devicePixelRatio || 1);
+		      const nextW = host.clientWidth || 640;
+		      const nextH = host.clientHeight || host.offsetHeight || height;
+		      if (sized && nextW === vw && nextH === vh && dpr === dprRef.current) return false;
+		      sized = true;
 		      dprRef.current = dpr;
-		      vw = host.clientWidth || 640;
-		      vh = host.clientHeight || host.offsetHeight || height;
+		      vw = nextW;
+		      vh = nextH;
 		      canvas.width = Math.round(vw * dpr);
 		      canvas.height = Math.round(vh * dpr);
 		      canvas.style.width = `${vw}px`;
 		      canvas.style.height = `${vh}px`;
 		      buffer.width = canvas.width;
 		      buffer.height = canvas.height;
+		      edgeCv.width = canvas.width;
+		      edgeCv.height = canvas.height;
+		      nodeCv.width = canvas.width;
+		      nodeCv.height = canvas.height;
+		      ectx.setTransform(dpr, 0, 0, dpr, 0, 0);
+		      nctx.setTransform(dpr, 0, 0, dpr, 0, 0);
 		      bctx.setTransform(dpr, 0, 0, dpr, 0, 0);
 		      ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
 		      bgCache = null;
+		      edgeDirty = true;
+		      nodeDirty = true;
+		      colStale = true;
+		      needsPresent = true;
+		      return true;
 		    };
 		    resize();
-		    const ro = new ResizeObserver(resize);
+		    const ro = new ResizeObserver(() => {
+		      if (resize()) presentNow();
+		    });
 		    ro.observe(host);
 		    const activeLayout = (now) => {
 		      const tr = transRef.current;
@@ -45278,133 +45322,192 @@ var __create = Object.create;
 		    };
 		    let lastProjected = [];
 		    const frame = (now) => {
+		      raf = 0;
 		      if (disposed) return;
+		      refreshColors();
 		      const cam = camRef.current;
 		      const layout = activeLayout(now);
 		      const ego = modeRef.current === "ego";
 		      const metas = metasRef.current;
 		      const hover = hoverRef.current;
 		      const focus = focusRef.current;
-		      let nbSet = null;
-		      if (hover) {
-		        nbSet = /* @__PURE__ */ new Set([hover, ...adj.get(hover) ?? []]);
-		        if (focus && focus !== hover) nbSet.add(focus);
+		      const emph = emphasisRef.current;
+		      if (transRef.current !== null || driftOn && !ego) {
+		        edgeDirty = true;
+		        nodeDirty = true;
 		      }
 		      const projected = projectAll(layout, cam, { w: vw, h: vh }, void 0, now, driftOn && !ego);
 		      lastProjected = projected;
-		      const c = bctx;
-		      c.clearRect(0, 0, vw, vh);
-		      if (!bgCache || bgCacheW !== vw || bgCacheH !== vh || bgCacheStarry !== starry) {
-		        bgCache = bakeBg(vw, vh, starry, nodeKeySeed);
-		        bgCacheW = vw;
-		        bgCacheH = vh;
-		        bgCacheStarry = starry;
-		      }
-		      c.drawImage(bgCache, 0, 0);
+		      const activeKey = `${hover ?? ""}|${focus ?? ""}|${emph ?? ""}`;
+		      if (activeKey !== lastActiveKey) {
+		        lastActiveKey = activeKey;
+		        nodeDirty = true;
+		      }
+		      const activeIds = /* @__PURE__ */ new Set();
+		      if (hover) activeIds.add(hover);
+		      if (focus) activeIds.add(focus);
+		      if (emph) activeIds.add(emph);
 		      const pos = new Map(projected.map((p) => [p.id, p]));
-		      if (edgesOn) {
-		        const edgeBase = resolveColor2(host, "--dsh-mem-border-strong");
-		        const causalC = resolveColor2(host, "--dsh-mem-accent");
-		        c.globalCompositeOperation = "source-over";
-		        for (const e of edgeList) {
-		          const a = pos.get(e.from);
-		          const b = pos.get(e.to);
-		          if (!a || !b) continue;
-		          const related = !hover || nbSet.has(e.from) && nbSet.has(e.to) && (e.from === hover || e.to === hover);
-		          if (hover && !related) continue;
-		          const avgF = (a.f + b.f) / 2;
-		          const alpha = Math.min(0.9, Math.max(0.05, avgF * 0.34));
-		          c.strokeStyle = e.causal ? causalC : edgeBase;
-		          c.globalAlpha = hover ? Math.min(0.9, alpha + 0.25) : alpha;
-		          c.lineWidth = e.causal ? 1.2 : 0.7;
+		      const edgeBase = colEdge;
+		      const causalC = colCausal;
+		      if (edgeDirty) {
+		        const c = ectx;
+		        c.clearRect(0, 0, vw, vh);
+		        if (!bgCache || bgCacheW !== vw || bgCacheH !== vh || bgCacheStarry !== starry) {
+		          bgCache = bakeBg(vw, vh, starry, nodeKeySeed);
+		          bgCacheW = vw;
+		          bgCacheH = vh;
+		          bgCacheStarry = starry;
+		        }
+		        c.drawImage(bgCache, 0, 0);
+		        if (edgesOn) {
+		          c.globalCompositeOperation = "source-over";
+		          for (const e of edgeList) {
+		            const a = pos.get(e.from);
+		            const b = pos.get(e.to);
+		            if (!a || !b) continue;
+		            const avgF = (a.f + b.f) / 2;
+		            c.strokeStyle = e.causal ? causalC : edgeBase;
+		            c.globalAlpha = Math.min(0.9, Math.max(0.05, avgF * 0.34));
+		            c.lineWidth = e.causal ? 1.2 : 0.7;
+		            c.beginPath();
+		            c.moveTo(a.x, a.y);
+		            c.lineTo(b.x, b.y);
+		            c.stroke();
+		          }
+		          c.globalAlpha = 1;
+		        }
+		        edgeDirty = false;
+		        needsPresent = true;
+		      }
+		      if (nodeDirty) {
+		        const c = nctx;
+		        c.clearRect(0, 0, vw, vh);
+		        for (const p of projected) {
+		          if (activeIds.has(p.id)) continue;
+		          const m = metas.get(p.id);
+		          if (!m) continue;
+		          const alpha = brightnessFor(p.f, agingOn ? m.aging : null, true);
+		          const r = Math.max(0.8, m.base * p.f * 1.75);
+		          if (glowOn) {
+		            c.globalCompositeOperation = "lighter";
+		            c.globalAlpha = alpha * 0.5;
+		            const sp = spriteFor(m.color);
+		            const gr = r * 3.4;
+		            c.drawImage(sp, p.x - gr, p.y - gr, gr * 2, gr * 2);
+		          }
+		          c.globalCompositeOperation = "source-over";
+		          c.globalAlpha = Math.min(1, alpha + 0.15);
+		          c.fillStyle = m.color;
 		          c.beginPath();
-		          c.moveTo(a.x, a.y);
-		          c.lineTo(b.x, b.y);
-		          c.stroke();
+		          c.arc(p.x, p.y, r, 0, Math.PI * 2);
+		          c.fill();
 		        }
 		        c.globalAlpha = 1;
-		      }
-		      for (const p of projected) {
-		        const m = metas.get(p.id);
-		        if (!m) continue;
-		        const isFocus = p.id === focus || p.id === emphasisRef.current;
-		        const isHover = p.id === hover;
-		        const dim = hover !== null && nbSet !== null && !nbSet.has(p.id) && !isFocus;
-		        let alpha = brightnessFor(p.f, agingOn ? m.aging : null, true);
-		        if (dim) alpha = Math.min(alpha, 0.12);
-		        const r = Math.max(0.8, m.base * p.f * 1.75 * (isFocus || isHover ? 1.9 : 1));
-		        if (glowOn) {
-		          c.globalCompositeOperation = "lighter";
-		          c.globalAlpha = alpha * 0.5;
-		          const sp = spriteFor(m.color);
-		          const gr = r * 3.4;
-		          c.drawImage(sp, p.x - gr, p.y - gr, gr * 2, gr * 2);
-		        }
-		        c.globalCompositeOperation = "source-over";
-		        c.globalAlpha = Math.min(1, alpha + 0.15);
-		        c.fillStyle = m.color;
-		        c.beginPath();
-		        c.arc(p.x, p.y, r, 0, Math.PI * 2);
-		        c.fill();
-		      }
-		      c.globalAlpha = 1;
-		      if (labelsOn) {
-		        const textColor = resolveColor2(host, "--dsh-mem-text-2");
-		        const inSet = /* @__PURE__ */ new Set();
-		        const cand = projected.filter((p) => metas.has(p.id)).map((p) => {
-		          const m = metas.get(p.id);
-		          const hot = p.id === focus || p.id === hover || p.id === emphasisRef.current;
-		          if (hot) inSet.add(p.id);
-		          return {
-		            id: p.id,
-		            x: p.x,
-		            y: p.y,
-		            f: p.f,
-		            rank: (hot ? 1e6 : 0) + m.degree * 10 + (m.aging ?? 1) * 5 + hash322(p.id) % 7
+		        if (labelsOn && cam.dist <= LABEL_SKIP_DIST) {
+		          const textColor = colText;
+		          const cand = projected.filter((p) => metas.has(p.id) && !activeIds.has(p.id)).map((p) => {
+		            const m = metas.get(p.id);
+		            return { id: p.id, x: p.x, y: p.y, f: p.f, rank: m.degree * 10 + (m.aging ?? 1) * 5 + hash322(p.id) % 7 };
+		          });
+		          const widthOf = (id) => {
+		            const m = metas.get(id);
+		            return m ? clipByWidth(m.name).length * 6.4 : 0;
 		          };
-		        });
-		        const widthOf = (id) => {
+		          const picked = new Set(pickLabels(cand, labelBudget(cam.dist), widthOf, vw));
+		          c.globalCompositeOperation = "source-over";
+		          c.fillStyle = textColor;
+		          c.font = '11px system-ui, "Microsoft YaHei", sans-serif';
+		          for (const p of projected) {
+		            if (!picked.has(p.id)) continue;
+		            c.globalAlpha = Math.min(1, Math.max(0.35, p.f));
+		            c.fillText(clipByWidth(metas.get(p.id).name), p.x + 7, p.y - 5);
+		          }
+		          c.globalAlpha = 1;
+		        }
+		        nodeDirty = false;
+		        needsPresent = true;
+		      }
+		      const breathing = twinkleOn && activeIds.size > 0;
+		      if (breathing) {
+		        const c = bctx;
+		        c.setTransform(1, 0, 0, 1, 0, 0);
+		        c.drawImage(edgeCv, 0, 0);
+		        c.drawImage(nodeCv, 0, 0);
+		        c.setTransform(dprRef.current, 0, 0, dprRef.current, 0, 0);
+		        for (const id of activeIds) {
+		          const p = pos.get(id);
 		          const m = metas.get(id);
-		          return m ? clipByWidth(m.name).length * 6.4 : 0;
-		        };
-		        const picked = /* @__PURE__ */ new Set([...pickLabels(cand, labelBudget(cam.dist), widthOf, vw), ...inSet]);
-		        c.globalCompositeOperation = "source-over";
-		        c.fillStyle = textColor;
-		        c.font = '11px system-ui, "Microsoft YaHei", sans-serif';
-		        for (const p of projected) {
-		          if (!picked.has(p.id)) continue;
-		          const m = metas.get(p.id);
-		          const dim = hover !== null && nbSet !== null && !nbSet.has(p.id);
-		          c.globalAlpha = dim ? 0.18 : Math.min(1, Math.max(0.35, p.f));
-		          c.fillText(clipByWidth(m.name), p.x + 7, p.y - 5);
-		        }
-		        c.globalAlpha = 1;
-		      }
-		      if (hover && edgesOn) {
-		        const causalC = resolveColor2(host, "--dsh-mem-accent");
-		        const edgeBase = resolveColor2(host, "--dsh-mem-border-strong");
-		        c.font = '10px system-ui, "Microsoft YaHei", sans-serif';
-		        const used = /* @__PURE__ */ new Set();
-		        const related = edgeList.filter((e) => (e.from === hover || e.to === hover) && pos.has(e.from) && pos.has(e.to)).sort((a, b) => Number(b.causal) - Number(a.causal));
-		        for (const e of related.slice(0, 12)) {
-		          const a = pos.get(e.from);
-		          const b = pos.get(e.to);
-		          const mx = (a.x + b.x) / 2;
-		          const my = (a.y + b.y) / 2;
-		          const cell = Math.floor(mx / 72) * 1e3 + Math.floor(my / 13);
-		          if (used.has(cell)) continue;
-		          used.add(cell);
-		          c.fillStyle = e.causal ? causalC : edgeBase;
-		          c.globalAlpha = 0.92;
-		          c.fillText(e.relation, mx, my);
-		        }
-		        c.globalAlpha = 1;
+		          if (!p || !m) continue;
+		          const tw = 0.5 + 0.5 * Math.sin(now / BREATH_PERIOD_MS + phaseOf(id));
+		          const alpha = brightnessFor(p.f, agingOn ? m.aging : null, true);
+		          const r = Math.max(0.8, m.base * p.f * 1.75 * 1.9);
+		          if (glowOn) {
+		            c.globalCompositeOperation = "lighter";
+		            c.globalAlpha = Math.min(1, alpha * 0.5 + tw * 0.4);
+		            const sp = spriteFor(m.color);
+		            const gr = r * 3.4 * (1 + tw * 0.45);
+		            c.drawImage(sp, p.x - gr, p.y - gr, gr * 2, gr * 2);
+		          }
+		          c.globalCompositeOperation = "source-over";
+		          c.globalAlpha = Math.min(1, alpha + 0.15 + tw * 0.25);
+		          c.fillStyle = m.color;
+		          c.beginPath();
+		          c.arc(p.x, p.y, r, 0, Math.PI * 2);
+		          c.fill();
+		          if (labelsOn) {
+		            c.globalAlpha = 1;
+		            c.fillStyle = colText;
+		            c.font = '11px system-ui, "Microsoft YaHei", sans-serif';
+		            c.fillText(clipByWidth(m.name), p.x + 7, p.y - 5);
+		          }
+		        }
+		        if (hover && edgesOn) {
+		          c.font = '10px system-ui, "Microsoft YaHei", sans-serif';
+		          const used = /* @__PURE__ */ new Set();
+		          const related = edgeList.filter((e) => (e.from === hover || e.to === hover) && pos.has(e.from) && pos.has(e.to)).sort((a, b) => Number(b.causal) - Number(a.causal));
+		          for (const e of related.slice(0, 12)) {
+		            const a = pos.get(e.from);
+		            const b = pos.get(e.to);
+		            const mx = (a.x + b.x) / 2;
+		            const my = (a.y + b.y) / 2;
+		            const cell = Math.floor(mx / 72) * 1e3 + Math.floor(my / 13);
+		            if (used.has(cell)) continue;
+		            used.add(cell);
+		            c.fillStyle = e.causal ? causalC : edgeBase;
+		            c.globalAlpha = 0.92;
+		            c.fillText(e.relation, mx, my);
+		          }
+		          c.globalAlpha = 1;
+		        }
+		        ctx.setTransform(1, 0, 0, 1, 0, 0);
+		        ctx.drawImage(buffer, 0, 0);
+		        ctx.setTransform(dprRef.current, 0, 0, dprRef.current, 0, 0);
+		        needsPresent = false;
+		      } else if (needsPresent) {
+		        ctx.setTransform(1, 0, 0, 1, 0, 0);
+		        ctx.drawImage(edgeCv, 0, 0);
+		        ctx.drawImage(nodeCv, 0, 0);
+		        ctx.setTransform(dprRef.current, 0, 0, dprRef.current, 0, 0);
+		        needsPresent = false;
+		      }
+		      running = edgeDirty || nodeDirty || needsPresent || breathing || transRef.current !== null || driftOn && !ego;
+		      if (running) raf = requestAnimationFrame(frame);
+		    };
+		    const presentNow = () => {
+		      if (disposed) return;
+		      if (raf) cancelAnimationFrame(raf);
+		      raf = 0;
+		      running = false;
+		      frame(performance.now());
+		    };
+		    const wake = () => {
+		      if (!running && !disposed) {
+		        running = true;
+		        raf = requestAnimationFrame(frame);
 		      }
-		      ctx.setTransform(1, 0, 0, 1, 0, 0);
-		      ctx.drawImage(buffer, 0, 0);
-		      ctx.setTransform(dprRef.current, 0, 0, dprRef.current, 0, 0);
-		      raf = requestAnimationFrame(frame);
 		    };
+		    wakeRef.current = wake;
 		    frame(performance.now());
 		    const toLocal = (ev) => {
 		      const rect = canvas.getBoundingClientRect();
@@ -45428,13 +45531,15 @@ var __create = Object.create;
 		        }
 		        drag.x = pt.x;
 		        drag.y = pt.y;
-		        dirtyRef.current = true;
+		        edgeDirty = true;
+		        nodeDirty = true;
+		        wake();
 		        return;
 		      }
 		      const hit = pickNearest(lastProjected, pt.x, pt.y, PICK_PX);
 		      if (hit !== hoverRef.current) {
 		        hoverRef.current = hit;
-		        dirtyRef.current = true;
+		        wake();
 		        setHoverInfo(hit ? { id: hit, x: pt.x, y: pt.y } : null);
 		      } else if (hit) {
 		        setHoverInfo({ id: hit, x: pt.x, y: pt.y });
@@ -45487,7 +45592,9 @@ var __create = Object.create;
 		    const onWheel = (ev) => {
 		      ev.preventDefault();
 		      camRef.current.dist = zoomBy(camRef.current.dist, ev.deltaY);
-		      dirtyRef.current = true;
+		      edgeDirty = true;
+		      nodeDirty = true;
+		      wake();
 		    };
 		    const onKey = (ev) => {
 		      if (ev.key === "Enter" && hoverRef.current) onPick(hoverRef.current);
@@ -45513,6 +45620,7 @@ var __create = Object.create;
 		    return () => {
 		      disposed = true;
 		      cancelAnimationFrame(raf);
+		      wakeRef.current = null;
 		      ro.disconnect();
 		      canvas.removeEventListener("mousedown", onDown);
 		      window.removeEventListener("mousemove", onMove);
@@ -45521,7 +45629,7 @@ var __create = Object.create;
 		      canvas.removeEventListener("mouseleave", onLeave);
 		      window.removeEventListener("keydown", onKey);
 		    };
-		  }, [full, edgeList, adj, clusterLayout, glowOn, edgesOn, labelsOn, agingOn, driftOn, starry, nodeKeySeed, height, onPick]);
+		  }, [full, edgeList, adj, clusterLayout, glowOn, edgesOn, labelsOn, agingOn, driftOn, twinkleOn, starry, nodeKeySeed, pointSize, height, onPick]);
 		  const hoverMeta = hoverInfo ? metasRef.current.get(hoverInfo.id) : null;
 		  const ui = starry ? {
 		    barBg: "rgba(10, 13, 22, 0.72)",
@@ -45602,6 +45710,7 @@ var __create = Object.create;
 		          toggle("边", edgesOn, setEdgesOn),
 		          toggle("标签", labelsOn, setLabelsOn),
 		          toggle("老化亮度", agingOn, setAgingOn),
+		          toggle("呼吸", twinkleOn, setTwinkleOn),
 		          toggle("漂移", driftOn, setDriftOn),
 		          toggle(starry ? "星空底" : "白底", starry, setStarry),
 		          /* @__PURE__ */ (0, import_jsx_runtime32.jsxs)("label", { style: { fontSize: 11, color: ui.dim, display: "inline-flex", alignItems: "center", gap: 4 }, children: [

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-prime-memory",
   "name": "dsh-prime-memory",
-  "version": "0.26.33",
+  "version": "0.26.34",
   "description": {
     "en": "Layered distilled memory plugin (L0 capture → L1 atomic memory → L2 scenes → L3 persona) with automatic recall injection before each model step.",
     "zh": "L0~L3 分层蒸馏记忆插件:自动捕获对话、抽取原子记忆、整合场景块、蒸馏核心画像,并在模型步骤前自动召回注入。"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-prime-memory",
-  "version": "0.26.33",
+  "version": "0.26.34",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",