sage-mem 1.2.1 → 1.3.0

package/README.md

@@ -498,6 +498,7 @@ 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)
 - 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,7 @@ memory/ 目录（markdown 文件，4 类）
 - `lib/recall/` —— 注入链：选材（`select`）/ 渲染与预算（`compose`）/ 文本（`text`）/ 会话状态（`state`）
 - `lib/assembly/` —— 四块挂载：autodream / 检索工具 / 观测 / 写入门
 - `lib/memory/` —— 记忆层的纯函数与文件操作；`lib/autodream/` —— 自动做梦引擎
+- `lib/shared/` —— 跨层零依赖的小判据：文件名规则 / 本地时间戳 / 两个体积上限（**只许一份**，`test/duplication-test.mjs` 会红）
 - 依赖方向：`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/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.3.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {