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

package/lib/client.src.js

@@ -17,17 +17,21 @@ window.__ModuleLoader__.load({
 
     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" };
+    var fieldStyle = { boxSizing: "border-box", padding: "10px 12px", borderRadius: "8px", border: "1px solid #35536b", background: "#091422", color: "#e2f4ff", font: "inherit", minWidth: 0 };
+    var kinds = ["知识", "印象", "对话", "事件", "日记"];
 
-    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 requestApi(url, options) {
+      return fetch(url, Object.assign({ cache: "no-store" }, options)).then(function (response) {
+        return response.json().then(function (result) {
+          if (!response.ok || !result || result.ok !== true) throw new Error(result && result.error || "HTTP " + response.status);
+          if (!result.data || typeof result.data !== "object") throw new Error("接口返回格式无效");
+          return result.data;
+        });
       });
     }
 
+    function readApi(url, signal) { return requestApi(url, { signal: signal }); }
+
     function loadSettings() {
       var controller = new AbortController();
       var timer = setTimeout(function () { controller.abort(); }, 5000);
@@ -107,6 +111,8 @@ window.__ModuleLoader__.load({
     function MemoryDetails(props) {
       var node = props.node;
       var text = typeof node.text === "string" ? node.text : "";
+      if (node.isCore) text = Array.from(text).slice(0, 4000).join("");
+      var defaultCopyLabel = node.isCore ? "复制全文" : "复制正文";
       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") : "未知";
@@ -119,7 +125,7 @@ window.__ModuleLoader__.load({
       ];
       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 copiedState = React.useState(defaultCopyLabel);
       var copyLabel = copiedState[0];
       var setCopyLabel = copiedState[1];
       var timer = React.useRef(null);
@@ -129,10 +135,10 @@ window.__ModuleLoader__.load({
         copyVersion.current++;
         clearTimeout(timer.current);
         timer.current = null;
-        setCopyLabel("复制正文");
+        setCopyLabel(defaultCopyLabel);
         if (body.current) body.current.scrollTop = 0;
         return function () { copyVersion.current++; clearTimeout(timer.current); timer.current = null; };
-      }, [node.id, text]);
+      }, [node.id, text, defaultCopyLabel]);
       function copyBody() {
         var version = ++copyVersion.current;
         clearTimeout(timer.current);
@@ -140,7 +146,7 @@ window.__ModuleLoader__.load({
           if (version !== copyVersion.current) return;
           setCopyLabel("已复制 ✓");
           timer.current = setTimeout(function () {
-            if (version === copyVersion.current) setCopyLabel("复制正文");
+            if (version === copyVersion.current) setCopyLabel(defaultCopyLabel);
             timer.current = null;
           }, 1800);
         }, function () {
@@ -154,13 +160,13 @@ window.__ModuleLoader__.load({
         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 } },
+      node.isCore ? null : 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 }, "在图里高亮它"),
+        node.isCore ? null : 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)));
     }
 
@@ -228,6 +234,297 @@ window.__ModuleLoader__.load({
           React.createElement("button", { type: "button", style: actionStyle, onClick: function () { setRetry(function (value) { return value + 1; }); } }, "重试")) : null);
     }
 
+    function ConfirmationDialog(props) {
+      var valueState = React.useState("");
+      var value = valueState[0], setValue = valueState[1];
+      var errorState = React.useState("");
+      var error = errorState[0], setError = errorState[1];
+      var form = React.useRef(null);
+      React.useEffect(function () {
+        var active = document.activeElement;
+        var target = form.current && form.current.querySelector("input,button");
+        if (target) target.focus();
+        return function () { if (active && active.isConnected) active.focus(); };
+      }, []);
+      function onKey(event) {
+        if (event.key === "Escape") {
+          event.preventDefault(); event.stopPropagation();
+          if (!props.busy) props.onClose();
+        }
+        if (event.key === "Tab" && form.current) {
+          var controls = Array.from(form.current.querySelectorAll("input,button")).filter(function (control) { return !control.disabled; });
+          if (!controls.length) { event.preventDefault(); return; }
+          var index = controls.indexOf(document.activeElement);
+          if (event.shiftKey && index <= 0) { event.preventDefault(); controls[controls.length - 1].focus(); }
+          else if (!event.shiftKey && (index === -1 || index === controls.length - 1)) { event.preventDefault(); controls[0].focus(); }
+        }
+      }
+      return React.createElement("div", { "data-memory-engine-confirm": "true", onKeyDown: onKey,
+        style: { position: "fixed", inset: 0, zIndex: 3, display: "grid", placeItems: "center", padding: "24px", background: "#03060ccc" } },
+        React.createElement("form", { ref: form, role: "dialog", "aria-modal": "true", "aria-label": props.title,
+          onSubmit: function (event) {
+            event.preventDefault();
+            if (props.busy) return;
+            if (props.requireDelete && value !== "DELETE") { setError("请输入大写 DELETE，其他内容不会执行清空。"); return; }
+            setError(""); props.onConfirm();
+          },
+          style: { width: "min(460px,100%)", padding: "24px", border: "1px solid #8b505c", borderRadius: "16px", background: "#101a29", color: "#e2f4ff", boxShadow: "0 16px 80px #0008" } },
+          React.createElement("h2", { style: { margin: "0 0 12px", fontSize: "20px" } }, props.title),
+          React.createElement("p", { style: { color: "#c2cedc" } }, props.message),
+          props.requireDelete ? React.createElement("label", null, "输入 DELETE 确认",
+            React.createElement("input", { "aria-label": "输入 DELETE 确认", autoComplete: "off", value: value, disabled: props.busy,
+              onChange: function (event) { setValue(event.target.value); setError(""); }, style: Object.assign({}, fieldStyle, { display: "block", width: "100%", marginTop: "8px" }) })) : null,
+          error || props.error ? React.createElement("p", { role: "alert", style: { color: "#ffb8b8" } }, error || props.error) : null,
+          React.createElement("div", { style: { display: "flex", justifyContent: "flex-end", gap: "10px", marginTop: "24px" } },
+            React.createElement("button", { type: "button", disabled: props.busy, onClick: props.onClose, style: actionStyle }, "取消"),
+            React.createElement("button", { type: "submit", disabled: props.busy, style: Object.assign({}, actionStyle, { borderColor: "#c86b7a", background: "#572a38" }) }, props.busy ? "正在处理…" : props.submitLabel))));
+    }
+
+    function MemoryRow(props) {
+      var item = props.item;
+      var expandedState = React.useState(false);
+      var expanded = expandedState[0], setExpanded = expandedState[1];
+      var detailState = React.useState(item);
+      var detail = detailState[0], setDetail = detailState[1];
+      var editState = React.useState(null);
+      var edit = editState[0], setEdit = editState[1];
+      var confirmState = React.useState(false);
+      var confirming = confirmState[0], setConfirming = confirmState[1];
+      var errorState = React.useState("");
+      var error = errorState[0], setError = errorState[1];
+      var loadingState = React.useState(false);
+      var loading = loadingState[0], setLoading = loadingState[1];
+      var busyState = React.useState(false);
+      var busy = busyState[0], setBusy = busyState[1];
+      var mutation = React.useRef(null);
+      React.useEffect(function () { return function () { if (mutation.current) mutation.current.abort(); }; }, []);
+      React.useEffect(function () {
+        if (!expanded) return;
+        var controller = new AbortController();
+        setLoading(true); setError("");
+        readApi("/memory-engine/api/item/" + encodeURIComponent(item.id), controller.signal).then(function (result) {
+          if (!controller.signal.aborted) setDetail(result);
+        }).catch(function (failure) {
+          if (!controller.signal.aborted) setError("读取详情失败：" + failure.message);
+        }).finally(function () { if (!controller.signal.aborted) setLoading(false); });
+        return function () { controller.abort(); };
+      }, [expanded, item.id]);
+      function mutate(method) {
+        if (mutation.current) return;
+        var controller = new AbortController();
+        mutation.current = controller;
+        setBusy(true); setError("");
+        var options = { method: method, signal: controller.signal };
+        if (method === "PUT") { options.headers = { "Content-Type": "application/json" }; options.body = JSON.stringify(edit); }
+        requestApi("/memory-engine/api/item/" + encodeURIComponent(item.id), options).then(function () {
+          if (controller.signal.aborted) return;
+          setEdit(null); setExpanded(false); setConfirming(false); props.onChanged();
+        }).catch(function (failure) {
+          if (!controller.signal.aborted) setError((method === "PUT" ? "保存失败：" : "删除失败：") + failure.message);
+        }).finally(function () {
+          if (!controller.signal.aborted) { mutation.current = null; setBusy(false); }
+        });
+      }
+      function change(field, value) { setEdit(function (previous) { var next = Object.assign({}, previous); next[field] = value; return next; }); }
+      var choices = kinds.includes(detail.kind) ? kinds : [detail.kind].concat(kinds);
+      return React.createElement("article", { "data-memory-engine-row": item.id,
+        style: { marginBottom: "12px", border: "1px solid " + (expanded ? "#4c85a4" : "#263f54"), borderRadius: "12px", background: "#0b1624", overflowWrap: "anywhere" } },
+        React.createElement("button", { type: "button", "data-memory-engine-expand": item.id, "aria-expanded": expanded, disabled: busy,
+          onClick: function () { setExpanded(!expanded); setEdit(null); setError(""); },
+          style: { width: "100%", display: "block", padding: "18px 20px", border: 0, borderRadius: "12px", background: "transparent", color: "inherit", textAlign: "left", font: "inherit", cursor: "pointer" } },
+          React.createElement("span", { style: { display: "flex", alignItems: "center", gap: "12px", flexWrap: "wrap" } },
+            React.createElement("span", { style: { color: "#a4e6ff", background: "#15344b", padding: "2px 8px", borderRadius: "6px", flexShrink: 0 } }, item.kind),
+            React.createElement("strong", { style: { flex: "1 1 180px", overflowWrap: "anywhere" } }, item.title),
+            React.createElement("span", { style: { color: "#8db0c7", fontSize: "12px", whiteSpace: "nowrap" } }, "留存 " + item.retention.toFixed(2) + " · " + item.degree + " 个连接")),
+          !expanded ? React.createElement("span", { style: { display: "block", color: "#9fb7ce", marginTop: "8px", overflowWrap: "anywhere" } }, item.preview) : null),
+        expanded ? React.createElement("div", { style: { padding: "0 20px 18px" } },
+          loading ? React.createElement("p", { role: "status" }, "正在读取全文…") : null,
+          edit ? React.createElement("form", { "data-memory-engine-editor": item.id, onSubmit: function (event) { event.preventDefault(); mutate("PUT"); } },
+            React.createElement("textarea", { "aria-label": "记忆正文", value: edit.text, disabled: busy,
+              onChange: function (event) { change("text", event.target.value); },
+              style: Object.assign({}, fieldStyle, { width: "100%", minHeight: "150px", maxHeight: "40vh", resize: "vertical", lineHeight: 1.7 }) }),
+            React.createElement("div", { style: { display: "flex", gap: "12px", flexWrap: "wrap", margin: "12px 0" } },
+              React.createElement("label", null, "分类 ", React.createElement("select", { "aria-label": "编辑分类", value: edit.kind, disabled: busy, style: fieldStyle,
+                onChange: function (event) { change("kind", event.target.value); } }, choices.map(function (value) { return React.createElement("option", { key: value, value: value }, value); }))),
+              React.createElement("label", null, "重要度 ", React.createElement("select", { "aria-label": "编辑重要度", value: edit.heat, disabled: busy, style: fieldStyle,
+                onChange: function (event) { change("heat", Number(event.target.value)); } },
+                [[1, "热（1）"], [2, "温（2）"], [3, "冷（3）"]].map(function (entry) { return React.createElement("option", { key: entry[0], value: entry[0] }, entry[1]); }))),
+              React.createElement("label", null, "相关人 ", React.createElement("input", { "aria-label": "编辑相关人", value: edit.who, disabled: busy,
+                onChange: function (event) { change("who", event.target.value); }, style: Object.assign({}, fieldStyle, { width: "140px" }) }))),
+            React.createElement("div", { style: { display: "flex", gap: "8px" } },
+              React.createElement("button", { type: "submit", disabled: busy, "data-memory-engine-save": "true", style: actionStyle }, busy ? "正在保存…" : "保存"),
+              React.createElement("button", { type: "button", disabled: busy, "data-memory-engine-cancel-edit": "true", style: actionStyle,
+                onClick: function () { setEdit(null); setExpanded(false); setError(""); } }, "取消")))
+            : React.createElement(React.Fragment, null,
+              React.createElement("div", { "data-memory-engine-full-text": "true", style: { whiteSpace: "pre-wrap", maxHeight: "40vh", overflowY: "auto", color: "#c2d3e3", marginBottom: "14px" } }, detail.text),
+              React.createElement("div", { style: { display: "flex", gap: "8px" } },
+                React.createElement("button", { type: "button", "data-memory-engine-edit": item.id, disabled: loading || busy, style: actionStyle,
+                  onClick: function () { setError(""); setEdit({ text: detail.text, kind: detail.kind, heat: detail.heat, who: detail.who || "" }); } }, "编辑"),
+                React.createElement("button", { type: "button", "data-memory-engine-delete": item.id, disabled: loading || busy,
+                  onClick: function () { setError(""); setConfirming(true); }, style: Object.assign({}, actionStyle, { color: "#ffb8b8", borderColor: "#8b505c" }) }, "删除"))),
+          error ? React.createElement("p", { role: "alert", style: { color: "#ffb8b8" } }, error) : null) : null,
+        confirming ? React.createElement(ConfirmationDialog, { title: "删除这条记忆", message: "确定删除这条记忆？不可撤销。操作前会保留备份。", submitLabel: "确定删除",
+          busy: busy, error: error, onClose: function () { setConfirming(false); }, onConfirm: function () { mutate("DELETE"); } }) : null);
+    }
+
+    function MemoryList(props) {
+      var searchState = React.useState("");
+      var search = searchState[0], setSearch = searchState[1];
+      var queryState = React.useState("");
+      var query = queryState[0], setQuery = queryState[1];
+      var kindState = React.useState("");
+      var kind = kindState[0], setKind = kindState[1];
+      var sortState = React.useState("recent");
+      var sort = sortState[0], setSort = sortState[1];
+      var offsetState = React.useState(0);
+      var offset = offsetState[0], setOffset = offsetState[1];
+      var pageState = React.useState({ items: [], total: 0, allTotal: 0 });
+      var page = pageState[0], setPage = pageState[1];
+      var loadingState = React.useState(true);
+      var loading = loadingState[0], setLoading = loadingState[1];
+      var errorState = React.useState("");
+      var error = errorState[0], setError = errorState[1];
+      var retryState = React.useState(0);
+      var retry = retryState[0], setRetry = retryState[1];
+      function refresh() {
+        setOffset(0); setRetry(function (value) { return value + 1; });
+        if (props.onChanged) props.onChanged();
+      }
+      React.useEffect(function () {
+        if (search === query) return;
+        var timer = setTimeout(function () { setOffset(0); setQuery(search); }, 250);
+        return function () { clearTimeout(timer); };
+      }, [search]);
+      React.useEffect(function () {
+        var controller = new AbortController();
+        var active = true;
+        setLoading(true); setError("");
+        var params = new URLSearchParams({ q: query, kind: kind, sort: sort, limit: "50", offset: String(offset) });
+        readApi("/memory-engine/api/list?" + params, controller.signal).then(function (result) {
+          if (!active) return;
+          setPage(function (previous) { return Object.assign({}, result, { items: offset === 0 ? result.items : previous.items.concat(result.items) }); });
+        }).catch(function (failure) {
+          if (active) setError("加载记忆失败：" + failure.message);
+        }).finally(function () { if (active) setLoading(false); });
+        return function () { active = false; controller.abort(); };
+      }, [query, kind, sort, offset, retry]);
+      return React.createElement("section", {
+        "aria-label": "记忆列表", "data-memory-engine-list": "true",
+        style: { position: "absolute", inset: "76px 0 0", display: "flex", flexDirection: "column", color: "#dbeaf8", font: "14px/1.6 system-ui,sans-serif" },
+      }, React.createElement("div", { style: { width: "min(980px,100%)", margin: "0 auto", padding: "0 24px 16px", display: "flex", gap: "12px", flexWrap: "wrap" } },
+        React.createElement("input", { type: "search", "aria-label": "搜索记忆", placeholder: "搜索正文或标题…", value: search,
+          onChange: function (event) { setSearch(event.target.value); }, style: Object.assign({}, fieldStyle, { flex: "1 1 220px" }) }),
+        React.createElement("select", { "aria-label": "分类筛选", value: kind, style: fieldStyle,
+          onChange: function (event) { setOffset(0); setKind(event.target.value); } },
+          [""].concat(kinds).map(function (value) { return React.createElement("option", { key: value, value: value }, value || "全部分类"); })),
+        React.createElement("select", { "aria-label": "记忆排序", value: sort, style: fieldStyle,
+          onChange: function (event) { setOffset(0); setSort(event.target.value); } },
+          [["recent", "最近"], ["oldest", "最老"], ["fading", "快忘了"], ["degree", "连接最多"]].map(function (entry) { return React.createElement("option", { key: entry[0], value: entry[0] }, entry[1]); }))),
+      React.createElement("div", { "data-memory-engine-list-scroll": "true", style: { flex: 1, minHeight: 0, overflowY: "auto", padding: "0 24px 24px" } },
+        React.createElement("div", { style: { maxWidth: "932px", margin: "0 auto" }, "aria-busy": loading },
+          error ? React.createElement("div", { role: "alert", style: { color: "#ffb8b8", padding: "16px" } }, error,
+            React.createElement("button", { type: "button", style: actionStyle, onClick: function () { setRetry(function (value) { return value + 1; }); } }, "重试")) : null,
+          page.items.map(function (item) {
+            return React.createElement(MemoryRow, { key: item.id, item: item, onChanged: refresh });
+          }),
+          !loading && !error && !page.items.length ? React.createElement("p", { role: "status", style: { padding: "24px", textAlign: "center", color: "#9fb7ce" } }, page.allTotal ? "没有匹配的记忆，试试其他关键词或分类。" : "还没有记忆，可以点右上角 ? 查看导入方法。") : null)),
+          React.createElement("div", { "data-memory-engine-list-total": "true", style: { padding: "14px", textAlign: "center", color: "#9fb7ce", flexShrink: 0, borderTop: "1px solid #263f54" } },
+            "共 " + page.total + " 条 · 已显示 " + page.items.length + " 条",
+            loading ? React.createElement("span", { role: "status" }, " · 正在加载…") : null,
+            page.items.length < page.total ? React.createElement("button", { type: "button", "data-memory-engine-more": "true", disabled: loading || search !== query || !!error,
+              onClick: function () { setOffset(page.items.length); }, style: Object.assign({}, actionStyle, { marginLeft: "12px", opacity: loading ? 0.5 : 1 }) }, "加载更多") : null));
+    }
+
+    function MemorySettings(props) {
+      var statsState = React.useState(null);
+      var stats = statsState[0], setStats = statsState[1];
+      var errorState = React.useState("");
+      var error = errorState[0], setError = errorState[1];
+      var noticeState = React.useState("");
+      var notice = noticeState[0], setNotice = noticeState[1];
+      var retryState = React.useState(0);
+      var retry = retryState[0], setRetry = retryState[1];
+      var busyState = React.useState(false);
+      var busy = busyState[0], setBusy = busyState[1];
+      var confirmState = React.useState(false);
+      var confirming = confirmState[0], setConfirming = confirmState[1];
+      var mutation = React.useRef(null);
+      var download = React.useRef(null);
+      var timer = React.useRef(null);
+      var active = React.useRef(true);
+      React.useEffect(function () {
+        active.current = true;
+        return function () {
+          active.current = false;
+          if (mutation.current) mutation.current.abort();
+          clearTimeout(timer.current);
+          if (download.current) URL.revokeObjectURL(download.current);
+        };
+      }, []);
+      React.useEffect(function () {
+        var controller = new AbortController();
+        setError("");
+        readApi("/memory-engine/api/stats", controller.signal).then(function (result) {
+          if (!controller.signal.aborted) setStats(result);
+        }).catch(function (failure) {
+          if (!controller.signal.aborted) setError("读取设置失败：" + failure.message);
+        });
+        return function () { controller.abort(); };
+      }, [retry]);
+      function manage(clearing) {
+        if (mutation.current) return;
+        var controller = new AbortController();
+        mutation.current = controller; setBusy(true); setError(""); setNotice("");
+        var options = { signal: controller.signal };
+        if (clearing) { options.method = "POST"; options.headers = { "Content-Type": "application/json" }; options.body = JSON.stringify({ confirm: "DELETE" }); }
+        requestApi("/memory-engine/api/" + (clearing ? "clear" : "export"), options).then(function (result) {
+          if (controller.signal.aborted) return;
+          if (clearing) { props.onCleared(); return; }
+          if (download.current) URL.revokeObjectURL(download.current);
+          clearTimeout(timer.current);
+          download.current = URL.createObjectURL(new Blob([JSON.stringify({ ok: true, data: result }, null, 2) + "\n"], { type: "application/json;charset=utf-8" }));
+          var anchor = document.createElement("a");
+          var date = new Date();
+          anchor.href = download.current;
+          anchor.download = "memories-" + date.getFullYear() + "-" + String(date.getMonth() + 1).padStart(2, "0") + "-" + String(date.getDate()).padStart(2, "0") + ".json";
+          document.body.appendChild(anchor); anchor.click(); anchor.remove();
+          timer.current = setTimeout(function () { URL.revokeObjectURL(download.current); download.current = null; timer.current = null; }, 1000);
+          setNotice("已开始下载，共 " + result.total + " 条记忆。");
+        }).catch(function (failure) {
+          if (!controller.signal.aborted) setError((clearing ? "清空失败：" : "导出失败：") + failure.message);
+        }).finally(function () {
+          if (!controller.signal.aborted) { mutation.current = null; setBusy(false); }
+        });
+      }
+      var directory = stats ? stats.file.replace(/[\\/][^\\/]*$/, "") : "";
+      return React.createElement("section", { "aria-label": "记忆设置", "data-memory-engine-settings": "true",
+        style: { position: "absolute", inset: "76px 0 0", overflowY: "auto", padding: "0 24px 32px", color: "#dbeaf8", font: "14px/1.7 system-ui,sans-serif" } },
+        React.createElement("div", { style: { maxWidth: "900px", margin: "0 auto", padding: "28px", border: "1px solid #263f54", borderRadius: "14px", background: "#0b1624" } },
+          React.createElement("h2", { style: { margin: "0 0 20px", fontSize: "20px", color: "#b7e9ff" } }, "数据管理"),
+          stats ? React.createElement(React.Fragment, null,
+            React.createElement("div", { style: { display: "flex", alignItems: "center", flexWrap: "wrap", gap: "12px" } },
+              React.createElement("span", { style: { flex: "1 1 360px", overflowWrap: "anywhere" } }, "数据目录：", React.createElement("code", { "data-memory-engine-directory": "true" }, directory)),
+              React.createElement("button", { type: "button", "data-memory-engine-copy-path": "true", style: actionStyle,
+                onClick: function () {
+                  setNotice(""); setError("");
+                  copyText(directory).then(function () { if (active.current) setNotice("数据目录已复制 ✓"); }, function () { if (active.current) setError("复制路径失败，请手动复制上方目录。"); });
+                } }, "复制路径")),
+            React.createElement("p", { "data-memory-engine-storage-stats": "true", style: { color: "#9fb7ce", margin: "16px 0 24px" } }, "记忆条数：" + stats.total + "　 文件大小：" + (stats.bytes / 1024).toFixed(1) + " KB"))
+            : React.createElement("p", { role: "status" }, error ? "暂时无法读取数据目录。" : "正在读取数据目录…"),
+          error ? React.createElement("div", { role: "alert", style: { color: "#ffb8b8", marginBottom: "16px" } }, error,
+            !stats ? React.createElement("button", { type: "button", style: actionStyle, onClick: function () { setRetry(function (value) { return value + 1; }); } }, "重试") : null) : null,
+          notice ? React.createElement("p", { role: "status", style: { color: "#9fe5c4" } }, notice) : null,
+          React.createElement("div", { style: { padding: "24px 0", borderTop: "1px solid #263f54", borderBottom: "1px solid #263f54" } },
+            React.createElement("button", { type: "button", "data-memory-engine-export": "true", disabled: busy, onClick: function () { manage(false); }, style: actionStyle }, "导出全部记忆（JSON）"),
+            React.createElement("p", { style: { margin: "10px 0 0", fontSize: "12px", color: "#9fb7ce" } }, "下载包含全部原始条目的 JSON 文件。导入已有记忆请使用 memory_import 工具。")),
+          React.createElement("h3", { style: { color: "#ffb8b8", marginTop: "24px" } }, "危险操作"),
+          React.createElement("p", { style: { color: "#9fb7ce" } }, "清空前会自动备份，最近五份操作备份保留在数据目录。"),
+          React.createElement("button", { type: "button", "data-memory-engine-clear": "true", disabled: busy,
+            onClick: function () { setError(""); setNotice(""); setConfirming(true); }, style: Object.assign({}, actionStyle, { color: "#ffb8b8", borderColor: "#8b505c", background: "#341c28" }) }, "清空全部记忆")),
+        confirming ? React.createElement(ConfirmationDialog, { title: "清空全部记忆", message: "这会删除当前记忆库的全部条目。请确认已导出需要保留的内容。", requireDelete: true,
+          submitLabel: "确认清空", busy: busy, error: error, onClose: function () { setConfirming(false); }, onConfirm: function () { manage(true); } }) : null);
+    }
+
     function MemoryButton(props) {
       var settings = props.settings;
       var state = React.useState(false);
@@ -248,6 +545,8 @@ window.__ModuleLoader__.load({
       var selectedState = React.useState(null);
       var selected = selectedState[0];
       var setSelected = selectedState[1];
+      var tabState = React.useState("map");
+      var tab = tabState[0], setTab = tabState[1];
       var renderer = React.useRef(null);
       var selectionVersion = React.useRef(0);
       var pointer = React.useRef(null);
@@ -262,6 +561,7 @@ window.__ModuleLoader__.load({
         dismissed.current = false;
         setGuideOpen(false);
         setSelected(null);
+        setTab("map");
         setOpen(Date.now());
       }
       function closeMap() { setSelected(null); setOpen(false); }
@@ -302,6 +602,7 @@ window.__ModuleLoader__.load({
         function onEscape() { if (guideOpen) closeGuide(); else if (selected) setSelected(null); else closeMap(); }
         function onKey(event) {
           if (event.key !== "Escape") return;
+          if (event.target && event.target.closest && event.target.closest("[data-memory-engine-confirm]")) return;
           event.preventDefault();
           event.stopPropagation();
           if (!event.repeat) onEscape();
@@ -325,12 +626,20 @@ window.__ModuleLoader__.load({
         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 }),
+      }, tab === "map" ? React.createElement(MemoryCanvas, { key: open, rendererRef: renderer, selectionVersion: selectionVersion, onSelect: setSelected })
+        : tab === "memories" ? React.createElement(MemoryList, { onChanged: function () { setRetry(function (value) { return value + 1; }); } })
+          : React.createElement(MemorySettings, { onCleared: function () { openMap(); setGuideOpen(true); } }),
+      tab !== "map" ? React.createElement("strong", { style: { position: "absolute", top: "23px", left: "24px", font: "600 18px system-ui,sans-serif", color: "#b7e9ff" } }, "记忆管理") : null,
       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", {
+      }, React.createElement("div", { role: "tablist", "aria-label": "记忆面板", style: { display: "flex", gap: "4px", marginRight: "8px" } },
+        [["map", "图谱"], ["memories", "记忆"], ["settings", "设置"]].map(function (entry) {
+          return React.createElement("button", { key: entry[0], type: "button", role: "tab", "aria-selected": tab === entry[0], "data-memory-engine-tab": entry[0],
+            onClick: function () { setSelected(null); setTab(entry[0]); },
+            style: Object.assign({}, actionStyle, { background: tab === entry[0] ? "#204762" : "#091422", borderColor: tab === entry[0] ? "#8acded" : "#35536b" }) }, entry[1]);
+        })), React.createElement("button", {
         ref: help, type: "button", onClick: function () { setGuideOpen(true); },
         "aria-label": "查看使用指南", title: "使用指南", style: actionStyle,
       }, "?"), React.createElement("button", {

package/lib/config.js

@@ -8,9 +8,30 @@ export function resolveDiaryDir({ home = defaultHome(), envDir = process.env.QQ_
   return envDir || readConfig(home).diaryDir || '';
 }
 
-export function readUiConfig(home = defaultHome()) {
+export function readUiConfig(home = defaultHome(), options = {}) {
   const config = readConfig(home);
-  return { hideButton: config.hideButton === true, showGuideOnEmpty: config.showGuideOnEmpty !== false };
+  return { hideButton: config.hideButton === true, showGuideOnEmpty: config.showGuideOnEmpty !== false,
+    hasPersona: readPersona(config, options) !== null, personaTitle: config.personaTitle, spinSpeed: config.spinSpeed };
+}
+
+export function readPersona(config, { now = Date.now(), warn = message => console.warn(`[dsh-memory-engine] ${message}`) } = {}) {
+  if (config.personaText?.trim()) return { text: config.personaText, ts: now };
+  if (!config.personaFile?.trim()) return null;
+  let descriptor;
+  try {
+    descriptor = fs.openSync(config.personaFile, 'r');
+    const metadata = fs.fstatSync(descriptor);
+    if (!metadata.isFile()) throw new Error('角色卡路径不是普通文件');
+    const buffer = Buffer.alloc(16003);
+    const length = fs.readSync(descriptor, buffer, 0, buffer.length, 0);
+    const text = Array.from(buffer.subarray(0, length).toString('utf8').replace(/^\uFEFF/u, '')).slice(0, 4000).join('');
+    return text.trim() ? { text, ts: metadata.mtimeMs } : null;
+  } catch (error) {
+    try { warn(`读取角色卡失败，使用原布局：${error.message}`); } catch {}
+    return null;
+  } finally {
+    if (descriptor !== undefined) fs.closeSync(descriptor);
+  }
 }
 
 export function readConfig(home = defaultHome()) {
@@ -18,9 +39,16 @@ export function readConfig(home = defaultHome()) {
   try {
     const value = JSON.parse(fs.readFileSync(file, 'utf8').replace(/^\uFEFF/u, ''));
     if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('配置必须是 JSON 对象');
-    return value;
+    for (const key of ['personaFile', 'personaText', 'personaTitle']) {
+      if (value[key] !== undefined && typeof value[key] !== 'string') throw new Error(`${key} 必须是字符串`);
+    }
+    if (value.personaText !== undefined && Array.from(value.personaText).length > 4000) throw new Error('personaText 最多 4000 字符');
+    if (value.spinSpeed !== undefined && (!Number.isFinite(value.spinSpeed) || value.spinSpeed < 0.05 || value.spinSpeed > 1.5)) {
+      throw new Error('spinSpeed 必须是 0.05～1.5 的数字');
+    }
+    return { ...value, personaTitle: value.personaTitle?.trim() || '角色卡', spinSpeed: value.spinSpeed ?? 0.35 };
   } catch (error) {
-    if (error.code === 'ENOENT') return {};
+    if (error.code === 'ENOENT') return { personaTitle: '角色卡', spinSpeed: 0.35 };
     throw new Error(`无法读取 ${file}：${error.message}`);
   }
 }

package/lib/map.js

@@ -4,16 +4,23 @@ import { randomBytes } from 'node:crypto';
 import { spawn } from 'node:child_process';
 import { pathToFileURL } from 'node:url';
 import { scoreMemories, layoutMemories, renderHtml } from './render/index.mjs';
-import { readConfig } from './config.js';
+import { readConfig, readPersona } from './config.js';
 
-export function computeMapData(store) {
+export function computeMapData(store, { warn } = {}) {
   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 config = readConfig(path.dirname(path.dirname(store.file)));
+  const persona = readPersona(config, { now, warn });
   const scored = scoreMemories(items, now);
-  const nodes = layoutMemories(scored.nodes);
+  const core = persona ? { id: 'persona', text: persona.text, title: config.personaTitle, kind: '人格', heat: 1,
+    ts: persona.ts, isCore: true, retention: 1, degree: 0, emotion: [], ageDays: 0, boosts: 0,
+    pos: { x: 0, y: 0, z: 0 }, radius: 6.5 } : null;
+  const nodes = layoutMemories(core ? [core, ...scored.nodes] : 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,
+    core: core ? { id: core.id, title: core.title, preview: Array.from(core.text).slice(0, 120).join('') + (Array.from(core.text).length > 120 ? '…' : '') } : null,
+    spinSpeed: config.spinSpeed,
     stats: { total: nodes.length, byKind: kinds, forgettingSoon: nodes.filter(node => node.retention < 0.3).length } };
 }