sage-mem 0.5.4 → 0.6.0

package/lib/client.js

@@ -108,12 +108,16 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		// ── 常量与纯函数 ─────────────────────────────────────────────
+		//
+		// 配色（2026-09-27 重做）：原来五个色都是高饱和高亮度（#ffd27d / #6fe3ff /
+		// #b18cff / #7dffb0），配上当时的星芒与脉冲环，整体读起来像贴纸。
+		// 现在统一降饱和、压亮度 —— 深空画布上够辨认，又不抢眼。
 		const KIND_META = {
-			user: { label: "用户", color: "#ffd27d" },
-			feedback: { label: "反馈", color: "#6fe3ff" },
-			project: { label: "项目", color: "#b18cff" },
-			reference: { label: "参考", color: "#7dffb0" },
-			special: { label: "特殊", color: "#cfd6e6" },
+			user: { label: "用户", color: "#e0c07a" },
+			feedback: { label: "反馈", color: "#7ec8da" },
+			project: { label: "项目", color: "#ac9edc" },
+			reference: { label: "参考", color: "#92ceaa" },
+			special: { label: "特殊", color: "#bcc3d0" },
 		};
 		const KIND_ORDER = ["user", "feedback", "project", "reference", "special"];
 		const FRESH_MS = 7 * 86400000;
