sage-mem 2.7.1 → 2.8.0

package/README.en.md

@@ -12,7 +12,7 @@
 
 **Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.**
 
-**Current release: `2.7.1`** — the npm badge above is the dynamic source of truth. **Contract baseline: `1.0.0`** — the first stable release, whose public commitments, the capability boundaries and the list of things it explicitly cannot do are frozen in the
+**Current release: `2.8.0`** — the npm badge above is the dynamic source of truth. **Contract baseline: `1.0.0`** — the first stable release, whose public commitments, the capability boundaries and the list of things it explicitly cannot do are frozen in the
 [frozen contract](https://github.com/gezi-wen/sage-mem/blob/main/docs/1.0.0-contract.md).
 
 If it is useful to you, a Star is the most direct feedback.

package/README.md

@@ -14,7 +14,7 @@
 
 > File-based cross-session memory for DeepSeek Harness — every memory is a plain markdown file you can open, edit and delete. No database, no worker, no port.
 
-**当前发布版本：`2.7.1`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
+**当前发布版本：`2.8.0`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
 [契约冻结](https://github.com/gezi-wen/sage-mem/blob/main/docs/1.0.0-contract.md)。
 
 如果它对你有用，给个 Star 是最直接的反馈。

package/lib/client.js

@@ -2679,6 +2679,8 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-autodream-note{font-size:11.5px;color:var(--dsw-alias-label-secondary);line-height:1.5;}",
 			// 2.7.1（Q04）：上限设置的诊断清单 —— 逐条列宿主的原话，缩进浅一点、行距紧一点。
 			".smem-diag-list{margin:4px 0 4px 16px;padding:0;font-size:11.5px;line-height:1.6;color:var(--dsw-alias-label-secondary);}",
+			// 2.8.0（子槽）：第三方向 settings.memory.starmap 注入的视图挂在这里，空的时候不占位置。
+			".smem-extra-slot{margin-top:14px;padding-top:12px;border-top:0.5px solid var(--dsw-alias-border-l2);}",
 			".smem-autodream-list{display:flex;flex-direction:column;gap:6px;}",
 			".smem-report{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 9px;font-size:12px;cursor:pointer;background:transparent;color:inherit;text-align:left;font-family:inherit;}",
 			".smem-report:hover{border-color:var(--dsw-alias-border-l2);}",
@@ -4268,6 +4270,7 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			"entry.sidebarUnsupported": "当前宿主不支持侧栏入口。",
 			"entry.degraded": "当前宿主不支持侧栏入口，已临时按「只显示设置页」显示。",
 			"entry.legacyHost": "宿主模块还是旧版本，重启 DSH 后可选「只显示侧栏」。",
+			"entry.sidebarHidesSlot": "选这一档后，第三方通过「记忆星图」子槽注入的视图也会一起藏掉 —— 那一块挂在设置页上。",
 			"entry.notice.saved": "界面入口已更新。",
 			"entry.err.noSetSettings": "宿主侧还没有 setSettings 接口（插件版本较旧）",
 			"entry.err.saveFailed": "保存失败（未知原因）",
@@ -4777,6 +4780,7 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			"entry.sidebarUnsupported": "This host does not support the sidebar entry.",
 			"entry.degraded": "The sidebar entry is unavailable on this host, so the Settings entry is shown instead.",
 			"entry.legacyHost": "The host module is still the old version; restart DSH to choose Sidebar only.",
+			"entry.sidebarHidesSlot": "With this mode, views that third-party plugins inject into the “memory starmap” sub-slot disappear too — they live on the Settings page.",
 			"entry.notice.saved": "Interface entries updated.",
 			"entry.err.noSetSettings": "The host has no setSettings API yet (older plugin version)",
 			"entry.err.saveFailed": "Save failed (unknown reason)",
@@ -6054,6 +6058,12 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 						? h("div", { className: "smem-autodream-note smem-ad-warn", key: "deg" },
 							t(entryApiModern === false ? "entry.legacyHost" : "entry.degraded"))
 						: null,
+					// 2.8.0：子槽接上渲染之后，「只显示侧栏」会连带把别人注入进来的视图一起藏掉
+					// （设置页 section 一注销，挂在它下面的 `settings.memory.starmap` 就没了）。
+					// 这不是 bug，但选这一档的人得先知道 —— 所以只在选中的时候写一句。
+					entryModeValue === "sidebar" && !entryIsDegraded
+						? h("div", { className: "smem-autodream-note", key: "slotloss" }, t("entry.sidebarHidesSlot"))
+						: null,
 					entryErr ? h("div", { className: "smem-autodream-note smem-ad-warn", key: "err" }, entryErr) : null,
 				]),
 				// 自动归档那一段（三档策略 + 三个阈值）**已挪到「自动归档」页签**（v0.9.9）：
