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

package/lib/client.src.js

@@ -0,0 +1,397 @@
+window.__ModuleLoader__.load({
+  id: "dsh-memory-engine",
+  factory: function (require) {
+    var module = { exports: {} };
+    var exports = module.exports;
+    var React = require("react");
+    var ReactDOM = require("react-dom");
+    // 2026-10-30：从 views.actions 挪到 header.actions。
+    // views.actions 是「更多视图」下拉菜单的行（Chat/Trajectory 旁边的 ⋯），
+    // 注册进去只是菜单里多一行，看不见；header.actions 才是头部正常按钮区。
+    var SLOT_NAME = "conversation.session.header.actions";
+    // 不同 DSH 版本暴露的插槽名不一样：新版本用 header.actions，
+    // 老版本没有这个槽时退回 views.actions（会出现在「更多视图」菜单里，虽然不显眼但能用）。
+    var SLOT_FALLBACKS = ["conversation.session.header.actions", "conversation.session.header.views.actions"];
+
+    /* __CANVAS_RENDERER__ */
+
+    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 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;
+        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, true);
+        return function () { window.removeEventListener("keydown", onKey, true); };
+      }, [open, guideOpen, selected]);
+      var button = React.createElement("button", {
+        type: "button",
+        onClick: openMap,
+        "data-memory-engine-map": "true",
+        "aria-label": "打开记忆图谱",
+        title: "记忆图谱",
+        style: { display: "inline-flex", alignItems: "center", gap: "5px", padding: "5px 9px", borderRadius: "8px", border: "1px solid rgba(130,160,190,.4)", background: "transparent", color: "inherit", font: "inherit", cursor: "pointer" },
+      }, React.createElement("span", { "aria-hidden": "true" }, "🧠"), "记忆图谱");
+      if (!open) return button;
+      var overlay = React.createElement("div", {
+        role: "dialog",
+        "aria-modal": "true",
+        "aria-label": "记忆图谱",
+        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: closeMap,
+        "aria-label": "关闭记忆图谱",
+        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, settings) {
+      var disposable = null;
+      slots.inject(name, function () {
+        try {
+          disposable = slots.register({
+            name: name,
+            id: "memory-engine-map",
+            order: 50,
+            label: function () { return "记忆图谱"; },
+          }, function ConfiguredMemoryButton() { return React.createElement(MemoryButton, { settings: settings }); });
+        } catch (error) {
+          try { console.error("[dsh-memory-engine] 注册到 " + name + " 失败：", error); } catch (ignored) {}
+        }
+        return disposable;
+      });
+      return disposable;
+    }
+
+    function apply(ctx) {
+      try {
+        if (!ctx || !ctx.slots || typeof ctx.slots.inject !== "function") {
+          try { console.warn("[dsh-memory-engine] 宿主没有 slots 服务，跳过图谱按钮（记忆工具不受影响）"); } catch (ignored) {}
+          return;
+        }
+        // 只注册第一个能用的插槽：优先 header.actions，老宿主没有就退到 views.actions
+        var target = ctx.slots && typeof ctx.slots.has === "function" && !ctx.slots.has(SLOT_FALLBACKS[0])
+          ? SLOT_FALLBACKS[1]
+          : SLOT_NAME;
+        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) {}
+      }
+    }
+
+    exports.apply = apply;
+    exports.inject = ["slots"];
+    return module.exports;
+  }
+});

package/lib/config.js

