sage-mem 1.2.1 → 1.4.0

package/README.md

@@ -498,6 +498,8 @@ Module boundaries (since 1.2.0):
 - `lib/recall/` — the injection chain: selection (`select`) / rendering and budget (`compose`) / text (`text`) / session state (`state`)
 - `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

@@ -502,6 +502,8 @@ memory/ 目录（markdown 文件，4 类）
 - `lib/recall/` —— 注入链：选材（`select`）/ 渲染与预算（`compose`）/ 文本（`text`）/ 会话状态（`state`）
 - `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/autodream/audit.js

@@ -23,6 +23,8 @@
 
 import { readdir, readFile } from 'node:fs/promises'
 import { join } from 'node:path'
+import { hasFrontmatter, parseFrontmatter } from '../memory/frontmatter.js'
+import { SESSION_LOG_KEY } from '../shared/md-name.js'
 import { ARCHIVE_DIR_NAME, inspectMemoryEntry } from '../memory/scan.js'
 import { warnLog } from '../memory/util.js'
 
@@ -51,7 +53,7 @@ const STRAY_RE = /\.archiving-[0-9a-f]+$/i
  * **索引 `MEMORY.md`**：它**要**被读（要当链接来源、要查行尾与链接），只是
  * **不是一条记忆** —— 见下面 `f !== INDEX_FILE` 那两处。
  */
-const AUDIT_SKIP_FILES = new Set(['session-log.md'])
+const AUDIT_SKIP_FILES = new Set([SESSION_LOG_KEY])
 
 /** 归档区目录名（与 autodream-tools.js 的 ARCHIVE_DIR、宿主侧 memory/scan.js 同名）。 */
 const ARCHIVE_DIR = 'archive'
