sage-mem 1.8.0 → 1.8.2

package/README.md

@@ -12,7 +12,7 @@
 
 **Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.**
 
-**Current release: `1.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
+**Current release: `1.8.2`** — 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.
@@ -82,7 +82,9 @@ The UI also carries four more capabilities (all of them optional): the memory ma
 
 **Since 1.8.0, memory management is also reachable from the sidebar**: a 「记忆管理」(memory management) icon appears in the sidebar and switches the central panel to this page (with a "back to conversation" control at the top).
 It can be turned off in the settings page under 「记忆管理 → 自动做梦 → 设置」(on by default; applies immediately, no restart);
+**since 1.8.2 the same toggle also lives on the plugin's detail page** (「插件 → sage-mem」card) and applies immediately too;
 **turning it off only removes the sidebar icon — the 「设置 → 记忆管理」 entry always stays**.
+Since 1.8.2 the plugin also ships its own icon (a golden stack of memory cards) instead of the generic square.
 
 The memory management page's file list also has an **Open memory folder** button: it opens the
 memory directory in the system file manager (Explorer / Finder / the Linux file manager) through a

package/README.zh.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.
 
-**当前发布版本：`1.8.0`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
+**当前发布版本：`1.8.2`** —— 顶部 npm 徽章是动态权威。**契约基线：`1.0.0`** —— 第一个稳定版，公开承诺、能力边界与「明确做不到」的清单冻结在
 [契约冻结](https://github.com/gezi-wen/sage-mem/blob/main/docs/1.0.0-contract.md)。
 
 如果它对你有用，给个 Star 是最直接的反馈。
@@ -84,7 +84,9 @@ sage-mem 补上这一层，做法是：**把该记住的事写成一张张卡片
 
 **1.8.0 起，记忆管理还能从侧栏直接进**：侧栏多一个「记忆管理」图标，点它把中央主区切到本页（页顶有「返回会话」）。
 设置页「记忆管理 → 自动做梦 → 设置」里可以关掉这个入口（默认开，立即生效、不用重启）；
+**1.8.2 起，插件详情页也有同一个开关**（「插件 → sage-mem」那张卡），改完立即生效；
 **关掉只影响侧栏图标，「设置 → 记忆管理」这个入口永远保留**。
+从 1.8.2 开始，sage-mem 在插件列表里有了自己的图标（金色记忆卡片），不再是默认的通用方图标。
 
 记忆管理页的「文件列表」头部还有一个「打开记忆文件夹」按钮：用系统文件管理器打开当前记忆目录
 （Windows Explorer / macOS Finder / Linux 文件管理器）。host 侧起一个 detached 进程就返回，不等窗口。

package/lib/client.js

@@ -2231,6 +2231,16 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-page-top{display:flex;align-items:center;}",
 			".smem-page-back{display:inline-flex;align-items:center;gap:5px;border:0;background:transparent;color:var(--dsw-alias-label-secondary);font-family:inherit;font-size:12.5px;line-height:1.4;padding:3px 6px 3px 2px;border-radius:6px;cursor:pointer;}",
 			".smem-page-back:hover{color:var(--dsw-alias-label-primary,#1f2329);background:var(--dsw-alias-bg-layer-2);}",
+			// ── 1.8.2：插件详情页的「侧栏入口」卡片 ──
+			// 融入宿主插件页：标题 13px/600、说明 12px 次要色，圆角与分隔线只用宿主 token。
+			// 不抄设置页的大标题 —— 这一块是插件页里的一张紧凑卡片，不是另一个 settings section。
+			".smem-plugin-card{display:flex;flex-direction:column;gap:8px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:12px 14px;background:var(--dsw-alias-bg-layer-1,#fafbfc);box-sizing:border-box;}",
+			".smem-plugin-card-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}",
+			".smem-plugin-card-title{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary,#1f2430);line-height:1.4;}",
+			".smem-plugin-card-status{font-size:12px;color:var(--dsw-alias-label-secondary,#6b7280);line-height:1.4;}",
+			".smem-plugin-card-check{font-size:12.5px;}",
+			".smem-plugin-card-note{font-size:12px;line-height:1.55;color:var(--dsw-alias-label-secondary,#6b7280);}",
+			".smem-plugin-card-err{font-size:12px;line-height:1.5;color:var(--dsw-alias-state-error-primary,#ef4444);overflow-wrap:anywhere;}",
 			// ── 底部一行仓库链接（引流，不抢视线）──
 			".smem-star{display:flex;align-items:center;justify-content:flex-end;gap:8px;flex-wrap:wrap;font-size:12px;color:var(--dsw-alias-label-tertiary,#8b93a1);padding:2px 2px 0;}",
 			".smem-star-link{color:var(--dsw-alias-brand-primary,#4d76e6);text-decoration:underline;}",
@@ -5131,32 +5141,136 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 		/** 该槽位的清理句柄数组（null = 当前没注册）。 */
 		let sidebarDispose = null;
 
-		/** 侧栏图标：内联 SVG、currentColor、细线 —— 不引外部图片/字体，跟随宿主明暗主题。 */
+		/**
+		 * 侧栏图标：内联 SVG、currentColor、细线 —— 不引外部图片/字体，跟随宿主明暗主题。
+		 *
+		 * 1.8.2 起字形与仓库根的 `icon.png` 同源：**叠层记忆卡片**（后面一张只描边、低透明，
+		 * 前面一张压在左下），不再是「文档三行」。单色而不是品牌金：侧栏图标必须跟随
+		 * 宿主的 currentColor，深色 / 浅色主题下才都可读。
+		 */
 		function SidebarEntryIcon(props) {
 			const edge = typeof props.size === "number" && props.size > 0 ? props.size : 16;
 			return h("svg", {
 				width: edge, height: edge, viewBox: "0 0 16 16", fill: "none",
 				"aria-hidden": "true", focusable: "false",
 			}, [
+				// 后面那张卡：错开、只描边、低透明 —— 表达「一叠记忆」而不是两张孤立的卡。
 				h("rect", {
-					key: "b", x: "2", y: "2.5", width: "12", height: "11", rx: "2.2",
-					stroke: "currentColor", strokeWidth: "1.2",
+					key: "back", x: "4.4", y: "2.2", width: "9.4", height: "9", rx: "1.8",
+					stroke: "currentColor", strokeWidth: "1.2", opacity: "0.45",
 				}),
-				h("path", {
-					key: "l1", d: "M5.2 6.2h5.6",
-					stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round",
+				// 前面那张卡：压在左下，实心描边。
+				h("rect", {
+					key: "front", x: "2.2", y: "4.8", width: "9.4", height: "9", rx: "1.8",
+					stroke: "currentColor", strokeWidth: "1.2",
 				}),
 				h("path", {
-					key: "l2", d: "M5.2 8.4h5.6",
+					key: "l1", d: "M4.7 8.2h4.4",
 					stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round",
 				}),
 				h("path", {
-					key: "l3", d: "M5.2 10.6h3.2",
+					key: "l2", d: "M4.7 10.6h3.1",
 					stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round",
 				}),
 			]);
 		}
 
+		/** 卡片里的错误文案：remote 可能 reject 一个字符串 / 对象 / Error，尽量展开成人话。 */
+		function pluginCardErr(e) {
+			if (!e) return "保存失败（未知原因）";
+			if (e instanceof Error) return e.message || String(e);
+			try {
+				const s = JSON.stringify(e);
+				return s && s !== "{}" ? s.slice(0, 200) : String(e);
+			} catch (_) {
+				return String(e);
+			}
+		}
+
+		/**
+		 * 插件详情页的「侧栏入口」卡片（1.8.2）。
+		 *
+		 * 槽位 `plugins.bundle.config` 是 keyed 槽（key = 包名），宿主在 sage-mem 的插件页里、
+		 * description 与「包含的组件」行之间渲染它，ownerProps 为 `{ view: "summary" | "page" }`：
+		 *   - summary：标题下的一块摘要位 —— 这里返回 null，不在摘要位重复渲染；
+		 *   - page：详情页本体（本卡片自己写设置，所以宿主给的是 page）。
+		 *
+		 * 数据与设置页同一个来源（remote.memory 的 getSettings / setSettings），切换成功后调
+		 * 模块级 `setSidebarEntry`：**立即**增删侧栏图标，不需要刷新 / 重启。
+		 * 勾选态一律由服务端回传的 settings 派生 —— 失败时什么都不改，于是自动回到原值。
+		 */
+		function SidebarEntryConfigCard(props) {
+			const ctx = props && props.ctx;
+			// 必须走 stableRemote：真实宿主里 ctx.get() 每次返回新对象，进依赖数组会无限重跑。
+			const remote = stableRemote(ctx, "remote.memory");
+			const sOn = react.useState(true); const on = sOn[0], setOn = sOn[1];
+			const sBusy = react.useState(false); const busy = sBusy[0], setBusy = sBusy[1];
+			const sErr = react.useState(""); const err = sErr[0], setErr = sErr[1];
+
+			react.useEffect(function () {
+				if (!remote || typeof remote.getSettings !== "function") return undefined;
+				let alive = true;
+				Promise.resolve(remote.getSettings()).then(function (out) {
+					if (!alive) return;
+					const loaded = unwrap(out) || {};
+					// 旧宿主没有 ui 字段 / 值不是布尔 → 保持默认「开」，不弹错、不阻塞界面。
+					if (loaded.ui && typeof loaded.ui.sidebarEntry === "boolean") setOn(loaded.ui.sidebarEntry);
+				}, function () {
+					// 读设置失败也按「开」显示：这里只是插件页的一张卡片，不该因为它报红。
+				});
+				return function () { alive = false; };
+			}, [remote]);
+
+			// summary 位不渲染（hooks 必须在上方无条件调用完再返回，规则与顺序都不变）。
+			if (props && props.view === "summary") return null;
+
+			function toggle(next) {
+				if (busy) return;
+				if (!remote || typeof remote.setSettings !== "function") {
+					setErr("宿主侧还没有 setSettings 接口（插件版本较旧）");
+					return;
+				}
+				setBusy(true); setErr("");
+				Promise.resolve(remote.setSettings({ ui: { sidebarEntry: !!next } })).then(function (out) {
+					setBusy(false);
+					// setSettings 是 { ok, settings, restartRequired } 形状，不要过 unwrap。
+					if (out && out.ok === false) {
+						setErr(out.error || "保存被拒绝");
+						return;
+					}
+					const settings = out && out.settings ? out.settings : null;
+					const applied = settings && settings.ui && typeof settings.ui.sidebarEntry === "boolean"
+						? settings.ui.sidebarEntry
+						: !!next;
+					setOn(applied);
+					// 写盘成功之后才动槽位：设置没落盘时界面不该先变一个样。
+					setSidebarEntry(!!next);
+				}, function (e) {
+					setBusy(false);
+					setErr(pluginCardErr(e));
+				});
+			}
+
+			return h("div", { className: "smem-plugin-card" }, [
+				h("div", { className: "smem-plugin-card-head", key: "h" }, [
+					h("span", { className: "smem-plugin-card-title", key: "t" }, "侧栏入口"),
+					h("span", { className: "smem-plugin-card-status", key: "s" }, on ? "已开启" : "已关闭"),
+				]),
+				h("label", { className: "smem-check smem-plugin-card-check", key: "row" }, [
+					h("input", {
+						type: "checkbox", key: "c",
+						checked: on,
+						disabled: busy,
+						onChange: function (e) { toggle(!!(e.target && e.target.checked)); },
+					}),
+					h("span", { key: "l" }, "在侧栏显示「记忆管理」入口"),
+				]),
+				h("div", { className: "smem-plugin-card-note", key: "n" },
+					"默认开启；改动立即生效，不需要重启。关闭后「设置 → 记忆管理」入口仍然保留。"),
+				err ? h("div", { className: "smem-plugin-card-err", key: "e" }, err) : null,
+			]);
+		}
+
 		/**
 		 * 返回会话：宿主 layout 服务的 `selectPanel(null)` 就是把中央主区还给 Conversation。
 		 * 取不到 layout（旧外壳 / 测试环境）时是**空操作**，不影响页面其它部分。
@@ -5288,6 +5402,29 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 				sidebarEnabled = true;
 			}
 			setSidebarEntry(sidebarEnabled);
+
+			// ── 1.8.2 插件详情页的「侧栏入口」卡片 ──────────────────────────────
+			// `plugins.bundle.config` 是 keyed 槽，key = 本 bundle 的 **package name**（sage-mem）。
+			// 宿主在插件页的 description 与「包含的组件」行之间渲染它；ownerProps 形如
+			// `{ view: "summary" | "page" }`，卡片里自己再判一次（summary 返回 null）。
+			//
+			// ⚠️ 这个槽 0.1.7+ 才有。旧宿主上 inject 会**抛错**，所以必须整段 try/catch ——
+			// 否则一个可选的插件页卡片会把设置页与侧栏入口一起拖垮（整个 client 插件不 apply）。
+			// 放在 apply 最后：即使这里因宿主差异出问题，前面的界面已经挂上去了。
+			try {
+				if (ctx.slots && typeof ctx.slots.inject === "function") {
+					ctx.slots.inject("plugins.bundle.config", function () {
+						return ctx.slots.register({
+							name: "plugins.bundle.config",
+							key: "sage-mem",
+						}, function (props) {
+							return react.createElement(SidebarEntryConfigCard, { ...(props || {}), ctx });
+						});
+					});
+				}
+			} catch (e) {
+				// 旧宿主没有这个槽 / 不接受注册：静默跳过，绝不影响其余界面。
+			}
 		}
 
 		exports.apply = apply;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "sage-mem",
   "description": "Cross-session memory for DeepSeek Harness — plain markdown files, no database, no worker.",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "type": "module",
   "main": "lib/index.js",
+  "icon": "./icon.png",
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
@@ -13,7 +14,8 @@
   "files": [
     "lib/",
     "cordis.patch.yml",
-    "NOTICE"
+    "NOTICE",
+    "icon.png"
   ],
   "scripts": {
     "test": "node test/run.mjs",