sage-mem 1.7.2 → 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.7.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
+**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.
@@ -80,6 +80,12 @@ Most memory schemes take the "SQLite + a long-running worker" route: once memori
 
 The UI also carries four more capabilities (all of them optional): the memory management page, type and tag filtering, the memory star map, and audit & archiving.
 
+**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
 detached host-side process and returns without waiting for the window.

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.7.2`** —— 顶部 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 是最直接的反馈。
@@ -82,6 +82,12 @@ 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

@@ -1772,6 +1772,9 @@ const StarmapRuntime = (function (require, _react) {
 					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
+					// 1.8.0：结果里多了 `ui.sidebarEntry`（侧栏入口开关）。客户端这份 codec 是
+					// **顶层严格、内部宽松**的 objCodec —— host 加字段不需要改这里（与 audit /
+					// autodream 那批同一套理由）；host 侧真正的形状约束在 typert.host.js 的 zod schema。
 					id: "sage-mem#memory/getSettings",
 					service: "memory",
 					namespace: "memory",
@@ -1782,6 +1785,8 @@ const StarmapRuntime = (function (require, _react) {
 					sourceLocation: { "file": "lib/index.js", "line": 1, "column": 1 },
 				},
 				{
+					// 1.8.0：patch 可带 `{ ui: { sidebarEntry: boolean } }`。objCodec 只保证顶层是对象，
+					// 字段级严格校验在 host 的 setSettings（非布尔 / 未知键都回 {ok:false}）。
 					id: "sage-mem#memory/setSettings",
 					service: "memory",
 					namespace: "memory",
@@ -2219,6 +2224,23 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-tabs-sep{width:1px;align-self:stretch;margin:6px 2px;background:var(--dsw-alias-border-l2);}",
 			// 窄窗口（≤420px）：头部带与筛选条各让一行，卡片动作允许换行、分隔符隐藏。
 			"@media (max-width:420px){.smem-root{gap:10px;}.smem-head{gap:6px;}.smem-head-actions{flex-wrap:wrap;}.smem-card-title{min-width:0;word-break:break-word;}.smem-actions{flex-wrap:wrap;}.smem-actions-sep{display:none;}.smem-num{width:56px;}.smem-search{min-width:100px;}}",
+			// ── 1.8.0：侧栏入口（设置开关 + 中央主区整页）──
+			".smem-check{display:flex;align-items:center;gap:7px;font-size:12.5px;cursor:pointer;user-select:none;}",
+			".smem-check input{margin:0;cursor:pointer;accent-color:var(--dsw-alias-brand-primary,#4d76e6);}",
+			".smem-page{display:flex;flex-direction:column;gap:10px;padding:14px 16px 18px;box-sizing:border-box;min-height:0;overflow:auto;}",
+			".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;}",
@@ -3086,6 +3108,9 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			const sLimitsDraft = react.useState(null); const limitsDraft = sLimitsDraft[0], setLimitsDraft = sLimitsDraft[1];
 			const sSaveBusy = react.useState(false); const saveBusy = sSaveBusy[0], setSaveBusy = sSaveBusy[1];
 			const sReservedNew = react.useState(""); const reservedNew = sReservedNew[0], setReservedNew = sReservedNew[1];
+			// ── 1.8.0 侧栏入口开关（客户端行为：改完立刻生效，不需要重启）──
+			const sSidebarBusy = react.useState(false); const sidebarBusy = sSidebarBusy[0], setSidebarBusy = sSidebarBusy[1];
+			const sSidebarErr = react.useState(""); const sidebarErr = sSidebarErr[0], setSidebarErr = sSidebarErr[1];
 
 			// 派生量放在 effect 之前：下面几个 effect 的依赖数组要在渲染期就能取到值。
 			const c = cfg || {};
@@ -3100,6 +3125,8 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			const fixedReserved = ((memSet && memSet.reserved) || []).filter(function (n) {
 				return extraLower.indexOf(String(n).toLowerCase()) < 0;
 			});
+			// 默认开：宿主没回 ui 字段（旧版本）或值不是布尔，都按「开」显示。
+			const sidebarEntryOn = !(memSet && memSet.ui && memSet.ui.sidebarEntry === false);
 
 			react.useEffect(function () {
 				if (!remote) { setErr("remote.autodream 不可用 —— 插件的 宿主侧可能没加载成功，看 DSH 启动日志"); return undefined; }
@@ -3210,6 +3237,31 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 				}, function (e) { setSaveBusy(false); setErr(detail(e)); });
 			}
 
+			/**
+			 * 侧栏入口开关（1.8.0）。
+			 *
+			 * 顺序是「先写设置、成功后再动槽位」：设置没落盘就不该让界面先变一个样。
+			 * 失败只报错、不改任何东西 —— checkbox 的勾选状态由 memSet 派生，于是自动回到原值。
+			 * 成功后调 `setSidebarEntry`：**立即**增删侧栏槽位，不刷新、不重启。
+			 */
+			function saveSidebarEntry(next) {
+				if (!memRemote || typeof memRemote.setSettings !== "function") {
+					setSidebarErr("宿主侧还没有 setSettings 接口（插件版本较旧）");
+					return;
+				}
+				if (sidebarBusy) return;
+				setSidebarBusy(true); setSidebarErr(""); setNotice("");
+				Promise.resolve(memRemote.setSettings({ ui: { sidebarEntry: !!next } })).then(function (out) {
+					setSidebarBusy(false);
+					// 与 saveLimits 同款：setSettings 是 {ok, settings, restartRequired} 形状，不要过 unwrap。
+					if (out && out.ok === false) { setSidebarErr(out.error || "保存被拒绝"); return; }
+					if (out && out.settings) setMemSet(out.settings);
+					else loadMemSettings();
+					setSidebarEntry(!!next);
+					setNotice(!!next ? "侧栏入口已开启（立即生效）" : "侧栏入口已关闭（设置页入口仍在）");
+				}, function (e) { setSidebarBusy(false); setSidebarErr(detail(e)); });
+			}
+
 			/**
 			 * 保存保留名名单（用户声明的那部分）。
 			 *
@@ -3481,6 +3533,26 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 				]),
 				]) : null,
 				segOf === "settings" ? h("div", { key: "seg-set" }, [
+				// 1.8.0：侧栏入口开关。默认开；关掉只影响侧栏那个图标，
+				// 「设置 → 记忆管理」这个入口永远在（它注册在 80-apply，和这个开关无关）。
+				h("div", { className: "smem-autodream-sec", key: "sidebar-entry" }, [
+					h("div", { className: "smem-autodream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "侧栏入口"),
+						h("span", { className: "smem-status", key: "s" }, sidebarEntryOn ? "已开启" : "已关闭"),
+					]),
+					h("div", { className: "smem-autodream-note", key: "n" },
+						"在 DSH 侧栏显示「记忆管理」图标，点它把中央主区切到本页。默认开启；关闭后「设置 → 记忆管理」这个入口仍然保留。改动立即生效，不需要重启。"),
+					h("label", { className: "smem-check", key: "row" }, [
+						h("input", {
+							type: "checkbox", key: "c",
+							checked: sidebarEntryOn,
+							disabled: sidebarBusy,
+							onChange: function (e) { saveSidebarEntry(!!(e.target && e.target.checked)); },
+						}),
+						h("span", { key: "l" }, "在侧栏显示「记忆管理」入口"),
+					]),
+					sidebarErr ? h("div", { className: "smem-autodream-note smem-ad-warn", key: "err" }, sidebarErr) : null,
+				]),
 				// 自动归档那一段（三档策略 + 三个阈值）**已挪到「自动归档」页签**（v0.9.9）：
 				// 归档是确定性规则、不调模型，和这一页的「让模型整理」不是一件事；
 				// 同一件事只在一处设定，这里不再重复摆一份。
@@ -5057,11 +5129,237 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			]);
 		}
 
+		// ── 侧栏入口（1.8.0）─────────────────────────────────────────────
+		// 宿主侧栏的官方契约是两个槽位：
+		//   `sidebar.panellist`（list 槽）：只画一个 size 见方的图标，行标题由宿主从 label 投影；
+		//   `main`（keyed 槽）：key **必须**与侧栏条目 id 相同，选中缺失 key 宿主会直接抛错。
+		// 开关（settings.ui.sidebarEntry）是**客户端行为**：这里持有两个 inject 的清理句柄，
+		// 关 → 调清理器（宿主会连带注销 register 进去的条目），开 → 重新 inject/register。
+		const SIDEBAR_ENTRY_ID = "sage-mem";
+		/** 插件 ctx（80-apply 在 apply 时挂进来）；setSidebarEntry 之后要拿它重注册。 */
+		let sidebarCtx = null;
+		/** 该槽位的清理句柄数组（null = 当前没注册）。 */
+		let sidebarDispose = null;
+
+		/**
+		 * 侧栏图标：内联 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: "back", x: "4.4", y: "2.2", width: "9.4", height: "9", rx: "1.8",
+					stroke: "currentColor", strokeWidth: "1.2", opacity: "0.45",
+				}),
+				// 前面那张卡：压在左下，实心描边。
+				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: "l1", d: "M4.7 8.2h4.4",
+					stroke: "currentColor", strokeWidth: "1.2", strokeLinecap: "round",
+				}),
+				h("path", {
+					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（旧外壳 / 测试环境）时是**空操作**，不影响页面其它部分。
+		 */
+		function backToConversation() {
+			try {
+				const layout = sidebarCtx && typeof sidebarCtx.get === "function" ? sidebarCtx.get("layout") : null;
+				if (layout && typeof layout.selectPanel === "function") layout.selectPanel(null);
+			} catch (e) {
+				// 返回按钮不能因为宿主差异把整页搞崩
+			}
+		}
+
+		/** 中央主区的整页：页顶「返回会话」+ 复用设置页那份 Section。 */
+		function MemoryPanelPage(props) {
+			const onBack = typeof props.backToConversation === "function" ? props.backToConversation : backToConversation;
+			return h("div", { className: "smem-page" }, [
+				h("div", { className: "smem-page-top", key: "top" }, [
+					h("button", {
+						type: "button", className: "smem-page-back", key: "back",
+						title: "返回会话", onClick: onBack,
+					}, [
+						h("svg", {
+							key: "i", width: 14, height: 14, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true",
+						}, h("path", {
+							d: "M10 3.5 5.5 8l4.5 4.5", stroke: "currentColor", strokeWidth: "1.6",
+							strokeLinecap: "round", strokeLinejoin: "round",
+						})),
+						h("span", { key: "l" }, "返回会话"),
+					]),
+				]),
+				h(Section, { key: "sec", ...props, ctx: sidebarCtx }),
+			]);
+		}
+
+		/** 注册两个槽位（幂等：已经注册就什么都不做）。 */
+		function registerSidebarEntry() {
+			if (sidebarDispose !== null || !sidebarCtx) return true;
+			const ctx = sidebarCtx;
+			const handles = [];
+			// 侧栏 list 槽：只给图标与 label，按钮由宿主自己画。
+			handles.push(ctx.slots.inject("sidebar.panellist", function () {
+				return ctx.slots.register({
+					name: "sidebar.panellist",
+					id: SIDEBAR_ENTRY_ID,
+					order: 20,
+					label: "记忆管理",
+				}, SidebarEntryIcon);
+			}));
+			// 中央主区 keyed 槽：key 与侧栏 id 相同；inject 面把「返回会话」交给页面组件。
+			handles.push(ctx.slots.inject("main", function () {
+				return ctx.slots.register({
+					name: "main",
+					key: SIDEBAR_ENTRY_ID,
+					inject: function () { return { backToConversation: backToConversation }; },
+				}, MemoryPanelPage);
+			}));
+			sidebarDispose = handles;
+			return true;
+		}
+
+		/**
+		 * 开 / 关侧栏入口（立即生效，不改设置文件 —— 写盘由设置页负责）。
+		 *
+		 * 关闭顺序是**反序**：先摘 main、再摘 sidebar，避免宿主在「侧栏条目还在、main 已没了」
+		 * 的中间态里去解析一个不存在的 key（官方契约里那会抛错）。
+		 */
+		function setSidebarEntry(enabled) {
+			if (enabled) return registerSidebarEntry();
+			const handles = sidebarDispose;
+			sidebarDispose = null;
+			if (Array.isArray(handles)) {
+				for (let i = handles.length - 1; i >= 0; i--) {
+					const dispose = handles[i];
+					if (typeof dispose !== "function") continue;
+					try { dispose(); } catch (e) { /* 注销失败也不该把开关卡死在「已注册」状态 */ }
+				}
+			}
+			return true;
+		}
+		// ⚠️ 不把 `layout` 写进 inject：它是**可选**依赖（官方 inspect：optional access =
+		// `ctx.get("layout")` + 判空；hardDependency 才是 inject）。写进 inject 会让旧外壳
+		// 缺这个服务时整个 client 插件不 apply —— 连带丢掉设置页。返回会话优先用宿主给的
+		// `props.backToConversation`，layout 只是兜底。
 		const inject = ["slots", "remote"];
 
 		/**
 		 * Client 插件：$mount strict remote contribution（第三方 remote 不在
-		 * 宿主的固定 remote 清单里，必须自己挂），再注册设置页签。
+		 * 宿主的固定 remote 清单里，必须自己挂），再注册设置页签 / 侧栏入口。
 		 */
 		async function apply(ctx) {
 			await ctx.remote.$mount(TYPERT_REMOTE);
@@ -5089,6 +5387,44 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 					(props) => react.createElement(Section, { ...props, ctx }),
 				),
 			);
+			// ── 1.8.0 侧栏入口：先记住 ctx，再读一次设置决定注不注册 ──────────────
+			// 设置页 section **永远**保留（关闭侧栏入口只是少一个入口，不是少一个设置页）。
+			// 读失败 / 旧宿主没有 ui 字段 / 值坏掉 → 一律按「开」处理，绝不阻塞界面。
+			sidebarCtx = ctx;
+			let sidebarEnabled = true;
+			try {
+				const mem = typeof ctx.get === "function" ? ctx.get("remote.memory") : null;
+				if (mem && typeof mem.getSettings === "function") {
+					const loaded = unwrap(await mem.getSettings()) || {};
+					if (loaded.ui && loaded.ui.sidebarEntry === false) sidebarEnabled = false;
+				}
+			} catch (e) {
+				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/lib/index.js

@@ -32,7 +32,7 @@ import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
 import { mkdir, unlink, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { checkUpdate as checkUpdateImpl } from './update.js'
-import { autodreamConfigSnapshot, clampInt, MAX_RAW_BYTES, pendingLimits, rawName, readReservedFile, readSettingsFile, RESERVED_FILE, SETTINGS_FILE } from './settings.js'
+import { autodreamConfigSnapshot, clampInt, MAX_RAW_BYTES, parseUiPatch, pendingLimits, pendingUi, rawName, readReservedFile, readSettingsFile, RESERVED_FILE, SETTINGS_FILE } from './settings.js'
 import { createRecallInjector, createSessionInjectState, readRecallDebug } from './recall/index.js'
 import { mountAutodream, mountMemoryTools, mountObserve, mountWriteGate } from './assembly/index.js'
 
@@ -451,6 +451,8 @@ export class MemoryGateway extends TypertRemoteService {
       limits,
       pendingLimits: pending,
       restartRequired,
+      // 1.8.0：客户端行为（侧栏入口开关）。**不参与** restartRequired —— 改完立刻生效。
+      ui: pendingUi(file),
       // 生效的保护名单（含两个内置名）+ 用户声明的那部分原文（面板编辑的是后者）
       reserved: [...new Set([INDEX_FILE_KEY, SESSION_LOG_KEY, ...reservedExtra.map((s) => s.toLowerCase())])],
       reservedExtra,
@@ -495,19 +497,31 @@ export class MemoryGateway extends TypertRemoteService {
       }
       nextReserved = cleaned
     }
-    if (!limitsPatch && nextReserved === null) return { ok: false, error: 'sage-mem: empty patch' }
+    // 1.8.0：ui 与 limits / reserved 同一套「先全验、后一起写」—— 任何一个非法，整份 patch 不落盘。
+    const uiCheck = parseUiPatch(p.ui)
+    if (!uiCheck.ok) return { ok: false, error: uiCheck.error }
+    const uiPatch = uiCheck.patch
+    if (!limitsPatch && nextReserved === null && uiPatch === null) return { ok: false, error: 'sage-mem: empty patch' }
 
     await mkdir(STATE_ROOT, { recursive: true })
-    if (limitsPatch) {
+    if (limitsPatch || uiPatch !== null) {
       const current = await readSettingsFile()
-      const merged = { ...(current?.limits ?? {}), ...nextLimits }
-      await writeFileAtomic(SETTINGS_FILE, JSON.stringify({ limits: merged, updatedAt: Date.now() }, null, 2))
+      const mergedLimits = { ...(current?.limits ?? {}), ...nextLimits }
+      // ui 只覆盖这次给出的键；没给就沿用文件里的有效值（坏值 / 缺失一律按默认「开」）
+      const mergedUi = { ...pendingUi(current), ...(uiPatch ?? {}) }
+      await writeFileAtomic(SETTINGS_FILE, JSON.stringify({ limits: mergedLimits, ui: mergedUi, updatedAt: Date.now() }, null, 2))
     }
     if (nextReserved !== null) {
       await writeFileAtomic(RESERVED_FILE, `${JSON.stringify(nextReserved, null, 2)}\n`)
     }
-    // 写盘即提示重启：这些值在模块加载时就固化了，不重启它一定还没生效。
-    return { ok: true, settings: await this.getSettings(), restartRequired: true }
+    // 上限 / 保护名单在模块加载时就固化了，写盘即提示重启；ui 是**客户端行为**，改完立刻生效，
+    // 所以只有前两者会强制 true，纯 ui 补丁照实回传（通常就是 false）。
+    const settings = await this.getSettings()
+    return {
+      ok: true,
+      settings,
+      restartRequired: limitsPatch || nextReserved !== null ? true : settings.restartRequired,
+    }
   }
 
   /**

package/lib/settings.js

@@ -20,6 +20,39 @@ export const RESERVED_FILE = join(STATE_ROOT, 'reserved.json')
 /** 整数收敛（与 config.js 的 envInt 同一套语义）：非有限数回落默认，越界夹到边界。 */
 export const clampInt = (v, spec) => (Number.isFinite(v) ? Math.max(spec.lo, Math.min(spec.hi, Math.round(v))) : spec.dflt)
 
+/**
+ * 面板 UI 设置（1.8.0）。
+ *
+ * ⚠️ 与 `limits` **不是一类**：上限在模块加载时就固化进常量，改完必须重启；
+ * `ui.sidebarEntry` 是**客户端行为** —— 界面读到值就决定注不注册侧栏槽位，
+ * 改完立刻生效。所以它不进 `restartRequired` 的计算。
+ */
+export const DEFAULT_UI = Object.freeze({ sidebarEntry: true })
+
+/** 读出 `ui` 的**有效值**：文件里没有 / 坏对象 / 不是布尔 → 一律回落默认（开）。 */
+export function pendingUi(fileObj) {
+  const saved = fileObj?.ui && typeof fileObj.ui === 'object' && !Array.isArray(fileObj.ui) ? fileObj.ui : {}
+  return { sidebarEntry: typeof saved.sidebarEntry === 'boolean' ? saved.sidebarEntry : DEFAULT_UI.sidebarEntry }
+}
+
+/**
+ * 校验 `setSettings({ ui })` 的那一段：**只认 `sidebarEntry` 一个键**，值必须是布尔。
+ *
+ * 返回 `{ ok:true, patch }`（patch 为 null = 调用方没给 ui，或给的是空对象）；`{ ok:false, error }`。
+ * 与 limits 同一套严格语义：绝不静默丢掉不认识的键。
+ */
+export function parseUiPatch(ui) {
+  if (ui === undefined) return { ok: true, patch: null }
+  if (!ui || typeof ui !== 'object' || Array.isArray(ui)) return { ok: false, error: 'sage-mem: ui must be an object' }
+  const patch = {}
+  for (const [key, value] of Object.entries(ui)) {
+    if (key !== 'sidebarEntry') return { ok: false, error: `sage-mem: unknown ui setting: ${key}` }
+    if (typeof value !== 'boolean') return { ok: false, error: `sage-mem: ui.sidebarEntry must be a boolean, got ${typeof value}` }
+    patch.sidebarEntry = value
+  }
+  return { ok: true, patch: Object.keys(patch).length ? patch : null }
+}
+
 /** 读 `<状态根>/settings.json`；缺失、坏 JSON、不是对象都当「没设置」。 */
 export async function readSettingsFile() {
   try {

package/lib/typert.host.js

@@ -222,10 +222,15 @@ const settingsLimitsSchema = z.object({
 	'maxSessionBytes': z.number().readonly(),
 	'staleDays': z.number().readonly(),
 }).readonly()
+// 1.8.0：面板 UI 设置。`sidebarEntry` 是**客户端行为**（改完立刻生效），不进 restartRequired。
+const settingsUiSchema = z.object({
+	'sidebarEntry': z.boolean().readonly(),
+}).readonly()
 const settingsSchema = z.object({
 	'limits': settingsLimitsSchema,
 	'pendingLimits': settingsLimitsSchema,
 	'restartRequired': z.boolean().readonly(),
+	'ui': settingsUiSchema,
 	'reserved': z.array(z.string()).readonly(),
 	'reservedExtra': z.array(z.string()).readonly(),
 }).readonly()
@@ -237,6 +242,9 @@ const settingsPatchSchema = z.object({
 		'maxSessionBytes': z.number().optional(),
 		'staleDays': z.number().optional(),
 	}).readonly().optional(),
+	'ui': z.object({
+		'sidebarEntry': z.boolean().optional(),
+	}).readonly().optional(),
 	'reserved': z.array(z.string()).optional(),
 }).readonly()
 // 成功回 { ok, settings, restartRequired }，失败回 { ok:false, error } —— 两条分支并集。

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.7.2",
+  "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",