@@ -6697,6 +6707,30 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			]);
 		}
 
+		/**
+		 * 渲染 `settings.memory.starmap` 子槽（2.8.0）。
+		 *
+		 * 1.8.0 起这个子槽就**只声明不渲染**（`Section` 从没调过 `renderSlot`）：
+		 * 第三方按契约往里面注入视图，一个像素都不会出现。接上之后：
+		 *   - `renderSlot` 是宿主经 props 传进来的（声明了 children 才有），旧外壳可能没有 → 判类型；
+		 *   - 返回 null / false 表示没有占用者 —— 此时**不占版面**（空 div 也会破坏间距）；
+		 *   - 出任何异常都吞掉：这是个可选面，绝不能让第三方把整个设置页拖垮。
+		 * ⚠️ 连带后果（2.7.0 的入口三选一带来的）：「只显示侧栏」会把设置页 section 注销，
+		 * 于是注入到这里的内容也跟着消失 —— 所以那一档的文案里点明了一句（`entry.sidebarHidesSlot`）。
+		 */
+		function renderMemoryExtraSlot(props) {
+			if (!props || typeof props.renderSlot !== "function") return null;
+			try {
+				// owner 传 `{}`：官方对 root scope 的子槽就是这么调的（`renderSlot("shell.overlay", {})`、
+				// `renderSlot("main", {}, …)`）—— 少传一个参数在对 scope 做检查的宿主上可能直接抛。
+				const node = props.renderSlot("settings.memory.starmap", {});
+				if (node === null || node === undefined || node === false) return null;
+				return h("div", { className: "smem-extra-slot", key: "extra-slot" }, node);
+			} catch (e) {
+				return null;
+			}
+		}
+
 		function Section(props) {
 			// 走 stableRemote：真实宿主里 `ctx.get()` 每次返回新对象（issue #3 的成因）。
 			// 这个面板的 effect 依赖是 `[]`、暂时不会爆，但引用稳定是**所有**面板的共同前提。
@@ -8159,6 +8193,9 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 							h(AuditPanel, { key: "audit", report: audit, busy: auditBusy, onRun: runAudit, standalone: true }),
 						])
 					: h("div", { className: "smem-view", key: "files" }, filesView),
+				// 2.8.0：第三方注入的视图（`settings.memory.starmap` 子槽）。没有占用者时是 null，
+				// 一个 div 都不出 —— 所以默认安装下界面与 2.7.0 逐像素相同。
+				renderMemoryExtraSlot(props),
 				// 2.6.0：复制成功的回执铺在视口下方中央（`position:fixed`，不吃点击，10s 自收，
 				// 也能自己点 × 关）。渲染在 `.smem-root` 直属层 —— 别塞进带进场动画的
 				// `.smem-view`（那个祖先有 transform，`fixed` 会被改写定位）。
@@ -8516,9 +8553,10 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 						order: 20,
 						label: function () { return t("section.label"); },
 						// 声明「记忆星图」子槽（沿用 1.8.0 的契约）：sage-starmap 之类的
-						// 第三方插件向它注入视图。⚠️ 现状：Section 还没有调用 renderSlot，
-						// 所以这个子槽目前只声明、不渲染（2.7.0 未改；渲染它是独立事项）。
-						// 保留声明是为了不破坏第三方插件的注入面。
+						// 第三方插件向它注入视图。2.8.0 起 `Section` 真的调 `renderSlot` 了
+						// （之前只声明、不渲染 —— 注进来的东西一个像素都不出现）。
+						// ⚠️ 连带后果：注销这个 section 时子槽跟着没（「只显示侧栏」那一档），
+						// 界面文案里已点明（`entry.sidebarHidesSlot`）。
 						children: { "settings.memory.starmap": { kind: "list", scope: "root" } },
 					}, function (props) {
 						return react.createElement(Section, { ...props, ctx: ctx });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sage-mem",
   "description": "Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.",
-  "version": "2.7.1",
+  "version": "2.8.0",
   "type": "module",
   "main": "lib/index.js",
   "icon": "./icon.png",