sage-mem 0.6.0 → 0.6.2

package/README.md

@@ -4,7 +4,8 @@
 
 记忆存在**本地 markdown 文件**里（frontmatter + 正文），不是数据库。透明、可检查、防膨胀。
 
-> **DSH 版本兼容性（0.5.3 核对于 `0.1.7-rc.1`）**
+> **DSH 版本兼容性（0.6.2 核对于 `0.2.0-rc.1`；0.5.3 核对于 `0.1.7-rc.1`）**
+> `@deepseek-ai/dsh-typert-protocol` 与 `@deepseek-ai/dsh-client-locale` 的 `lib/` 在 `0.1.7-rc.2` → `0.2.0-rc.1` 之间**逐字节未变**（导出符号零增删、签名零变化），peer 范围随之放宽为 `^0.1.2-rc.1 || ^0.2.0-rc.1`，同时覆盖两条版本线；插件在 0.2.0 上无需改动即可工作。
 > `session.deriveMessages()`（仍是同步）、`system-prompt/assemble` 事件、以及 `context.agent.session` 这条链，在 0.1.6 → 0.1.7 之间**均未改变**，本插件在 0.1.7 上无需改动即可工作。
 > 0.5.3 另加了一层防御：`deriveMessages()` 若哪天被改成异步，或 `Session` 上的历史读取接口被改名（0.1.7 起 `snapshotEvents` / `eventAt` / `ownEvents` 已标记弃用），插件会在**日志里报警**，而不是像以前那样静默地不再注入记忆。0.1.6 上的行为与 0.5.2 完全一致。
 
@@ -37,30 +38,30 @@ sage-mem 换成文件式：每条记忆一个 markdown 文件，直接用编辑
 - **Web 文件管理器**（v0.4）：DSH 设置页「记忆管理」，浏览/查看/编辑/删除记忆文件，添加新记忆
 - **类型与标签筛选**（v0.6）：文件列表顶部一排 chip，按四类 + 自定义标签筛；自定义标签写在 frontmatter 的 `tags`（flow / block / 逗号三种写法都认），从全库自动聚合带计数；与搜索框是 AND 关系
 - **记忆星图**（v0.4 加入，v0.6 重做）：把记忆画成星空，按类型着色、按体积分级、按新鲜度分亮度，支持时间线与「诞生回放」。v0.6 换了渲染材质（中性深灰画布、锐利核心 + 收敛辉光、去掉衍射星芒与脉冲环），并把常驻满帧循环改成**按需重绘**：画面静止时不发起任何绘制
-- **夜间整理 dream**（v0.6）：可选的记忆整理功能，见下一节
+- **做梦 dream**（v0.6）：可选的记忆整理功能，见下一节
 
-## 夜间整理（dream）
+## 做梦（dream）
 
-移植自 Claude Code 的 `autoDream`：把记忆目录通读一遍，合并重复的、删掉被推翻的、修索引与断链、把相对日期换成绝对日期，让下一次会话能快速对上位置。
+把记忆目录通读一遍：合并重复的、删掉被推翻的、修索引与断链、把相对日期换成绝对日期，让下一次会话能快速对上位置。
 
-**默认关闭**，在设置页「记忆管理 → 夜间整理」里开。三件事各自可选：
+**默认关闭**，在设置页「记忆管理 → 做梦」里开。三件事各自可选：
 
 | 选项 | 取值 | 说明 |
 |---|---|---|
-| 触发 | 只手动 / 满足条件自动跑 | 自动模式照搬 CC 的三级门控，**最便宜的先查**：时间门（距上次 ≥ N 小时，一次读写）→ 会话门（期间 ≥ M 个会话有更新，一次目录扫描）→ 锁（防并发）。中间还夹一层 10 分钟扫描节流，免得「时间门过了、会话门没过」时每轮都重扫一遍
+| 触发 | 只手动 / 满足条件自动跑 | 自动模式走三级门控，**最便宜的先查**：时间门（距上次 ≥ N 小时，一次读写）→ 会话门（期间 ≥ M 个会话有更新，一次目录扫描）→ 锁（防并发）。中间还夹一层 10 分钟扫描节流，免得「时间门过了、会话门没过」时每轮都重扫一遍
 | 改动方式 | 只出报告 / 直接改写 | 「只出报告」模式下**写工具根本不会挂给模型** —— 不是靠一句「请不要写」约束，是它没有手
 | 输入源 | 仅记忆目录 / 记忆 + 会话记录 | 后者会解压会话记录（zstd）做定向关键词搜索；代价是私密对话会进入模型上下文，token 成本也更高
 
 模型可配（留空则跟随聊天页当前的默认模型），最多轮数、快照保留份数在「高级设置」里。
 