@@ -8,6 +8,11 @@ export function resolveDiaryDir({ home = defaultHome(), envDir = process.env.QQ_
   return envDir || readConfig(home).diaryDir || '';
 }
 
+export function readUiConfig(home = defaultHome()) {
+  const config = readConfig(home);
+  return { hideButton: config.hideButton === true, showGuideOnEmpty: config.showGuideOnEmpty !== false };
+}
+
 export function readConfig(home = defaultHome()) {
   const file = path.join(home, 'memory-engine', 'config.json');
   try {

package/lib/index.js

@@ -1,10 +1,10 @@
 import { MemoryStore } from './store.js';
 import { chars, titleOf } from './decay.js';
 import { generateMap, mapReport, openMap } from './map.js';
-import { startMapServer } from './serve.js';
+import { registerMemoryRoutes } from './routes.js';
 
 export const name = 'memory-engine';
-export const inject = ['tools'];
+export const inject = ['tools', 'webServer'];
 
 function report(ctx, error) {
   try {
@@ -184,10 +184,9 @@ export function apply(ctx) {
         const store = new MemoryStore();
         for (const tool of createTools(defineTool, store, { warning: message => warn(ctx, message) })) disposers.push(ctx.tools.register(tool));
         try {
-          const server = await startMapServer({ store, warn: message => warn(ctx, message) });
-          disposers.push(() => server.close());
+          disposers.push(registerMemoryRoutes(ctx.webServer, { store, warn: message => warn(ctx, message) }));
         } catch (error) {
-          warn(ctx, `图谱服务启动失败，记忆工具仍可用：${error.message}`);
+          warn(ctx, `图谱路由注册失败，记忆工具仍可用：${error.message}`);
         }
         const timer = setTimeout(() => {
           try { if (store.read().length > 0) generateMap(store); }

package/lib/map.js

@@ -6,6 +6,17 @@ import { pathToFileURL } from 'node:url';
 import { scoreMemories, layoutMemories, renderHtml } from './render/index.mjs';
 import { readConfig } from './config.js';
 
+export function computeMapData(store) {
+  const items = store.read().map(({ id, text, title: nodeTitle, ts, kind, heat }) => ({ id, text,
+    title: nodeTitle || Array.from(text).slice(0, 20).join(''), ts, kind, heat }));
+  const now = store.now();
+  const scored = scoreMemories(items, now);
+  const nodes = layoutMemories(scored.nodes);
+  const kinds = Object.fromEntries([...new Set(nodes.map(node => node.kind))].map(kind => [kind, nodes.filter(node => node.kind === kind).length]));
+  return { generatedAt: now, nodes, links: scored.links, review: scored.review,
+    stats: { total: nodes.length, byKind: kinds, forgettingSoon: nodes.filter(node => node.retention < 0.3).length } };
+}
+
 export function generateMap(store, { out, title = '我的记忆神经网络' } = {}) {
   const started = performance.now();
   if (typeof title !== 'string' || !title.trim()) throw new Error('title 必须是非空字符串');
@@ -20,15 +31,8 @@ export function generateMap(store, { out, title = '我的记忆神经网络' } =
       throw new Error('桥接目录只读，请把图谱输出到插件数据目录或其他目录');
     }
   }
-  const items = store.read().map(({ id, text, title: nodeTitle, ts, kind, heat }) => ({ id, text,
-    title: nodeTitle || Array.from(text).slice(0, 20).join(''), ts, kind, heat }));
-  const now = store.now();
-  const { nodes, links, review } = scoreMemories(items, now);
-  const stars = layoutMemories(nodes);
-  const kinds = Object.fromEntries([...new Set(stars.map(star => star.kind))].map(kind => [kind, stars.filter(star => star.kind === kind).length]));
-  const payload = { generatedAt: now, stats: { total: stars.length, byKind: kinds,
-    forgettingSoon: stars.filter(star => star.retention < 0.3).length }, stars, links, review };
-  const html = renderHtml(payload, title);
+  const { nodes, ...data } = computeMapData(store);
+  const html = renderHtml({ ...data, stars: nodes }, title);
   fs.mkdirSync(path.dirname(file), { recursive: true });
   const temporary = `${file}.${process.pid}.${randomBytes(5).toString('hex')}.tmp`;
   try {
@@ -37,7 +41,8 @@ export function generateMap(store, { out, title = '我的记忆神经网络' } =
   } finally {
     try { fs.unlinkSync(temporary); } catch (error) { if (error.code !== 'ENOENT') throw error; }
   }
-  return { file, total: stars.length, edges: links.length, kinds, bytes: Buffer.byteLength(html), elapsedMs: performance.now() - started };
+  return { file, total: nodes.length, edges: data.links.length, kinds: data.stats.byKind,
+    bytes: Buffer.byteLength(html), elapsedMs: performance.now() - started };
 }
 
 export function mapReport(result) {

package/lib/onboard.js

@@ -0,0 +1,18 @@
+export const ONBOARD_PROMPT = [
+  '聊天时遇到这些，用 memory_save 记下来：',
+  '  · 对方的称呼、偏好、忌讳、习惯（kind="印象"，who 填对方名字）',
+  '  · 答应过的事、约定、承诺（kind="对话"）',
+  '  · 情绪特别重的瞬间（kind="事件"，heat=1）',
+  '  · 新学到的知识、名词、梗的解释（kind="知识"）',
+  '  · 每天结束时，用一两句写当天小结（kind="日记"）',
+  '',
+  '不用每条都记。一天三五条就够，宁可少存也别灌水。',
+  '存之前先 memory_recall 查一下，避免重复。',
+].join('\n');
+
+export const ONBOARD_STEPS = [
+  { title: '让机器人开始记', body: '把这段提示词加进机器人的角色卡或提示词里。' },
+  { title: '或者导入旧记忆', body: '在对话里说：「把 D:\\bot\\memories.json 导进记忆库」。支持 JSON、Markdown 和纯文本，先预览，确认后导入。' },
+  { title: '聊几句，回来点刷新', body: '有了新记忆后，点「刷新图谱」就能看到。' },
+];
+