@@ -369,7 +373,13 @@ const StarmapRuntime = (function (require, _react) {
 			".smap-modal{width:min(980px,94vw);height:min(680px,92vh);background:linear-gradient(160deg,#0d1226,#111a33);border:1px solid rgba(140,160,220,.22);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{color:#dbe4f5;display:flex;flex-direction:column;flex:1;min-height:0;}",
+			// 2026-09-27（B 方案「自洽夜空」）：星图整块含 header 与图例，同属一张深色画布。
+			//
+			// 不这么做的下场是实测出来的：宿主切到**浅色主题**后，这个组件里硬编码的
+			// 浅色文字（#dbe4f5 系）落在白色卡片上，标题、搜索框、图例几乎看不见 ——
+			// 截图里就是一片「重影」。星图本来就不打算跟随宿主主题（它是一张夜空），
+			// 那就把边界画清楚：整块深色，而不是只有中间那半块。
+			".smap-card{background:#0c0e12;border-radius:10px;padding:12px 14px;color:#e3e7ef;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;opacity:.55;}",
@@ -439,35 +449,18 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		const SMAP_BG_VS = "attribute vec2 aPos; void main(){ gl_Position = vec4(aPos, 0.0, 1.0); }";
+		// 底色（2026-09-27 重做）。旧版是四层 fbm 噪声算出来的蓝紫星云，还带 uTime 动画 ——
+		// 「会呼吸的彩色底」正是廉价感的一大来源，而且每帧都要重算噪声。
+		// 现在只剩一条静态径向渐变：中心略亮的中性深灰，边缘更暗。uTime 保留声明
+		// 只为让 uniform 列表不变（用不到时 getUniformLocation 返回 null，调用是安全空操作）。
 		const SMAP_BG_FS = [
 			"precision highp float;",
 			"uniform vec2 uRes;",
 			"uniform float uTime;",
-			"float hash21(vec2 p){ p = fract(p * vec2(234.34, 435.345)); p += dot(p, p + 34.23); return fract(p.x * p.y); }",
-			"float vnoise(vec2 p){",
-			"  vec2 i = floor(p); vec2 f = fract(p);",
-			"  f = f * f * (3.0 - 2.0 * f);",
-			"  float a = hash21(i); float b = hash21(i + vec2(1.0, 0.0));",
-			"  float c = hash21(i + vec2(0.0, 1.0)); float e = hash21(i + vec2(1.0, 1.0));",
-			"  return mix(mix(a, b, f.x), mix(c, e, f.x), f.y);",
-			"}",
-			"float fbm(vec2 p){",
-			"  float v = 0.0; float amp = 0.55;",
-			"  for (int i = 0; i < 4; i++){ v += amp * vnoise(p); p = p * 2.03 + vec2(17.7, 9.2); amp *= 0.5; }",
-			"  return v;",
-			"}",
 			"void main(){",
-			"  float fy = gl_FragCoord.y / uRes.y;",
-			"  vec3 col = mix(vec3(0.063, 0.090, 0.192), vec3(0.043, 0.063, 0.149), fy);",
 			"  vec2 suv = gl_FragCoord.xy / uRes;",
-			"  float band = suv.x * 0.92 - suv.y * 0.62 + 0.16;",
-			"  float bandMask = exp(-band * band * 13.0);",
-			"  vec2 np = vec2(suv.x * 3.1 + suv.y * 1.35, suv.y * 2.15 - suv.x * 0.75);",
-			"  float neb = fbm(np + vec2(uTime * 0.010, -uTime * 0.006));",
-			"  vec3 dustCol = mix(vec3(0.36, 0.44, 0.78), vec3(0.72, 0.58, 0.46), fbm(np * 0.63 + 4.7));",
-			"  col += dustCol * bandMask * (neb * neb) * 0.30;",
-			"  float dark = fbm(np * 0.42 + 13.1);",
-			"  col *= 1.0 - dark * bandMask * 0.22;",
+			"  float r = length((suv - vec2(0.5, 0.44)) * vec2(1.0, 1.28));",
+			"  vec3 col = mix(vec3(0.105, 0.117, 0.145), vec3(0.043, 0.050, 0.065), clamp(r * 1.30, 0.0, 1.0));",
 			"  gl_FragColor = vec4(col, 1.0);",
 			"}",
 		].join("\n");
@@ -491,6 +484,11 @@ const StarmapRuntime = (function (require, _react) {
 			"}",
 		].join("\n");
 
+		// 星点（2026-09-27 重做）。去掉了三样东西，它们就是「塑料感」的来源：
+		//   1. 衍射星芒（横竖两条十字 spike）—— 用户明确要求去掉
+		//   2. 脉冲扩散环（fract(uTime*0.3) 画出来的同心圆）—— 看起来像贴纸上的亮环
+		//   3. 呼吸闪烁（sin(uTime) 调制整体透明度）—— 满屏一起闪，廉价
+		// 留下的是「锐利实心核心 + 收敛辉光」，亮度按 vMeta1.y（是否新鲜）分档。
 		const SMAP_STAR_FS = [
 			"precision mediump float;",
 			"varying vec2 vLocal;",
@@ -509,27 +507,16 @@ const StarmapRuntime = (function (require, _react) {
 			"  float d = length(vLocal);",
 			"  float alpha = 0.0;",
 			"  if (vMeta1.z < -0.5){",
-			"    float core = smoothstep(0.34, 0.02, d);",
-			"    float slow = 0.5 + 0.5 * sin(uTime * 0.8 + vMeta1.x * 6.2831853);",
-			"    alpha = core * vColor.a * (0.45 + 0.55 * slow);",
+			"    alpha = smoothstep(0.55, 0.0, d) * vColor.a;",
 			"  } else {",
-			"    float tw = 0.72 + 0.28 * sin(uTime * 2.1 + vMeta1.x * 6.2831853);",
-			"    float core = smoothstep(0.30, 0.02, d);",
-			"    float sh = smoothstep(0.09, 0.0, abs(vLocal.y)) * smoothstep(1.0, 0.12, abs(vLocal.x));",
-			"    float sv = smoothstep(0.09, 0.0, abs(vLocal.x)) * smoothstep(1.0, 0.12, abs(vLocal.y));",
-			"    float spikes = max(sh, sv); spikes = spikes * spikes * spikes * 0.6;",
-			"    float glow = exp(-d * 3.2) * 0.5;",
-			"    alpha = core + spikes * core + glow;",
-			"    if (vMeta1.y > 0.5){",
-			"      float ph = fract(uTime * 0.30 + vMeta1.x * 0.61803399);",
-			"      float rr = mix(0.20, 0.88, ph);",
-			"      alpha += smoothstep(0.075, 0.0, abs(d - rr)) * (1.0 - ph) * 0.85;",
-			"    }",
+			"    float aFresh = mix(0.60, 1.0, vMeta1.y);",
+			"    float core = smoothstep(0.30, 0.04, d);",
+			"    float glow = exp(-d * 3.8) * 0.30;",
+			"    alpha = (core + glow) * aFresh;",
 			"    if (abs(vMeta1.z - uHoverIdx) < 0.5){",
-			"      alpha += smoothstep(0.10, 0.0, abs(d - 0.66)) * 0.18;",
-			"      alpha += smoothstep(0.05, 0.0, abs(d - 0.66)) * 0.9;",
+			"      alpha += smoothstep(0.10, 0.0, abs(d - 0.62)) * 0.55;",
 			"    }",
-			"    alpha = clamp(alpha, 0.0, 1.15) * tw;",
+			"    alpha = clamp(alpha, 0.0, 1.0);",
 			"  }",
 			"  alpha *= revealFactor();",
 			"  gl_FragColor = vec4(vColor.rgb, alpha);",
@@ -906,7 +893,7 @@ const StarmapRuntime = (function (require, _react) {
 
 			const hoverBox = react.useRef({ idx: -1 }).current;
 			const visBox = react.useRef({ flags: [], lines: [] }).current;
-			const drawBox = react.useRef({ renderer: null, t0: 0 }).current;
+			const drawBox = react.useRef({ renderer: null, t0: 0, markDirty: null }).current;
 			const replayBox = react.useRef({ raf: 0, active: false }).current;
 
 			// Esc 分层：详情面板开着时先关面板（capture 阶段拦截），再按才落到 overlay 关星空。
@@ -970,13 +957,40 @@ const StarmapRuntime = (function (require, _react) {
 				drawBox.renderer = renderer;
 				drawBox.t0 = Date.now();
 				renderer.render(0);
-				let raf = window.requestAnimationFrame(function loop() {
-					if (drawBox.renderer) drawBox.renderer.render((Date.now() - drawBox.t0) / 1000);
-					raf = window.requestAnimationFrame(loop);
-				});
+
+				// ── 按需重绘（2026-09-27 重做）──
+				// 旧版是一个常驻 rAF 循环：只要星图页开着就永远满帧重画，后台标签页也一样，
+				// 而画面其实早就静止了。新的规矩只有三种情况会画：
+				//   1. 入场展示动画期间（约 1.3s，星点按诞生时间依次点亮）
+				//   2. 有人调 markDirty()（hover / 数据或筛选变化 / 尺寸变化）
+				//   3. 诞生回放进行中
+				// 其余时间一帧都不画。另外帧率封顶 30fps，页面不可见时直接跳过。
+				const FRAME_MS = 1000 / 30;
+				const ENTRANCE_MS = 1300;
+				let raf = 0;
+				let dirty = true;
+				let lastDraw = 0;
+				function schedule() {
+					if (!raf) raf = window.requestAnimationFrame(tick);
+				}
+				function tick(ts) {
+					raf = 0;
+					if (!drawBox.renderer) return;
+					if (ts - drawBox.t0 < ENTRANCE_MS || replayBox.active) dirty = true;
+					if (!dirty) return;
+					if (typeof document !== "undefined" && document.hidden) return;
+					if (ts - lastDraw < FRAME_MS) { schedule(); return; }
+					dirty = false;
+					lastDraw = ts;
+					drawBox.renderer.render((ts - drawBox.t0) / 1000);
+				}
+				drawBox.markDirty = function () { dirty = true; schedule(); };
+				schedule();
+
 				return () => {
 					window.cancelAnimationFrame(raf);
 					drawBox.renderer = null;
+					drawBox.markDirty = null;
 					replayBox.active = false;
 					window.cancelAnimationFrame(replayBox.raf);
 					if (renderer.destroy) renderer.destroy();
@@ -994,7 +1008,9 @@ const StarmapRuntime = (function (require, _react) {
 				setEmptySky(!anyVis);
 				if (drawBox.renderer) {
 					if (drawBox.renderer.setGeometry) drawBox.renderer.setGeometry();
-					drawBox.renderer.render((Date.now() - drawBox.t0) / 1000);
+					// 交给按需重绘那一套：下一帧画（<33ms），不再这里直接 render
+					if (drawBox.markDirty) drawBox.markDirty();
+					else drawBox.renderer.render((Date.now() - drawBox.t0) / 1000);
 				}
 			}, [data, layout, kindsOn, query]);
 
@@ -1024,6 +1040,7 @@ const StarmapRuntime = (function (require, _react) {
 				if (best !== hoverBox.idx) {
 					hoverBox.idx = best;
 					if (drawBox.renderer && drawBox.renderer.setHighlight) drawBox.renderer.setHighlight(best);
+					if (drawBox.markDirty) drawBox.markDirty();
 				}
 				if (best >= 0) {
 					const p = layout.pts[best];
@@ -1039,6 +1056,7 @@ const StarmapRuntime = (function (require, _react) {
 			function onLeave() {
 				hoverBox.idx = -1;
 				if (drawBox.renderer && drawBox.renderer.setHighlight) drawBox.renderer.setHighlight(-1);
+				if (drawBox.markDirty) drawBox.markDirty();
 				setHover(null);
 			}
 
@@ -1098,6 +1116,7 @@ const StarmapRuntime = (function (require, _react) {
 				replayBox.active = false;
 				window.cancelAnimationFrame(replayBox.raf);
 				if (drawBox.renderer && drawBox.renderer.setReveal) drawBox.renderer.setReveal(null);
+				if (drawBox.markDirty) drawBox.markDirty();
 				setReplaying(false);
 				setReplayDate(null);
 			}
@@ -1347,6 +1366,30 @@ const StarmapRuntime = (function (require, _react) {
 		const starmapListSchema = { parse(v) { if (!v || typeof v !== "object") throw new Error("expected object"); if (!Array.isArray(v.stars)) throw new Error("expected stars array"); v.stars.forEach((f) => starmapStarSchema.parse(f)); return v; } };
 		const starmapReadSchema = parseSchema({ "name": isStr, "content": isStr });
 
+		// ── dream 的 codec ──
+		// 刻意写得宽：这几个方法返回的是配置 / 状态对象，字段会随版本增删。
+		// 用 parseSchema 逐字段硬写一遍的代价是 —— host 那边加一个字段，client 的旧
+		// schema 就把整条调用当「缺字段」拒掉（parseSchema 会 throw missing field），
+		// 于是插件一升级、界面就整体报错。所以顶层类型严格、内部宽松。
+		const objCodec = {
+			parse(v) {
+				if (v === null || typeof v !== "object" || Array.isArray(v)) throw new Error("sage-mem: expected object");
+				return v;
+			},
+		};
+		const arrCodec = {
+			parse(v) {
+				if (!Array.isArray(v)) throw new Error("sage-mem: expected array");
+				return v;
+			},
+		};
+		const boolCodec = {
+			parse(v) {
+				if (typeof v !== "boolean") throw new Error("sage-mem: expected boolean");
+				return v;
+			},
+		};
+
 		const TYPERT_REMOTE = {
 			package: "sage-mem",
 			descriptors: [
@@ -1419,6 +1462,89 @@ const StarmapRuntime = (function (require, _react) {
 					result: { mode: "strict", typeSymbol: "sage-mem/types#StarmapRead", schema: starmapReadSchema, create: () => starmapReadSchema },
 					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
 				},
+				// ── dream（夜间整理）──
+				// 2026-09-27 踩到的坑：namespace 不会自动出现。dsh-api-remotes 里那份
+				// remote 清单是**官方构建期生成的产物**，只有 memory / starmap 在里面；
+				// 后加的 dream 不在，于是 `ctx.get("remote.dream")` 永远 undefined ——
+				// 界面上表现为「remote.dream 不可用」，而 host 半日志明确写着
+				// 「dream gateway mounted ok」（服务是真的挂上了，只是 client 不知道）。
+				// 修法就是这七条：和 memory / starmap 一样，自己声明 + $mount。
+				{
+					id: "sage-mem#dream/getConfig",
+					service: "dream",
+					namespace: "dream",
+					method: "getConfig",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamConfigResult", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/setConfig",
+					service: "dream",
+					namespace: "dream",
+					method: "setConfig",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "patch", wire: "patch", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#DreamPatch", schema: objCodec, create: () => objCodec } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamConfigResult", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/status",
+					service: "dream",
+					namespace: "dream",
+					method: "status",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamStatus", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/runNow",
+					service: "dream",
+					namespace: "dream",
+					method: "runNow",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "force", wire: "force", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#Boolean", schema: boolCodec, create: () => boolCodec } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamRunResult", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/listReports",
+					service: "dream",
+					namespace: "dream",
+					method: "listReports",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamReportList", schema: arrCodec, create: () => arrCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/readReport",
+					service: "dream",
+					namespace: "dream",
+					method: "readReport",
+					invocation: { kind: "direct" },
+					parameters: [
+						{ name: "name", wire: "name", source: "json", codec: { mode: "strict", typeSymbol: "sage-mem/types#FileName", schema: strSchema, create: () => strSchema } },
+					],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#FileContent", schema: objCodec, create: () => objCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
+				{
+					id: "sage-mem#dream/listSnapshots",
+					service: "dream",
+					namespace: "dream",
+					method: "listSnapshots",
+					invocation: { kind: "direct" },
+					parameters: [],
+					result: { mode: "strict", typeSymbol: "sage-mem/types#DreamSnapshotList", schema: arrCodec, create: () => arrCodec },
+					sourceLocation: { "file": "workspace/sage-mem/lib/index.js", "line": 1, "column": 1 },
+				},
 			],
 		};
 
@@ -1430,6 +1556,14 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-dot--bad{background:var(--dsw-alias-state-error-primary,#ef4444);}",
 			".smem-muted{color:var(--dsw-alias-label-secondary);font-size:12px;}",
 			".smem-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}",
+			// 筛选条：类型 + 自定义标签两组 chip，与搜索框是 AND 关系。
+			// 只消费宿主变量，浅色深色同一套语言（这是融入型界面，见 frontend-craft）。
+			".smem-filters{display:flex;align-items:center;gap:6px;flex-wrap:wrap;}",
+			".smem-filters-label{font-size:11.5px;color:var(--dsw-alias-label-secondary);flex:none;}",
+			".smem-sep{width:1px;height:15px;background:var(--dsw-alias-border-l2);flex:none;margin:0 3px;}",
+			".smem-chip-n{opacity:.62;margin-left:5px;font-variant-numeric:tabular-nums;}",
+			".smem-taglist{display:flex;gap:4px;flex-wrap:wrap;}",
+			".smem-tag{font-size:11px;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-3,var(--dsw-alias-bg-layer-2));border-radius:5px;padding:1px 6px;white-space:nowrap;}",
 			".smem-search{flex:1;min-width:160px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-layer-2);color:inherit;padding:5px 10px;font-size:12px;outline:none;font-family:inherit;}",
 			".smem-search:focus{border-color:var(--dsw-alias-brand-primary,#4d76e6);}",
 			".smem-btn{border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);border-radius:8px;padding:4px 12px;font-size:12px;cursor:pointer;font-family:inherit;white-space:nowrap;}",
@@ -1467,7 +1601,30 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-tab{background:none;border:0;padding:8px 2px 10px;font-size:13px;font-family:inherit;color:var(--dsw-alias-label-secondary);cursor:pointer;position:relative;}",
 			'.smem-tab--on{color:var(--dsw-alias-label-primary);}',
 			'.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);}',
-			".smem-starmap{display:flex;flex-direction:column;height:min(70vh,720px);min-height:420px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;overflow:hidden;}",
+			// 高度预算压到 62vh（原 70vh）：设置弹窗本身高度有限，
+			// 70vh 在 1050px 视口下会把星图底部的图例和计数挤出面板之外（实测截图被裁）。
+			".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;}",
+			// ── 「梦境」面板 ──
+			// 融入型：全部走宿主变量，控件复用已有的 chip / input / btn 语言，不另造一套。
+			".smem-dream{display:flex;flex-direction:column;gap:12px;}",
+			".smem-dream-sec{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1);padding:10px 12px;display:flex;flex-direction:column;gap:9px;}",
+			".smem-dream-row{display:flex;align-items:center;gap:9px;flex-wrap:wrap;}",
+			".smem-dream-key{font-size:12px;color:var(--dsw-alias-label-secondary);flex:none;min-width:78px;}",
+			".smem-switch{border:1px solid var(--dsw-alias-border-l2);background:transparent;border-radius:999px;width:38px;height:21px;position:relative;cursor:pointer;flex:none;padding:0;}",
+			'.smem-switch::after{content:"";position:absolute;top:2px;left:2px;width:15px;height:15px;border-radius:50%;background:var(--dsw-alias-label-secondary);transition:left .15s,background .15s;}',
+			'.smem-switch[data-on="1"]{border-color:var(--dsw-alias-brand-primary,#4d76e6);background:var(--dsw-alias-brand-primary,#4d76e6);}',
+			'.smem-switch[data-on="1"]::after{left:19px;background:#fff;}',
+			".smem-num{width:66px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-base);color:inherit;padding:4px 8px;font-size:12px;font-family:inherit;outline:none;}",
+			".smem-num:focus{border-color:var(--dsw-alias-brand-primary,#4d76e6);}",
+			".smem-status{font-size:12px;color:var(--dsw-alias-label-secondary);}",
+			".smem-dream-note{font-size:11.5px;color:var(--dsw-alias-label-secondary);line-height:1.5;}",
+			".smem-dream-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);}",
+			'.smem-report[data-on="1"]{border-color:var(--dsw-alias-brand-primary,#4d76e6);}',
+			".smem-report-pre{max-height:320px;overflow:auto;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:10px 12px;background:var(--dsw-alias-bg-layer-2);font-size:12px;white-space:pre-wrap;overflow-wrap:anywhere;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;line-height:1.6;}",
+			".smem-dream-adv>summary{cursor:pointer;font-size:12px;color:var(--dsw-alias-label-secondary);}",
+			".smem-dream-adv>div{display:flex;flex-direction:column;gap:8px;padding-top:9px;}",
 		].join("\n");
 
 		const TYPE_META = {
@@ -1477,6 +1634,26 @@ const StarmapRuntime = (function (require, _react) {
 			reference: ["🔗", "参考"],
 		};
 		const TYPE_ORDER = ["user", "feedback", "project", "reference"];
+		// 筛选条上的显示名：emoji 在筛选条里太吵，只用文字；special 是星图的兜底类，
+		// 文件列表里出现它说明 frontmatter 写了 type: special（本机有 2 条）。
+		const TYPE_LABEL = { user: "用户", feedback: "反馈", project: "项目", reference: "参考", special: "特殊" };
+		const TYPE_SORT = ["user", "feedback", "project", "reference", "special"];
+
+		/**
+		 * 把输入框里的一串标签切成数组。
+		 *
+		 * 分隔符收半角逗号、全角逗号、顿号三种 —— 中文输入法下这三种都会自然敲出来。
+		 * 顺手剥掉 YAML 里有语法含义的字符（[ ] " ' # :），因为标签是按 flow 写法
+		 * 落进 frontmatter 的，带着这些字符写进去会让整行解析错位。
+		 */
+		function parseTagInput(s) {
+			return String(s == null ? "" : s)
+				.split(/[,，、]+/)
+				.map(function (t) { return t.replace(/[\[\]"'#:]/g, "").trim(); })
+				.filter(Boolean)
+				.slice(0, 20)
+				.map(function (t) { return t.slice(0, 40); });
+		}
 
 		// ── frontmatter 纯逻辑（顶层自包含普通函数，不碰 React state）─────
 		//
@@ -1553,6 +1730,32 @@ const StarmapRuntime = (function (require, _react) {
 			return m ? stripQuotes(m[1]) : "";
 		}
 
+		/**
+		 * 取顶层 tags 的值。三种写法都认，与 host 半 parseTags 保持同一套规则：
+		 *   tags: ["a", "b"]       （flow，本插件自己写出去的就是这种）
+		 *   tags:\n  - a\n  - b    （block，手写文件常见）
+		 *   tags: a, b             （松散逗号串）
+		 */
+		function detectTags(text) {
+			const fm = fmInner(text);
+			const flow = fm.match(/^tags[ \t]*:[ \t]*\[([^\]]*)\]/m);
+			if (flow) return flow[1].split(",").map(stripQuotes).filter(Boolean);
+			const block = fm.match(/^tags[ \t]*:[ \t]*\r?\n((?:[ \t]+-[^\r\n]*\r?\n?)+)/m);
+			if (block) {
+				return block[1].split(/\r?\n/).map(function (l) {
+					return stripQuotes(l.replace(/^[ \t]*-[ \t]*/, ""));
+				}).filter(Boolean);
+			}
+			const inline = fm.match(/^tags[ \t]*:[ \t]*(.+?)[ \t\r]*$/m);
+			if (inline && inline[1].trim()) return inline[1].split(",").map(stripQuotes).filter(Boolean);
+			return [];
+		}
+
+		/** 渲染 tags 成一行 YAML flow（带引号：标签可能含空格或中文标点）。 */
+		function renderTags(tags) {
+			return "tags: [" + tags.map(function (t) { return '"' + yamlQuote(t) + '"'; }).join(", ") + "]";
+		}
+
 		/**
 		 * 就地合并 frontmatter，返回新的完整文件内容。
 		 * patch = { type, description, addMissingType }
@@ -1587,12 +1790,34 @@ const StarmapRuntime = (function (require, _react) {
 
 			const wantDesc = typeof p.description === "string" && p.description !== oldDesc;
 			const wantType = typeof p.type === "string" && p.type !== "" && p.type !== oldType;
+			// tags：只有传了数组才管（undefined = 调用方不关心，一行都不动）；空数组 = 明确要求移除。
+			// 相同则整行逐字保留 —— 与 description 一样的规矩，别把用户手写的
+			// `tags:\n  - a` block 形式悄悄改写成 flow 形式。
+			const wantTags = Array.isArray(p.tags);
+			const tagsSame = wantTags && JSON.stringify(detectTags(parts.fm)) === JSON.stringify(p.tags);
+			let tagsIdx = -1;
+			for (let i = 0; i < srcLines.length; i++) {
+				if (/^tags[ \t]*:/.test(srcLines[i])) { tagsIdx = i; break; }
+			}
 			const out = [];
 			let descDone = !wantDesc;
 			let typeDone = !wantType || typeIdx < 0;
+			let tagsDone = !wantTags || tagsSame;
+			let tagsBlockChild = false;
 			let metadataAt = -1;
 			for (let i = 0; i < srcLines.length; i++) {
 				const line = srcLines[i];
+				// block 形式 tags 的缩进子行：紧跟在被替换/移除的 tags 行之后，一起处理掉
+				if (tagsBlockChild) {
+					if (/^[ \t]*-[^\r\n]*$/.test(line)) continue;
+					tagsBlockChild = false;
+				}
+				if (!tagsDone && i === tagsIdx) {
+					if (p.tags.length) out.push(renderTags(p.tags));
+					tagsDone = true;
+					tagsBlockChild = true;
+					continue;
+				}
 				if (/^metadata[ \t]*:/.test(line)) metadataAt = out.length;
 				if (!descDone && /^description[ \t]*:/.test(line)) {
 					out.push('description: "' + yamlQuote(p.description) + '"');
@@ -1631,6 +1856,19 @@ const StarmapRuntime = (function (require, _react) {
 				}
 				if (at >= 0) out.splice(at, 0, rendered); else out.unshift(rendered);
 			}
+			// 原本没有 tags 行 → 只在这次确实要写标签时插一行（空数组不插，避免留下一行空 tags）
+			if (wantTags && tagsIdx < 0 && p.tags.length) {
+				let at = -1;
+				for (let i = 0; i < out.length; i++) {
+					if (/^description[ \t]*:/.test(out[i])) { at = i + 1; break; }
+				}
+				if (at < 0) {
+					for (let i = 0; i < out.length; i++) {
+						if (/^name[ \t]*:/.test(out[i])) { at = i + 1; break; }
+					}
+				}
+				if (at >= 0) out.splice(at, 0, renderTags(p.tags)); else out.unshift(renderTags(p.tags));
+			}
 
 			// 原文件是 CRLF 就照样回写 CRLF（LF 文件回写 \n）——保证逐字节 round-trip。
 			// 组件把原文重建成 "---\n" + fm + "\n---\n" + body，所以还要从 fm / body 里看 CRLF。
@@ -1642,10 +1880,11 @@ const StarmapRuntime = (function (require, _react) {
 		 * 新建记忆的 frontmatter（只用于「添加记忆」或原本没有 frontmatter 的文件；
 		 * 编辑已有文件一律走 mergeFrontmatter，绝不重建）。
 		 */
-		function buildFrontmatter(type, desc, fileName) {
+		function buildFrontmatter(type, desc, fileName, tags) {
 			const slug = String(fileName == null ? "" : fileName).replace(/\.md$/i, "");
-			return "---\nname: \"" + yamlQuote(slug) + "\"\ndescription: \"" + yamlQuote(desc) +
-				"\"\nmetadata:\n  node_type: memory\n  type: " + type + "\n---\n\n";
+			const tagLine = Array.isArray(tags) && tags.length ? "\n" + renderTags(tags) : "";
+			return "---\nname: \"" + yamlQuote(slug) + "\"\ndescription: \"" + yamlQuote(desc) + "\"" +
+				tagLine + "\nmetadata:\n  node_type: memory\n  type: " + type + "\n---\n\n";
 		}
 
 		function fmtSize(n) {
@@ -1678,6 +1917,11 @@ const StarmapRuntime = (function (require, _react) {
 					h("span", { className: "smem-card-title", key: "title" }, item.file),
 					h("span", { className: "smem-muted", key: "size" }, fmtSize(item.size)),
 				]),
+				(item.tags && item.tags.length)
+					? h("div", { className: "smem-taglist", key: "tags" }, item.tags.map(function (t) {
+							return h("span", { className: "smem-tag", key: t }, "#" + t);
+						}))
+					: null,
 				item.description
 					? h("div", {
 							className: "smem-narrative",
@@ -1701,6 +1945,232 @@ const StarmapRuntime = (function (require, _react) {
 			]);
 		}
 
+		/** 单选按钮组。复用已有的 chip 语言，不另造一套视觉。 */
+		function Seg(props) {
+			return h("div", { className: "smem-chips" }, props.options.map(function (o) {
+				return h("button", {
+					type: "button",
+					key: o.value,
+					className: "smem-chip",
+					"data-on": props.value === o.value ? "1" : "0",
+					onClick: function () { if (props.value !== o.value) props.onChange(o.value); },
+				}, o.label);
+			}));
+		}
+
+		/**
+		 * 「梦境」面板 —— 夜间记忆整理（移植 Claude Code 的 autoDream）。
+		 *
+		 * 数据全走 remote.dream（host 半的 DreamGateway）。两条实现约定：
+		 *   1. **轮询而不是等待**。「立即整理」启动后台任务后立刻返回 —— 一趟可能跑
+		 *      几分钟，把 remote 调用挂在那儿等会撞上前端超时。进度靠每 2 秒拉一次
+		 *      status() 显示。
+		 *   2. **不替用户做判断**。触发方式 / 改动方式 / 输入源三件事各自明说代价
+		 *      （比如「记忆 + 会话记录」会把私密对话送进模型），默认全是最保守的那一档。
+		 */
+		function DreamPanel(props) {
+			const remote = props.ctx && props.ctx.get ? props.ctx.get("remote.dream") : null;
+			const sCfg = react.useState(null); const cfg = sCfg[0], setCfg = sCfg[1];
+			const sSt = react.useState(null); const st = sSt[0], setSt = sSt[1];
+			const sErr = react.useState(null); const err = sErr[0], setErr = sErr[1];
+			const sNotice = react.useState(""); const notice = sNotice[0], setNotice = sNotice[1];
+			const sBusy = react.useState(false); const busy = sBusy[0], setBusy = sBusy[1];
+			const sReports = react.useState([]); const reports = sReports[0], setReports = sReports[1];
+			const sOpen = react.useState(null); const open = sOpen[0], setOpen = sOpen[1];
+			const sBody = react.useState(""); const body = sBody[0], setBody = sBody[1];
+			const sModelEdit = react.useState(false); const modelEdit = sModelEdit[0], setModelEdit = sModelEdit[1];
+			const sProv = react.useState(""); const prov = sProv[0], setProv = sProv[1];
+			const sModel = react.useState(""); const model = sModel[0], setModel = sModel[1];
+
+			react.useEffect(function () {
+				if (!remote) { setErr("remote.dream 不可用 —— 插件的 host 半可能没加载成功，看 DSH 启动日志"); return undefined; }
+				let alive = true;
+				function pull() {
+					remote.status().then(function (r) {
+						if (!alive) return;
+						const d = unwrap(r);
+						if (d) { setSt(d); if (d.config) setCfg(d.config); }
+						setErr(null);
+					}).catch(function (e) { if (alive) setErr(detail(e)); });
+				}
+				pull();
+				remote.listReports().then(function (r) { if (alive) setReports(unwrap(r) || []); }).catch(function () {});
+				const id = setInterval(pull, 2000);
+				return function () { alive = false; clearInterval(id); };
+			}, [remote]);
+
+			function patch(p) {
+				setErr(null); setNotice("");
+				remote.setConfig(p).then(function (r) {
+					const d = unwrap(r);
+					if (d && d.config) setCfg(d.config);
+				}).catch(function (e) { setErr(detail(e)); });
+			}
+
+			function run() {
+				setErr(null); setNotice(""); setBusy(true);
+				remote.runNow(true).then(function (r) {
+					const d = unwrap(r);
+					if (d && d.ok === false) setErr(d.error || "启动失败");
+					else setNotice("已开始整理 —— 进度每 2 秒刷新一次");
+					return remote.listReports().then(function (rr) { setReports(unwrap(rr) || []); });
+				}).catch(function (e) { setErr(detail(e)); }).then(function () { setBusy(false); });
+			}
+
+			function openReport(name) {
+				if (name === null) { setOpen(null); setBody(""); return; }
+				setOpen(name); setBody("载入中…");
+				remote.readReport(name).then(function (r) {
+					const d = unwrap(r);
+					setBody((d && d.content) || "(空)");
+				}).catch(function (e) { setBody("读取失败：" + detail(e)); });
+			}
+
+			const c = cfg || {};
+			const running = !!(st && st.running);
+			const last = (st && st.lastResult) || null;
+
+			return h("div", { className: "smem-dream" }, [
+				h("div", { className: "smem-dream-sec", key: "top" }, [
+					h("div", { className: "smem-dream-row", key: "r" }, [
+						h("button", {
+							type: "button", key: "sw", className: "smem-switch",
+							"data-on": c.enabled ? "1" : "0",
+							title: c.enabled ? "点击停用" : "点击启用",
+							"aria-label": "启用或停用夜间整理",
+							onClick: function () { patch({ enabled: !c.enabled }); },
+						}),
+						h("span", { key: "t", style: { fontWeight: "600" } }, "夜间整理（dream）"),
+						h("span", { className: "smem-status", key: "s" },
+							running ? ("运行中 · " + String((st && st.phase) || "准备中")) : (c.enabled ? "已启用 · 空闲" : "未启用")),
+					]),
+					h("div", { className: "smem-dream-note", key: "n" },
+						"把记忆目录通读一遍：合并重复的、删掉被推翻的、修索引与断链、把相对日期换成绝对日期。门控、锁、快照、审计都照 Claude Code autoDream 那套做。"),
+				]),
+				h("div", { className: "smem-dream-sec", key: "mode" }, [
+					h("div", { className: "smem-dream-row", key: "a" }, [
+						h("span", { className: "smem-dream-key", key: "k" }, "触发"),
+						h(Seg, {
+							key: "v", value: c.trigger,
+							options: [{ value: "manual", label: "只手动" }, { value: "auto", label: "满足条件自动跑" }],
+							onChange: function (v) { patch({ trigger: v }); },
+						}),
+					]),
+					h("div", { className: "smem-dream-row", key: "b" }, [
+						h("span", { className: "smem-dream-key", key: "k" }, "改动方式"),
+						h(Seg, {
+							key: "v", value: c.apply ? "apply" : "report",
+							options: [{ value: "report", label: "只出报告" }, { value: "apply", label: "直接改写（先快照）" }],
+							onChange: function (v) { patch({ apply: v === "apply" }); },
+						}),
+					]),
+					h("div", { className: "smem-dream-row", key: "c" }, [
+						h("span", { className: "smem-dream-key", key: "k" }, "输入源"),
+						h(Seg, {
+							key: "v", value: c.source,
+							options: [{ value: "memory", label: "仅记忆目录" }, { value: "memory+sessions", label: "记忆 + 会话记录" }],
+							onChange: function (v) { patch({ source: v }); },
+						}),
+					]),
+					h("div", { className: "smem-dream-note", key: "w" },
+						c.source === "memory+sessions"
+							? "会解压会话记录做定向搜索 —— 私密对话会进入模型上下文，token 成本也更高。"
+							: "只看记忆文件本身，不碰会话记录。"),
+					h("div", { className: "smem-dream-note", key: "w2" },
+						c.apply
+							? "改写前会自动把整个记忆目录快照一份（memory 上一层 .sage-mem/snapshots/），改坏可回退。"
+							: "只读模式：这一趟连写工具都不会挂给模型，所以它不可能改到任何文件。"),
+				]),
+				h("details", { className: "smem-dream-adv", key: "adv" }, [
+					h("summary", { key: "s" }, "高级设置"),
+					h("div", { key: "d" }, [
+						c.trigger === "auto" ? h("div", { className: "smem-dream-row", key: "gate" }, [
+							h("span", { className: "smem-dream-key", key: "k" }, "自动触发"),
+							h("span", { className: "smem-status", key: "a" }, "距上次 ≥"),
+							h("input", { className: "smem-num", key: "h", type: "number", min: "1", max: "720", value: c.minHours, onChange: function (e) { patch({ minHours: Number(e.target.value) }); } }),
+							h("span", { className: "smem-status", key: "b" }, "小时，且期间 ≥"),
+							h("input", { className: "smem-num", key: "m", type: "number", min: "1", max: "200", value: c.minSessions, onChange: function (e) { patch({ minSessions: Number(e.target.value) }); } }),
+							h("span", { className: "smem-status", key: "c" }, "个会话有更新"),
+						]) : null,
+						h("div", { className: "smem-dream-row", key: "model" }, [
+							h("span", { className: "smem-dream-key", key: "k" }, "模型"),
+							modelEdit
+								? [
+										h("input", { className: "smem-input", key: "p", style: { flex: "1", minWidth: "110px" }, value: prov, placeholder: "provider（留空=默认）", onChange: function (e) { setProv(e.target.value); } }),
+										h("input", { className: "smem-input", key: "m", style: { flex: "1", minWidth: "110px" }, value: model, placeholder: "model（留空=默认）", onChange: function (e) { setModel(e.target.value); } }),
+										h("button", { type: "button", className: "smem-btn smem-btn-primary", key: "ok", onClick: function () { patch({ provider: prov, model: model }); setModelEdit(false); setNotice("模型已保存"); } }, "保存"),
+										h("button", { type: "button", className: "smem-btn", key: "no", onClick: function () { setModelEdit(false); } }, "取消"),
+									]
+								: [
+										h("span", { className: "smem-status", key: "cur" },
+											st && st.route ? (st.route.provider + " / " + st.route.model + (st.route.fromDefault ? "（跟随聊天页默认）" : "")) : "（拿不到默认模型）"),
+										h("button", {
+											type: "button", className: "smem-btn", key: "e",
+											onClick: function () { setProv(c.provider || ""); setModel(c.model || ""); setModelEdit(true); },
+										}, "改"),
+									],
+						]),
+						h("div", { className: "smem-dream-row", key: "steps" }, [
+							h("span", { className: "smem-dream-key", key: "k" }, "最多轮数"),
+							h("input", { className: "smem-num", key: "v", type: "number", min: "1", max: "80", value: c.maxSteps, onChange: function (e) { patch({ maxSteps: Number(e.target.value) }); } }),
+							h("span", { className: "smem-status", key: "s" }, "一轮 = 一次模型调用 + 它要的工具调用"),
+						]),
+						h("div", { className: "smem-dream-row", key: "keep" }, [
+							h("span", { className: "smem-dream-key", key: "k" }, "保留快照"),
+							h("input", { className: "smem-num", key: "v", type: "number", min: "1", max: "50", value: c.maxSnapshotKeep, onChange: function (e) { patch({ maxSnapshotKeep: Number(e.target.value) }); } }),
+							h("span", { className: "smem-status", key: "s" }, "份"),
+						]),
+						h("div", { className: "smem-status", key: "paths" }, "配置与状态：" + ((st && st.paths && st.paths.configPath) || "—")),
+					]),
+				]),
+				h("div", { className: "smem-dream-sec", key: "run" }, [
+					h("div", { className: "smem-dream-row", key: "r" }, [
+						h("button", {
+							type: "button", className: "smem-btn smem-btn-primary", key: "go",
+							disabled: busy || running || !remote,
+							onClick: run,
+						}, running ? "正在整理…" : "立即整理"),
+						h("span", { className: "smem-status", key: "s" },
+							running
+								? ("已跑 " + ((st && st.steps && st.steps.length) || 0) + " 轮 · " + String((st && st.phase) || ""))
+								: (st && st.hoursSince != null ? ("距上次整理 " + st.hoursSince.toFixed(1) + " 小时") : "从未整理过")),
+					]),
+					running && st && st.steps && st.steps.length
+						? h("div", { className: "smem-dream-note", key: "prog" }, st.steps.map(function (x) {
+								return "第 " + x.step + " 轮：" + (x.tools.length ? x.tools.join("、") : "结束");
+							}).join("　·　"))
+						: null,
+					last
+						? h("div", { className: "smem-status", key: "last" },
+								"上次 " + String(last.atHuman || "") + " · " + (last.ok
+									? ("成功" + (last.apply ? "，改写了 " + ((last.touched || []).length) + " 个文件" : "（只出报告）") +
+										" · 结构问题 " + last.problemsBefore + " → " + last.problemsAfter +
+										" · token " + last.tokensIn + " / " + last.tokensOut)
+									: ("失败：" + (last.error || "未知"))) +
+								(last.report ? " · 报告 " + last.report : ""))
+						: null,
+				]),
+				h("div", { className: "smem-dream-sec", key: "rep" }, [
+					h("div", { className: "smem-dream-row", key: "h" }, [
+						h("span", { key: "t", style: { fontWeight: "600", fontSize: "12.5px" } }, "历史报告"),
+						h("span", { className: "smem-status", key: "c" }, String(reports.length) + " 份"),
+					]),
+					reports.length === 0
+						? h("div", { className: "smem-status", key: "e" }, "还没有报告 —— 跑一次就有了。报告写在 memory/dream/ 下，不会混进记忆列表。")
+						: h("div", { className: "smem-dream-list", key: "l" }, reports.slice(0, 12).map(function (r) {
+								return h("button", {
+									type: "button", key: r.name, className: "smem-report",
+									"data-on": open === r.name ? "1" : "0",
+									onClick: function () { openReport(open === r.name ? null : r.name); },
+								}, String(r.atHuman || "") + " · " + r.name + " · " + fmtSize(r.bytes) + (open === r.name ? " · 收起" : " · 查看"));
+							})),
+					open && body ? h("pre", { className: "smem-report-pre", key: "body" }, body) : null,
+				]),
+				err ? h("div", { className: "smem-err", key: "err" }, "⚠ " + err) : null,
+				notice && !err ? h("div", { className: "smem-ok", key: "ok" }, "✓ " + notice) : null,
+			]);
+		}
+
 		function Section(props) {
 			const remote = props.ctx.get("remote.memory");
 			const sItems = react.useState([]);
@@ -1729,6 +2199,20 @@ const StarmapRuntime = (function (require, _react) {
 			const formDesc = sFormDesc[0], setFormDesc = sFormDesc[1];
 			const sFormBody = react.useState("");
 			const formBody = sFormBody[0], setFormBody = sFormBody[1];
+			const sFormTags = react.useState("");
+			const formTags = sFormTags[0], setFormTags = sFormTags[1];
+			// 筛选：空数组 = 不筛。类型与标签各自组内 OR、两组之间 AND，再与搜索框 AND。
+			const sTypeFilter = react.useState([]);
+			const typeFilter = sTypeFilter[0], setTypeFilter = sTypeFilter[1];
+			const sTagFilter = react.useState([]);
+			const tagFilter = sTagFilter[0], setTagFilter = sTagFilter[1];
+			function toggleIn(setter, value) {
+				setter(function (cur) {
+					return cur.indexOf(value) >= 0
+						? cur.filter(function (x) { return x !== value; })
+						: cur.concat([value]);
+				});
+			}
 			// 打开编辑时的原 frontmatter 原文（null = 该文件没有 frontmatter）
 			const sFormFm = react.useState(null);
 			const formFm = sFormFm[0], setFormFm = sFormFm[1];
@@ -1764,7 +2248,7 @@ const StarmapRuntime = (function (require, _react) {
 
 			function closeForm() {
 				setFormOpen(false); setEditingFile(null); setFormName(""); setFormDesc(""); setFormBody(""); setFormType("feedback");
-				setFormFm(null); setFormBaseType("");
+				setFormFm(null); setFormBaseType(""); setFormTags("");
 			}
 
 			function openEdit(file) {
@@ -1786,6 +2270,7 @@ const StarmapRuntime = (function (require, _react) {
 						setFormBaseType(shown);
 						setFormDesc(extractDescription(parts.fm));
 						setFormBody(parts.body);
+						setFormTags(detectTags(parts.fm).join(", "));
 						// 关键：原 frontmatter 原文留着，保存时「就地合并」而不是重建
 						setFormFm(parts.hasFm ? parts.fm : null);
 						setFormOpen(true);
@@ -1803,6 +2288,7 @@ const StarmapRuntime = (function (require, _react) {
 				setFormDesc("");
 				setFormBody("");
 				setFormFm(null);
+				setFormTags("");
 				setFormOpen(true);
 			}
 
@@ -1813,18 +2299,20 @@ const StarmapRuntime = (function (require, _react) {
 				const name = (formName.trim() || (type + "_note.md"));
 				const safeName = name.endsWith(".md") ? name : name + ".md";
 				const desc = formDesc.trim();
+				const tags = parseTagInput(formTags);
 				let content;
 				if (formFm === null) {
 					// 没有 frontmatter（新增记忆 / 索引文件）→ 生成一份
-					content = buildFrontmatter(type, desc, safeName) + formBody;
+					content = buildFrontmatter(type, desc, safeName, tags) + formBody;
 				} else {
-					// 有 frontmatter → 就地合并：除 description / type 外一字不动
+					// 有 frontmatter → 就地合并：除 description / type / tags 外一字不动
 					const original = "---\n" + formFm + "\n---\n" + formBody;
 					content = mergeFrontmatter(original, {
 						type: type,
 						description: desc,
 						// 原文没有 type 行时，只有用户确实改过类型才补写一行
 						addMissingType: type !== formBaseType,
+						tags: tags,
 					});
 				}
 				remote.writeFile(safeName, content)
@@ -1852,29 +2340,103 @@ const StarmapRuntime = (function (require, _react) {
 					.then(function () { setBusy(false); });
 			}
 
+			// ── 筛选条的数据 ──
+			// 计数一律按**全量**算，不随当前筛选变化 —— 否则一筛下去别的类型就都显示 0，
+			// 用户没法知道「换个类型还有多少条」。
+			const typeCounts = {};
+			const tagCounts = {};
+			for (let i = 0; i < items.length; i++) {
+				const it = items[i];
+				const t = it.type || "reference";
+				typeCounts[t] = (typeCounts[t] || 0) + 1;
+				const tg = Array.isArray(it.tags) ? it.tags : [];
+				for (let j = 0; j < tg.length; j++) tagCounts[tg[j]] = (tagCounts[tg[j]] || 0) + 1;
+			}
+			// 类型顺序：认识的类型按固定次序在前（用户/反馈/项目/参考/特殊），
+			// 遇到 frontmatter 里写了别的 type 的，按名字排在后面 —— 不丢任何一个。
+			const typeList = Object.keys(typeCounts).sort(function (a, b) {
+				const ia = TYPE_SORT.indexOf(a), ib = TYPE_SORT.indexOf(b);
+				if (ia >= 0 && ib >= 0) return ia - ib;
+				if (ia >= 0) return -1;
+				if (ib >= 0) return 1;
+				return a < b ? -1 : 1;
+			});
+			const tagList = Object.keys(tagCounts).sort(function (a, b) {
+				return tagCounts[b] - tagCounts[a] || (a < b ? -1 : 1);
+			});
+
 			const q = query.trim().toLowerCase();
 			const filtered = items.filter(function (it) {
+				if (typeFilter.length && typeFilter.indexOf(it.type || "reference") < 0) return false;
+				if (tagFilter.length) {
+					const tg = Array.isArray(it.tags) ? it.tags : [];
+					let hit = false;
+					for (let i = 0; i < tagFilter.length; i++) {
+						if (tg.indexOf(tagFilter[i]) >= 0) { hit = true; break; }
+					}
+					if (!hit) return false;
+				}
 				if (!q) return true;
-				const hay = ((it.file || "") + "\n" + (it.description || "") + "\n" + (it.type || "")).toLowerCase();
+				const hay = ((it.file || "") + "\n" + (it.description || "") + "\n" + (it.type || "") + "\n" +
+					(Array.isArray(it.tags) ? it.tags.join(" ") : "")).toLowerCase();
 				return hay.indexOf(q) >= 0;
 			});
+			const hasFilter = !!(typeFilter.length || tagFilter.length || q);
 
 			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 === "dream" ? " smem-tab--on" : ""), key: "d", onClick: function () { setTab("dream"); } }, "夜间整理"),
 				]),
 				h("div", { className: "smem-head", key: "head" }, [
 					h("span", { className: "smem-title", key: "t" }, "记忆文件（sage-mem）"),
 					h("span", { className: "smem-dot" + (dirOk ? "" : " smem-dot--bad"), key: "dot", title: dirOk ? "memory 目录可读" : "memory 目录不可读" }),
 					h("span", { className: "smem-muted", key: "st" }, dirOk ? "目录可读" : "目录不可读"),
-					h("span", { className: "smem-badge", key: "cnt" }, "共 " + String(items.length) + " 个文件"),
+					h("span", { className: "smem-badge", key: "cnt" }, hasFilter
+						? "筛出 " + String(filtered.length) + " / " + String(items.length)
+						: "共 " + String(items.length) + " 个文件"),
 				]),
-				h("div", { className: "smem-toolbar", key: "bar" }, [
-					h("input", { className: "smem-search", key: "q", value: query, placeholder: "搜索文件名 / 描述 / 类型…", onChange: function (e) { setQuery(e.target.value); } }),
+				// 搜索 / 刷新 / 添加 / 筛选都只属于「文件列表」这个视图。
+				// 放在 tab 分支外面，会让星图和夜间整理页也顶着一排用不上的控件
+				// （2026-09-27 截图走查时发现：「+ 添加记忆」出现在星图页上）。
+				tab === "files" ? h("div", { className: "smem-toolbar", key: "bar" }, [
+					h("input", { className: "smem-search", key: "q", value: query, placeholder: "搜索文件名 / 描述 / 类型 / 标签…", onChange: function (e) { setQuery(e.target.value); } }),
 					h("button", { type: "button", className: "smem-btn", key: "refresh", disabled: busy || loading, onClick: load }, "刷新"),
 					h("button", { type: "button", className: "smem-btn smem-btn-primary", key: "add", onClick: openAdd }, "+ 添加记忆"),
-				]),
+				]) : null,
+				tab === "files" && items.length
+					? h("div", { className: "smem-filters", key: "filters" }, [
+							h("span", { className: "smem-filters-label", key: "lt" }, "类型"),
+							h("button", {
+								type: "button", key: "all", className: "smem-chip",
+								"data-on": typeFilter.length ? "0" : "1",
+								onClick: function () { setTypeFilter([]); },
+							}, ["全部", h("span", { className: "smem-chip-n", key: "n" }, String(items.length))]),
+							typeList.map(function (t) {
+								return h("button", {
+									type: "button", key: t, className: "smem-chip",
+									"data-on": typeFilter.indexOf(t) >= 0 ? "1" : "0",
+									onClick: function () { toggleIn(setTypeFilter, t); },
+								}, [TYPE_LABEL[t] || t, h("span", { className: "smem-chip-n", key: "n" }, String(typeCounts[t]))]);
+							}),
+							tagList.length ? h("span", { className: "smem-sep", key: "sep" }) : null,
+							tagList.length ? h("span", { className: "smem-filters-label", key: "lgt" }, "标签") : null,
+							tagList.map(function (g) {
+								return h("button", {
+									type: "button", key: "tag-" + g, className: "smem-chip",
+									"data-on": tagFilter.indexOf(g) >= 0 ? "1" : "0",
+									onClick: function () { toggleIn(setTagFilter, g); },
+								}, ["#" + g, h("span", { className: "smem-chip-n", key: "n" }, String(tagCounts[g]))]);
+							}),
+							hasFilter
+								? h("button", {
+										type: "button", key: "clear", className: "smem-btn",
+										onClick: function () { setTypeFilter([]); setTagFilter([]); setQuery(""); },
+									}, "清除筛选")
+								: null,
+						])
+					: null,
 				error ? h("div", { className: "smem-err", key: "err" }, "⚠ " + error) : null,
 				notice && !error ? h("div", { className: "smem-ok", key: "ok" }, "✓ " + notice) : null,
 				formOpen
@@ -1891,6 +2453,8 @@ const StarmapRuntime = (function (require, _react) {
 							h("input", { className: "smem-input", key: "tn", value: formName, onChange: function (e) { setFormName(e.target.value); }, placeholder: "例如 project_traveler.md" }),
 							h("label", { className: "smem-label", key: "ld" }, "描述（写进 frontmatter，检索与列表都靠它）"),
 							h("input", { className: "smem-input", key: "td", value: formDesc, onChange: function (e) { setFormDesc(e.target.value); }, placeholder: "一句话说清这条记忆是什么" }),
+							h("label", { className: "smem-label", key: "lt" }, "自定义标签（可选，逗号分隔；会写进 frontmatter 的 tags，列表页可按它筛）"),
+							h("input", { className: "smem-input", key: "tt", value: formTags, onChange: function (e) { setFormTags(e.target.value); }, placeholder: "例如 发布, 脱敏, dsh" }),
 							h("label", { className: "smem-label", key: "lb" }, "正文（可选，frontmatter 自动生成）"),
 							h("textarea", { className: "smem-textarea", key: "tb", rows: 6, value: formBody, onChange: function (e) { setFormBody(e.target.value); }, placeholder: "要长期记住的细节" }),
 							h("div", { className: "smem-row", key: "btns" }, [
@@ -1899,7 +2463,9 @@ const StarmapRuntime = (function (require, _react) {
 							]),
 						])
 					: null,
-				tab === "star"
+				tab === "dream"
+					? h(DreamPanel, { key: "dream", ctx: props.ctx })
+					: tab === "star"
 					? h("div", { className: "smem-starmap", key: "starmap" },
 							h(StarmapRuntime.StarMap, { ctx: props.ctx }))
 					: loading && items.length === 0