sage-mem 1.3.0 → 1.5.0

package/README.md

@@ -499,6 +499,7 @@ Module boundaries (since 1.2.0):
 - `lib/assembly/` — the four mounts: autodream / retrieval tools / observation / write gate
 - `lib/memory/` — pure memory-layer functions and file operations; `lib/autodream/` — the autodream engine
 - `lib/shared/` — zero-dependency cross-layer rules: file-name rule / local timestamps / the two size limits (**exactly one copy each**; `test/duplication-test.mjs` turns red otherwise)
+- UI side: `client/*.js` is split per screen (`05-shared.js` holds the cross-screen primitives and type tables); `npm run build:client` concatenates them into `lib/client.js`
 - Dependency direction: `memory` never imports `autodream`, `recall` depends only on `memory`, `assembly` never imports the composition root (`test/structure-test.mjs` turns red if that changes)
 
 ## Contributing

package/README.zh.md

@@ -503,6 +503,7 @@ memory/ 目录（markdown 文件，4 类）
 - `lib/assembly/` —— 四块挂载：autodream / 检索工具 / 观测 / 写入门
 - `lib/memory/` —— 记忆层的纯函数与文件操作；`lib/autodream/` —— 自动做梦引擎
 - `lib/shared/` —— 跨层零依赖的小判据：文件名规则 / 本地时间戳 / 两个体积上限（**只许一份**，`test/duplication-test.mjs` 会红）
+- 界面侧：`client/*.js` 按屏分片（`05-shared.js` 放跨屏小基元与类型词表），`npm run build:client` 拼成 `lib/client.js`
 - 依赖方向：`memory` 不认识 `autodream`，`recall` 只依赖 `memory`，`assembly` 不反向依赖组合根（`test/structure-test.mjs` 会红）
 
 ## 参与开发

package/lib/client.js

@@ -22,13 +22,68 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		const h = react.createElement;
 