@@ -60,26 +62,19 @@ const ARCHIVE_DIR = 'archive'
 const YAML_LEAF_RE = /^[A-Za-z0-9_.-]+:\s*(.*)$/
 
 /**
- * 极简 frontmatter 解析，读法与 宿主侧一致：
- * 顶层 `type:` 优先，没有才下钻 `metadata.type:`。
- * @param {string} content — 文件全文
- * @returns {{name: string, description: string, type: string, hasFrontmatter: boolean}}
+ * 审计用的 frontmatter 视图：**不再自己写一份正则**，改成正典解析的薄包装。
+ *
+ * 原先这里是一份独立的 `grab` 实现，漏了 `updated` / `tags` —— 两份解析器对同一份
+ * 损坏文件的"type 是空还是不是空"可能给出不同答案，而审计报告与注入排序都依赖它。
+ * 保留本函数只为**导出面**不变（审计与工具都在用）；行为差异由 shared-parity 对拍守着。
  */
 export function parseFrontmatterLite(content) {
-  const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
-  if (!m) return { name: '', description: '', type: '', hasFrontmatter: false }
-  const body = m[1]
-  const grab = (key) => {
-    const hit = body.match(new RegExp(`^${key}:[ \\t]*(.+?)[ \\t\\r]*$`, 'm'))
-    return hit ? hit[1].replace(/^["']|["']$/g, '').trim() : ''
-  }
-  const nested = body.match(/^metadata:\s*\r?\n(?:\s+[^\r\n]+\r?\n)*?\s+type:\s*(\S+)/m)
-  const type = grab('type') || (nested ? nested[1] : '')
+  const fm = parseFrontmatter(content)
   return {
-    name: grab('name'),
-    description: grab('description'),
-    type: String(type).trim(),
-    hasFrontmatter: true,
+    name: fm.name,
+    description: fm.description,
+    type: String(fm.type).trim(),
+    hasFrontmatter: hasFrontmatter(content),
   }
 }
 

package/lib/autodream/prompt.js

@@ -13,12 +13,7 @@
  * 那段文字会发给每一个使用者的模型；把作者的记忆主题编进去就是泄漏
  */
 
-/** 让 prompt 里的日期对人可读：模型算相对日期时不会写错。 */
-function today(ms) {
-  const d = new Date(ms)
-  const p = (n) => String(n).padStart(2, '0')
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`
-}
+import { stampDate } from '../shared/stamp.js'
 
 /**
  * 系统提示：身份 + 记忆系统的约定 + 这一趟的权限边界。
@@ -92,7 +87,7 @@ export function buildAutodreamUserPrompt(opts) {
 
   return `# Autodream：一次记忆整理
 
-今天：${today(now)}
+今天：${stampDate(now)}
 记忆目录：\`${memoryDir}\`
 距上次整理：${hoursSince === 0 ? '（没有记录，当成第一次）' : hoursSince.toFixed(1) + ' 小时'}
 期间有更新的会话数：${sessionCount}

package/lib/autodream/tools.js

@@ -30,6 +30,8 @@ import { createHash } from 'node:crypto'
 import { auditMemoryDir, formatAudit, parseFrontmatterLite } from './audit.js'
 import { archiveMemory } from '../memory/archive.js'
 import { MAX_FILE_BYTES, STATE_ROOT } from '../memory/config.js'
+import { INDEX_FILE_KEY, SESSION_LOG_KEY } from '../shared/md-name.js'
+import { stampHuman as localStamp } from '../shared/stamp.js'
 import { writeFileAtomic, warnLog } from '../memory/util.js'
 import { buildConflict, writeConflict } from '../memory/conflicts.js'
 import { memoryPathOf } from '../memory/paths.js'
@@ -42,17 +44,6 @@ const READ_LIMIT = 20000
 const LIST_DESC_CHARS = 70
 /** search_sessions 单次返回上限（字符）。 */
 const SEARCH_LIMIT = 8000
-/** 索引文件名：它在列表里要单独标注，免得模型当成一条普通记忆去改。 */
-const INDEX_FILE = 'memory.md'
-/**
- * 非记忆条目：不进 list_memory。
- *
- * session-log.md 是追加型流水，不是一条记忆 —— 列出来既
- * 占掉模型一大块注意力，又诱导它去「整理」一份流水账。冒烟测试
- * 逮到的就是这条：它出现在了 list_memory 的输出里。
- */
-const NON_ENTRY_FILES = new Set(['session-log.md'])
-
 /**
  * 把一个模型给的文件名收敛成 memory 目录顶层的一个真实路径。
  *
@@ -92,11 +83,7 @@ async function resolveRealName(memoryDir, base) {
   return hit ? hit.name : base
 }
 
-/** ISO 时间 → 本地 `YYYY-MM-DD HH:mm`（报告与列表里给人看）。 */function localStamp(ms) {
-  const d = new Date(ms)
-  const p = (n) => String(n).padStart(2, '0')
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
-}
+/** ISO 时间 → 本地 `YYYY-MM-DD HH:mm`（唯一实现在 shared/stamp.js）。 */
 
 /** 距今多少天，给模型一个人话尺度。 */
 function ageDays(ms) {
@@ -118,7 +105,7 @@ async function scanEntries(memoryDir, ctx) {
   }
   const reservedIds = await reservedIdentitySet(memoryDir)
   const names = entries
-    .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md') && !NON_ENTRY_FILES.has(e.name.toLowerCase()))
+    .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md') && e.name.toLowerCase() !== SESSION_LOG_KEY)
     .map((e) => e.name)
   const out = []
   for (const name of names) {
@@ -141,7 +128,7 @@ async function scanEntries(memoryDir, ctx) {
       out.push({
         file: name,
         // 索引不是一条记忆：标出来，否则模型会看到「MEMORY.md · reference」而困惑。
-        type: name.toLowerCase() === INDEX_FILE ? '索引' : meta.type || 'reference',
+        type: name.toLowerCase() === INDEX_FILE_KEY ? '索引' : meta.type || 'reference',
         bytes: gate.size,
         mtimeMs: gate.mtimeMs,
         title: (h1 ? h1[1] : meta.name || '').trim(),

package/lib/autodream/util.js

@@ -9,19 +9,8 @@ import { join } from 'node:path'
 
 export const clampNum = (v, lo, hi, dflt) => (Number.isFinite(v) ? Math.max(lo, Math.min(hi, v)) : dflt)
 
-/** 本地时间戳，给文件名用。 */
-export function stampCompact(ms) {
-  const d = new Date(ms)
-  const p = (n) => String(n).padStart(2, '0')
-  return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`
-}
-
-/** 本地时间戳，给人看。 */
-export function stampHuman(ms) {
-  const d = new Date(ms)
-  const p = (n) => String(n).padStart(2, '0')
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
-}
+import { stampCompact, stampHuman } from '../shared/stamp.js'
+export { stampCompact, stampHuman }
 
 /**
  * 运行 id：`YYYYMMDD-HHmmss-<4 位>`。

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,10 +2034,6 @@ 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 个问题」徽标 —— 那是整个
 			// 抽屉方案能成立的前提（否则三个能力就退回「藏起来」了）。
@@ -2207,18 +2165,6 @@ const StarmapRuntime = (function (require, _react) {
 			".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 +2413,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",
@@ -2766,7 +2701,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 +3187,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 +3311,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 +3412,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 +3641,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 +3833,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);

package/lib/index.js

@@ -17,7 +17,8 @@
 import { AutodreamEngine } from './autodream.js'
 import { auditMemoryDir } from './autodream/audit.js'
 import { DEFAULT_CONFIG } from './autodream/config.js'
-import { MAX_BASELINE, MAX_CHARS_PER_FILE, MAX_FILE_BYTES, MAX_RESULTS, MAX_SESSION_BYTES, MEMORY_DIR, RECALL_DISCIPLINE, RESERVED_FILES, SESSIONS_ROOT, STALE_DAYS, STATE_ROOT } from './memory/config.js'
+import { LIMIT_SPECS, MAX_BASELINE, MAX_CHARS_PER_FILE, MAX_FILE_BYTES, MAX_RESULTS, MAX_SESSION_BYTES, MEMORY_DIR, RECALL_DISCIPLINE, RESERVED_FILES, SESSIONS_ROOT, STALE_DAYS, STATE_ROOT } from './memory/config.js'
+import { INDEX_FILE_KEY, SESSION_LOG_KEY, isPlainMdName } from './shared/md-name.js'
 import { parseAliases, parseBaseline, parseBaselinePriority, parseFrontmatter, parseTags } from './memory/frontmatter.js'
 import { ageDays, bigrams, score, selectBaseline, selectRelevant } from './memory/retrieval.js'
 import { isReserved, nameKey, safeName } from './memory/naming.js'
@@ -30,7 +31,7 @@ import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol'
 import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { checkUpdate as checkUpdateImpl } from './update.js'
-import { autodreamConfigSnapshot, clampInt, LIMIT_SPECS, MAX_RAW_BYTES, pendingLimits, rawName, readReservedFile, readSettingsFile, RESERVED_FILE, SETTINGS_FILE } from './settings.js'
+import { autodreamConfigSnapshot, clampInt, MAX_RAW_BYTES, pendingLimits, rawName, readReservedFile, readSettingsFile, RESERVED_FILE, SETTINGS_FILE } from './settings.js'
 import { createRecallInjector, createSessionInjectState } from './recall/index.js'
 import { mountAutodream, mountMemoryTools, mountObserve, mountWriteGate } from './assembly/index.js'
 
@@ -420,7 +421,7 @@ export class MemoryGateway extends TypertRemoteService {
     const pending = pendingLimits(file)
     const reservedExtra = await readReservedFile()
     // 模块加载时那份「用户声明的保护名」（RESERVED_FILES 里抠掉两个内置名）
-    const activeExtra = [...RESERVED_FILES].filter((n) => n !== 'memory.md' && n !== 'session-log.md')
+    const activeExtra = [...RESERVED_FILES].filter((n) => n !== INDEX_FILE_KEY && n !== SESSION_LOG_KEY)
     const norm = (list) => JSON.stringify([...list].map((s) => String(s).toLowerCase()).sort())
     const restartRequired =
       JSON.stringify(limits) !== JSON.stringify(pending) || norm(activeExtra) !== norm(reservedExtra)
@@ -429,7 +430,7 @@ export class MemoryGateway extends TypertRemoteService {
       pendingLimits: pending,
       restartRequired,
       // 生效的保护名单（含两个内置名）+ 用户声明的那部分原文（面板编辑的是后者）
-      reserved: [...new Set(['memory.md', 'session-log.md', ...reservedExtra.map((s) => s.toLowerCase())])],
+      reserved: [...new Set([INDEX_FILE_KEY, SESSION_LOG_KEY, ...reservedExtra.map((s) => s.toLowerCase())])],
       reservedExtra,
     }
   }
@@ -465,7 +466,7 @@ export class MemoryGateway extends TypertRemoteService {
       const cleaned = []
       for (const item of p.reserved) {
         const s = String(item ?? '').trim()
-        if (!s || !s.endsWith('.md') || s.includes('/') || s.includes('\\') || s.startsWith('..')) {
+        if (!isPlainMdName(s) || s.startsWith('..')) {
           return { ok: false, error: `sage-mem: invalid reserved file name: ${String(item)}` }
         }
         if (!cleaned.includes(s)) cleaned.push(s)

package/lib/memory/config.js

@@ -8,6 +8,7 @@
 import { readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
+import { INDEX_FILE_KEY, SESSION_LOG_KEY, isPlainMdName } from '../shared/md-name.js'
 
 export const MEMORY_DIR = process.env.SAGE_MEM_DIR || join(homedir(), '.sage-mem', 'memory')
 /**
@@ -29,6 +30,19 @@ export function envInt(name, dflt, lo, hi) {
   return Math.max(lo, Math.min(hi, Math.round(n)))
 }
 
+/**
+ * 面板可改的 5 项注入上限 —— **唯一定义**（值 + 边界）。
+ * 面板（\u0060lib/settings.js\u0060）、组合根、环境变量三处都从这里取，不再各写一份。
+ */
+export const LIMIT_SPECS = {
+  maxResults: { env: 'SAGE_MEM_MAX_RESULTS', dflt: 10, lo: 1, hi: 30 },
+  maxChars: { env: 'SAGE_MEM_MAX_CHARS', dflt: 1500, lo: 200, hi: 20000 },
+  maxBaseline: { env: 'SAGE_MEM_MAX_BASELINE', dflt: 8, lo: 1, hi: 50 },
+  maxSessionBytes: { env: 'SAGE_MEM_MAX_SESSION_BYTES', dflt: 60 * 1024, lo: 4096, hi: 512 * 1024 },
+  staleDays: { env: 'SAGE_MEM_STALE_DAYS', dflt: 1, lo: 0, hi: 365 },
+}
+const fromSpec = (spec) => envInt(spec.env, spec.dflt, spec.lo, spec.hi)
+
 /**
  * 一次注入最多带几条记忆。
  *
@@ -37,10 +51,10 @@ export function envInt(name, dflt, lo, hi) {
  * 字符的上下文。**这个数字该由实测决定**，所以留了 SAGE_MEM_MAX_RESULTS 覆写口
  * （比较两档的命中率与 token 账单，别拍脑袋）。
  */
-export const MAX_RESULTS = envInt('SAGE_MEM_MAX_RESULTS', 10, 1, 30)
+export const MAX_RESULTS = fromSpec(LIMIT_SPECS.maxResults)
 
 /** 单条记忆注入的字符上限。 */
-export const MAX_CHARS_PER_FILE = envInt('SAGE_MEM_MAX_CHARS', 1500, 200, 20000)
+export const MAX_CHARS_PER_FILE = fromSpec(LIMIT_SPECS.maxChars)
 
 /**
  * baseline 名额。
@@ -49,7 +63,7 @@ export const MAX_CHARS_PER_FILE = envInt('SAGE_MEM_MAX_CHARS', 1500, 200, 20000)
  * 而 baseline 恰恰是短问题、恢复会话时唯一的兜底。现在放到 8，
  * 排序见下面「按显式优先级排，不按文件名」那段。
  */
-export const MAX_BASELINE = envInt('SAGE_MEM_MAX_BASELINE', 8, 1, 50)
+export const MAX_BASELINE = fromSpec(LIMIT_SPECS.maxBaseline)
 
 /**
  * 单会话累计注入字节上限 —— 到顶以后这个会话就不再注入新的记忆。
@@ -63,7 +77,7 @@ export const MAX_BASELINE = envInt('SAGE_MEM_MAX_BASELINE', 8, 1, 50)
  * 60 KB 是与 CC 对齐的起点、不是实测出来的数字 —— 留了 SAGE_MEM_MAX_SESSION_BYTES
  * 覆写口，量过再定。
  */
-export const MAX_SESSION_BYTES = envInt('SAGE_MEM_MAX_SESSION_BYTES', 60 * 1024, 4096, 512 * 1024)
+export const MAX_SESSION_BYTES = fromSpec(LIMIT_SPECS.maxSessionBytes)
 
 /**
  * 状态卡预留占总预算的比例，以及它的上下夹逼区间。
@@ -94,7 +108,7 @@ export const CONTENT_BUDGET = MAX_SESSION_BYTES - STATUS_RESERVE
  * 推理，相对天数才会。为什么需要它：陈旧记忆被当事实引用时，「引用」这个动作
  * 本身会让它显得更权威、而不是更可疑。
  */
-export const STALE_DAYS = envInt('SAGE_MEM_STALE_DAYS', 1, 0, 365)
+export const STALE_DAYS = fromSpec(LIMIT_SPECS.staleDays)
 
 /**
  * 注入文本开头的引用纪律 —— **必须独立成节，不能压成一条 bullet**。
@@ -144,13 +158,13 @@ export function readExtraReserved() {
     if (!Array.isArray(arr)) return []
     return arr
       .map((s) => String(s).trim().toLowerCase())
-      .filter((s) => s.endsWith('.md') && !s.includes('/') && !s.includes('\\') && !s.startsWith('..'))
+      .filter((s) => isPlainMdName(s) && !s.startsWith('..'))
   } catch {
     return []
   }
 }
 
-export const RESERVED_FILES = new Set(['memory.md', 'session-log.md', ...readExtraReserved()])
+export const RESERVED_FILES = new Set([INDEX_FILE_KEY, SESSION_LOG_KEY, ...readExtraReserved()])
 
 /**
  * 非记忆条目：不参与检索 / 不进星图 / 不出现在设置页列表里，读写也一律不通。
@@ -161,8 +175,8 @@ export const RESERVED_FILES = new Set(['memory.md', 'session-log.md', ...readExt
  * （要出现在列表与星图里、要能读），只是不许从表单写/删。
  */
 export const NON_ENTRY_FILES = new Set([
-  'memory.md',
-  'session-log.md',
+  INDEX_FILE_KEY,
+  SESSION_LOG_KEY,
 ])
 
 /**
@@ -173,4 +187,4 @@ export const NON_ENTRY_FILES = new Set([
  *     到这个量级基本可以判定是写错了目标（比如把日志、代码贴进来）。
  * 与 lib/typert.host.js 的 fileContentSchema.max(512 * 1024) 保持一致。
  */
-export const MAX_FILE_BYTES = 512 * 1024
+export { MAX_FILE_BYTES } from '../shared/limits.js'

package/lib/memory/frontmatter.js

@@ -29,6 +29,11 @@ export function parseTags(body) {
   return []
 }
 
+/** 这份文件有没有 frontmatter 块（审计用；与 parseFrontmatter 的匹配规则同一份）。 */
+export function hasFrontmatter(content) {
+  return typeof content === 'string' && /^---\r?\n[\s\S]*?\r?\n---/.test(content)
+}
+
 /** 解析 frontmatter 的 name/description/type（兼容顶层与 metadata 嵌套两种 type）。 */
 export function parseFrontmatter(content) {
   // 换行必须容忍 CRLF：任何用 Windows 编辑器碰过一次的文件都会被换成 \r\n，

package/lib/memory/index-file.js

@@ -12,9 +12,10 @@ import { readFile, readdir } from 'node:fs/promises'
 import { basename, join } from 'node:path'
 import { parseFrontmatter } from './frontmatter.js'
 import { nameKey } from './naming.js'
+import { INDEX_FILE_KEY } from '../shared/md-name.js'
 import { createWriteQueue, writeFileAtomic } from './util.js'
 
-const INDEX_KEY = 'memory.md'
+const INDEX_KEY = INDEX_FILE_KEY
 /** 条目里的描述上限：索引是清单，不是内容堆。 */
 const DESC_MAX = 120
 

package/lib/memory/naming.js

@@ -3,6 +3,7 @@
  */
 
 import { NON_ENTRY_FILES, RESERVED_FILES } from './config.js'
+import { isPlainMdName } from '../shared/md-name.js'
 import { basename } from 'node:path'
 
 /**
@@ -44,23 +45,9 @@ export function isMemoryEntry(name) {
  * @returns 通过校验的原始文件名；非法返回 null
  */
 export function safeName(raw) {
-  if (typeof raw !== 'string' || raw === '') return null
-  // basename 与原文不一致＝含目录成分。旧版是「悄悄取 basename 继续」，
-  // 与 starmap 那套（要求 safe === raw）行为不一致；现在统一为拒绝。
-  if (basename(raw) !== raw) return null
-  // `:` 在 NTFS 上是**交替数据流**的分隔符：`MEMORY.md:evil.md` 以 `.md` 结尾、能过下面
-  // 所有判据，落盘时却会写到索引的隐藏数据流上（`readdir` 看不见，只写流不报错）。
-  // 实测更糟：`writeFile('MEMORY.md:evil.md')` 会在 `rename` 处抛**未捕获**的 EINVAL ——
-  // 违背「拒绝一律返回 {ok:false}、不抛」这条契约。正常文件名不允许 `:`，直接拒。
-  if (raw.includes(':')) return null
-  // `\` 是 `:` 那条理由的另一半：**它是 Windows 的路径分隔符，在 Linux 上却只是普通字符**。
-  // 于是 `basename('..\\a.md')` 在 Windows 上得到 `a.md`（被上面那条判据拒掉），
-  // 在 Linux 上原样返回 `..\a.md`（整条通过）—— 同一份输入在两个平台上得出相反的合法性。
-  // 而记忆目录是会被同步 / 拷贝 / 备份还原的：**在 Linux 上合法落盘的名字，同步到 Windows
-  // 就是一个目录穿越**。判定必须与平台无关，所以无条件拒。
-  // （这条是 Linux CI 抓出来的：本机 Windows 上测试一直是绿的。）
-  if (raw.includes('\\')) return null
-  if (!/\.md$/i.test(raw)) return null
+  // 底线规则（单段 / .md / 无路径分隔符 / 无冒号）只有一份：shared/md-name.js。
+  // 这里额外的是**记忆条目**语义：索引与流水不是一条记忆。
+  if (!isPlainMdName(raw)) return null
   if (isNonEntry(raw)) return null
   return raw
 }

package/lib/memory/scan.js

@@ -24,12 +24,7 @@ export const ARCHIVE_DIR_NAME = 'archive'
 /** 归档区绝对路径。文件名不变，只换目录。 */
 export const MEMORY_ARCHIVE_DIR = join(MEMORY_DIR, ARCHIVE_DIR_NAME)
 
-/** 本地时间 `YYYY-MM-DD HH:mm` —— 归档留痕是给人看的，不用 ISO / UTC。 */
-export function localStamp(ms = Date.now()) {
-  const d = new Date(ms)
-  const p = (n) => String(n).padStart(2, '0')
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
-}
+export { stampHuman as localStamp } from '../shared/stamp.js'
 
 /**
  * 把一个值写成 YAML 标量。

package/lib/settings.js

@@ -5,35 +5,18 @@
  * envInt 调用（lo/hi 不许在这里另立一套）。
  */
 import { readFile } from 'node:fs/promises'
-import { basename, join } from 'node:path'
-import { STATE_ROOT } from './memory/config.js'
+import { join } from 'node:path'
+import { LIMIT_SPECS, STATE_ROOT } from './memory/config.js'
+import { MAX_RAW_BYTES } from './shared/limits.js'
+import { isPlainMdName } from './shared/md-name.js'
+export { LIMIT_SPECS, MAX_RAW_BYTES }
 import { DEFAULT_CONFIG } from './autodream/config.js'
 import { readJson } from './autodream/util.js'
 
-/**
- * 面板可改的 5 项注入上限 —— 与 `memory/config.js` 里的 `SAGE_MEM_*` 一一对应。
- * 边界值照抄那边的 envInt 调用（lo/hi 不许在这里另立一套）。
- */
-export const LIMIT_SPECS = {
-  maxResults: { env: 'SAGE_MEM_MAX_RESULTS', dflt: 10, lo: 1, hi: 30 },
-  maxChars: { env: 'SAGE_MEM_MAX_CHARS', dflt: 1500, lo: 200, hi: 20000 },
-  maxBaseline: { env: 'SAGE_MEM_MAX_BASELINE', dflt: 8, lo: 1, hi: 50 },
-  maxSessionBytes: { env: 'SAGE_MEM_MAX_SESSION_BYTES', dflt: 60 * 1024, lo: 4096, hi: 512 * 1024 },
-  staleDays: { env: 'SAGE_MEM_STALE_DAYS', dflt: 1, lo: 0, hi: 365 },
-}
-
 /** 面板设置的落点：状态根下（与 autodream 的配置、台账同级）。 */
 export const SETTINGS_FILE = join(STATE_ROOT, 'settings.json')
 export const RESERVED_FILE = join(STATE_ROOT, 'reserved.json')
 
-/**
- * `writeRaw` 的体积上限（4 MB）。
- *
- * ⚠️ **故意不复用 `MAX_FILE_BYTES`（512 KB）**：保留名里就有 `session-log.md` 这种追加型
- * 流水，它天然长得比单条记忆大得多（实测已 > 512 KB）。沿用小上限 = 用户永远存不回去。
- */
-export const MAX_RAW_BYTES = 4 * 1024 * 1024
-
 /** 整数收敛（与 config.js 的 envInt 同一套语义）：非有限数回落默认，越界夹到边界。 */
 export const clampInt = (v, spec) => (Number.isFinite(v) ? Math.max(spec.lo, Math.min(spec.hi, Math.round(v))) : spec.dflt)
 
@@ -84,11 +67,8 @@ export async function readReservedFile() {
  */
 export function rawName(raw) {
   const s = typeof raw === 'string' ? raw : ''
-  if (!s || basename(s) !== s) return null
-  // `:` 是 NTFS 交替数据流的分隔符：`MEMORY.md:evil.md` 能过扩展名判据，落盘却是写到
-  // 索引的隐藏流上（`readdir` 看不见）。与 `safeName` 同一条理由，这里也要拒。
-  if (s.includes(':')) return null
-  return /\.md$/i.test(s) ? s : null
+  if (!isPlainMdName(s)) return null
+  return s
 }
 
 /** autodream 的实际配置（缺文件/坏文件回落默认值）—— 面板要显示真实策略，不能显示想象。 */

package/lib/shared/limits.js

@@ -0,0 +1,17 @@
+/**
+ * 两个体积上限的**唯一**来源（零依赖，host / manifest / 引擎共用）。
+ *
+ * 为什么单独抽：512 KB 那条同时出现在 `memory/config.js`、`typert.host.js` 的
+ * `fileContentSchema` 与注释里；4 MB 那条出现在设置工具与 manifest 的
+ * `rawFileContentSchema`。它们**必须相等** —— 传输层比写入层紧，用户就会收到
+ * "面板能存、remote 存不进去"的怪现象；比写入层松，则超限内容会穿过闸门。
+ */
+
+/** 单条记忆的上限（512 KB）。`writeFile` / 读取闸门 / manifest 三处同一把尺子。 */
+export const MAX_FILE_BYTES = 512 * 1024
+
+/**
+ * 保留名原样读写的上限（4 MB）。**故意不复用 512 KB**：
+ * `session-log.md` 是追加型流水，天然比单条记忆大得多，沿用小上限 = 用户永远存不回去。
+ */
+export const MAX_RAW_BYTES = 4 * 1024 * 1024

package/lib/shared/md-name.js

@@ -0,0 +1,25 @@
+/**
+ * 「合法 .md 文件名」的**唯一**判据（零依赖，host 与 manifest 共用）。
+ *
+ * 为什么单独一个文件：这条规则原先有 5 份实现（`memory/naming.js` 的 safeName、
+ * 设置页的 rawName、`setSettings` 里手写一遍、`config.js` 的 readExtraReserved 过滤、
+ * `typert.host.js` 的 fileNameSchema 正则）。它们**不是复制粘贴这么简单**：
+ * 有一份漏了 `i`、有一份少了 `:` 判定，于是同一份"能过的名字"在不同入口得到相反结论。
+ * 判据必须只有一份，平台相关的例外必须写成显式规则。
+ *
+ * 三条平台无关的底线（全部有事故来源）：
+ *   - `/` 与 `\\` 一律拒：Windows 当路径分隔符、Linux 不当，判据不能依赖 path.sep；
+ *   - `:` 一律拒：NTFS 交替数据流（`MEMORY.md:evil.md` 能过扩展名判据却写到隐藏流）；
+ *   - 扩展名大小写不敏感：文件系统（NTFS/APFS）就是如此，`a.MD` 必须与 `a.md` 同宽。
+ */
+export const MD_NAME_RE = /^[^\\/:*?"<>|\u0000-\u001f]+\.md$/i
+export const MD_NAME_PATTERN = MD_NAME_RE.source
+
+/** 单段、`.md` 结尾、无路径分隔符 / 冒号 / 控制字符。**不含**保留名判定。 */
+export function isPlainMdName(raw) {
+  return typeof raw === 'string' && raw !== '' && MD_NAME_RE.test(raw)
+}
+
+/** 索引与流水的规范名（小写）。它们不是"某条记忆"，但多处要按名字识别。 */
+export const INDEX_FILE_KEY = 'memory.md'
+export const SESSION_LOG_KEY = 'session-log.md'

package/lib/shared/stamp.js

@@ -0,0 +1,30 @@
+/**
+ * 本地时间戳的**唯一**实现（零依赖）。
+ *
+ * 原先三份：`memory/scan.js` 的 localStamp、`autodream/util.js` 的 stampHuman、
+ * `autodream/tools.js` 里那行与注释挤在一起的 localStamp。三份输出必须逐字相同 ——
+ * 它们都会写进**记忆文件本身**（archived_at）或报告，差一个补零规则就是数据不一致。
+ *
+ * 一律本地时间：这是给人看的（"什么时候归档的"），不是机器间传输的 ISO 时间。
+ */
+
+/** `YYYY-MM-DD` —— 只要日期的场合（提示词里的「今天是」）。 */
+export function stampDate(ms = Date.now()) {
+  const d = new Date(ms)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`
+}
+
+/** `YYYY-MM-DD HH:mm` —— 给人看（归档留痕、报告列表）。 */
+export function stampHuman(ms = Date.now()) {
+  const d = new Date(ms)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
+}
+
+/** `YYYYMMDD-HHmmss` —— 给文件名用（快照目录 / 运行 id 的前半）。 */
+export function stampCompact(ms = Date.now()) {
+  const d = new Date(ms)
+  const p = (n) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`
+}

package/lib/typert.host.js

@@ -5,6 +5,8 @@
  * schema 必须是 zod v4 实例（typert-loader 校验 "_zod" in schema）。
  */
 import { z } from 'zod'
+import { MD_NAME_PATTERN } from './shared/md-name.js'
+import { MAX_FILE_BYTES, MAX_RAW_BYTES } from './shared/limits.js'
 
 // 文件名：与 host 侧 safeName 同一套底线 —— 非空、无路径分隔符与 Windows 非法字符、
 // 以 .md 结尾、长度有界。（真正的目录逃逸防护仍在 host 侧 safeName。）
@@ -13,10 +15,10 @@ import { z } from 'zod'
 // 而文件名闸门原先**没有** `i`，两层判据宽度不一致 —— 宿主侧认可的 `a.MD`
 // 会被传输入参 schema 挡在门外（读不了自己列表里列出来的文件）。大小写不敏感是
 // NTFS / APFS 的事实，判据必须与文件系统同宽（与 `nameKey` 归一同一原则）。
-const fileNameSchema = z.string().min(1).max(255).regex(/^[^\\/:*?"<>|\u0000-\u001f]+\.md$/i)
+const fileNameSchema = z.string().min(1).max(255).regex(new RegExp(MD_NAME_PATTERN, 'i'))
 // 正文：512 KB 上限。理由是「记忆要塞进 system prompt」——单条正常量级在几十 KB，
 // 到半兆量级基本是写错了目标（贴了日志/代码进来）。与 lib/index.js 的 MAX_FILE_BYTES 一致。
-const fileContentSchema = z.string().max(512 * 1024)
+const fileContentSchema = z.string().max(MAX_FILE_BYTES)
 
 // autodream 报告引用：比 fileNameSchema 宽——旧版报告列表里的条目带 `dream/` 前缀
 // （新版 `autodream/` 不加前缀只给裸文件名）。这里放行斜杠，真正的目录逃逸防护
@@ -254,7 +256,7 @@ const rawWriteResultSchema = z.object({
 }).readonly()
 // 保留名的体积上限比单条记忆大得多（session-log.md 天然 > 512 KB）—— 4 MB，独立于
 // fileContentSchema，别把两者混用。
-const rawFileContentSchema = z.string().max(4 * 1024 * 1024)
+const rawFileContentSchema = z.string().max(MAX_RAW_BYTES)
 
 // ── autodream（夜间记忆整理）───────────────────────────────────────────────
 // 配置的每一项都可写；lastResult 是一个「成功/失败两条分支共用」的结构，

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