-**两道 CC 没有的安全网：**
+**两道额外的安全网：**
 
 1. **改写前自动快照**整个记忆目录（只快照顶层 `.md`，不含 `archive/`），落在 `<memory 目录的上一层>/.sage-mem/snapshots/<时间戳>/`，保留最近 N 份。理由是 memory 目录**不在任何版本控制下**、删除没有回收站，「可回滚」得自己造。
 2. **跑完自动审计**：六查（索引悬空 / 漏索引 / `type` 与文件名前缀不一致 / CRLF / 双链断链 / frontmatter 里被 YAML 当注释吞掉的「空格+#」），结果与前后对比写进报告。它只报不改。
 
 报告落在 `memory/dream/YYYYMMDD-HHmmss.md` —— 子目录，不会被扫成记忆条目。
 
-**安全边界在工具集上，不在提示词里**：dream 跑起来时，宿主只把 `list_memory` / `read_memory` / `audit_memory`（+ 只读模式下的 `search_sessions`）交给模型；改写模式才多给 `write_memory` / `archive_memory`。而且没有「删除」这个能力 —— 归档是把文件移进 `archive/`，可人工捞回。
+**安全边界在工具集上，不在提示词里**：做梦时宿主只把 `list_memory` / `read_memory` / `audit_memory`（+ 只读模式下的 `search_sessions`）交给模型；改写模式才多给 `write_memory` / `archive_memory`。而且没有「删除」这个能力 —— 归档是把文件移进 `archive/`，可人工捞回。
 
 ## 架构
 

package/lib/client.js

@@ -1462,7 +1462,7 @@ 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（夜间整理）──
+				// ── dream（做梦）──
 				// 2026-09-27 踩到的坑：namespace 不会自动出现。dsh-api-remotes 里那份
 				// remote 清单是**官方构建期生成的产物**，只有 memory / starmap 在里面；
 				// 后加的 dream 不在，于是 `ctx.get("remote.dream")` 永远 undefined ——