+		// ── 共享基元（1.4.0）：跨屏复用的小东西只有这一份 ─────────────
+		// 这些名字原本在 10 / 20 / 50 三个分片各写一遍（isStr/isNum/strSchema/parseSchema/
+		// unwrap/fmtSize/hexA，以及类型词表 3 份）。分片共享同一个 factory 作用域，
+		// 所以收敛到本片之后，后面的分片直接用、不再各写一份。
+		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
+		const isBool = (v) => { if (typeof v !== "boolean") throw new Error("expected boolean"); };
+		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
+		function parseSchema(shape) {
+			return {
+				parse(value) {
+					if (value === null || typeof value !== "object") throw new Error("sage-mem: invalid payload");
+					for (const [key, check] of Object.entries(shape)) {
+						if (!(key in value)) throw new Error("sage-mem: missing field " + key);
+						check(value[key]);
+					}
+					return value;
+				},
+			};
+		}
+		const strSchema = { parse(v) { isStr(v); return v; } };
+
+		/** 拆 typert remote 的 {ok, value} 信封。 */
+		function unwrap(result) {
+			return result && result.ok ? result.value : result;
+		}
+
+		/** 字节数 → 人话。三个档位对记忆文件足够（单条上限 512 KB）。 */
+		function fmtSize(n) {
+			if (n < 1024) return n + " B";
+			if (n < 1024 * 1024) return (n / 1024).toFixed(1) + " KB";
+			return (n / 1024 / 1024).toFixed(1) + " MB";
+		}
+
+		/** #rrggbb + alpha → rgba()。星图的辉光/底盘用。 */
+		function hexA(hex, a) {
+			const n = parseInt(hex.slice(1), 16);
+			return "rgba(" + ((n >> 16) & 255) + "," + ((n >> 8) & 255) + "," + (n & 255) + "," + a.toFixed(3) + ")";
+		}
+
+		// ── 类型词表（唯一定义） ──
+		// 文件列表的排序 / 筛选 / 徽章、星图的 kind 标签与配色，全部从这里取。
+		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
+		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
+		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
+		const TYPE_META = {
+			user: ["👤", TYPE_LABEL.user],
+			feedback: ["📌", TYPE_LABEL.feedback],
+			project: ["📁", TYPE_LABEL.project],
+			reference: ["🔗", TYPE_LABEL.reference],
+		};
+		// 星图配色：深色档（夜空）与浅色档（暖纸 + 矿物颜料）各一套，色相错开才分得清类型。
+		const TYPE_COLOR_DARK = {
+			user: "#e0c07a", feedback: "#7ec8da", project: "#ac9edc", reference: "#92ceaa", special: "#bcc3d0",
+		};
+		const TYPE_COLOR_LIGHT = {
+			user: "#a4652c", feedback: "#3a6f8f", project: "#6a5b8f", reference: "#4a7c63", special: "#5b5750",
+		};
 const StarmapRuntime = (function (require, _react) {
 	let react = _react;
 	const h = react.createElement;
 // ── 手写 strict codec（浏览器无 zod，typert 只要求 parse 方法）──
-		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
-		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
-		const strSchema = { parse(v) { isStr(v); return v; } };
+		// isStr / isNum / strSchema 来自 05-shared.js（这个 IIFE 在 factory 作用域内，看得到）。
 		const starSchema = {
 			parse(v) {
 				if (v === null || typeof v !== "object") throw new Error("invalid star");
@@ -81,11 +136,6 @@ const StarmapRuntime = (function (require, _react) {
 			],
 		};
 
-		/** 拆 typert remote 的 {ok, value} 信封。 */
-		function unwrap(result) {
-			return result && result.ok ? result.value : result;
-		}
-
 		/** 错误详情尽量展开，避免 "[object Object]" 式黑洞。 */
 		function detail(e) {
 			if (!e) return "未知错误";
@@ -114,15 +164,10 @@ const StarmapRuntime = (function (require, _react) {
 		// 深空画布上够辨认，又不抢眼。
 		//
 		// 两档取值：`color` = 深色档（夜空画布），`light` = 浅色档（纸本设色）。
-		// 浅色档不用「深色档降亮度」那种做法 —— 高饱和冷色压在暖纸上会发脏；
-		// 换成明度接近的矿物颜料色（赭石/石青/紫墨/石绿/墨），色相错开才分得清类型。
-		const KIND_META = {
-			user: { label: "用户", color: "#e0c07a", light: "#a4652c" },
-			feedback: { label: "反馈", color: "#7ec8da", light: "#3a6f8f" },
-			project: { label: "项目", color: "#ac9edc", light: "#6a5b8f" },
-			reference: { label: "参考", color: "#92ceaa", light: "#4a7c63" },
-			special: { label: "特殊", color: "#bcc3d0", light: "#5b5750" },
-		};
+		// 类型标签与配色来自 05-shared.js 的唯一定义；这里只是把它们组装成星图用的 meta。
+		const KIND_META = {};
+		for (const k of TYPE_SORT) KIND_META[k] = { label: TYPE_LABEL[k], color: TYPE_COLOR_DARK[k], light: TYPE_COLOR_LIGHT[k] };
+
 		/**
 		 * 宿主主题挂钩 —— 与 ui-theme 同一处：body[data-ds-dark-theme] 存在即深色档。
 		 */
@@ -180,16 +225,6 @@ const StarmapRuntime = (function (require, _react) {
 			return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
 		}
 
-		function hexA(hex, a) {
-			const n = parseInt(hex.slice(1), 16);
-			return "rgba(" + ((n >> 16) & 255) + "," + ((n >> 8) & 255) + "," + (n & 255) + "," + a.toFixed(3) + ")";
-		}
-
-		function fmtBytes(n) {
-			if (n >= 1024) return (n / 1024).toFixed(1) + " KB";
-			return n + " B";
-		}
-
 		function fmtDate(ms) {
 			if (!ms) return "";
 			const d = new Date(ms);
@@ -391,39 +426,12 @@ const StarmapRuntime = (function (require, _react) {
 			return blocks;
 		}
 
-		// ── overlay 开合的模块级 store（footer 按钮与 overlay 共享）──
-		const uiStore = { open: false, subs: new Set() };
 		/** client context 由 apply 存入；Slot 组件经 props 或此兜底获取。 */
 		let appCtx = null;
-		function setOpen(v) {
-			uiStore.open = !!v;
-			uiStore.subs.forEach((fn) => fn(uiStore.open));
-		}
-		function useOpen() {
-			const s = react.useState(uiStore.open);
-			react.useEffect(() => {
-				const fn = (v) => s[1](v);
-				uiStore.subs.add(fn);
-				return () => { uiStore.subs.delete(fn); };
-			}, []);
-			return s[0];
-		}
-
 		// ── 样式（data-plugin-css 约定，幂等注入）──
 		const CSS = [
-			".smap-footer-btn{display:inline-flex;align-items:center;gap:6px;border:1px solid var(--dsw-alias-border-l1,transparent);background:transparent;color:var(--dsw-alias-label-secondary,inherit);border-radius:8px;padding:4px 10px;font-size:12px;cursor:pointer;font-family:inherit;white-space:nowrap;}",
-			".smap-fab{position:fixed;right:0;top:15%;transform:translateY(-50%);z-index:900;width:36px;height:64px;border-radius:12px 0 0 12px;border:1px solid var(--dsw-alias-border-l1);border-right:none;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-brand-primary);font-size:17px;cursor:pointer;display:flex;align-items:center;justify-content:center;opacity:.5;pointer-events:auto;transition:opacity .15s,background .15s,width .15s;box-shadow:-4px 0 18px rgba(0,0,0,.35);font-family:inherit;}",
-			".smap-fab:hover{opacity:1;width:46px;background:var(--dsw-alias-bg-layer-1);}",
-			".smap-footer-btn:hover{color:var(--dsw-alias-label-primary,inherit);border-color:var(--dsw-alias-border-l2,#8886);}",
-			".smap-footer-icon{font-size:13px;line-height:1;}",
-			".smap-veil{position:fixed;inset:0;z-index:1000;background:var(--dsw-alias-bg-mask-1,rgba(0,0,0,.45));backdrop-filter:blur(3px);display:flex;align-items:center;justify-content:center;pointer-events:auto;animation:smap-fade-in .18s ease-out;}",
-			".smap-modal{width:min(980px,94vw);height:min(680px,92vh);background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:16px;box-shadow:0 24px 80px rgba(0,0,0,.55);padding:16px 18px;display:flex;flex-direction:column;overflow:hidden;pointer-events:auto;animation:smap-pop-in .22s cubic-bezier(.2,.9,.3,1.15);}",
-			"@keyframes smap-fade-in{from{opacity:0}to{opacity:1}}",
-			"@keyframes smap-pop-in{from{opacity:0;transform:scale(.96) translateY(10px)}to{opacity:1;transform:none}}",
 			".smap-card{background:var(--dsw-alias-bg-layer-1);border-radius:10px;padding:12px 14px;color:var(--dsw-alias-label-primary);display:flex;flex-direction:column;flex:1;min-height:0;}",
 			".smap-head{display:flex;align-items:center;gap:10px;margin-bottom:10px;flex-wrap:wrap;}",
-			".smap-title{font-size:15px;font-weight:600;letter-spacing:.06em;}",
-			".smap-sub{font-size:11px;color:var(--dsw-alias-label-secondary);}",
 			".smap-spacer{flex:1;}",
 			".smap-search{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;color:var(--dsw-alias-label-primary);font-size:12px;padding:4px 9px;outline:none;width:160px;font-family:inherit;}",
 			".smap-search:focus{border-color:var(--dsw-alias-border-l2);}",
@@ -1358,7 +1366,7 @@ const StarmapRuntime = (function (require, _react) {
 					if (s.mtimeMs > newest) newest = s.mtimeMs;
 				}
 				legendKids.push(h("span", { key: "count", className: "smap-count" },
-					viewStars.length + " 条 · " + fmtBytes(totalBytes) + (newest ? " · 最近更新 " + fmtDate(newest) : "") +
+					viewStars.length + " 条 · " + fmtSize(totalBytes) + (newest ? " · 最近更新 " + fmtDate(newest) : "") +
 					(showArchive && archivedN ? " · 档案馆 " + archivedN + " 颗暗星" : "") +
 					" · 单击看" + (showArchive && archivedN ? "详情" : "全文")));
 
@@ -1367,7 +1375,7 @@ const StarmapRuntime = (function (require, _react) {
 					const kids = [
 						h("div", { key: "t", className: "smap-tip-title" }, hover.star.title),
 						h("div", { key: "k", className: "smap-tip-kind" },
-							meta.label + " · " + hover.star.file + " · " + fmtBytes(hover.star.bytes)),
+							meta.label + " · " + hover.star.file + " · " + fmtSize(hover.star.bytes)),
 					];
 					if (hover.star.archived === true) {
 						// 悬浮也要说清它是档案馆里的：暗星外表已经不同，别让人猜。
@@ -1391,7 +1399,7 @@ const StarmapRuntime = (function (require, _react) {
 							h("button", { className: "smap-btn", onClick: () => setSelected(null), title: "关闭" }, "×")),
 						h("div", { key: "meta", className: "smap-panel-meta" },
 							h("span", { className: "smap-meta-dot", style: { background: kindColor(meta) } }),
-							meta.label + " · " + selected.star.file + " · " + fmtBytes(selected.star.bytes) +
+							meta.label + " · " + selected.star.file + " · " + fmtSize(selected.star.bytes) +
 							// 归档星的 mtime 是「当年写下」的时间，跟「什么时候收起来的」不是一回事 ——
 							// 这里只留「已归档」，具体时间在下面的归档块里给。
 							(selected.star.archived === true
@@ -1494,42 +1502,11 @@ const StarmapRuntime = (function (require, _react) {
 				body);
 		}
 
-		// ── 全屏 overlay ─────────────────────────────────────────────
-		function StarmapOverlay() {
-			const open = useOpen();
-			react.useEffect(() => {
-				if (!open) return undefined;
-				const onKey = (e) => { if (e.key === "Escape") setOpen(false); };
-				document.addEventListener("keydown", onKey);
-				return () => document.removeEventListener("keydown", onKey);
-			}, [open]);
-			if (!open) return null;
-			return h("div", {
-				className: "smap-veil",
-				onMouseDown: (e) => { if (e.target === e.currentTarget) setOpen(false); },
-			},
-			h("div", { className: "smap-modal" },
-				h(StarMap, { ctx: appCtx, onClose: () => setOpen(false) })));
-		}
-
-		// ── 窗口右缘浮标（唯一入口，不绑实例/会话/Run 卡片）────────────
-		function StarmapEdgeTab() {
-			const open = useOpen();
-			if (open) return null;
-			return h("button", {
-				type: "button",
-				className: "smap-fab",
-				onClick: () => setOpen(true),
-				title: "记忆星图 — 把 sage-mem 的记忆画成一片星空",
-				"aria-label": "记忆星图",
-			}, "✦");
-		}
-
 		const inject = ["slots", "remote"];
 
 		/**
 		 * Client 插件：$mount strict remote contribution（第三方 remote 不在
-		 * 宿主的固定 remote 清单里，必须自己挂），再注册 footer 按钮与 overlay。
+		 * 宿主的固定 remote 清单里，必须自己挂），再注册星图子槽（B 方案起不再有右缘浮标与全屏 overlay）。
 		 */
 		async function apply(ctx) {
 			appCtx = ctx;
@@ -1559,22 +1536,7 @@ const StarmapRuntime = (function (require, _react) {
 
 
 		// ── 手写 strict codec（浏览器无 zod，typert 只要求 parse 方法）──
-		function parseSchema(shape) {
-			return {
-				parse(value) {
-					if (value === null || typeof value !== "object") throw new Error("sage-mem: invalid payload");
-					for (const [key, check] of Object.entries(shape)) {
-						if (!(key in value)) throw new Error("sage-mem: missing field " + key);
-						check(value[key]);
-					}
-					return value;
-				},
-			};
-		}
-		const isStr = (v) => { if (typeof v !== "string") throw new Error("expected string"); };
-		const isBool = (v) => { if (typeof v !== "boolean") throw new Error("expected boolean"); };
-		const isNum = (v) => { if (typeof v !== "number") throw new Error("expected number"); };
-		const strSchema = { parse(v) { isStr(v); return v; } };
+		// 基元（parseSchema / isStr / isBool / isNum / strSchema）在 05-shared.js。
 		const fileSchema = parseSchema({ "file": isStr, "type": isStr, "description": isStr, "size": isNum });
 		const listSchema = { parse(v) { if (!Array.isArray(v)) throw new Error("expected array"); v.forEach((f) => fileSchema.parse(f)); return v; } };
 		const readSchema = parseSchema({ "name": isStr, "content": isStr });
@@ -2072,15 +2034,11 @@ const StarmapRuntime = (function (require, _react) {
 			// ── 工具行 + 工具面板（体检 / 归档候选 / 保留名原样编辑）──
 			// 三个新入口收在一行**轻量**文字按钮里：不跟主工具栏抢重量级，也不各占一块版面。
 			// 面板一次只开一个（Section 里一个 tool 状态），否则文件列表会被顶到屏幕外。
-			".smem-tools{display:flex;align-items:center;gap:4px;flex-wrap:wrap;}",
-			".smem-tool-btn{border:0;background:transparent;color:var(--dsw-alias-label-secondary);font-size:12px;font-family:inherit;cursor:pointer;padding:2px 8px;border-radius:6px;}",
-			".smem-tool-btn:hover{color:var(--dsw-alias-label-primary);}",
-			'.smem-tool-btn[data-on="1"]{color:var(--dsw-alias-brand-primary,#4d76e6);background:var(--dsw-alias-bg-layer-2);}',
 			// 工具抽屉：关着时**零占位**（工具栏里只有一个「工具 ▾」），点开才占版面。
 			// ⚠️ 可发现性不靠抽屉本身，靠头部带常显的「体检 N 个问题」徽标 —— 那是整个
 			// 抽屉方案能成立的前提（否则三个能力就退回「藏起来」了）。
 			".smem-drawer{position:relative;flex:none;}",
-			".smem-drawer-pop{position:absolute;right:0;top:calc(100% + 6px);z-index:6;min-width:236px;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;box-shadow:0 8px 24px rgba(0,0,0,.10);padding:6px;display:flex;flex-direction:column;gap:2px;}",
+			".smem-drawer-pop{position:absolute;right:0;top:calc(100% + 6px);z-index:6;min-width:236px;max-width:min(320px,calc(100vw - 24px));background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:10px;box-shadow:0 8px 24px rgba(0,0,0,.10);padding:6px;display:flex;flex-direction:column;gap:2px;}",
 			".smem-drawer-item{display:flex;align-items:center;gap:8px;border:0;background:transparent;font-family:inherit;font-size:12.5px;color:var(--dsw-alias-label-primary);text-align:left;padding:6px 8px;border-radius:8px;cursor:pointer;}",
 			".smem-drawer-item:hover{background:var(--dsw-alias-bg-layer-2);}",
 			'.smem-drawer-item[data-on="1"]{background:var(--dsw-alias-bg-layer-2);font-weight:600;}',
@@ -2131,7 +2089,7 @@ const StarmapRuntime = (function (require, _react) {
 			'.smem-subtab--on:after{content:"";position:absolute;left:0;right:0;bottom:-1px;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary);}',
 			".smem-subtab-n{opacity:.6;margin-left:5px;font-variant-numeric:tabular-nums;}",
 			// 五个注入参数排两列：一行放两个，扫读反而更清楚（吸收方案 A 的做法）。
-			".smem-ad-grid2{display:grid;grid-template-columns:repeat(auto-fit,minmax(330px,1fr));gap:4px 18px;}",
+			".smem-ad-grid2{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:4px 18px;}",
 			".smem-ad-field{display:flex;align-items:center;gap:8px;min-width:0;}",
 			".smem-ad-field .smem-autodream-key{min-width:96px;}",
 			".smem-actions{display:flex;gap:6px;}",
@@ -2155,7 +2113,7 @@ const StarmapRuntime = (function (require, _react) {
 			'.smem-tab--on:after{content:"";position:absolute;left:0;right:0;bottom:-1px;height:2px;border-radius:2px 2px 0 0;background:var(--dsw-alias-label-primary);}',
 			// 高度预算压到 62vh（原 70vh）：设置弹窗本身高度有限，
 			// 70vh 在较矮的设置弹窗视口下会把星图底部的图例和计数挤出面板之外。
-			".smem-starmap{display:flex;flex-direction:column;height:min(62vh,660px);min-height:400px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;overflow:hidden;}",
+			".smem-starmap{display:flex;flex-direction:column;height:clamp(320px,55vh,620px);min-height:280px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;overflow:hidden;}",
 			// ── 「自动做梦」面板 ──
 			// 融入型：全部走宿主变量，控件复用已有的 chip / input / btn 语言，不另造一套。
 			".smem-autodream{display:flex;flex-direction:column;gap:12px;}",
@@ -2202,23 +2160,21 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-update{display:flex;align-items:center;gap:10px;flex-wrap:wrap;border:1px solid var(--dsw-alias-brand-primary,#4d76e6);border-radius:8px;padding:6px 10px;font-size:12px;background:var(--dsw-alias-bg-layer-1);}",
 			".smem-update-link{color:var(--dsw-alias-brand-primary,#4d76e6);text-decoration:underline;}",
 			".smem-update-x{margin-left:auto;border:0;background:transparent;color:inherit;cursor:pointer;font-size:14px;line-height:1;padding:0 2px;}",
+			// ── 1.5.0：动作分组 / 长文 clamp / 空态骨架 / 窄窗口 ──
+			".smem-actions-sep{width:1px;height:16px;background:var(--dsw-alias-border-l2);margin:0 2px;align-self:center;}",
+			".smem-clamp-2{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;cursor:pointer;}",
+			".smem-clamp-2--open{-webkit-line-clamp:unset;display:block;}",
+			".smem-skeleton{display:flex;flex-direction:column;gap:10px;padding:6px 0;}",
+			".smem-skeleton-row{height:44px;border-radius:8px;background:var(--dsw-alias-bg-layer-2);opacity:.55;}",
+			".smem-empty{display:flex;flex-direction:column;align-items:flex-start;gap:8px;}",
+			".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-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;}}",
 			// ── 底部一行仓库链接（引流，不抢视线）──
 			".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;}",
 		].join("\n");
 
-		const TYPE_META = {
-			user: ["👤", "用户"],
-			feedback: ["📌", "反馈"],
-			project: ["📁", "项目"],
-			reference: ["🔗", "参考"],
-		};
-		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
-		// 筛选条上的显示名：emoji 在筛选条里太吵，只用文字；special 是星图的兜底类，
-		// 文件列表里出现它说明 frontmatter 写了 type: special。
-		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
-		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
-
 		/**
 		 * 把输入框里的一串标签切成数组。
 		 *
@@ -2467,17 +2423,6 @@ const StarmapRuntime = (function (require, _react) {
 				tagLine + "\nmetadata:\n  node_type: memory\n  type: " + type + "\n---\n\n";
 		}
 
-		function fmtSize(n) {
-			if (n < 1024) return n + " B";
-			if (n < 1024 * 1024) return (n / 1024).toFixed(1) + " KB";
-			return (n / 1024 / 1024).toFixed(1) + " MB";
-		}
-
-		/** 拆 typert remote 的 {ok, value} 信封。 */
-		function unwrap(result) {
-			return result && result.ok ? result.value : result;
-		}
-
 		function Chip(props) {
 			return h("button", {
 				type: "button",
@@ -2539,6 +2484,8 @@ const StarmapRuntime = (function (require, _react) {
 										]
 									: [
 											h("button", { type: "button", className: "smem-btn", key: "edit", onClick: function () { props.onEdit(item.file); } }, "编辑"),
+											// 语义分组：左边只放「编辑」（安全、可逆），右边放「锁定 / 归档 / 删除」（对这条记忆的退役/保护决定）。
+											h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 											/**
 											 * 锁定排在「编辑」与「归档」之间（用户 2026-10-11 指定）：
 											 * 它是「别归档这条」的开关，紧挨着归档才说得通。
@@ -2589,6 +2536,9 @@ const StarmapRuntime = (function (require, _react) {
 		function ArchivedCard(props) {
 			const item = props.item;
 			const meta = TYPE_META[item.type] || TYPE_META.reference;
+			// 描述与归档理由都可能很长：默认各 clamp（描述 3 行 / 理由 2 行），点一下展开全文。
+			const sDescOpen = react.useState(false);
+			const descOpen = sDescOpen[0], setDescOpen = sDescOpen[1];
 			return h("div", { className: "smem-card smem-card--archived", key: item.file }, [
 				h("div", { className: "smem-card-head", key: "head" }, [
 					h("span", { className: "smem-badge", key: "badge", title: "类型 " + String(item.type) }, meta[0] + " " + meta[1]),
@@ -2604,9 +2554,18 @@ const StarmapRuntime = (function (require, _react) {
 				// 描述留在活动卡片里的同一个位置（标签下面），归档留痕块再往下 ——
 				// 否则「归档理由」像卡片结尾，后面孤零零一行描述没人认得它是什么。
 				item.description
-					? h("div", { className: "smem-narrative", key: "desc" }, String(item.description))
+					? h("div", {
+							className: "smem-narrative", key: "desc",
+							"data-clamp": descOpen ? "0" : "1",
+							title: descOpen ? "点击收起" : "点击展开全文",
+							onClick: function () { setDescOpen(!descOpen); },
+						}, String(item.description))
 					: null,
-				h("div", { className: "smem-ar-reason", key: "why" }, "归档理由：" + (item.archivedReason || "（没写）")),
+				h("div", {
+					className: "smem-ar-reason smem-clamp-2" + (descOpen ? " smem-clamp-2--open" : ""),
+					key: "why", title: "归档理由：" + (item.archivedReason || "（没写）"),
+					onClick: function () { setDescOpen(!descOpen); },
+				}, "归档理由：" + (item.archivedReason || "（没写）")),
 				props.editing
 					? h("div", { className: "smem-ar-edit", key: "edit" }, [
 							h("div", { className: "smem-ar-hint", key: "note" },
@@ -2643,7 +2602,8 @@ const StarmapRuntime = (function (require, _react) {
 										disabled: props.busy,
 										onClick: function () { props.onEdit(item.file); },
 									}, "编辑"),
-									h("button", {
+h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
+																		h("button", {
 										type: "button", className: "smem-btn smem-btn-primary", key: "restore",
 										disabled: props.busy,
 										onClick: function () { props.onRestore(item.file); },
@@ -2766,7 +2726,7 @@ const StarmapRuntime = (function (require, _react) {
 					standalone ? null : toolClose(props),
 				]),
 				r.problems
-					? h("div", { className: "smem-audit-secs", key: "secs" }, [
+					? h("div", { key: "secs" }, [
 							section("索引悬空（索引里有、文件没了）", r.dangling, (x) => x.file),
 							section("漏索引（文件在、索引里没有）", r.unlisted, (x) => x.file),
 							section("type 与前缀对不上", r.typeMismatch, (x) => x.file + " · type=" + x.type + "，文件名前缀=" + x.prefix),
@@ -3252,7 +3212,7 @@ const StarmapRuntime = (function (require, _react) {
 					subtab("settings", "设置"),
 					subtab("records", "记录", String(snaps.length + runs.length + reports.length)),
 				]),
-				segOf === "run" ? h("div", { className: "smem-seg", key: "seg-run" }, [
+				segOf === "run" ? h("div", { key: "seg-run" }, [
 				h("div", { className: "smem-autodream-sec", key: "top" }, [
 					h("div", { className: "smem-autodream-row", key: "r" }, [
 						h("button", {
@@ -3376,7 +3336,7 @@ const StarmapRuntime = (function (require, _react) {
 						: null,
 				]),
 				]) : null,
-				segOf === "settings" ? h("div", { className: "smem-seg", key: "seg-set" }, [
+				segOf === "settings" ? h("div", { key: "seg-set" }, [
 				// 自动归档那一段（三档策略 + 三个阈值）**已挪到「自动归档」页签**（v0.9.9）：
 				// 归档是确定性规则、不调模型，和这一页的「让模型整理」不是一件事；
 				// 同一件事只在一处设定，这里不再重复摆一份。
@@ -3477,7 +3437,7 @@ const StarmapRuntime = (function (require, _react) {
 				]) : null,
 				// ── 回滚点（新）──────────────────────────────────────────────
 				// 只改这一个文件、只用既有 h() 写法；数据全走 remote.autodream。
-				segOf === "records" ? h("div", { className: "smem-seg", key: "seg-rec" }, [
+				segOf === "records" ? h("div", { key: "seg-rec" }, [
 				h("div", { className: "smem-autodream-sec", key: "snap" }, [
 					h("div", { className: "smem-autodream-row", key: "h" }, [
 						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "回滚点"),
@@ -3706,7 +3666,7 @@ const StarmapRuntime = (function (require, _react) {
 				});
 			}
 
-			return h("div", { className: "smem-seg" }, [
+			return h("div", { }, [
 				// ── ① 它做什么（这一屏存在的理由写在最前面）──
 				h("div", { className: "smem-autodream-sec", key: "what" }, [
 					h("div", { className: "smem-autodream-row", key: "h" }, [
@@ -3898,7 +3858,8 @@ const StarmapRuntime = (function (require, _react) {
 			const rawBusy = sRawBusy[0], setRawBusy = sRawBusy[1];
 			const sRawLoading = react.useState(false);
 			const rawLoading = sRawLoading[0], setRawLoading = sRawLoading[1];
-			const renderSlot = props.renderSlot;
+			// renderSlot：shell 会经 props 传进来（见 80-apply 的 children 声明），
+			// 但本插件改用并列 tab 渲染星图，不再调用它 —— 声明保留给 shell，这里不取。
 
 			function load() {
 				setLoading(true);
@@ -4420,18 +4381,29 @@ const StarmapRuntime = (function (require, _react) {
 			// banner 只在**专门看归档**时出现，切到全部时不重复说一遍。
 			let filesView;
 			if (loading && totalCount === 0) {
-				filesView = h("div", { className: "smem-muted", key: "loading" }, "加载中…");
+				filesView = h("div", { className: "smem-skeleton", key: "loading", "data-loading": "1" }, [0, 1, 2].map(function (i) {
+					return h("div", { className: "smem-skeleton-row", key: i });
+				}));
 			} else if (totalCount === 0) {
-				filesView = h("div", { className: "smem-empty", key: "empty" },
-					"还没有记忆文件。对话中值得记住的事会写到这里，也可以点「添加记忆」手动写入。");
+				filesView = h("div", { className: "smem-empty", key: "empty" }, [
+					h("div", { key: "t" }, "还没有记忆文件。对话中值得记住的事会写到这里，也可以手动写入。"),
+					h("button", { type: "button", className: "smem-btn smem-btn-primary", key: "add", onClick: openAdd }, "+ 添加记忆"),
+				]);
 			} else if (statusFilter === "archived" && archiveItems.length === 0) {
-				filesView = h("div", { className: "smem-empty", key: "empty" },
-					"档案馆是空的 —— 在活动记忆那张卡上点「归档」，它就会收到这里。");
+				filesView = h("div", { className: "smem-empty", key: "empty" }, [
+					h("div", { key: "t" }, "档案馆是空的 —— 在活动记忆那张卡上点「归档」，它就会收到这里。"),
+					h("button", { type: "button", className: "smem-btn", key: "back", onClick: function () { setStatusFilter("active"); } }, "回文件列表"),
+				]);
 			} else if (statusFilter === "active" && items.length === 0) {
-				filesView = h("div", { className: "smem-empty", key: "empty" },
-					"活动记忆是空的 —— 状态筛到「已归档」还能捞出 " + archiveItems.length + " 条。");
+				filesView = h("div", { className: "smem-empty", key: "empty" }, [
+					h("div", { key: "t" }, "活动记忆是空的 —— 状态筛到「已归档」还能捞出 " + archiveItems.length + " 条。"),
+					h("button", { type: "button", className: "smem-btn", key: "go", onClick: function () { setStatusFilter("archived"); } }, "切到已归档"),
+				]);
 			} else if (filtered.length === 0) {
-				filesView = h("div", { className: "smem-empty", key: "empty" }, "没有符合搜索或筛选条件的文件。");
+				filesView = h("div", { className: "smem-empty", key: "empty" }, [
+					h("div", { key: "t" }, "没有符合搜索或筛选条件的文件。"),
+					h("button", { type: "button", className: "smem-btn", key: "clear", onClick: function () { setStatusFilter("all"); setTypeFilter([]); setTagFilter([]); setQuery(""); } }, "清除筛选"),
+				]);
 			} else {
 				const list = h("div", { className: "smem-list", key: "list" }, filtered.map(function (it) {
 					if (it.archived === true) {
@@ -4491,25 +4463,26 @@ const StarmapRuntime = (function (require, _react) {
 			}
 
 			return h("div", { className: "smem-root" }, [
-				h("div", { className: "smem-tabs", key: "tabs" }, [
-					h("button", { type: "button", className: "smem-tab" + (tab === "files" ? " smem-tab--on" : ""), key: "f", onClick: function () { setTab("files"); } }, "文件列表"),
-					h("button", { type: "button", className: "smem-tab" + (tab === "star" ? " smem-tab--on" : ""), key: "s", onClick: function () { setTab("star"); } }, "记忆星图"),
-					h("button", { type: "button", className: "smem-tab" + (tab === "autodream" ? " smem-tab--on" : ""), key: "d", onClick: function () { setTab("autodream"); } }, "自动做梦"),
+				h("div", { className: "smem-tabs", key: "tabs", role: "tablist" }, [
+					h("button", { type: "button", className: "smem-tab" + (tab === "files" ? " smem-tab--on" : ""), key: "f", role: "tab", "aria-selected": tab === "files" ? "true" : "false", onClick: function () { setTab("files"); } }, "文件列表"),
+					h("button", { type: "button", className: "smem-tab" + (tab === "star" ? " smem-tab--on" : ""), key: "s", role: "tab", "aria-selected": tab === "star" ? "true" : "false", onClick: function () { setTab("star"); } }, "记忆星图"),
+					h("button", { type: "button", className: "smem-tab" + (tab === "autodream" ? " smem-tab--on" : ""), key: "d", role: "tab", "aria-selected": tab === "autodream" ? "true" : "false", onClick: function () { setTab("autodream"); } }, "自动做梦"),
+					// 视觉分组：左边「看」（文件列表 / 星图），右边「设置 · 自动化」。
+					h("span", { className: "smem-tabs-sep", key: "sep", "aria-hidden": "true" }),
 					// 「自动归档」排在自动做梦之后：归档是**确定性规则**（按闲置天数算，不调模型），
 					// 和「让模型整理记忆」是两件事。塞在自动做梦的设置里用户找不到
 					// （2026-10-11 用户原话：「扔这里连我都找不到」）。
-					h("button", { type: "button", className: "smem-tab" + (tab === "archive" ? " smem-tab--on" : ""), key: "ar", onClick: function () { setTab("archive"); } }, "自动归档"),
+					h("button", { type: "button", className: "smem-tab" + (tab === "archive" ? " smem-tab--on" : ""), key: "ar", role: "tab", "aria-selected": tab === "archive" ? "true" : "false", onClick: function () { setTab("archive"); } }, "自动归档"),
 					// 体检再排在「自动归档」之后、独立成一屏：它只报告不修改，和「文件列表」里的
 					// 增删改是两件事，塞在工具抽屉里会让人以为它是个动作按钮。
-					h("button", { type: "button", className: "smem-tab" + (tab === "audit" ? " smem-tab--on" : ""), key: "a", onClick: openAuditTab }, "体检"),
+					h("button", { type: "button", className: "smem-tab" + (tab === "audit" ? " smem-tab--on" : ""), key: "a", role: "tab", "aria-selected": tab === "audit" ? "true" : "false", onClick: openAuditTab }, "体检"),
 				]),
 				// 四个 tab 共用的一条头部带：我在哪 · 目录状态 · 活动/归档计数 · 体检徽标 · 待重启徽标 · 主操作。
 				// 层级形状固定：导航＝下划线（.smem-tabs）、筛选＝chip、动作＝按钮，三种不混用。
 				h("div", { className: "smem-head", key: "head" }, [
 					h("span", { className: "smem-title", key: "t" }, "记忆管理"),
-					h("span", { className: "smem-head-job", key: "job" }, TAB_LABEL[tab] || ""),
-					h("span", { className: "smem-dot" + (dirOk ? "" : " smem-dot--bad"), key: "dot", title: dirOk ? "memory 目录可读" : "memory 目录不可读" }),
-					h("span", { className: "smem-muted", key: "st" }, dirOk ? "目录可读" : "目录不可读"),
+					// 目录状态收进状态点的 title（不可读时下面另有一条 smem-err，错误本来就该显眼）。
+					h("span", { className: "smem-dot" + (dirOk ? "" : " smem-dot--bad"), key: "dot", title: (dirOk ? "memory 目录可读" : "memory 目录不可读") + " · " + String(TAB_LABEL[tab] || "") }),
 					h("span", { className: "smem-badge", key: "cnt" }, headerCount),
 					// 体检徽标：**抽屉关着也一直看得见**，点它就切到「体检」那一屏。
 					h("button", {
@@ -4560,6 +4533,7 @@ const StarmapRuntime = (function (require, _react) {
 							type: "button", key: "btn",
 							className: "smem-btn" + (drawer ? " smem-btn-primary" : ""),
 							"aria-expanded": drawer ? "true" : "false",
+							"aria-haspopup": "menu",
 							title: "归档候选 / 保留名编辑",
 							onClick: function () { setDrawer(!drawer); },
 						}, "工具 ▾"),
@@ -4679,8 +4653,8 @@ const StarmapRuntime = (function (require, _react) {
 								: null,
 						])
 					: null,
-				error ? h("div", { className: "smem-err", key: "err" }, "⚠ " + error) : null,
-				notice && !error ? h("div", { className: "smem-ok", key: "ok" }, "✓ " + notice) : null,
+				error ? h("div", { className: "smem-err", key: "err", role: "alert" }, "⚠ " + error) : null,
+				notice && !error ? h("div", { className: "smem-ok", key: "ok", role: "status" }, "✓ " + notice) : null,
 				formOpen
 					? h("div", { className: "smem-form", key: "form" }, [
 							h("div", { className: "smem-form-title", key: "ft" }, editingFile ? "编辑 " + editingFile : "添加记忆"),

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": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {