sage-mem 2.7.0 → 2.7.1

package/README.en.md

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

package/README.md

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

package/lib/client.js

@@ -678,9 +678,10 @@ const StarmapRuntime = (function (require, _react) {
 			"uniform float uTime;",
 			"uniform float uHoverIdx;",
 			"uniform float uRevealT;",
+			"uniform float uFadeMs;",
 			"float revealFactor(){",
 			"  if (vBirth < 0.0) return 1.0;",
-			"  float t = clamp((uRevealT - vBirth) / 900.0, 0.0, 1.0);",
+			"  float t = clamp((uRevealT - vBirth) / uFadeMs, 0.0, 1.0);",
 			"  return t * t * (3.0 - 2.0 * t);",
 			"}",
 			"void main(){",
@@ -725,9 +726,10 @@ const StarmapRuntime = (function (require, _react) {
 			"varying vec4 vColor;",
 			"varying float vBirth;",
 			"uniform float uRevealT;",
+			"uniform float uFadeMs;",
 			"void main(){",
 			"  if (vBirth < 0.0){ gl_FragColor = vColor; return; }",
-			"  float t = clamp((uRevealT - vBirth) / 900.0, 0.0, 1.0);",
+			"  float t = clamp((uRevealT - vBirth) / uFadeMs, 0.0, 1.0);",
 			"  t = t * t * (3.0 - 2.0 * t);",
 			"  gl_FragColor = vec4(vColor.rgb, vColor.a * t);",
 			"}",
@@ -756,6 +758,44 @@ const StarmapRuntime = (function (require, _react) {
 		const SMAP_CORNERS = [-1, -1, 1, -1, 1, 1, -1, -1, 1, 1, -1, 1];
 		const SMAP_ATTR_SIZE = { aCorner: 2, aMeta0: 3, aColor: 4, aMeta1: 3, aBirth: 1 };
 
+		/**
+		 * 诞生回放的**数值域**（Q15 尾巴 / 2.7.2）。
+		 *
+		 * 为什么不能把 epoch 毫秒直接喂给 shader：`vBirth` 是 Float32 顶点属性，`uRevealT`
+		 * 也是 Float32 uniform —— 1.7e12 这个量级的 ulp = 2^(40-23) ≈ 131072 ms，而渐亮窗口
+		 * 只有 900 ms。两个数各自舍入之后，`uRevealT - vBirth` 要么 ≤ 0 要么 ≫ 窗口，
+		 * 于是 WebGL 后端里每颗星其实都是**瞬亮**；canvas2d 兜底路径用 double 不受影响，
+		 * 所以肉眼看不出差异 —— 这正是一个藏了五版的精度问题。
+		 *
+		 * 修法两层：① 时间域压到**最老的那颗星**（base = 最小 mtime），birth 存相对值，
+		 * 最大量级只剩「最老的记忆有多老」；② 窗口按跨度取 `max(900, span/40)`，
+		 * 保证窗口 ≫ 1 ulp（跨度越大时间轴越粗，但 900ms 的固定窗口对粗时间轴毫无意义）。
+		 *
+		 * @param {Array<{star?:{mtimeMs?:number}}>} pts 参与绘制的可见点
+		 * @returns {{base:number, span:number, fadeMs:number}} base=0 表示没有任何时间信息
+		 */
+		function starmapRevealDomain(pts) {
+			const list = Array.isArray(pts) ? pts : [];
+			let mn = Infinity;
+			let mx = -Infinity;
+			for (const p of list) {
+				const m = p && p.star && typeof p.star.mtimeMs === "number" ? p.star.mtimeMs : 0;
+				if (m > 0) {
+					if (m < mn) mn = m;
+					if (m > mx) mx = m;
+				}
+			}
+			if (!isFinite(mn)) return { base: 0, span: 1, fadeMs: 900 };
+			const span = Math.max(mx - mn, 1);
+			return { base: mn, span: span, fadeMs: starmapFadeMs(span) };
+		}
+
+		/** 渐亮窗口：至少 900ms；跨度大时取跨度的 1/40（18s 回放走完整段，观感仍是逐颗点亮）。 */
+		function starmapFadeMs(span) {
+			const s = typeof span === "number" && isFinite(span) && span > 0 ? span : 1;
+			return Math.max(900, s / 40);
+		}
+
 		function pushStarQuad(arr, cx, cy, r, rgb, aBase, twPhase, fresh, idx, birth) {
 			for (let v = 0; v < 6; v++) {
 				arr.push(SMAP_CORNERS[v * 2], SMAP_CORNERS[v * 2 + 1]);
@@ -794,8 +834,8 @@ const StarmapRuntime = (function (require, _react) {
 				gl.viewport(0, 0, canvasEl.width, canvasEl.height);
 				const pal = starmapPalette();
 				const progBg = glProgram(gl, SMAP_BG_VS, smapBgFs(pal.bgGl[0], pal.bgGl[1]), ["aPos"], ["uRes", "uTime"]);
-				const progStar = glProgram(gl, SMAP_STAR_VS, SMAP_STAR_FS, ["aCorner", "aMeta0", "aColor", "aMeta1", "aBirth"], ["uRes", "uTime", "uHoverIdx", "uRevealT"]);
-				const progLine = glProgram(gl, SMAP_LINE_VS, SMAP_LINE_FS, ["aPos", "aColor", "aBirth"], ["uRes", "uRevealT"]);
+				const progStar = glProgram(gl, SMAP_STAR_VS, SMAP_STAR_FS, ["aCorner", "aMeta0", "aColor", "aMeta1", "aBirth"], ["uRes", "uTime", "uHoverIdx", "uRevealT", "uFadeMs"]);
+				const progLine = glProgram(gl, SMAP_LINE_VS, SMAP_LINE_FS, ["aPos", "aColor", "aBirth"], ["uRes", "uRevealT", "uFadeMs"]);
 
 				// 背景全屏两三角(clip space 直给)
 				const bgQuadBuf = gl.createBuffer();
@@ -825,17 +865,22 @@ const StarmapRuntime = (function (require, _react) {
 				// 脏标记：canvas 晚于 visibility effect 挂载时（JSX 分支决定 ref 时序），
 				// setGeometry 可能从未被调过——render 前自动补传，顺序无关。
 				let geoDirty = true;
+				// 诞生回放的时间域（base / span / 渐亮窗口）：由 uploadStars 现算，
+				// 顶点里的 birth、uniform 的 uRevealT 与 uFadeMs 三处必须共用同一份。
+				let revealDomain = { base: 0, span: 1, fadeMs: 900 };
 
 				function uploadStars() {
 					const arr = [];
 					const nowMs = Date.now();
+					revealDomain = starmapRevealDomain(layout.pts.filter(function (p, i) { return !!visBox.flags[i]; }));
 					for (let i = 0; i < layout.pts.length; i++) {
 						if (!visBox.flags[i]) continue;
 						const p = layout.pts[i];
 						const meta = KIND_META[p.star.kind] || KIND_META.special;
 						const arch = p.star.archived === true;
 						const fresh = p.star.mtimeMs > 0 && nowMs - p.star.mtimeMs < FRESH_MS ? 1 : 0;
-						const birth = p.star.mtimeMs > 0 ? p.star.mtimeMs : 0;
+						// -1 在着色器里是「没有诞生时刻，永远全亮」（尘星也是这条分支）。
+						const birth = p.star.mtimeMs > 0 ? p.star.mtimeMs - revealDomain.base : -1;
 						if (arch) {
 							// 归档星 = 暗星，两层画：
 							//   ① 一层很淡的冷色底盘（走 dust 分支：不带星芒、不参与 hover），
@@ -864,7 +909,8 @@ const StarmapRuntime = (function (require, _react) {
 						const hot = hoverLineIdx >= 0 && (ln[0] === hoverLineIdx || ln[1] === hoverLineIdx);
 						const mul = hot ? 1 : 0.72;
 						const al = hot ? 0.6 : 0.22;
-						const birth = Math.max(a.star.mtimeMs || 0, b.star.mtimeMs || 0);
+						const birthAbs = Math.max(a.star.mtimeMs || 0, b.star.mtimeMs || 0);
+						const birth = birthAbs > 0 ? birthAbs - revealDomain.base : -1;
 						arr.push(a.x, a.y, c[0] * mul, c[1] * mul, c[2] * mul, al, birth);
 						arr.push(b.x, b.y, c[0] * mul, c[1] * mul, c[2] * mul, al, birth);
 					}
@@ -878,10 +924,12 @@ const StarmapRuntime = (function (require, _react) {
 					gl.drawArrays(gl.TRIANGLES, 0, count);
 				}
 
-				let revealT = null; // null = 全亮；数字 = 诞生回放的当前时刻
+				let revealT = null; // null = 全亮；数字 = 诞生回放的当前时刻（墙钟 ms）
 				function render(phase) {
 					if (geoDirty) { uploadStars(); uploadLines(); geoDirty = false; }
-					const rt = revealT === null ? 8.7e15 : revealT;
+					// 全亮用一个足够大的哨兵（1e30 在 Float32 里仍可表示，且远大于任何跨度）；
+					// 回放时刻换算到与顶点里的 birth 同一个时间域 —— 两边的差才是精度问题的所在。
+					const rt = revealT === null ? 1e30 : revealT - revealDomain.base;
 					gl.viewport(0, 0, canvasEl.width, canvasEl.height);
 					// 背景:不透明
 					gl.disable(gl.BLEND);
@@ -899,6 +947,7 @@ const StarmapRuntime = (function (require, _react) {
 						gl.useProgram(progLine.prog);
 						gl.uniform2f(progLine.uni.uRes, W, H);
 						gl.uniform1f(progLine.uni.uRevealT, rt);
+						gl.uniform1f(progLine.uni.uFadeMs, revealDomain.fadeMs);
 						gl.bindBuffer(gl.ARRAY_BUFFER, lineBuf);
 						if (progLine.attr.aPos >= 0) { gl.enableVertexAttribArray(progLine.attr.aPos); gl.vertexAttribPointer(progLine.attr.aPos, 2, gl.FLOAT, false, 28, 0); }
 						if (progLine.attr.aColor >= 0) { gl.enableVertexAttribArray(progLine.attr.aColor); gl.vertexAttribPointer(progLine.attr.aColor, 4, gl.FLOAT, false, 28, 8); }
@@ -910,6 +959,7 @@ const StarmapRuntime = (function (require, _react) {
 					gl.uniform1f(progStar.uni.uTime, phase);
 					gl.uniform1f(progStar.uni.uHoverIdx, hoverBox.idx);
 					gl.uniform1f(progStar.uni.uRevealT, rt);
+					gl.uniform1f(progStar.uni.uFadeMs, revealDomain.fadeMs);
 					drawQuad(progStar, dustBuf, dustCount);
 					if (starCount > 0) drawQuad(progStar, starBuf, starCount);
 				}
@@ -948,6 +998,10 @@ const StarmapRuntime = (function (require, _react) {
 			canvasEl.width = W * SCALE;
 			canvasEl.height = H * SCALE;
 			const nowMs = Date.now();
+			// 与 WebGL 路径共用同一份时间域（只取 fadeMs 用；这里都是 double，不存在精度问题，
+			// 但窗口长度必须一致 —— 否则两条路径的点亮节奏对不上，真机上看就是两套动画）。
+			const domain = starmapRevealDomain(layout.pts.filter(function (p, i) { return !!visBox.flags[i]; }));
+			const fadeMs = domain.fadeMs;
 			function render(phase) {
 				const c2d = canvasEl.getContext("2d");
 				if (!c2d) return;
@@ -983,7 +1037,7 @@ const StarmapRuntime = (function (require, _react) {
 					const birth = Math.max(a.star.mtimeMs || 0, b.star.mtimeMs || 0);
 					let lrv = 1;
 					if (rt !== null) {
-						const lt = Math.max(0, Math.min(1, (rt - birth) / 900));
+						const lt = Math.max(0, Math.min(1, (rt - birth) / fadeMs));
 						lrv = lt * lt * (3 - 2 * lt);
 						if (lrv <= 0) continue;
 					}
@@ -1000,7 +1054,7 @@ const StarmapRuntime = (function (require, _react) {
 					const meta = KIND_META[p.star.kind] || KIND_META.special;
 					let rv = 1;
 					if (rt !== null && p.star.mtimeMs > 0) {
-						const st = Math.max(0, Math.min(1, (rt - p.star.mtimeMs) / 900));
+						const st = Math.max(0, Math.min(1, (rt - p.star.mtimeMs) / fadeMs));
 						rv = st * st * (3 - 2 * st);
 						if (rv <= 0) continue;
 					}
@@ -2623,6 +2677,8 @@ const StarmapRuntime = (function (require, _react) {
 			".smem-num:focus{border-color:var(--dsw-alias-brand-primary,#4d76e6);}",
 			".smem-status{font-size:12px;color:var(--dsw-alias-label-secondary);}",
 			".smem-autodream-note{font-size:11.5px;color:var(--dsw-alias-label-secondary);line-height:1.5;}",
+			// 2.7.1（Q04）：上限设置的诊断清单 —— 逐条列宿主的原话，缩进浅一点、行距紧一点。
+			".smem-diag-list{margin:4px 0 4px 16px;padding:0;font-size:11.5px;line-height:1.6;color:var(--dsw-alias-label-secondary);}",
 			".smem-autodream-list{display:flex;flex-direction:column;gap:6px;}",
 			".smem-report{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 9px;font-size:12px;cursor:pointer;background:transparent;color:inherit;text-align:left;font-family:inherit;}",
 			".smem-report:hover{border-color:var(--dsw-alias-border-l2);}",
@@ -3916,6 +3972,15 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 					? h("div", { className: "smem-empty", key: "empty" },
 							"按当前阈值没有可归档的 —— 要么闲置天数还没到该类型的阈值，要么台账里还没有访问记录。")
 					: h("div", { className: "smem-cand-list", key: "list" }, [
+							// 2.7.1（Q05 尾巴）：锁表读不出来时**不许装作「都没锁」**。
+							// 宿主 2.1.12 起就在 archiveCandidates 的结果里带 lockedUnknown / lockedError，
+							// 但那两个字段一直只在日志里 —— 面板照样把整张清单画成「全部未锁定」。
+							// 这里如实标出来：自动归档会直接拒绝，手动归档要不要继续由人自己判断。
+							c.lockedUnknown === true
+								? h("div", { className: "smem-cand-note smem-ad-warn", key: "lockunknown", role: "status" },
+										"⚠ 锁表读不出来" + (c.lockedError ? "（" + String(c.lockedError) + "）" : "") +
+										"：下面每一条的锁定状态都是「未知」（不是「都没锁」）。自动归档会直接拒绝执行；手动归档前请自己确认。")
+								: null,
 							h("div", { className: "smem-cand-note", key: "note" },
 								"候选只按「多久没被注入过」算。归档 = 移进 archive/（不删），随时可以恢复。"),
 							offNow
@@ -4404,6 +4469,8 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			"ad.limits.pending": "有改动待生效",
 			"ad.limits.restartWarn": "⚠ 这些值在 DSH 启动时就固化了 —— 要重启 DSH 才生效。下面每行都写清「当前 → 重启后」。",
 			"ad.limits.restartNote": "这些值在 DSH 启动时固化：保存后要重启 DSH 才生效 —— 所以每行都会标出「当前生效」与「重启后」。",
+			"ad.limits.diagTitle": "⚠ 上限设置里有 {count} 条问题（本次仍按环境变量 / 默认值生效）",
+			"ad.limits.diagNote": "下面是宿主的原话。改好面板里的值只能修一部分 —— 环境变量与 settings.json 里的坏值也要一并清掉。",
 			"ad.limit.maxResults": "一次注入条数",
 			"ad.limit.maxChars": "单条字符上限",
 			"ad.limit.maxBaseline": "baseline 名额",
@@ -4909,6 +4976,8 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 			"ad.limits.pending": "changes pending",
 			"ad.limits.restartWarn": "⚠ These values are fixed at DSH startup — restart DSH for them to apply. Each row below shows “current → after restart”.",
 			"ad.limits.restartNote": "These values are fixed at DSH startup: saving requires a DSH restart to take effect — so each row shows both “currently effective” and “after restart”.",
+			"ad.limits.diagTitle": "⚠ {count} problem(s) with these limits (environment variables / defaults are in effect)",
+			"ad.limits.diagNote": "The lines below are the host's own words. Fixing the values in this panel only covers part of it — bad values in environment variables and settings.json must be cleared too.",
 			"ad.limit.maxResults": "Memories per injection",
 			"ad.limit.maxChars": "Characters per memory",
 			"ad.limit.maxBaseline": "baseline slots",
@@ -5513,6 +5582,10 @@ 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;
 			});
+			// 2.7.1（Q04 尾巴）：宿主从 2.1.11 起就在 getSettings 里带 `limitDiagnostics`
+			// —— 坏 JSON / 逐项越界 / 环境变量写错都在这份数组里。以前它只进日志，
+			// 面板上看不见，于是「我改的值怎么没生效」只能靠猜。现在就地摊开逐条列。
+			const limitDiag = Array.isArray(memSet && memSet.limitDiagnostics) ? memSet.limitDiagnostics : [];
 			// 入口模式：新字段优先，旧 sidebarEntry 兜底；坏值 / 旧宿主一律按「两个都显示」。
 			// 存了 sidebar 但当前宿主不支持侧栏时，界面按 settings 显示并给一条降级提示。
 			const entryModeValue = entryModeFromSettings(memSet);
@@ -5996,6 +6069,17 @@ h("span", { key: "sep", className: "smem-actions-sep", "aria-hidden": "true" }),
 					memSet && memSet.restartRequired
 						? h("div", { className: "smem-autodream-note smem-ad-warn", key: "rw" }, t("ad.limits.restartWarn"))
 						: h("div", { className: "smem-autodream-note", key: "rn" }, t("ad.limits.restartNote")),
+					// 2.7.1（Q04）：诊断逐条列出来。文案不猜原因 —— 数组里每一条都是宿主的原话
+					// （「读 settings.json 失败（ENOENT）」「maxResults 必须是 1..20 的整数」…）。
+					limitDiag.length
+						? h("div", { className: "smem-autodream-note smem-ad-warn", key: "diag", role: "status" }, [
+								h("div", { key: "t", style: { fontWeight: "600" } }, t("ad.limits.diagTitle", { count: limitDiag.length })),
+								h("ul", { key: "ul", className: "smem-diag-list" }, limitDiag.map(function (d, i) {
+									return h("li", { key: "diag-" + i }, String(d));
+								})),
+								h("div", { key: "n", className: "smem-status" }, t("ad.limits.diagNote")),
+							])
+						: null,
 					// 五个参数排两列（一行两个）：同样的信息，行数少一半，扫读反而更清楚。
 					h("div", { className: "smem-ad-grid2", key: "grid" }, LIMIT_FIELDS.map(function (f) {
 						const cur = memSet && memSet.limits ? memSet.limits[f.key] : null;

package/package.json

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