@@ -1604,7 +1604,7 @@ const StarmapRuntime = (function (require, _react) {
 			// 高度预算压到 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;}",
@@ -1959,7 +1959,7 @@ const StarmapRuntime = (function (require, _react) {
 		}
 
 		/**
-		 * 「梦境」面板 —— 夜间记忆整理（移植 Claude Code 的 autoDream）。
+		 * 「做梦」面板 —— 让记忆自己整理一遍（引擎在 host 半 lib/dream.js）。
 		 *
 		 * 数据全走 remote.dream（host 半的 DreamGateway）。两条实现约定：
 		 *   1. **轮询而不是等待**。「立即整理」启动后台任务后立刻返回 —— 一趟可能跑
@@ -2037,15 +2037,15 @@ const StarmapRuntime = (function (require, _react) {
 							type: "button", key: "sw", className: "smem-switch",
 							"data-on": c.enabled ? "1" : "0",
 							title: c.enabled ? "点击停用" : "点击启用",
-							"aria-label": "启用或停用夜间整理",
+							"aria-label": "启用或停用做梦",
 							onClick: function () { patch({ enabled: !c.enabled }); },
 						}),
-						h("span", { key: "t", style: { fontWeight: "600" } }, "夜间整理（dream）"),
+						h("span", { key: "t", style: { fontWeight: "600" } }, "做梦"),
 						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" }, [
@@ -2387,7 +2387,7 @@ const StarmapRuntime = (function (require, _react) {
 				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("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）"),
@@ -2398,7 +2398,7 @@ const StarmapRuntime = (function (require, _react) {
 						: "共 " + String(items.length) + " 个文件"),
 				]),
 				// 搜索 / 刷新 / 添加 / 筛选都只属于「文件列表」这个视图。
-				// 放在 tab 分支外面，会让星图和夜间整理页也顶着一排用不上的控件
+				// 放在 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); } }),

package/lib/dream-audit.js

@@ -1,211 +1,211 @@
-/**
- * sage-mem dream — 记忆目录审计（六查）。
- *
- * 把 `sage-memory` 技能里的审计清单搬到 host 侧，让 dream 每次跑完都能自证
- * 没把记忆改坏：
- *   1. 索引悬空 —— MEMORY.md 指向不存在的文件
- *   2. 漏索引   —— 存在但没进索引的记忆文件
- *   3. type 与前缀不一致（分类看 type，前缀骗不了它）
- *   4. CRLF     —— 「某个 Windows 编辑器碰过」的可疑信号
- *   5. 双链断链 —— [[目标]] 找不到对应文件或 frontmatter name
- *   6. 未加引号值里的「空格+#」—— 会被 YAML 当注释吞掉，解析不报错但描述残缺
- *
- * **纯只读**：不修任何东西。修哪条、怎么修，由 dream agent 或人决定。
- *
- * 这一份解析是 sage-mem host 半 parseFrontmatter 的同源精简版，故意不共用：
- * 那边带着一长串历史坑的注释与行为（baseline、type 回落），审计只读不写，
- * 重复二十行换零回归风险是划算的。
- */
-
-import { readdir, readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-/** 索引文件名。它本身不是一条记忆，是索引。 */
-const INDEX_FILE = 'MEMORY.md'
-
-/**
- * 非记忆条目：不是四类记忆、也不该套「type 与前缀一致」这条规则。
- *
- * session-log.md 是追加型流水（本机已 390+ KB），逐会话的账本而不是一条记忆；
- * 它没有 `user_/feedback_/project_/reference_` 前缀，扫进来只会白白读一大坨
- * 再报一条假问题（2026-09-27 实测：报出 `session-log.md type=reference`）。
- * 同理 MEMORY.md 是索引本身，只作为链接来源读，不作为被审对象。
- */
-const NON_ENTRY_FILES = new Set(['session-log.md'])
-
-/** YAML 行形态：`key: value`（顶层键，不含缩进的嵌套行）。 */
-const YAML_LEAF_RE = /^[A-Za-z0-9_.-]+:\s*(.*)$/
-
-/**
- * 极简 frontmatter 解析，读法与 host 半一致：
- * 顶层 `type:` 优先，没有才下钻 `metadata.type:`。
- * @param {string} content — 文件全文
- * @returns {{name: string, description: string, type: string, hasFrontmatter: boolean}}
- */
-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] : '')
-  return {
-    name: grab('name'),
-    description: grab('description'),
-    type: String(type).trim(),
-    hasFrontmatter: true,
-  }
-}
-
-/**
- * 抽 MEMORY.md 里的相对链接目标（`](file.md)` / `](file.md#L12)`）。
- * @param {string} indexText
- * @returns {string[]} 去重后的文件名列表
- */
-export function indexTargets(indexText) {
-  const out = new Set()
-  for (const m of indexText.matchAll(/\]\(([^)]+\.md)(?:#[^)]*)?\)/g)) {
-    const raw = m[1].trim()
-    // 跳过外链与子目录路径：索引只指根目录下的记忆文件。
-    if (/^[a-z]+:\/\//i.test(raw) || raw.includes('/') || raw.includes('\\')) continue
-    out.add(raw)
-  }
-  return [...out]
-}
-
-/**
- * 扫一个目录下的记忆文件（不含子目录 —— 归档区就该扫不到）。
- * @param {string} dir
- * @returns {Promise<{files: string[], indexText: string}>}
- */
-async function readDirSnapshot(dir) {
-  let entries
-  entries = await readdir(dir, { withFileTypes: true })
-  const all = entries
-    .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md'))
-    .map((e) => e.name)
-  const files = all.filter((f) => !NON_ENTRY_FILES.has(f.toLowerCase()))
-  let indexText = ''
-  try {
-    indexText = await readFile(join(dir, INDEX_FILE), 'utf8')
-  } catch (err) {
-    if (err?.code !== 'ENOENT') throw err
-  }
-  return { files, all, skipped: all.length - files.length, indexText }
-}
-
-/**
- * 六查主入口。
- * @param {string} dir — 记忆根目录
- * @returns {Promise<object>} 结构化审计结果（problems 是六项之和）
- */
-export async function auditMemoryDir(dir) {
-  const { files, all, skipped, indexText } = await readDirSnapshot(dir)
-  const entries = files.filter((f) => f !== INDEX_FILE)
-
-  const targets = indexTargets(indexText)
-  const targetSet = new Set(targets.map((t) => t.toLowerCase()))
-  // 悬空判定用 `all`（含 session-log.md）：索引万一真引用了它，那是索引的问题，
-  // 不该因为「审计不检查 session-log」而被顺手放过。
-  const allSet = new Set(all.map((f) => f.toLowerCase()))
-
-  const dangling = targets.filter((t) => !allSet.has(t.toLowerCase()))
-  const unlisted = entries.filter((f) => !targetSet.has(f.toLowerCase()))
-
-  const typeMismatch = []
-  const crlf = []
-  const hashHazards = []
-  const brokenLinks = []
-  const noFrontmatter = []
-  const linkKeys = new Set()
-
-  const contents = new Map()
-  for (const f of files) {
-    contents.set(f, await readFile(join(dir, f), 'utf8'))
-  }
-  for (const f of files) {
-    const meta = parseFrontmatterLite(contents.get(f))
-    if (meta.name) linkKeys.add(meta.name.trim())
-  }
-  for (const f of files) linkKeys.add(f)
-  for (const f of files) linkKeys.add(f.replace(/\.md$/, ''))
-
-  for (const f of entries) {
-    const raw = contents.get(f)
-    if (raw.includes('\r')) crlf.push(f)
-    const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)
-    if (!fmMatch) {
-      noFrontmatter.push(f)
-    } else {
-      const meta = parseFrontmatterLite(raw)
-      const prefix = f.split('_')[0]
-      const effective = meta.type || 'reference'
-      if (effective !== prefix) {
-        typeMismatch.push({ file: f, type: meta.type || '(缺失)', prefix, effective })
-      }
-      for (const line of fmMatch[1].split(/\r?\n/)) {
-        const mv = line.match(YAML_LEAF_RE)
-        if (mv && !/^["']/.test(mv[1]) && / #/.test(mv[1])) {
-          hashHazards.push({ file: f, line: line.trim().slice(0, 100) })
-        }
-      }
-    }
-    for (const m of raw.matchAll(/\[\[([^\]]+)\]\]/g)) {
-      const target = m[1].trim()
-      if (!linkKeys.has(target)) brokenLinks.push({ file: f, target })
-    }
-  }
-
-  const problems =
-    dangling.length +
-    unlisted.length +
-    typeMismatch.length +
-    crlf.length +
-    brokenLinks.length +
-    hashHazards.length +
-    noFrontmatter.length
-
-  return {
-    dir,
-    fileCount: entries.length,
-    skipped,
-    indexEntries: targets.length,
-    dangling: dangling.map((file) => ({ file })),
-    unlisted: unlisted.map((file) => ({ file })),
-    typeMismatch,
-    crlf: crlf.map((file) => ({ file })),
-    brokenLinks,
-    hashHazards,
-    noFrontmatter: noFrontmatter.map((file) => ({ file })),
-    problems,
-  }
-}
-
-/**
- * 把审计结果压成给模型看的短文本（dream 工具返回值 / 报告附录都用它）。
- * @param {object} report — auditMemoryDir 的返回值
- * @param {number} [limit] — 每个分项最多列几条
- * @returns {string}
- */
-export function formatAudit(report, limit = 12) {
-  const lines = [
-    `扫描 ${report.fileCount} 个记忆文件 · 索引 ${report.indexEntries} 条 · 问题合计 ${report.problems}`,
-  ]
-  const section = (title, rows, render) => {
-    if (!rows.length) return
-    lines.push(`${title} (${rows.length})`)
-    for (const r of rows.slice(0, limit)) lines.push(`  - ${render(r)}`)
-    if (rows.length > limit) lines.push(`  … 另有 ${rows.length - limit} 条`)
-  }
-  section('索引悬空', report.dangling, (r) => r.file)
-  section('漏索引', report.unlisted, (r) => r.file)
-  section('type 与前缀不一致', report.typeMismatch, (r) => `${r.file} type=${r.type} 前缀=${r.prefix}`)
-  section('CRLF', report.crlf, (r) => r.file)
-  section('双链断链', report.brokenLinks, (r) => `${r.file} -> [[${r.target}]]`)
-  section('未加引号的「空格+#」', report.hashHazards, (r) => `${r.file} :: ${r.line}`)
-  section('无 frontmatter', report.noFrontmatter, (r) => r.file)
-  return lines.join('\n')
-}
+/**
+ * sage-mem dream — 记忆目录审计（六查）。
+ *
+ * 把 `sage-memory` 技能里的审计清单搬到 host 侧，让 dream 每次跑完都能自证
+ * 没把记忆改坏：
+ *   1. 索引悬空 —— MEMORY.md 指向不存在的文件
+ *   2. 漏索引   —— 存在但没进索引的记忆文件
+ *   3. type 与前缀不一致（分类看 type，前缀骗不了它）
+ *   4. CRLF     —— 「某个 Windows 编辑器碰过」的可疑信号
+ *   5. 双链断链 —— [[目标]] 找不到对应文件或 frontmatter name
+ *   6. 未加引号值里的「空格+#」—— 会被 YAML 当注释吞掉，解析不报错但描述残缺
+ *
+ * **纯只读**：不修任何东西。修哪条、怎么修，由 dream agent 或人决定。
+ *
+ * 这一份解析是 sage-mem host 半 parseFrontmatter 的同源精简版，故意不共用：
+ * 那边带着一长串历史坑的注释与行为（baseline、type 回落），审计只读不写，
+ * 重复二十行换零回归风险是划算的。
+ */
+
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** 索引文件名。它本身不是一条记忆，是索引。 */
+const INDEX_FILE = 'MEMORY.md'
+
+/**
+ * 非记忆条目：不是四类记忆、也不该套「type 与前缀一致」这条规则。
+ *
+ * session-log.md 是追加型流水（本机已 390+ KB），逐会话的账本而不是一条记忆；
+ * 它没有 `user_/feedback_/project_/reference_` 前缀，扫进来只会白白读一大坨
+ * 再报一条假问题（2026-09-27 实测：报出 `session-log.md type=reference`）。
+ * 同理 MEMORY.md 是索引本身，只作为链接来源读，不作为被审对象。
+ */
+const NON_ENTRY_FILES = new Set(['session-log.md'])
+
+/** YAML 行形态：`key: value`（顶层键，不含缩进的嵌套行）。 */
+const YAML_LEAF_RE = /^[A-Za-z0-9_.-]+:\s*(.*)$/
+
+/**
+ * 极简 frontmatter 解析，读法与 host 半一致：
+ * 顶层 `type:` 优先，没有才下钻 `metadata.type:`。
+ * @param {string} content — 文件全文
+ * @returns {{name: string, description: string, type: string, hasFrontmatter: boolean}}
+ */
+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] : '')
+  return {
+    name: grab('name'),
+    description: grab('description'),
+    type: String(type).trim(),
+    hasFrontmatter: true,
+  }
+}
+
+/**
+ * 抽 MEMORY.md 里的相对链接目标（`](file.md)` / `](file.md#L12)`）。
+ * @param {string} indexText
+ * @returns {string[]} 去重后的文件名列表
+ */
+export function indexTargets(indexText) {
+  const out = new Set()
+  for (const m of indexText.matchAll(/\]\(([^)]+\.md)(?:#[^)]*)?\)/g)) {
+    const raw = m[1].trim()
+    // 跳过外链与子目录路径：索引只指根目录下的记忆文件。
+    if (/^[a-z]+:\/\//i.test(raw) || raw.includes('/') || raw.includes('\\')) continue
+    out.add(raw)
+  }
+  return [...out]
+}
+
+/**
+ * 扫一个目录下的记忆文件（不含子目录 —— 归档区就该扫不到）。
+ * @param {string} dir
+ * @returns {Promise<{files: string[], indexText: string}>}
+ */
+async function readDirSnapshot(dir) {
+  let entries
+  entries = await readdir(dir, { withFileTypes: true })
+  const all = entries
+    .filter((e) => e.isFile() && e.name.toLowerCase().endsWith('.md'))
+    .map((e) => e.name)
+  const files = all.filter((f) => !NON_ENTRY_FILES.has(f.toLowerCase()))
+  let indexText = ''
+  try {
+    indexText = await readFile(join(dir, INDEX_FILE), 'utf8')
+  } catch (err) {
+    if (err?.code !== 'ENOENT') throw err
+  }
+  return { files, all, skipped: all.length - files.length, indexText }
+}
+
+/**
+ * 六查主入口。
+ * @param {string} dir — 记忆根目录
+ * @returns {Promise<object>} 结构化审计结果（problems 是六项之和）
+ */
+export async function auditMemoryDir(dir) {
+  const { files, all, skipped, indexText } = await readDirSnapshot(dir)
+  const entries = files.filter((f) => f !== INDEX_FILE)
+
+  const targets = indexTargets(indexText)
+  const targetSet = new Set(targets.map((t) => t.toLowerCase()))
+  // 悬空判定用 `all`（含 session-log.md）：索引万一真引用了它，那是索引的问题，
+  // 不该因为「审计不检查 session-log」而被顺手放过。
+  const allSet = new Set(all.map((f) => f.toLowerCase()))
+
+  const dangling = targets.filter((t) => !allSet.has(t.toLowerCase()))
+  const unlisted = entries.filter((f) => !targetSet.has(f.toLowerCase()))
+
+  const typeMismatch = []
+  const crlf = []
+  const hashHazards = []
+  const brokenLinks = []
+  const noFrontmatter = []
+  const linkKeys = new Set()
+
+  const contents = new Map()
+  for (const f of files) {
+    contents.set(f, await readFile(join(dir, f), 'utf8'))
+  }
+  for (const f of files) {
+    const meta = parseFrontmatterLite(contents.get(f))
+    if (meta.name) linkKeys.add(meta.name.trim())
+  }
+  for (const f of files) linkKeys.add(f)
+  for (const f of files) linkKeys.add(f.replace(/\.md$/, ''))
+
+  for (const f of entries) {
+    const raw = contents.get(f)
+    if (raw.includes('\r')) crlf.push(f)
+    const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/)
+    if (!fmMatch) {
+      noFrontmatter.push(f)
+    } else {
+      const meta = parseFrontmatterLite(raw)
+      const prefix = f.split('_')[0]
+      const effective = meta.type || 'reference'
+      if (effective !== prefix) {
+        typeMismatch.push({ file: f, type: meta.type || '(缺失)', prefix, effective })
+      }
+      for (const line of fmMatch[1].split(/\r?\n/)) {
+        const mv = line.match(YAML_LEAF_RE)
+        if (mv && !/^["']/.test(mv[1]) && / #/.test(mv[1])) {
+          hashHazards.push({ file: f, line: line.trim().slice(0, 100) })
+        }
+      }
+    }
+    for (const m of raw.matchAll(/\[\[([^\]]+)\]\]/g)) {
+      const target = m[1].trim()
+      if (!linkKeys.has(target)) brokenLinks.push({ file: f, target })
+    }
+  }
+
+  const problems =
+    dangling.length +
+    unlisted.length +
+    typeMismatch.length +
+    crlf.length +
+    brokenLinks.length +
+    hashHazards.length +
+    noFrontmatter.length
+
+  return {
+    dir,
+    fileCount: entries.length,
+    skipped,
+    indexEntries: targets.length,
+    dangling: dangling.map((file) => ({ file })),
+    unlisted: unlisted.map((file) => ({ file })),
+    typeMismatch,
+    crlf: crlf.map((file) => ({ file })),
+    brokenLinks,
+    hashHazards,
+    noFrontmatter: noFrontmatter.map((file) => ({ file })),
+    problems,
+  }
+}
+
+/**
+ * 把审计结果压成给模型看的短文本（dream 工具返回值 / 报告附录都用它）。
+ * @param {object} report — auditMemoryDir 的返回值
+ * @param {number} [limit] — 每个分项最多列几条
+ * @returns {string}
+ */
+export function formatAudit(report, limit = 12) {
+  const lines = [
+    `扫描 ${report.fileCount} 个记忆文件 · 索引 ${report.indexEntries} 条 · 问题合计 ${report.problems}`,
+  ]
+  const section = (title, rows, render) => {
+    if (!rows.length) return
+    lines.push(`${title} (${rows.length})`)
+    for (const r of rows.slice(0, limit)) lines.push(`  - ${render(r)}`)
+    if (rows.length > limit) lines.push(`  … 另有 ${rows.length - limit} 条`)
+  }
+  section('索引悬空', report.dangling, (r) => r.file)
+  section('漏索引', report.unlisted, (r) => r.file)
+  section('type 与前缀不一致', report.typeMismatch, (r) => `${r.file} type=${r.type} 前缀=${r.prefix}`)
+  section('CRLF', report.crlf, (r) => r.file)
+  section('双链断链', report.brokenLinks, (r) => `${r.file} -> [[${r.target}]]`)
+  section('未加引号的「空格+#」', report.hashHazards, (r) => `${r.file} :: ${r.line}`)
+  section('无 frontmatter', report.noFrontmatter, (r) => r.file)
+  return lines.join('\n')
+}