@kenz1117/dsh-engram 0.6.1 → 0.7.2

package/lib/index.js

@@ -1,10 +1,12 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, statSync } from "node:fs";
+import { createHash, randomUUID } from "node:crypto";
+import { createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 import { homedir } from "node:os";
 import z from "@deepseek-ai/schemastery";
-import { mkdir, writeFile } from "node:fs/promises";
-import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { createGzip, gunzip } from "node:zlib";
+import { promisify } from "node:util";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 //#region src/config.ts
 /**
@@ -26,7 +28,9 @@ const CONFIG_KEYS = /* @__PURE__ */ new Set([
 	"injectTokenBudget",
 	"rankRecencyWeight",
 	"rankProofWeight",
-	"queryRewrite"
+	"queryRewrite",
+	"autoSlot",
+	"reviewScheduling"
 ]);
 const INGEST_MODES = /* @__PURE__ */ new Set([
 	"off",
@@ -48,7 +52,9 @@ const Config = z.object({
 	injectTokenBudget: z.number().step(1).min(128).max(8192),
 	rankRecencyWeight: z.number().min(0).max(2),
 	rankProofWeight: z.number().min(0).max(2),
-	queryRewrite: z.boolean()
+	queryRewrite: z.boolean(),
+	autoSlot: z.boolean(),
+	reviewScheduling: z.boolean()
 });
 /**
 * 显式 resolve 步骤：默认值只在唯一的此处落地，非法值 loud 失败。
@@ -85,7 +91,9 @@ function resolveConfig(config = {}) {
 		injectTokenBudget: config.injectTokenBudget ?? 1024,
 		rankRecencyWeight: config.rankRecencyWeight ?? .2,
 		rankProofWeight: config.rankProofWeight ?? .1,
-		queryRewrite: config.queryRewrite ?? true
+		queryRewrite: config.queryRewrite ?? true,
+		autoSlot: config.autoSlot ?? true,
+		reviewScheduling: config.reviewScheduling ?? true
 	};
 }
 //#endregion
@@ -257,6 +265,8 @@ async function streamText(ctx, params) {
 const MEMORY_CONTEXT_TAG = "engram_memory_context";
 /** 当前用户请求协议标签。 */
 const CURRENT_USER_REQUEST_TAG = "current_user_request";
+/** 用户显式禁记标签：在对话中用 <no-palace>...</no-palace> 包裹的整段不会被记忆。 */
+const NO_PALACE_TAG = "no-palace";
 /**
 * 入库剥离时识别的记忆上下文标签集合：不区分来源——历史正文可能携带
 * 其他记忆插件（如 memmy/memos）的包裹标签，一律按不可信协议块剥离。
@@ -274,7 +284,7 @@ const MEMORY_CONTEXT_TAGS = [
 * @returns 可安全入库/复用的正文。
 */
 function sanitizeProtocolText(value) {
-	return normalizeWhitespace(unwrapCurrentUserRequestBlocks(stripMemoryContextBlocks(value)));
+	return normalizeWhitespace(unwrapCurrentUserRequestBlocks(stripMemoryContextBlocks(stripNoPalaceBlocks(value))));
 }
 /**
 * 渲染记忆包：内容先清洗再包裹协议标签，附三条使用警告；当前请求独立成段。
@@ -320,6 +330,10 @@ function stripMemoryContextBlocks(value) {
 	for (const tag of MEMORY_CONTEXT_TAGS) text = replaceTaggedBlocks(text, tag, () => "", { removeUnclosedTail: true });
 	return text;
 }
+/** 剥离 <no-palace>...</no-palace> 整段：用户显式禁记（默认整段移除，不留存任何痕迹）。 */
+function stripNoPalaceBlocks(value) {
+	return replaceTaggedBlocks(value, NO_PALACE_TAG, () => "", { removeUnclosedTail: true });
+}
 /** 解包 current_user_request 块，保留内部文本（当前请求是可信正文，只是去除标签）。 */
 function unwrapCurrentUserRequestBlocks(value) {
 	return replaceTaggedBlocks(value, CURRENT_USER_REQUEST_TAG, (inner) => inner);
@@ -507,8 +521,71 @@ function collectTexts(events, includeAssistant) {
 		minSeq
 	};
 }
-/** 各 turn/start 事件的下标与轮次号（缺 data.turn 时轮次为 undefined）。 */
+/** 寒暄正则：整段用户输入只含问候/感谢等无信息内容时跳过摄取。 */
+const CHITCHAT_RE = /^(?:你好|您好|嗨|哈喽|hello|hi|hey|谢谢|感谢|ok|okay|好的|在吗|收到|辛苦了)[!！,.，。?？~\s]*$/iu;
+/** 显式禁记正则：用户明确要求不要记住本轮内容时跳过摄取（窄匹配整句指令，避免误伤）。 */
+const NO_CAPTURE_RE = /(?:不要|别|不用|无需)(?:把这?[个件些条]?|把上一?轮|把刚才)?(?:记|存)(?:住|录|下来|进去|到记忆|进记忆)|don'?t\s+(?:remember|record|save)\s+(?:this|that|it)/i;
+/** 工具多样性得分：无工具 0；1-2 种 1；≥3 种 2。 */
+function toolDiversity(distinct) {
+	return distinct === 0 ? 0 : distinct <= 2 ? 1 : 2;
+}
+/**
+* 活动评分（四信号，< ACTIVITY_THRESHOLD 跳过摄取）：
+* min(floor(userChars/50), 3) + completedTurns + min(floor(toolResults/5), 2) + toolDiversity。
+* @param signals - 上一轮活动信号。
+* @returns 0-8 的整数评分。
+*/
+function activityScore(signals) {
+	return Math.min(Math.floor(signals.userChars / 50), 3) + signals.completedTurns + Math.min(Math.floor(signals.toolResults / 5), 2) + toolDiversity(signals.toolNames.size);
+}
+/** 判断用户输入是否为纯寒暄（无信息内容）。 */
+function isChitchat(text) {
+	return CHITCHAT_RE.test(text.trim());
+}
+/** 判断用户输入是否显式要求不要记住。 */
+function forbidsCapture(text) {
+	return NO_CAPTURE_RE.test(text);
+}
+/** 从事件切片提取活动信号（用户文本排除插件注入的快照消息）。 */
+function turnSignals(events) {
+	let userChars = 0;
+	let completedTurns = 0;
+	let toolResults = 0;
+	const toolNames = /* @__PURE__ */ new Set();
+	for (const event of events) if (event.type === "user/message") {
+		const data = event.data;
+		if (data?.source?.kind === "plugin") continue;
+		for (const block of data?.content ?? []) if (block?.type === "text" && typeof block.text === "string") userChars += block.text.length;
+	} else if (event.type === "assistant/message") {
+		if ((event.data?.content ?? []).some((block) => block?.type === "text" && typeof block.text === "string" && block.text !== "")) completedTurns = 1;
+	} else if (event.type === "tool/result") toolResults += 1;
+	else if (event.type === "tool/call") {
+		const name = event.data?.name;
+		if (typeof name === "string") toolNames.add(name);
+	}
+	return {
+		userChars,
+		completedTurns,
+		toolResults,
+		toolNames
+	};
+}
+/**
+* 上一轮自动摄取的节流判定（只作用于 previous 切片；末轮/pending 重放补做不受限）。
+* @returns 跳过原因；null = 允许摄取。
+*/
+function throttleDecision(events) {
+	if (activityScore(turnSignals(events)) < 5) return "low-activity";
+	const joined = collectTexts(events, false).texts.join(" ");
+	if (joined !== "" && isChitchat(joined)) return "chitchat";
+	if (forbidsCapture(joined)) return "capture-forbidden";
+	return null;
+}
+/** 各 turn/start 事件的下标与轮次号（缺 data.turn 时轮次为 undefined）。
+*  events 允许 undefined：会话 dispose 后事件源已 detach，宿主可能给不出日志，
+*  此时按空日志处理而不是抛 TypeError（调用方在会话生命周期之外，异常会变成未处理 rejection）。 */
 function turnStarts(events) {
+	if (events === void 0) return [];
 	const starts = [];
 	for (let i = 0; i < events.length; i++) {
 		if (events[i]?.type !== "turn/start") continue;
@@ -579,6 +656,15 @@ async function ingestPreviousTurn(deps) {
 		written: 0,
 		skipped: "already-ingested"
 	};
+	if (sliceMode === "previous") {
+		const throttled = throttleDecision(slice);
+		if (throttled !== null) return {
+			scannedEvents: slice.length,
+			candidates: 0,
+			written: 0,
+			skipped: throttled
+		};
+	}
 	const scoped = omitRecallToolResults(slice);
 	const { texts, minSeq } = collectTexts(scoped, limits.includeAssistant);
 	const cleaned = texts.map((text) => redactSecrets(sanitizeProtocolText(text)));
@@ -674,18 +760,22 @@ async function markPendingIngest(store, sessionId, turn) {
 * 会话结束时的末轮摄取：切片为最后一个 turn/start 到日志末尾，复用提炼管线。
 * 失败/超时只告警并把 (sessionId, turn) pending 键写入 op_log（下次会话首次
 * pre-step 重放补做），绝不影响对话。
+* 本函数不 reject：从取轮次到摄取全程在 try 内，异常一律降级为告警 + pending 键
+* （dispose 观察器是 fire-and-forget，逃逸的 rejection 会被宿主的 fail-loud 当作致命错误）。
 * @returns 摄取结果；无末轮或失败（已落 pending）时返回 null。
 */
 async function ingestFinalTurn(deps) {
-	const round = lastTurnNumber(deps.events);
-	if (round === void 0) return null;
+	/** 末轮轮次号；取不到（无 turn/start 或事件源不可用）时不落 pending——键需要轮次。 */
+	let round;
 	try {
+		round = lastTurnNumber(deps.events);
+		if (round === void 0) return null;
 		return await ingestPreviousTurn({
 			...deps,
 			slice: "last"
 		});
 	} catch (error) {
-		try {
+		if (round !== void 0) try {
 			await markPendingIngest(await deps.openStore(), deps.sessionId, round);
 		} catch {}
 		console.warn("[dsh-engram] 会话结束的末轮摄取失败（已记入待补做队列，不影响对话）：", error);
@@ -734,6 +824,726 @@ async function replayPendingIngests(deps) {
 	};
 }
 //#endregion
+//#region src/consolidation/run.ts
+/** 单条整理动作（写入 op_log 的统一标记）。 */
+const CONSOLIDATION_OP = "consolidation";
+/** 默认参数。 */
+const DEFAULTS = {
+	olderThanDays: 30,
+	importanceBelow: .3,
+	mergeThreshold: .92
+};
+/** 闭馆整理主函数：纯异步，不抛错（失败仅记日志 / 落 pending）。 */
+async function runConsolidation(store, embedder, opts = {}) {
+	const start = Date.now();
+	const options = {
+		...DEFAULTS,
+		...opts
+	};
+	const scope = options.scope ?? "user";
+	const stats = await store.stats();
+	const records = await store.topActive(scope, Math.max(stats.active, 0));
+	const archivedIds = /* @__PURE__ */ new Set();
+	let archived = 0;
+	let merged = 0;
+	let skipped = 0;
+	const now = Date.now();
+	const ageCutoff = options.olderThanDays * 864e5;
+	for (const record of records) {
+		if (record.importance >= options.importanceBelow) continue;
+		if (now - record.createdAt < ageCutoff) continue;
+		if (record.confidence >= .3) continue;
+		try {
+			await store.forget(record.id);
+			archivedIds.add(record.id);
+			archived += 1;
+		} catch {
+			skipped += 1;
+		}
+	}
+	const emb = await embedder;
+	const buckets = /* @__PURE__ */ new Map();
+	for (const record of records) {
+		if (archivedIds.has(record.id)) continue;
+		const list = buckets.get(record.kind) ?? [];
+		list.push(record);
+		buckets.set(record.kind, list);
+	}
+	const seedIds = options.mergeCandidateIds !== void 0 ? new Set(options.mergeCandidateIds) : null;
+	for (const list of buckets.values()) {
+		if (list.length < 2) continue;
+		if (seedIds !== null && !list.some((record) => seedIds.has(record.id))) continue;
+		if (emb === void 0) {
+			const seen = /* @__PURE__ */ new Map();
+			for (const record of list) {
+				const key = record.content.slice(0, 60);
+				const existing = seen.get(key);
+				if (existing === void 0) seen.set(key, record);
+				else if (record.importance > existing.importance) {
+					await store.supersedeMany({
+						scope,
+						kind: record.kind,
+						content: record.content,
+						importance: record.importance,
+						confidence: record.confidence
+					}, [existing.id]).catch(() => {
+						skipped += 1;
+					});
+					merged += 1;
+					seen.set(key, record);
+				}
+			}
+			continue;
+		}
+		const vectors = /* @__PURE__ */ new Map();
+		for (const record of list) {
+			if (seedIds !== null && !seedIds.has(record.id)) continue;
+			try {
+				const vec = (await emb.embed([record.content]))[0];
+				if (vec !== void 0) vectors.set(record.id, vec);
+			} catch {
+				skipped += 1;
+			}
+		}
+		const arr = list.filter((record) => vectors.has(record.id));
+		const visited = /* @__PURE__ */ new Set();
+		for (let i = 0; i < arr.length; i += 1) {
+			const a = arr[i];
+			if (visited.has(a.id)) continue;
+			const dupes = [];
+			for (let j = i + 1; j < list.length; j += 1) {
+				const b = list[j];
+				if (visited.has(b.id)) continue;
+				const bVec = vectors.get(b.id);
+				if (bVec === void 0) continue;
+				if (cosine$1(vectors.get(a.id), bVec) >= options.mergeThreshold) dupes.push(b);
+			}
+			if (dupes.length === 0) continue;
+			const ids = dupes.map((record) => record.id);
+			try {
+				await store.supersedeMany({
+					scope,
+					kind: a.kind,
+					content: a.content,
+					importance: a.importance,
+					confidence: a.confidence
+				}, ids);
+				for (const id of ids) visited.add(id);
+				visited.add(a.id);
+				merged += 1;
+			} catch {
+				skipped += 1;
+			}
+		}
+	}
+	const report = {
+		archived,
+		merged,
+		skipped,
+		tookMs: Date.now() - start
+	};
+	try {
+		await store.audit(CONSOLIDATION_OP, "AUX", JSON.stringify({
+			scope,
+			archived: report.archived,
+			merged: report.merged,
+			skipped: report.skipped,
+			tookMs: report.tookMs
+		}));
+	} catch {}
+	return report;
+}
+/** cosine 相似度（两个等长非零向量）。 */
+function cosine$1(a, b) {
+	let dot = 0;
+	let na = 0;
+	let nb = 0;
+	const n = Math.min(a.length, b.length);
+	for (let i = 0; i < n; i += 1) {
+		dot += a[i] * b[i];
+		na += a[i] * a[i];
+		nb += b[i] * b[i];
+	}
+	const denom = Math.sqrt(na) * Math.sqrt(nb);
+	return denom === 0 ? 0 : dot / denom;
+}
+//#endregion
+//#region src/mirror/markdown.ts
+/**
+* Markdown 镜像：把 SQLite 记忆库导出为可被 Obsidian / VS Code / git 直接漫游的
+* 文件树，每个房间一个 .md + frontmatter，附楼层清单 _meta.json 与全宫殿入口 _index.md。
+* 写入过程全部幂等：重复执行只会覆盖同名文件，不会向 SQLite 写任何东西（只读）。
+* @module @kenz1117/dsh-engram/mirror/markdown
+*/
+/** 房间铭牌 URL/路径安全的 slug（仅 ASCII、连字符分隔）。 */
+function slugify(input) {
+	const stripped = input.toLowerCase().replace(/[\u4e00-\u9fa5]+/g, "记").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+	return stripped === "" ? "untitled" : stripped.slice(0, 32);
+}
+/** frontmatter 字段值序列化（string 原样、数字 / 布尔直接、null 空字符串）。 */
+function yaml(value) {
+	if (value === null || value === void 0) return "\"\"";
+	if (typeof value === "string") return `"${value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"").replaceAll("\n", " ")}"`;
+	return JSON.stringify(value);
+}
+/** ISO 时间戳（秒级，frontmatter 与 _meta 通用）。 */
+function iso(ms) {
+	return new Date(ms).toISOString();
+}
+/** 楼层中文别名（与面板 i18n 的 kindLabel 保持一致；只用做目录名）。 */
+const FLOOR_LABEL = {
+	fact: "fact",
+	preference: "preference",
+	decision: "decision",
+	episode: "episode",
+	skill: "skill"
+};
+/** 顶层 _index.md 的纯文本模板（楼层卡片 + 房间清单链接）。 */
+function renderIndex(scope, data, floors) {
+	const total = data.records.length;
+	const active = data.records.filter((r) => r.status === "active").length;
+	const edges = data.edges.length;
+	return `# 记忆宫殿 · ${scope === "user" ? "私人宫殿" : "项目宫殿"}\n` + [
+		"",
+		`> 导出时间 ${iso(data.exportedAt)} · 共 **${total}** 间房间（对外开放 ${active}） · 走廊 ${edges} 条`,
+		"",
+		"## 楼层导览",
+		"",
+		...floors.map((f) => `- **${FLOOR_LABEL[f.kind] ?? f.kind} 层** · ${f.roomCount} 间（开放 ${f.active} · 展厅 ${f.archived} · 闭馆 ${f.forgotten}）`),
+		"",
+		"## 房间清单",
+		"",
+		...data.records.slice().sort((a, b) => b.importance - a.importance).map((record) => `- [${record.status === "active" ? "●" : record.status === "archived" ? "◇" : "×"}][${FLOOR_LABEL[record.kind] ?? record.kind}] ${record.content.slice(0, 60)}${record.content.length > 60 ? "…" : ""} — [[${record.id.slice(0, 8)}]]`),
+		"",
+		"## 走廊（关系边）",
+		"",
+		...edges === 0 ? ["（暂无走廊）"] : data.edges.map((edge) => `- \`${edge.from.slice(0, 8)}\` --${edge.type}--> \`${edge.to.slice(0, 8)}\``),
+		""
+	].join("\n");
+}
+/** 单房间 .md 模板：YAML frontmatter + 铭牌正文 + 走廊列表。 */
+function renderRoom(record, edges) {
+	const relEdges = edges.filter((edge) => edge.from === record.id || edge.to === record.id);
+	const tags = [];
+	if (record.outcome !== void 0) tags.push(`outcome-${record.outcome}`);
+	if (record.content.includes("[REDACTED:")) tags.push("redacted");
+	const imagery = record.imagery;
+	const caption = imagery?.caption;
+	const sensory = imagery?.sensoryTags ?? [];
+	const frontmatter = [
+		"---",
+		`id: ${record.id}`,
+		`scope: ${record.scope}`,
+		`kind: ${record.kind}`,
+		`status: ${record.status}`,
+		`importance: ${record.importance.toFixed(3)}`,
+		`confidence: ${record.confidence.toFixed(3)}`,
+		`createdAt: "${iso(record.createdAt)}"`,
+		`accessCount: ${record.accessCount}`,
+		`sourceSession: ${record.sourceSessionId === null ? "\"\"" : yaml(record.sourceSessionId)}`,
+		`sourceRound: ${record.sourceRound ?? "\"\""}`,
+		...tags.length === 0 ? [] : [`tags: [${tags.join(", ")}]`],
+		...caption !== void 0 && caption !== null ? [`imageryCaption: ${yaml(caption)}`] : [],
+		...sensory.length > 0 ? [`imagerySensory: [${sensory.map((s) => yaml(s)).join(", ")}]`, `imageryValence: ${(imagery?.emotionalValence ?? 0).toFixed(3)}`] : [],
+		"---"
+	].join("\n");
+	const body = [
+		`# ${record.content.split("\n")[0]?.slice(0, 80) ?? "房间铭牌"}`,
+		"",
+		record.content,
+		"",
+		"## 走廊",
+		"",
+		...relEdges.length === 0 ? ["（此房间暂未连接任何走廊）"] : relEdges.map((edge) => {
+			const other = edge.from === record.id ? edge.to : edge.from;
+			return `- ${edge.from === record.id ? "→" : "←"} \`${other.slice(0, 8)}\`（${edge.type}）`;
+		}),
+		""
+	].join("\n");
+	return frontmatter + "\n" + body;
+}
+/** 楼层 _meta.json 模板。 */
+function renderMeta(scope, data, floors) {
+	const payload = {
+		scope,
+		exportedAt: data.exportedAt,
+		total: data.records.length,
+		floors
+	};
+	return JSON.stringify(payload, null, 2) + "\n";
+}
+/** 计算楼层摘要（按 kind 分组统计 active/archived/forgotten）。 */
+function summarizeFloors(records) {
+	const map = /* @__PURE__ */ new Map();
+	for (const record of records) {
+		const entry = map.get(record.kind) ?? {
+			roomCount: 0,
+			active: 0,
+			archived: 0,
+			forgotten: 0
+		};
+		entry.roomCount += 1;
+		if (record.status === "active") entry.active += 1;
+		else if (record.status === "archived") entry.archived += 1;
+		else if (record.status === "forgotten") entry.forgotten += 1;
+		map.set(record.kind, entry);
+	}
+	return [...map.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([kind, count]) => ({
+		kind,
+		...count
+	}));
+}
+/**
+* 把一份 exportAll 数据写入镜像目录。
+* @param rootDir - 镜像根目录（通常 `${exportDir}/mirror/<scope>/`，由调用方拼）。
+* @param data - exportAll 的产物（含 records + edges）。
+* @returns 写入摘要（rootDir / fileCount / floors）。
+*/
+async function writeMirror(rootDir, data) {
+	const scope = data.records[0]?.scope ?? "user";
+	await mkdir(rootDir, {
+		recursive: true,
+		mode: 448
+	});
+	const floors = summarizeFloors(data.records);
+	const recordsByKind = /* @__PURE__ */ new Map();
+	for (const record of data.records) {
+		const list = recordsByKind.get(record.kind) ?? [];
+		list.push(record);
+		recordsByKind.set(record.kind, list);
+	}
+	let fileCount = 0;
+	for (const record of data.records) {
+		const floor = recordsByKind.get(record.kind);
+		if (floor === void 0) continue;
+		const indexInFloor = floor.indexOf(record);
+		const floorDir = join(rootDir, FLOOR_LABEL[record.kind] ?? record.kind);
+		await mkdir(floorDir, {
+			recursive: true,
+			mode: 448
+		});
+		const fileName = `${record.id.slice(0, 8)}-${slugify(record.content)}-${String(indexInFloor).padStart(3, "0")}.md`;
+		await writeFile(join(floorDir, fileName), renderRoom(record, data.edges), { mode: 384 });
+		fileCount += 1;
+	}
+	await writeFile(join(rootDir, "_index.md"), renderIndex(scope, data, floors), { mode: 384 });
+	await writeFile(join(rootDir, "_meta.json"), renderMeta(scope, data, floors), { mode: 384 });
+	fileCount += 2;
+	if (scope === "shared") {
+		const manifest = buildShareManifest(data);
+		await writeFile(join(rootDir, "share-manifest.json"), JSON.stringify(manifest, null, 2) + "\n", { mode: 384 });
+		fileCount += 1;
+	}
+	return {
+		rootDir,
+		fileCount,
+		floors,
+		exportedAt: data.exportedAt
+	};
+}
+/**
+* 从导出数据构造借阅归还清单（仅 shared scope 调用）。
+* firstLentAt 用 createdAt 替代（数据库没记首次公开时刻，这是务实选择）。
+*/
+function buildShareManifest(data, now = Date.now()) {
+	const loans = data.records.filter((record) => record.scope === "shared").map((record) => ({
+		id: record.id,
+		kind: record.kind,
+		status: record.status,
+		importance: record.importance,
+		confidence: record.confidence,
+		firstLentAt: record.createdAt,
+		lastAccessedAt: record.lastAccessedAt,
+		accessCount: record.accessCount
+	}));
+	return {
+		generatedAt: now,
+		scope: "shared",
+		roomCount: loans.length,
+		loans
+	};
+}
+//#endregion
+//#region src/backup/tar-stream.ts
+/**
+* 极简 tar 流的写入与解包：UStar 格式（POSIX.1-1988），足够本插件「打包几个 .db + _meta.json」场景。
+* 文件名长度 ≤ 99 字节、文件 ≤ 8 GiB 已覆盖本插件的备份规模；超过则抛错。
+* 不依赖 npm 包（无第三方 = 无供应链风险）；可被测试套件无障碍运行。
+* @module @kenz1117/dsh-engram/backup/tar-stream
+*/
+/** UStar 头字段宽度（POSIX.1-1988）。 */
+const BLOCK_SIZE = 512;
+const NAME_LEN = 100;
+const SIZE_LEN = 12;
+/** 把数字按八进制 + ASCII 写入固定宽度（末尾置空）。 */
+function writeOctal(buf, offset, length, value) {
+	const str = value.toString(8).padStart(length - 1, "0");
+	buf.write(str, offset, length - 1, "ascii");
+	buf.write("\0", offset + length - 1, 1, "ascii");
+}
+/** 校验和：头块 0-511 字节所有字节求和（chksum 字段本身按空格处理）。 */
+function computeChecksum(header) {
+	let sum = 0;
+	for (let i = 0; i < BLOCK_SIZE; i += 1) sum += header[i];
+	return sum;
+}
+/** 写一个文件条目到 tar 流（UStar 头 + 数据 + 填充到 512 边界）。 */
+function createTarPack(out, name, data) {
+	if (name.length >= NAME_LEN) throw new Error(`tar 文件名过长（${String(name.length)} / ${String(99)}）：${name}`);
+	if (data.length >= 2 ** 88 - 1) throw new Error(`tar 文件过大：${name}（${String(data.length)} bytes）`);
+	const header = Buffer.alloc(BLOCK_SIZE);
+	header.write(name, 0, NAME_LEN, "ascii");
+	writeOctal(header, 100, 8, 384);
+	writeOctal(header, 108, 8, 0);
+	writeOctal(header, 116, 8, 0);
+	writeOctal(header, 124, SIZE_LEN, data.length);
+	writeOctal(header, 136, 12, Math.floor(Date.now() / 1e3));
+	header.write("0", 156, 1, "ascii");
+	header.write("ustar\0", 257, 6, "ascii");
+	header.write("00", 263, 2, "ascii");
+	header.write("        ", 148, 8, "ascii");
+	writeOctal(header, 148, 8, computeChecksum(header));
+	out.write(header);
+	out.write(data);
+	const padLen = (BLOCK_SIZE - data.length % BLOCK_SIZE) % BLOCK_SIZE;
+	if (padLen > 0) out.write(Buffer.alloc(padLen));
+}
+/** 写两个全 0 块作为 tar 结束标记（EOF）。 */
+function endTarPack(out) {
+	out.write(Buffer.alloc(BLOCK_SIZE * 2));
+}
+/** 解 tar 字节流到目标目录。整段读完再解析（备份场景文件小、可接受）。 */
+async function extractTar(buffer, destDir) {
+	const { writeFile, mkdir } = await import("node:fs/promises");
+	const { dirname } = await import("node:path");
+	let offset = 0;
+	while (offset + BLOCK_SIZE <= buffer.length) {
+		const header = buffer.subarray(offset, offset + BLOCK_SIZE);
+		if (header.every((b) => b === 0)) return;
+		const name = header.toString("ascii", 0, NAME_LEN).replace(/\0+$/, "");
+		const sizeOct = header.toString("ascii", 124, 136).replace(/\0+$/, "");
+		const size = parseInt(sizeOct, 8);
+		offset += BLOCK_SIZE;
+		if (size > 0) {
+			const data = buffer.subarray(offset, offset + size);
+			const target = join(destDir, name);
+			await mkdir(dirname(target), {
+				recursive: true,
+				mode: 448
+			});
+			await writeFile(target, data, { mode: 384 });
+			const pad = (BLOCK_SIZE - size % BLOCK_SIZE) % BLOCK_SIZE;
+			offset += size + pad;
+		} else offset += (BLOCK_SIZE - size % BLOCK_SIZE) % BLOCK_SIZE;
+	}
+}
+//#endregion
+//#region src/backup/tar.ts
+/**
+* 宫殿备份与恢复：把当前 user/project 两库的 .db + 元信息打包成单一 .tar.gz 文件；
+* 恢复时校验 tar 内的 _meta.json schema 版本并覆盖原库（恢复前自动备份现状为 .before-restore-<ts>）。
+* 设计原则：
+* 1. tar 内文件路径用相对形式 `palace.db` / `palace-<scope>.db` / `_meta.json`，避免暴露绝对路径。
+* 2. 元信息必须含 schema_version（与插件同构），恢复时若不匹配返回明确的兼容错误而不是默默覆盖。
+* 3. 整个过程失败原子：恢复前若任何前置校验失败，原库不动。
+* @module @kenz1117/dsh-engram/backup/tar
+*/
+const gunzipAsync = promisify(gunzip);
+/**
+* 创建备份：把 dbDir 下所有 *.db 与 `_meta.json` 一起打包成 .tar.gz。
+* @param dbDir - 插件数据目录（含 user.db / project-*.db）。
+* @param pluginVersion - 写进 _meta.json 的插件版本（与 package.json 同步）。
+*/
+async function createBackup(dbDir, pluginVersion) {
+	await mkdir(dbDir, {
+		recursive: true,
+		mode: 448
+	});
+	const files = (await readdir(dbDir)).filter((name) => name.endsWith(".db"));
+	const scopes = [];
+	const entries = [];
+	for (const name of files) {
+		const path = join(dbDir, name);
+		if (!(await stat(path)).isFile()) continue;
+		entries.push({
+			name,
+			data: await readFileBuffer(path)
+		});
+		scopes.push({
+			scope: name === "user.db" ? "user" : "project",
+			recordCount: 0,
+			edgeCount: 0
+		});
+	}
+	const meta = {
+		schemaVersion: 1,
+		pluginVersion,
+		exportedAt: Date.now(),
+		scopes
+	};
+	entries.push({
+		name: "_meta.json",
+		data: Buffer.from(JSON.stringify(meta, null, 2), "utf8")
+	});
+	const stamp = (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-").slice(0, 19);
+	const archivePath = join(dbDir, `palace-backup-${stamp}.tar.gz`);
+	await writeTarGz(archivePath, entries);
+	return {
+		archivePath,
+		meta,
+		bytes: (await stat(archivePath)).size
+	};
+}
+/** 异步读文件为 Buffer（小文件路径，备份场景可接受）。 */
+async function readFileBuffer(path) {
+	const { readFile } = await import("node:fs/promises");
+	return readFile(path);
+}
+/**
+* 把 entries 写入 .tar.gz。tar 头由本模块自带实现（避免引入 tar 依赖），gzip 用 zlib.createGzip。
+*/
+async function writeTarGz(outPath, entries) {
+	await new Promise((resolve, reject) => {
+		const sink = createWriteStream(outPath, { mode: 384 });
+		sink.on("error", reject);
+		sink.on("finish", () => resolve());
+		const gz = createGzip();
+		gz.on("error", reject);
+		gz.pipe(sink);
+		for (const entry of entries) createTarPack(gz, entry.name, entry.data);
+		endTarPack(gz);
+		gz.end();
+	});
+}
+/**
+* 从 .tar.gz 恢复：解包到临时目录 → 校验 _meta.json → 把 .db 文件原子搬到 dbDir。
+* 任何前置校验失败抛错，原 dbDir 不变。
+*/
+async function restoreBackup(archivePath, dbDir, options = {}) {
+	const tempDir = join(dbDir, `.restore-tmp-${Date.now()}`);
+	await mkdir(tempDir, {
+		recursive: true,
+		mode: 448
+	});
+	try {
+		await untarGz(archivePath, tempDir);
+		const metaRaw = await readFileBuffer(join(tempDir, "_meta.json")).then((buf) => buf.toString("utf8"));
+		const meta = JSON.parse(metaRaw);
+		if (meta.schemaVersion !== 1) throw new Error(`备份 schema 版本 ${meta.schemaVersion} 与当前 1 不兼容（请升级插件或使用旧版恢复）`);
+		if (typeof meta.pluginVersion !== "string" || meta.pluginVersion === "") throw new Error("备份 _meta.json 缺少 pluginVersion 字段，可能已损坏");
+		const restored = [];
+		if (options.keepCurrent !== false) {
+			const stamp = (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-").slice(0, 19);
+			for (const name of (await readdir(dbDir)).filter((n) => n.endsWith(".db"))) {
+				const path = join(dbDir, name);
+				await rename(path, `${path}.before-restore-${stamp}`);
+			}
+		}
+		for (const name of (await readdir(tempDir)).filter((n) => n.endsWith(".db"))) {
+			const target = join(dbDir, name);
+			await rename(join(tempDir, name), target);
+			restored.push(target);
+		}
+		return {
+			restored,
+			archiveMeta: meta
+		};
+	} finally {
+		await rm(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+/** 解 .tar.gz 到目标目录：先解压到 buffer，再 inline 解 tar。 */
+async function untarGz(archivePath, destDir) {
+	const compressed = await readFileBuffer(archivePath);
+	await extractTar(await gunzipAsync(compressed), destDir);
+}
+//#endregion
+//#region src/telemetry/aggregate.ts
+/** 聚合窗口（默认 7 天，可由路由 query 覆盖）。 */
+const DEFAULT_WINDOW_DAYS = 7;
+/** 从单库 op_log 统计各 op 的计数（窗口内）。 */
+async function countByOp(store, sinceMs) {
+	const ops = await store.recentOps(1e5);
+	const counts = {};
+	for (const op of ops) {
+		if (op.at < sinceMs) continue;
+		counts[op.op] = (counts[op.op] ?? 0) + 1;
+	}
+	return counts;
+}
+/** 聚合两库的指标 + 各 scope 状态。
+* @param scopeFilter - 限定只聚合指定 scope；undefined = 三库全聚合（向后兼容）。 */
+async function aggregateTelemetry(openStore, windowDays = DEFAULT_WINDOW_DAYS, scopeFilter) {
+	const untilMs = Date.now();
+	const sinceMs = untilMs - windowDays * 864e5;
+	const scopes = scopeFilter !== void 0 ? [scopeFilter] : [
+		"user",
+		"project",
+		"shared"
+	];
+	const countsAgg = {
+		ingestRequests: 0,
+		ingestDones: 0,
+		searches: 0,
+		writes: 0,
+		updates: 0,
+		forgets: 0,
+		restores: 0,
+		distillRequests: 0,
+		compressRequests: 0,
+		searchRewrites: 0,
+		consumptions: 0,
+		consolidations: 0
+	};
+	const scopeViews = [];
+	for (const scope of scopes) try {
+		const store = await openStore(scope);
+		const [counts, stats] = await Promise.all([countByOp(store, sinceMs), store.stats()]);
+		countsAgg.ingestRequests += counts["ingest-request"] ?? 0;
+		countsAgg.ingestDones += counts["ingest-done"] ?? 0;
+		countsAgg.searches += counts["search-rewrite-request"] ?? 0;
+		countsAgg.writes += counts["write"] ?? 0;
+		countsAgg.updates += counts["update"] ?? 0;
+		countsAgg.forgets += counts["forget"] ?? 0;
+		countsAgg.restores += counts["restore"] ?? 0;
+		countsAgg.distillRequests += counts["distill-request"] ?? 0;
+		countsAgg.compressRequests += counts["compress-request"] ?? 0;
+		countsAgg.searchRewrites += counts["search-rewrite-request"] ?? 0;
+		countsAgg.consumptions += counts["outcome-report"] ?? 0;
+		countsAgg.consolidations += counts["consolidation"] ?? 0;
+		scopeViews.push({
+			scope,
+			active: stats.active,
+			total: stats.total,
+			signalRatio: stats.signalRatio
+		});
+	} catch {}
+	return {
+		windowDays,
+		sinceMs,
+		untilMs,
+		counts: countsAgg,
+		scopes: scopeViews
+	};
+}
+//#endregion
+//#region src/tour-proposal.ts
+/**
+* 构造入殿建议。
+* @param scope - 作用域（user/project；shared 单独处理）
+* @param records - 当前 scope 的 active 条目（已按 importance × confidence 倒序）
+* @param focusKind - 本轮 user 输入的主题（可选；存在时优先选同 kind）
+*/
+function buildTourProposal(scope, records, focusKind) {
+	const active = records.filter((r) => r.status === "active");
+	const empty = active.length === 0;
+	const limit = Math.min(5, Math.max(1, active.length));
+	const scored = [...active].sort((a, b) => {
+		const focusBoost = (record) => focusKind !== void 0 && record.kind === focusKind ? 1 : 0;
+		const scoreA = focusBoost(a) * 1e3 + a.importance * a.confidence * 100;
+		return focusBoost(b) * 1e3 + b.importance * b.confidence * 100 - scoreA;
+	}).slice(0, limit);
+	return {
+		greeting: empty ? `[${scope}] 宫殿尚空。建议：先放第一段记忆（例如一条 fact 或 preference），让后续会话有锚点可循。` : `[${scope}] 宫殿现存 ${active.length} 间 active 房间。建议开场巡游：${scored.map((r, i) => `第 ${i + 1} 站「${r.content.slice(0, 24)}${r.content.length > 24 ? "…" : ""}」`).join("；")}。`,
+		suggestedStops: scored,
+		activeCount: active.length,
+		empty
+	};
+}
+//#endregion
+//#region src/refurb.ts
+/** 缺省参数。 */
+const DEFAULT_REFURB_OPTIONS = {
+	demoteBelow: .2,
+	staleDays: 60,
+	duplicateTitleWindow: 0
+};
+/**
+* 扫描一组 active 条目，按规则生成翻新建议。
+* 仅扫描同 scope 内的内容；跨 scope 的相似合并留给上层判定。
+*/
+function gatherRefurbSuggestions(records, options = DEFAULT_REFURB_OPTIONS) {
+	const suggestions = [];
+	const now = Date.now();
+	const active = records.filter((r) => r.status === "active");
+	const byScope = /* @__PURE__ */ new Map();
+	for (const record of active) {
+		const list = byScope.get(record.scope) ?? [];
+		list.push(record);
+		byScope.set(record.scope, list);
+	}
+	for (const record of active) {
+		const daysSinceAccess = (now - record.lastAccessedAt) / 864e5;
+		if (record.importance < options.demoteBelow && daysSinceAccess > options.staleDays) suggestions.push({
+			action: "demote",
+			primaryId: record.id,
+			candidates: [],
+			scope: record.scope,
+			reason: `重要性 ${record.importance.toFixed(2)} < ${options.demoteBelow} 且 ${Math.floor(daysSinceAccess)} 天未访问，建议降级为 archived。`,
+			confidence: .7
+		});
+	}
+	for (const [scope, list] of byScope) {
+		const byKind = /* @__PURE__ */ new Map();
+		for (const record of list) {
+			const bucket = byKind.get(record.kind) ?? [];
+			bucket.push(record);
+			byKind.set(record.kind, bucket);
+		}
+		for (const [, items] of byKind) {
+			if (items.length < 2) continue;
+			const seen = /* @__PURE__ */ new Set();
+			for (const record of items) {
+				const key = record.content.slice(0, 20);
+				if (seen.has(key)) continue;
+				seen.add(key);
+				const dupes = items.filter((other) => other.id !== record.id && other.content.startsWith(key));
+				if (dupes.length > 0) suggestions.push({
+					action: "merge",
+					primaryId: record.id,
+					candidates: dupes.map((d) => d.id),
+					scope,
+					reason: `与 ${dupes.length} 间房间内容前 20 字重复，建议蒸馏合并。`,
+					confidence: .6
+				});
+			}
+		}
+	}
+	for (const record of active) if (record.accessCount === 0 && record.importance >= .7) suggestions.push({
+		action: "review",
+		primaryId: record.id,
+		candidates: [],
+		scope: record.scope,
+		reason: `重要性 ${record.importance.toFixed(2)} 但从未被参观，可能埋没在走廊，建议复习。`,
+		confidence: .5
+	});
+	for (const record of active) if (record.content.length > 400) suggestions.push({
+		action: "split",
+		primaryId: record.id,
+		candidates: [],
+		scope: record.scope,
+		reason: `内容长度 ${record.content.length} > 400，建议拆为多条独立房间。`,
+		confidence: .6
+	});
+	for (const record of active) {
+		const score = record.imageryScore;
+		if (score !== void 0 && score >= .5) continue;
+		const slot = record.slot === void 0 ? "" : `${record.slot.room}#${record.slot.index} `;
+		suggestions.push({
+			action: "review",
+			primaryId: record.id,
+			candidates: [],
+			scope: record.scope,
+			reason: score === void 0 ? `${slot}未挂门牌：宫殿纪律要求每个标记唯一、差异化、带日期，建议用 engram_update 的 placard 参数补挂。` : `${slot}门牌得分 ${score.toFixed(2)} < 0.5（不合唯一/差异化/带日期纪律），建议重写铭牌。`,
+			confidence: .4
+		});
+	}
+	return suggestions;
+}
+//#endregion
 //#region src/routes.ts
 /** 回环 peer：IPv4 127/8、IPv6 ::1、IPv4-mapped IPv6。 */
 function isLoopbackPeer(req) {
@@ -804,7 +1614,8 @@ function json(res, status, body) {
 }
 /** 从 URL searchParams 收敛 scope（缺省 user）。 */
 function scopeOf$1(raw, fallback) {
-	return raw === "user" || raw === "project" ? raw : fallback;
+	if (raw === "user" || raw === "project" || raw === "shared") return raw;
+	return fallback;
 }
 /**
 * 注册 /engram 页面与 /api/engram/* 接口（effect 由调用方持有，disposer 可逆）。
@@ -840,12 +1651,103 @@ function registerEngramRoutes(ctx, deps) {
 						...kind !== null && kind !== "" && kind !== "all" ? { kind } : {},
 						...q !== null && q !== "" ? { q } : {},
 						...redacted === "true" || redacted === "false" ? { redacted: redacted === "true" } : {},
+						...url.searchParams.get("sort") === "tour" ? { sort: "tour" } : {},
 						limit,
 						offset
 					};
 					json(res, 200, await (await deps.openStore(scope)).list(filter));
 					return;
 				}
+				if (req.method === "GET" && route === "search-test") {
+					const q = url.searchParams.get("q");
+					if (q === null || q.trim() === "") {
+						json(res, 400, { error: "q required" });
+						return;
+					}
+					const scopeParam = url.searchParams.get("scope");
+					const scopes = scopeParam === "all" || scopeParam === null || scopeParam === "" ? ["user", "project"] : [scopeOf$1(scopeParam, "user")];
+					const kind = url.searchParams.get("kind");
+					const limit = Math.min(20, Math.max(1, Number(url.searchParams.get("limit") ?? 10) || 10));
+					const embedder = deps.embedder === void 0 ? void 0 : await deps.embedder;
+					const vector = embedder === void 0 ? void 0 : (await embedder.embed([q.trim()]))[0];
+					const results = await Promise.all(scopes.map(async (scope) => {
+						return (await deps.openStore(scope)).search({
+							text: q,
+							scopes: [scope],
+							limit
+						}, vector);
+					}));
+					const degraded = results.some((result) => result.degraded);
+					let hits = results.flatMap((result) => result.hits);
+					if (kind !== null && kind !== "" && kind !== "all") hits = hits.filter((hit) => hit.record.kind === kind);
+					json(res, 200, {
+						degraded,
+						hits: hits.map((hit) => ({
+							id: hit.record.id,
+							score: hit.score,
+							via: hit.via,
+							...hit.viaEdge === void 0 ? {} : { viaEdge: hit.viaEdge },
+							scope: hit.record.scope,
+							kind: hit.record.kind,
+							status: hit.record.status,
+							content: hit.record.content,
+							createdAt: hit.record.createdAt
+						}))
+					});
+					return;
+				}
+				if (req.method === "GET" && route === "activity") {
+					const limit = Math.min(50, Math.max(1, Number(url.searchParams.get("limit") ?? 20) || 20));
+					json(res, 200, { operations: (await Promise.all(["user", "project"].map(async (scope) => {
+						return (await (await deps.openStore(scope)).recentOps(limit)).map((op) => ({
+							...op,
+							scope
+						}));
+					}))).flat().sort((a, b) => b.at - a.at).slice(0, limit) });
+					return;
+				}
+				if (req.method === "GET" && route === "review-due") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const limit = Math.min(50, Math.max(1, Number(url.searchParams.get("limit") ?? 20) || 20));
+					const now = Date.now();
+					json(res, 200, {
+						scope,
+						items: (await (await deps.openStore(scope)).dueReviews(now, limit)).map((record) => ({
+							id: record.id,
+							kind: record.kind,
+							...record.slot === void 0 ? {} : { slot: record.slot },
+							caption: record.imagery?.caption ?? null,
+							nextReviewAt: record.review?.nextReviewAt ?? null,
+							overdueDays: record.review?.nextReviewAt === null || record.review?.nextReviewAt === void 0 ? 0 : Math.max(0, Math.floor((now - record.review.nextReviewAt) / 864e5)),
+							reps: record.review?.reps ?? 0
+						}))
+					});
+					return;
+				}
+				if (req.method === "POST" && route === "review-answer") {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					if (body === null || typeof body.id !== "string" || body.id === "") {
+						json(res, 400, { error: "id required" });
+						return;
+					}
+					const grade = typeof body.grade === "number" && Number.isInteger(body.grade) && body.grade >= 0 && body.grade <= 5 ? body.grade : null;
+					if (grade === null) {
+						json(res, 400, { error: "grade must be an integer 0-5" });
+						return;
+					}
+					const scope = scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user");
+					const record = await (await deps.openStore(scope)).scheduleReview(body.id, grade);
+					if (record === void 0) {
+						json(res, 404, { error: `未找到条目 ${body.id}` });
+						return;
+					}
+					json(res, 200, {
+						id: record.id,
+						review: record.review ?? null
+					});
+					return;
+				}
 				if (req.method === "GET" && route === "review") {
 					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
 					const id = url.searchParams.get("id");
@@ -854,7 +1756,6 @@ function registerEngramRoutes(ctx, deps) {
 						return;
 					}
 					const view = await (await deps.openStore(scope)).review(id);
-					view === void 0 || view.operations;
 					if (view === void 0) {
 						json(res, 404, { error: `未找到条目 ${id}` });
 						return;
@@ -862,6 +1763,53 @@ function registerEngramRoutes(ctx, deps) {
 					json(res, 200, view);
 					return;
 				}
+				if (req.method === "GET" && route === "review-due") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const limit = Math.min(50, Math.max(1, Number(url.searchParams.get("limit") ?? 20) || 20));
+					const now = Date.now();
+					const due = await (await deps.openStore(scope)).dueReviews(now, limit);
+					json(res, 200, {
+						scope,
+						count: due.length,
+						now,
+						items: due.map((record) => ({
+							id: record.id,
+							kind: record.kind,
+							scope: record.scope,
+							importance: record.importance,
+							confidence: record.confidence,
+							...record.slot === void 0 ? {} : { slot: record.slot },
+							...typeof record.imagery?.caption === "string" ? { caption: record.imagery.caption } : {},
+							...record.review?.nextReviewAt === null || record.review?.nextReviewAt === void 0 ? {} : { overdueDays: Math.max(0, Math.floor((now - record.review.nextReviewAt) / 864e5)) },
+							...record.review === void 0 ? {} : {
+								reps: record.review.reps,
+								intervalDays: record.review.intervalDays
+							}
+						}))
+					});
+					return;
+				}
+				if (req.method === "POST" && route === "review-answer") {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					if (body === null || typeof body.id !== "string" || body.id === "") {
+						json(res, 400, { error: "id required" });
+						return;
+					}
+					const grade = Number(body.grade);
+					if (!Number.isInteger(grade) || grade < 0 || grade > 5) {
+						json(res, 400, { error: "grade must be an integer 0-5" });
+						return;
+					}
+					const scope = scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user");
+					const record = await (await deps.openStore(scope)).scheduleReview(body.id, grade);
+					if (record === void 0) {
+						json(res, 404, { error: `未找到条目 ${body.id}` });
+						return;
+					}
+					json(res, 200, { record });
+					return;
+				}
 				if (req.method === "GET" && route === "export") {
 					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
 					const format = url.searchParams.get("format") === "json" ? "json" : "markdown";
@@ -883,12 +1831,194 @@ function registerEngramRoutes(ctx, deps) {
 					res.end(body);
 					return;
 				}
-				if (req.method === "POST" && (route === "update" || route === "forget" || route === "restore")) {
-					if (!guardWrite(req, res)) return;
-					const body = await readJsonBody(req);
-					if (body === null || typeof body.id !== "string" || body.id === "") {
-						json(res, 400, { error: "id required" });
-						return;
+				if (req.method === "GET" && route === "mirror") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const data = await (await deps.openStore(scope)).exportAll();
+					const stamp = (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-").slice(0, 19);
+					json(res, 200, {
+						...await writeMirror(join(deps.mirrorDir, scope, stamp), data),
+						scope,
+						roomCount: data.records.length,
+						edgeCount: data.edges.length
+					});
+					return;
+				}
+				if (req.method === "GET" && route === "health") {
+					const rawScope = url.searchParams.get("scope");
+					const scopes = rawScope === "user" || rawScope === "project" || rawScope === "shared" ? [rawScope] : ["user", "project"];
+					const parts = await Promise.all(scopes.map(async (scope) => {
+						const store = await deps.openStore(scope);
+						const s = await store.stats();
+						const edgeCount = (await store.exportAll()).edges.length;
+						const total = Math.max(s.total, 1);
+						const signal = s.signalRatio;
+						const activeRatio = s.active / total;
+						const corridorRatio = Math.min(.5, edgeCount / Math.max(s.active, 1)) / .5;
+						const redactedPenalty = Math.max(0, 1 - s.redacted / total);
+						const archivedRatio = s.archived / total;
+						const isShared = scope === "shared";
+						const targetActive = isShared ? .7 : .85;
+						const decayLow = isShared ? .25 : .15;
+						const decayHigh = isShared ? .5 : .45;
+						const decayWindow = isShared ? .25 : .3;
+						const decayCoverage = archivedRatio >= decayLow && archivedRatio <= decayHigh ? 1 : Math.max(0, 1 - Math.min(Math.abs(archivedRatio - decayLow), Math.abs(archivedRatio - decayHigh)) / decayWindow);
+						const score = Math.round(signal * 40 + (1 - Math.abs(activeRatio - targetActive) / targetActive) * 25 + corridorRatio * 15 + redactedPenalty * 10 + decayCoverage * 10);
+						return {
+							scope,
+							score: Math.min(100, Math.max(0, score)),
+							signal,
+							activeRatio,
+							edgeCount,
+							redacted: s.redacted,
+							archivedRatio
+						};
+					}));
+					json(res, 200, {
+						overall: Math.round(parts.reduce((sum, part) => sum + part.score, 0) / parts.length),
+						parts,
+						evaluatedAt: Date.now()
+					});
+					return;
+				}
+				if (req.method === "GET" && route === "corridor") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const includeStatuses = /* @__PURE__ */ new Set(["active"]);
+					const rawStatus = url.searchParams.get("status");
+					if (rawStatus !== null && rawStatus !== "" && rawStatus !== "all") {
+						for (const s of rawStatus.split(",")) if (s === "active" || s === "archived" || s === "forgotten") includeStatuses.add(s);
+					}
+					const data = await (await deps.openStore(scope)).exportAll();
+					const nodes = data.records.filter((r) => includeStatuses.has(r.status)).map((r) => ({
+						id: r.id,
+						scope: r.scope,
+						kind: r.kind,
+						status: r.status,
+						importance: r.importance,
+						confidence: r.confidence,
+						title: r.content.length > 40 ? `${r.content.slice(0, 40)}…` : r.content,
+						content: r.content
+					}));
+					const allowedIds = new Set(nodes.map((n) => n.id));
+					json(res, 200, {
+						scope,
+						nodes,
+						edges: data.edges.filter((e) => allowedIds.has(e.from) && allowedIds.has(e.to)).map((e) => ({
+							id: `${e.from}-${e.to}-${e.type}`,
+							from: e.from,
+							to: e.to,
+							type: e.type
+						}))
+					});
+					return;
+				}
+				if (req.method === "GET" && route === "telemetry") {
+					const windowDays = Math.min(90, Math.max(1, Number(url.searchParams.get("days") ?? 7) || 7));
+					const rawScope = url.searchParams.get("scope");
+					const scopeFilter = rawScope === "user" ? "user" : rawScope === "project" ? "project" : rawScope === "shared" ? "shared" : void 0;
+					json(res, 200, await aggregateTelemetry(deps.openStore, windowDays, scopeFilter));
+					return;
+				}
+				if (req.method === "GET" && route === "tour-proposal") {
+					const rawScope = url.searchParams.get("scope");
+					const scope = rawScope === "project" ? "project" : rawScope === "shared" ? "shared" : "user";
+					const filter = await (await deps.openStore(scope)).list({
+						scope,
+						status: "active",
+						limit: 200,
+						offset: 0
+					});
+					const focusKind = url.searchParams.get("focusKind");
+					const proposal = buildTourProposal(scope, filter.records, focusKind ?? void 0);
+					json(res, 200, {
+						scope: proposal.empty ? "empty" : scope,
+						greeting: proposal.greeting,
+						activeCount: proposal.activeCount,
+						empty: proposal.empty,
+						suggestedStops: proposal.suggestedStops.map((record) => ({
+							id: record.id,
+							kind: record.kind,
+							content: record.content,
+							importance: record.importance,
+							confidence: record.confidence
+						}))
+					});
+					return;
+				}
+				if (req.method === "GET" && route === "refurb") {
+					const rawScope = url.searchParams.get("scope");
+					const scope = rawScope === "project" ? "project" : rawScope === "shared" ? "shared" : "user";
+					const suggestions = gatherRefurbSuggestions((await (await deps.openStore(scope)).list({
+						scope,
+						status: "active",
+						limit: 500,
+						offset: 0
+					})).records, DEFAULT_REFURB_OPTIONS);
+					json(res, 200, {
+						scope,
+						count: suggestions.length,
+						suggestions: suggestions.map((suggestion) => ({
+							action: suggestion.action,
+							primaryId: suggestion.primaryId,
+							candidates: [...suggestion.candidates],
+							scope: suggestion.scope,
+							reason: suggestion.reason,
+							confidence: suggestion.confidence
+						}))
+					});
+					return;
+				}
+				if (req.method === "POST" && route === "consolidate") {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					const rawScope = typeof body?.scope === "string" ? body.scope : "user";
+					const scope = rawScope === "project" ? "project" : rawScope === "shared" ? "shared" : "user";
+					const candidates = Array.isArray(body?.candidates) ? body.candidates.filter((value) => typeof value === "string") : void 0;
+					json(res, 200, await runConsolidation(await deps.openStore(scope), deps.embedder, candidates === void 0 ? { scope } : {
+						scope,
+						mergeCandidateIds: candidates
+					}));
+					return;
+				}
+				if (req.method === "POST" && route === "backup") {
+					if (!guardWrite(req, res)) return;
+					const result = await createBackup(deps.dbDir, deps.pluginVersion);
+					json(res, 200, {
+						archivePath: result.archivePath,
+						bytes: result.bytes,
+						meta: result.meta,
+						schemaVersion: 1
+					});
+					return;
+				}
+				if (req.method === "POST" && route === "restore-backup") {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					if (body === null || typeof body.archivePath !== "string" || body.archivePath === "") {
+						json(res, 400, { error: "archivePath required" });
+						return;
+					}
+					const normalized = join(deps.dbDir, body.archivePath.replace(/^\/+/, ""));
+					if (!normalized.startsWith(deps.dbDir + "/") && normalized !== deps.dbDir) {
+						json(res, 400, { error: "archivePath 必须在 dbDir 内" });
+						return;
+					}
+					try {
+						const result = await restoreBackup(normalized, deps.dbDir);
+						json(res, 200, {
+							restored: result.restored,
+							meta: result.archiveMeta
+						});
+					} catch (restoreError) {
+						json(res, 400, { error: `恢复失败：${restoreError instanceof Error ? restoreError.message : String(restoreError)}` });
+					}
+					return;
+				}
+				if (req.method === "POST" && (route === "update" || route === "forget" || route === "restore")) {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					if (body === null || typeof body.id !== "string" || body.id === "") {
+						json(res, 400, { error: "id required" });
+						return;
 					}
 					const scope = scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user");
 					const store = await deps.openStore(scope);
@@ -1050,6 +2180,106 @@ function migrateProjectDb(dbDir, identity) {
 	}
 	return "none";
 }
+/** kind → 默认房间名。固定映射，保证同主题记忆总是聚在同一间（同类巩固）。 */
+const KIND_ROOMS = {
+	fact: "事实厅",
+	preference: "偏好阁",
+	decision: "决策堂",
+	episode: "往事廊",
+	skill: "技法坊"
+};
+/**
+* 为新条目分配桩位。
+* @param kind - 记忆种类（决定默认房间）。
+* @param occupancy - 各房间占用状态（store.slotCountsByRoom() 的快照）。
+* @returns 分配的桩位与是否开了新房（开新房时调用方应记 op_log 提醒人工命名/拆分）。
+*/
+function assignSlot(kind, occupancy) {
+	const base = KIND_ROOMS[kind];
+	for (let n = 1;; n += 1) {
+		const room = n === 1 ? base : `${base}-${n}`;
+		const state = occupancy[room];
+		if (state === void 0) return {
+			slot: {
+				room,
+				index: 1
+			},
+			openedNewRoom: n > 1
+		};
+		if (state.count < 9) return {
+			slot: {
+				room,
+				index: state.maxIndex + 1
+			},
+			openedNewRoom: false
+		};
+	}
+}
+//#endregion
+//#region src/review/sm2.ts
+/** ease 系数下限（SM-2 标准值）：低于此值记忆会陷入过密复习。 */
+const MIN_EASE = 1.3;
+const DAY_MS = 864e5;
+/**
+* 按回忆质量推进调度。
+* @param grade - 回忆质量 0-5（0/1 完全遗忘，2 模糊错误，3 勉强，4 正确有迟疑，5 完美）。
+* @param state - 当前调度状态。
+* @param now - 答题时刻（epoch 毫秒）。
+* @returns 新调度状态（不修改入参）。
+*/
+function nextSchedule(grade, state, now) {
+	if (grade < 3) {
+		const ease = Math.max(MIN_EASE, state.easeFactor + (.1 - (5 - grade) * (.08 + (5 - grade) * .02)));
+		return {
+			nextReviewAt: now + 1 * DAY_MS,
+			easeFactor: Math.round(ease * 100) / 100,
+			intervalDays: 1,
+			reps: 0
+		};
+	}
+	const reps = state.reps + 1;
+	const intervalDays = reps === 1 ? 1 : reps === 2 ? 6 : Math.max(1, Math.round(state.intervalDays * state.easeFactor));
+	const ease = Math.max(MIN_EASE, state.easeFactor + (.1 - (5 - grade) * (.08 + (5 - grade) * .02)));
+	return {
+		nextReviewAt: now + intervalDays * DAY_MS,
+		easeFactor: Math.round(ease * 100) / 100,
+		intervalDays,
+		reps
+	};
+}
+/** 日期/时间锚点：ISO 日期、中文年月、相对时间词。 */
+const DATE_ANCHOR = /\d{4}[-/年.]\s?\d{1,2}|[今昨]天|本周|上周|周[一二三四五六日天]|\d{1,2}月\d{1,2}[日号]/;
+/** 差异化比较的前缀长度：前 6 字相同即视为「近似到无法区分」。 */
+const DIFF_PREFIX_LEN = 6;
+/**
+* 计算门牌质量分（0-1，保留两位小数）。
+* 构成：caption 有效（4-30 字）且全库唯一 +0.4；带日期/时间锚点 +0.3；
+* 与同房既有门牌差异化（前 6 字不重复）+0.3。无 caption 记 0 分。
+* @param caption - 门牌文字（ImageryLabel.caption）；null/undefined 表示未挂牌。
+* @param context - 既有门牌快照。
+* @returns 0-1 的质量分。
+*/
+function scorePlacard(caption, context) {
+	if (caption === null || caption === void 0) return 0;
+	const text = caption.trim();
+	let score = 0;
+	const valid = text.length >= 4 && text.length <= 30;
+	if (valid && !context.existingCaptions.includes(text)) score += .4;
+	if (DATE_ANCHOR.test(text)) score += .3;
+	const prefix = text.slice(0, DIFF_PREFIX_LEN);
+	const clashes = context.roomCaptions.some((other) => other.slice(0, DIFF_PREFIX_LEN) === prefix);
+	if (valid && !clashes) score += .3;
+	return Math.round(Math.min(1, score) * 100) / 100;
+}
+/**
+* 低分门牌的增强建议（附在 engram_save 输出末尾，中文一行）。
+* @param score - scorePlacard 的得分。
+* @returns 建议文本；非低分返回 null。
+*/
+function placardImprovementHint(score) {
+	if (score >= .5) return null;
+	return "门牌不合规（宫殿纪律：唯一 · 差异化 · 带日期）：建议用 engram_update 的 imagery 参数挂一个 4-30 字、含日期锚点、与同房其他门牌前 6 字不重复的铭牌。";
+}
 //#endregion
 //#region src/store/sqlite.ts
 /**
@@ -1059,8 +2289,33 @@ function migrateProjectDb(dbDir, identity) {
 * 本包声明兼容 node ^22.19。
 * @module @kenz1117/dsh-engram/store/sqlite
 */
-/** 当前 schema 版本；结构性变更必须 +1 并拒绝旧库（pre-release 无兼容承诺）。 */
-const SCHEMA_VERSION = 2;
+/** 当前 schema 版本；结构性变更必须 +1。可空列与伴随表走增量迁移（见 openEngramStore 的迁移段）。 */
+const SCHEMA_VERSION = 6;
+/** 增量迁移表：key 为起始版本，value 为升到下一版本的 SQL（可多语句）。
+*  v2 → v3：nodes 补可空列 outcome（使用效果回报）。
+*  v3 → v4：新增 nodes_revisions 修订表（update 归档旧条目时的内容快照）。
+*  v4 → v5：nodes 补 imagery_json 列（意象铭牌：caption + sensoryTags + emotionalValence + provisional）。
+*  v5 → v6：桩位（slot_room/slot_index）、意象质量分（imagery_score）、SM-2 调度
+*   （next_review_at/ease_factor/interval_days/review_reps）+ 固定巡游路线表 tour_routes。
+*   全部可空或带默认值，存量条目零搬运；排桩由 backfillSlots 幂等补齐。 */
+const MIGRATIONS = {
+	"2": "ALTER TABLE nodes ADD COLUMN outcome TEXT",
+	"3": `CREATE TABLE IF NOT EXISTS nodes_revisions (
+    node_id TEXT NOT NULL, content TEXT NOT NULL, kind TEXT NOT NULL,
+    importance REAL NOT NULL, superseded_at INTEGER NOT NULL);`,
+	"4": "ALTER TABLE nodes ADD COLUMN imagery_json TEXT",
+	"5": `ALTER TABLE nodes ADD COLUMN slot_room TEXT;
+    ALTER TABLE nodes ADD COLUMN slot_index INTEGER;
+    ALTER TABLE nodes ADD COLUMN imagery_score REAL;
+    ALTER TABLE nodes ADD COLUMN next_review_at INTEGER;
+    ALTER TABLE nodes ADD COLUMN ease_factor REAL;
+    ALTER TABLE nodes ADD COLUMN interval_days REAL;
+    ALTER TABLE nodes ADD COLUMN review_reps INTEGER DEFAULT 0;
+    CREATE TABLE IF NOT EXISTS tour_routes (
+      position INTEGER PRIMARY KEY, node_id TEXT NOT NULL);
+    CREATE INDEX IF NOT EXISTS nodes_slot ON nodes (slot_room, slot_index);
+    CREATE INDEX IF NOT EXISTS nodes_review_due ON nodes (next_review_at);`
+};
 /** RRF 融合常数：score = Σ 1/(K + rank)。 */
 const RRF_K = 60;
 /** 向量道的语义门槛：低于该余弦的条目不参与排序。 */
@@ -1073,9 +2328,38 @@ const RANK_POOL = 64;
 const EXPANSION_LIMIT = 32;
 /** 命中强化：每次检索命中的置信度增量。 */
 const CONFIDENCE_BUMP = .05;
+/** 效果回报降权：failure 回报的置信度扣减（success 复用 CONFIDENCE_BUMP）。 */
+const OUTCOME_PENALTY = .1;
 /** 审计视图返回的操作日志条数上限。 */
 const REVIEW_LOG_LIMIT = 20;
+/** 把意象铭牌序列化为 JSON（缺省序列化为 null，落库）。 */
+function imageryToJson(imagery) {
+	if (imagery === void 0) return null;
+	return JSON.stringify({
+		caption: imagery.caption,
+		sensoryTags: [...imagery.sensoryTags],
+		emotionalValence: imagery.emotionalValence,
+		provisional: imagery.provisional
+	});
+}
+/** 从 JSON 反序列化意象铭牌；空串或解析失败返回 undefined（视作未铭刻）。 */
+function jsonToImagery(raw) {
+	if (raw === null || raw === "") return void 0;
+	try {
+		const parsed = JSON.parse(raw);
+		return {
+			caption: typeof parsed.caption === "string" ? parsed.caption : null,
+			sensoryTags: Array.isArray(parsed.sensoryTags) ? parsed.sensoryTags.filter((s) => typeof s === "string") : [],
+			emotionalValence: typeof parsed.emotionalValence === "number" && Number.isFinite(parsed.emotionalValence) ? Math.min(1, Math.max(0, parsed.emotionalValence)) : 0,
+			provisional: parsed.provisional === true
+		};
+	} catch {
+		return;
+	}
+}
 function rowToRecord(row) {
+	const imagery = jsonToImagery(row.imagery_json);
+	const hasReviewState = row.next_review_at !== null || row.ease_factor !== null || row.interval_days !== null;
 	return {
 		id: asMemoryId(row.id),
 		scope: row.scope,
@@ -1084,12 +2368,25 @@ function rowToRecord(row) {
 		importance: row.importance,
 		confidence: row.confidence,
 		status: row.status,
+		...row.outcome === "success" || row.outcome === "failure" ? { outcome: row.outcome } : {},
 		createdAt: row.created_at,
 		lastAccessedAt: row.last_accessed_at,
 		accessCount: row.access_count,
 		sourceSessionId: row.source_session_id,
 		sourceRound: row.source_round,
-		sourceSeq: row.source_seq
+		sourceSeq: row.source_seq,
+		...imagery === void 0 ? {} : { imagery },
+		...row.slot_room === null || row.slot_index === null ? {} : { slot: {
+			room: row.slot_room,
+			index: row.slot_index
+		} },
+		...row.imagery_score === null ? {} : { imageryScore: row.imagery_score },
+		...hasReviewState ? { review: {
+			nextReviewAt: row.next_review_at,
+			easeFactor: row.ease_factor ?? 2.5,
+			intervalDays: row.interval_days ?? 0,
+			reps: row.review_reps ?? 0
+		} } : {}
 	};
 }
 function blobToVec(blob) {
@@ -1142,14 +2439,20 @@ const NO_BOOST = {
 	proofWeight: 0,
 	decayAfterDays: 30
 };
+/** 缺省全开（config 的默认值也在此处对齐）。 */
+const DEFAULT_AUTOMATION = {
+	autoSlot: true,
+	reviewScheduling: true
+};
 /**
 * 打开（必要时创建）一个 scope 分库。
 * @param path - SQLite 文件路径；目录不存在会自动创建（0o700）。
 * @param rankBoost - 排序 boost 参数；缺省不乘任何因子。
+* @param automation - 写入期自动化开关（自动排桩/初始排期）；缺省全开。
 * @returns 就绪的 EngramStore。
 * @throws EngramError(code=SCHEMA_INCOMPATIBLE) 当库的 schema 版本高于当前实现。
 */
-async function openEngramStore(path, rankBoost = NO_BOOST) {
+async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_AUTOMATION) {
 	await mkdir(dirname(path), {
 		recursive: true,
 		mode: 448
@@ -1173,36 +2476,89 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
       id TEXT PRIMARY KEY, scope TEXT NOT NULL, kind TEXT NOT NULL, content TEXT NOT NULL,
       importance REAL NOT NULL, confidence REAL NOT NULL, status TEXT NOT NULL,
       created_at INTEGER NOT NULL, last_accessed_at INTEGER NOT NULL, access_count INTEGER NOT NULL,
-      source_session_id TEXT, source_round INTEGER, source_seq INTEGER, embedding BLOB);
+      source_session_id TEXT, source_round INTEGER, source_seq INTEGER, embedding BLOB, outcome TEXT,
+      imagery_json TEXT,
+      slot_room TEXT, slot_index INTEGER, imagery_score REAL,
+      next_review_at INTEGER, ease_factor REAL, interval_days REAL,
+      review_reps INTEGER DEFAULT 0);
     CREATE TABLE IF NOT EXISTS edges (
       from_id TEXT NOT NULL, to_id TEXT NOT NULL, type TEXT NOT NULL, created_at INTEGER NOT NULL,
       PRIMARY KEY (from_id, to_id, type));
     CREATE TABLE IF NOT EXISTS op_log (
       seq INTEGER PRIMARY KEY AUTOINCREMENT, at INTEGER NOT NULL, op TEXT NOT NULL,
       target_id TEXT NOT NULL, detail TEXT);
+    CREATE TABLE IF NOT EXISTS nodes_revisions (
+      node_id TEXT NOT NULL, content TEXT NOT NULL, kind TEXT NOT NULL,
+      importance REAL NOT NULL, superseded_at INTEGER NOT NULL);
+    CREATE TABLE IF NOT EXISTS tour_routes (
+      position INTEGER PRIMARY KEY, node_id TEXT NOT NULL);
     CREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(node_id UNINDEXED, content, tokenize='unicode61');
     CREATE INDEX IF NOT EXISTS nodes_scope_status ON nodes (scope, status);
   `);
 	const versionRow = db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
-	if (versionRow === void 0) db.prepare("INSERT INTO meta (key, value) VALUES ('schema_version', ?)").run(String(SCHEMA_VERSION));
-	else if (Number(versionRow.value) !== SCHEMA_VERSION) {
-		db.close();
-		throw new EngramError("SCHEMA_INCOMPATIBLE", `engram 数据库 schema 版本 ${versionRow.value} 与插件支持的 ${SCHEMA_VERSION} 不一致：请备份并删除旧库文件（${path}）后重试`);
+	if (versionRow === void 0) {
+		db.exec(`CREATE INDEX IF NOT EXISTS nodes_slot ON nodes (slot_room, slot_index);
+      CREATE INDEX IF NOT EXISTS nodes_review_due ON nodes (next_review_at);`);
+		db.prepare("INSERT INTO meta (key, value) VALUES ('schema_version', ?)").run(String(SCHEMA_VERSION));
+	} else {
+		let version = Number(versionRow.value);
+		if (!Number.isInteger(version) || version > SCHEMA_VERSION) {
+			db.close();
+			throw new EngramError("SCHEMA_INCOMPATIBLE", `engram 数据库 schema 版本 ${versionRow.value} 高于插件支持的 ${SCHEMA_VERSION}：请升级插件或备份后删除旧库文件（${path}）`);
+		}
+		while (version < SCHEMA_VERSION) {
+			const migration = MIGRATIONS[String(version)];
+			if (migration === void 0) {
+				db.close();
+				throw new EngramError("SCHEMA_INCOMPATIBLE", `engram 数据库 schema 版本 ${version} 无法升到 ${SCHEMA_VERSION}（缺迁移步骤）：请备份并删除旧库文件（${path}）后重试`);
+			}
+			withTransaction(() => {
+				const safe = migration.split(";").map((stmt) => stmt.trim()).filter((stmt) => stmt !== "").filter((stmt) => {
+					const match = /^ALTER\s+TABLE\s+(\w+)\s+ADD\s+COLUMN\s+(\w+)/i.exec(stmt);
+					if (match === null) return true;
+					const table = match[1];
+					const column = match[2];
+					return !db.prepare(`PRAGMA table_info(${table})`).all().some((c) => c.name === column);
+				});
+				for (const stmt of safe) db.exec(stmt);
+				version += 1;
+				db.prepare("UPDATE meta SET value = ? WHERE key = 'schema_version'").run(String(version));
+			});
+		}
 	}
 	const sqlGet = db.prepare("SELECT * FROM nodes WHERE id = ?");
 	const sqlInsert = db.prepare(`INSERT INTO nodes
     (id, scope, kind, content, importance, confidence, status, created_at, last_accessed_at, access_count,
-     source_session_id, source_round, source_seq, embedding)
-    VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, 0, ?, ?, ?, ?)`);
+     source_session_id, source_round, source_seq, embedding, imagery_json,
+     slot_room, slot_index, imagery_score, next_review_at, ease_factor, interval_days)
+    VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, 0, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
 	const sqlFtsInsert = db.prepare("INSERT INTO nodes_fts (node_id, content) VALUES (?, ?)");
 	const sqlSetStatus = db.prepare("UPDATE nodes SET status = ?, last_accessed_at = ? WHERE id = ?");
+	const sqlSetOutcome = db.prepare(`UPDATE nodes
+    SET outcome = ?,
+        confidence = CASE WHEN ? = 'success' THEN min(1.0, confidence + ${CONFIDENCE_BUMP}) ELSE max(0.0, confidence - ${OUTCOME_PENALTY}) END
+    WHERE id = ?`);
 	const sqlTouch = db.prepare(`UPDATE nodes SET access_count = access_count + 1, last_accessed_at = ?,
     confidence = MIN(1, confidence + ${CONFIDENCE_BUMP}) WHERE id = ?`);
 	const sqlLog = db.prepare("INSERT INTO op_log (at, op, target_id, detail) VALUES (?, ?, ?, ?)");
 	const sqlHasAudit = db.prepare("SELECT 1 AS x FROM op_log WHERE op = ? AND detail = ? LIMIT 1");
 	const sqlListAudit = db.prepare("SELECT detail FROM op_log WHERE op = ? AND detail IS NOT NULL ORDER BY seq");
 	const sqlClearAudit = db.prepare("DELETE FROM op_log WHERE op = ? AND detail = ?");
-	const sqlOpLogById = db.prepare("SELECT at, op, detail FROM op_log WHERE target_id = ? ORDER BY seq DESC LIMIT ?");
+	const sqlOpLogById = db.prepare("SELECT at, op, target_id, detail FROM op_log WHERE target_id = ? ORDER BY seq DESC LIMIT ?");
+	const sqlGetManyByIds = db.prepare("SELECT * FROM nodes WHERE id IN (SELECT value FROM json_each(?))");
+	const sqlNeighborsBounded = db.prepare(`SELECT * FROM nodes WHERE id IN (
+    WITH RECURSIVE walk(id, depth) AS (
+      SELECT ?, 0
+      UNION
+      SELECT CASE WHEN e.from_id = walk.id THEN e.to_id ELSE e.from_id END, walk.depth + 1
+      FROM edges e JOIN walk ON (e.from_id = walk.id OR e.to_id = walk.id)
+      WHERE walk.depth < ? AND e.type IN ('supports','refines','related','supersedes','contradicts')
+    )
+    SELECT id FROM walk WHERE depth > 0
+  )`);
+	const sqlRecentOps = db.prepare("SELECT at, op, target_id, detail FROM op_log ORDER BY seq DESC LIMIT ?");
+	const sqlRevisionInsert = db.prepare("INSERT INTO nodes_revisions (node_id, content, kind, importance, superseded_at) VALUES (?, ?, ?, ?, ?)");
+	const sqlRevisionsById = db.prepare("SELECT content, kind, importance, superseded_at FROM nodes_revisions WHERE node_id = ? ORDER BY superseded_at DESC");
 	const sqlTopActive = db.prepare("SELECT * FROM nodes WHERE scope = ? AND status = 'active' ORDER BY importance DESC, confidence DESC LIMIT ?");
 	const sqlEdgeUpsert = db.prepare("INSERT OR IGNORE INTO edges (from_id, to_id, type, created_at) VALUES (?, ?, ?, ?)");
 	const sqlNeighbors = db.prepare(`SELECT * FROM edges WHERE from_id IN (SELECT value FROM json_each(?))
@@ -1216,31 +2572,54 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 	const sqlAllNodes = db.prepare("SELECT * FROM nodes ORDER BY created_at");
 	const sqlAllEdges = db.prepare("SELECT * FROM edges");
 	const sqlDecay = db.prepare(`UPDATE nodes SET status = 'archived'
-    WHERE status = 'active' AND importance < ? AND last_accessed_at < ?`);
+    WHERE status = 'active' AND importance < ? AND last_accessed_at < ? AND next_review_at IS NULL`);
+	const sqlScheduleReview = db.prepare(`UPDATE nodes
+    SET next_review_at = ?, ease_factor = ?, interval_days = ?, review_reps = ?, last_accessed_at = ?
+    WHERE id = ?`);
+	const sqlDueReviews = db.prepare(`SELECT * FROM nodes
+    WHERE status = 'active' AND next_review_at IS NOT NULL AND next_review_at <= ?
+    ORDER BY next_review_at ASC LIMIT ?`);
+	const sqlSlotCounts = db.prepare(`SELECT slot_room AS room, MAX(slot_index) AS maxIndex, COUNT(*) AS n
+    FROM nodes WHERE slot_room IS NOT NULL AND status != 'forgotten' GROUP BY slot_room`);
+	const sqlSetSlot = db.prepare("UPDATE nodes SET slot_room = ?, slot_index = ? WHERE id = ?");
+	const sqlUnslotted = db.prepare(`SELECT * FROM nodes WHERE slot_room IS NULL AND status = 'active'
+    ORDER BY kind, created_at`);
+	const sqlRouteAppend = db.prepare(`INSERT INTO tour_routes (position, node_id)
+    VALUES ((SELECT COALESCE(MAX(position), -1) + 1 FROM tour_routes), ?)`);
+	const sqlRouteList = db.prepare("SELECT position, node_id FROM tour_routes ORDER BY position");
+	const sqlRouteHas = db.prepare("SELECT 1 AS x FROM tour_routes WHERE node_id = ? LIMIT 1");
+	const sqlSlotNeighbors = db.prepare(`SELECT id FROM nodes
+    WHERE slot_room = ? AND slot_index IN (?, ?) AND status = 'active' AND id != ?`);
+	const sqlListPlacards = db.prepare(`SELECT slot_room AS room, json_extract(imagery_json, '$.caption') AS caption
+    FROM nodes WHERE imagery_json IS NOT NULL AND status = 'active'`);
 	const sqlPurgeNodes = db.prepare("DELETE FROM nodes");
 	const sqlPurgeEdges = db.prepare("DELETE FROM edges");
 	const sqlPurgeFts = db.prepare("DELETE FROM nodes_fts");
 	const sqlPurgeLog = db.prepare("DELETE FROM op_log");
-	/** FTS 道：按 scope 集合检索（占位符动态生成，scope 集合由调用方去重）。 */
-	const ftsSearch = (match, scopes) => {
+	const sqlPurgeRoutes = db.prepare("DELETE FROM tour_routes");
+	/** FTS 道：按 scope 集合检索（占位符动态生成，scope 集合由调用方去重）；rooms 非空时只查指定房间。 */
+	const ftsSearch = (match, scopes, rooms) => {
 		const placeholders = scopes.map(() => "?").join(",");
+		const roomCond = rooms === void 0 || rooms.length === 0 ? "" : ` AND n.slot_room IN (${rooms.map(() => "?").join(",")})`;
 		return db.prepare(`SELECT n.* FROM nodes_fts f JOIN nodes n ON n.id = f.node_id
-      WHERE nodes_fts MATCH ? AND n.status = 'active' AND n.scope IN (${placeholders})
-      ORDER BY bm25(nodes_fts) LIMIT ${RANK_POOL}`).all(match, ...scopes);
+      WHERE nodes_fts MATCH ? AND n.status = 'active' AND n.scope IN (${placeholders})${roomCond}
+      ORDER BY bm25(nodes_fts) LIMIT ${RANK_POOL}`).all(match, ...scopes, ...rooms ?? []);
 	};
-	/** 向量候选池：active 且带向量的条目，按 scope 集合过滤（占位符动态生成）。 */
-	const vectorPool = (scopes) => {
+	/** 向量候选池：active 且带向量的条目，按 scope 集合过滤（占位符动态生成）；rooms 非空时只查指定房间。 */
+	const vectorPool = (scopes, rooms) => {
 		const placeholders = scopes.map(() => "?").join(",");
-		return db.prepare(`SELECT * FROM nodes WHERE status = 'active' AND embedding IS NOT NULL AND scope IN (${placeholders})`).all(...scopes);
+		const roomCond = rooms === void 0 || rooms.length === 0 ? "" : ` AND slot_room IN (${rooms.map(() => "?").join(",")})`;
+		return db.prepare(`SELECT * FROM nodes WHERE status = 'active' AND embedding IS NOT NULL AND scope IN (${placeholders})${roomCond}`).all(...scopes, ...rooms ?? []);
 	};
 	const getRow = (id) => sqlGet.get(id);
 	/**
 	* 写入公共体：插入节点 + FTS + 操作日志（不建边、不开事务）。
 	* 事务由调用方持有（withTransaction）。
 	*/
-	const insertRecord = (id, input, content, importance, confidence, at, sourceSessionId, embedding, op) => {
+	const insertRecord = (id, input, content, importance, confidence, at, sourceSessionId, embedding, imagery, op) => {
 		const stored = embedding === null ? null : embedding instanceof Float32Array ? vecToBlob(embedding) : embedding;
-		sqlInsert.run(id, input.scope, input.kind, content, importance, confidence, at, at, sourceSessionId, input.sourceRound ?? null, input.sourceSeq ?? null, stored);
+		const initialReview = input.initialReviewAt ?? null;
+		sqlInsert.run(id, input.scope, input.kind, content, importance, confidence, at, at, sourceSessionId, input.sourceRound ?? null, input.sourceSeq ?? null, stored, imageryToJson(imagery), input.slot?.room ?? null, input.slot?.index ?? null, input.imageryScore ?? null, initialReview, initialReview === null ? null : 2.5, initialReview === null ? null : 0);
 		sqlFtsInsert.run(id, tokenizeForFts(content));
 		sqlLog.run(at, op, id, JSON.stringify({
 			kind: input.kind,
@@ -1266,6 +2645,45 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			related: related.map(asMemoryId)
 		};
 	};
+	/**
+	* 写入期自动化（save/批量/摄取/update/蒸馏全部写入路径统一在此落地；调用方须已持事务）：
+	* 1) 排桩——显式 slot 优先，否则按 kind 分房自动分配（满员开新房并记 op_log）；
+	* 2) 门牌评分——有铭牌时按「唯一/差异化/带日期」启发式落库；
+	* 3) 初始排期——reviewScheduling 开启且未显式指定时，1 天后首次到期；
+	* 4) 巡游路线——有桩位的条目登记到固定路线末尾。
+	* @returns 合入 WriteInput 的自动化字段。
+	*/
+	const applyWriteAutomation = (input, id, at, imagery) => {
+		let slot = input.slot;
+		if (slot === void 0 && automation.autoSlot) {
+			const occupancy = {};
+			for (const row of sqlSlotCounts.all()) occupancy[row.room] = {
+				count: row.n,
+				maxIndex: row.maxIndex
+			};
+			const assigned = assignSlot(input.kind, occupancy);
+			slot = assigned.slot;
+			if (assigned.openedNewRoom) sqlLog.run(at, "room-open", "BATCH", JSON.stringify({
+				room: slot.room,
+				kind: input.kind
+			}));
+		}
+		let imageryScore = input.imageryScore;
+		if (imageryScore === void 0 && imagery !== void 0) {
+			const placards = sqlListPlacards.all().filter((row) => typeof row.caption === "string" && row.caption !== "");
+			imageryScore = scorePlacard(imagery.caption, {
+				existingCaptions: placards.map((row) => row.caption),
+				roomCaptions: slot === void 0 ? [] : placards.filter((row) => row.room === slot.room).map((row) => row.caption)
+			});
+		}
+		const initialReviewAt = input.initialReviewAt ?? (automation.reviewScheduling ? at + 864e5 : void 0);
+		if (slot !== void 0 && sqlRouteHas.get(id) === void 0) sqlRouteAppend.run(id);
+		return {
+			...slot === void 0 ? {} : { slot },
+			...imageryScore === void 0 ? {} : { imageryScore },
+			...initialReviewAt === void 0 ? {} : { initialReviewAt }
+		};
+	};
 	return {
 		async write(input) {
 			const content = input.content.trim();
@@ -1273,7 +2691,11 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const id = asMemoryId(randomUUID());
 			const at = Date.now();
 			withTransaction(() => {
-				insertRecord(id, input, content, input.importance ?? .5, input.confidence ?? .5, at, input.sourceSessionId ?? null, input.embedding ?? null, "write");
+				const automationFields = applyWriteAutomation(input, id, at, input.imagery);
+				insertRecord(id, {
+					...input,
+					...automationFields
+				}, content, input.importance ?? .5, input.confidence ?? .5, at, input.sourceSessionId ?? null, input.embedding ?? null, input.imagery, "write");
 			});
 			return rowToRecord(sqlGet.get(id));
 		},
@@ -1281,11 +2703,36 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const row = getRow(id);
 			return row === void 0 ? void 0 : rowToRecord(row);
 		},
+		async getMany(ids) {
+			if (ids.length === 0) return [];
+			const seen = /* @__PURE__ */ new Set();
+			const unique = [];
+			for (const id of ids) if (!seen.has(id)) {
+				seen.add(id);
+				unique.push(id);
+			}
+			const rows = sqlGetManyByIds.all(JSON.stringify(unique.map((id) => String(id))));
+			const map = /* @__PURE__ */ new Map();
+			for (const row of rows) map.set(row.id, rowToRecord(row));
+			return unique.map((id) => map.get(id)).filter((r) => r !== void 0);
+		},
+		async neighbors(id, depth) {
+			const boundedDepth = Math.min(Math.max(1, Math.floor(depth)), 3);
+			const rows = sqlNeighborsBounded.all(String(id), boundedDepth);
+			const seen = /* @__PURE__ */ new Set([String(id)]);
+			const result = [];
+			for (const row of rows) {
+				if (seen.has(row.id)) continue;
+				seen.add(row.id);
+				result.push(rowToRecord(row));
+			}
+			return result;
+		},
 		async search(query, queryVector) {
 			const limit = query.limit ?? 8;
 			const scores = /* @__PURE__ */ new Map();
 			const match = ftsMatchExpression(query.text);
-			if (match !== void 0) ftsSearch(match, query.scopes).forEach((row, index) => {
+			if (match !== void 0) ftsSearch(match, query.scopes, query.rooms).forEach((row, index) => {
 				scores.set(row.id, {
 					score: 1 / (RRF_K + index + 1),
 					via: "fts"
@@ -1294,7 +2741,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			let degraded = true;
 			if (queryVector !== void 0) {
 				degraded = false;
-				vectorPool(query.scopes).map((row) => ({
+				vectorPool(query.scopes, query.rooms).map((row) => ({
 					row,
 					sim: cosine(queryVector, blobToVec(row.embedding))
 				})).filter((entry) => entry.sim >= MIN_COSINE).sort((a, b) => b.sim - a.sim).slice(0, RANK_POOL).forEach((entry, index) => {
@@ -1347,11 +2794,13 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 				const row = getRow(id);
 				if (row === void 0) continue;
 				const viaEdge = viaEdgeOf.get(id);
+				const cueNeighbors = hits.length < 5 && row.slot_room !== null && row.slot_index !== null ? sqlSlotNeighbors.all(row.slot_room, row.slot_index - 1, row.slot_index + 1, id).map((neighbor) => asMemoryId(neighbor.id)) : [];
 				hits.push({
 					record: rowToRecord(row),
 					score: info.score,
 					via: info.via,
-					...viaEdge === void 0 ? {} : { viaEdge }
+					...viaEdge === void 0 ? {} : { viaEdge },
+					...cueNeighbors.length === 0 ? {} : { cues: { neighbors: cueNeighbors } }
 				});
 				sqlTouch.run(Date.now(), id);
 			}
@@ -1376,13 +2825,20 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const id = asMemoryId(randomUUID());
 			const at = Date.now();
 			withTransaction(() => {
+				sqlRevisionInsert.run(input.id, old.content, old.kind, old.importance, at);
 				sqlSetStatus.run("archived", at, input.id);
 				sqlLog.run(at, "superseded", input.id, JSON.stringify({ supersededBy: id }));
-				insertRecord(id, {
+				const imagery = input.imagery ?? jsonToImagery(old.imagery_json);
+				const updateInput = {
 					scope: input.scope,
 					kind: input.kind,
 					content
-				}, content, input.importance ?? old.importance, old.confidence, at, old.source_session_id, input.embedding ?? old.embedding, "update");
+				};
+				const automationFields = applyWriteAutomation(updateInput, id, at, imagery);
+				insertRecord(id, {
+					...updateInput,
+					...automationFields
+				}, content, input.importance ?? old.importance, old.confidence, at, old.source_session_id, input.embedding ?? old.embedding, imagery, "update");
 				sqlEdgeUpsert.run(id, input.id, "supersedes", at);
 			});
 			return rowToRecord(sqlGet.get(id));
@@ -1393,6 +2849,132 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			sqlLog.run(Date.now(), "forget", id, null);
 			return rowToRecord(sqlGet.get(id));
 		},
+		async forgetWithTombstone(id, tombstone) {
+			if (getRow(id) === void 0) throw new EngramError("NOT_FOUND", `条目 ${id} 不存在`);
+			const at = Date.now();
+			const cleaned = {
+				reason: tombstone.reason.trim().slice(0, 200),
+				affects: tombstone.affects.trim().slice(0, 200),
+				stillUseful: tombstone.stillUseful.trim().slice(0, 200)
+			};
+			sqlSetStatus.run("forgotten", at, id);
+			sqlLog.run(at, "forget", id, JSON.stringify({ tombstone: cleaned }));
+			return rowToRecord(sqlGet.get(id));
+		},
+		async listForgottenWithTombs(limit) {
+			const boundedLimit = Math.max(1, Math.min(limit, 200));
+			return db.prepare(`SELECT n.*, o.at AS forgotten_at, o.detail AS tombstone_json
+        FROM nodes n
+        INNER JOIN op_log o ON o.target_id = n.id AND o.op = 'forget'
+        WHERE n.status = 'forgotten'
+        ORDER BY o.seq DESC
+        LIMIT ?`).all(boundedLimit).map((row) => {
+				let tombstone = null;
+				if (row.tombstone_json !== null) try {
+					const inner = JSON.parse(row.tombstone_json).tombstone;
+					if (inner !== void 0 && typeof inner.reason === "string") tombstone = {
+						reason: inner.reason,
+						affects: typeof inner.affects === "string" ? inner.affects : "",
+						stillUseful: typeof inner.stillUseful === "string" ? inner.stillUseful : ""
+					};
+				} catch {
+					tombstone = null;
+				}
+				const base = rowToRecord(row);
+				return {
+					id: base.id,
+					scope: base.scope,
+					kind: base.kind,
+					content: base.content,
+					importance: base.importance,
+					lastAccessedAt: base.lastAccessedAt,
+					tombstone,
+					forgottenAt: row.forgotten_at
+				};
+			});
+		},
+		async reportOutcome(id, outcome) {
+			if (getRow(id) === void 0) return void 0;
+			sqlSetOutcome.run(outcome, outcome, id);
+			sqlLog.run(Date.now(), "outcome-report", id, outcome);
+			return rowToRecord(sqlGet.get(id));
+		},
+		async scheduleReview(id, grade) {
+			const row = getRow(id);
+			if (row === void 0) return void 0;
+			const now = Date.now();
+			const next = nextSchedule(grade, rowToRecord(row).review ?? {
+				nextReviewAt: null,
+				easeFactor: 2.5,
+				intervalDays: 0,
+				reps: row.review_reps ?? 0
+			}, now);
+			sqlScheduleReview.run(next.nextReviewAt, next.easeFactor, next.intervalDays, next.reps, now, id);
+			sqlLog.run(now, "review-answer", id, JSON.stringify({
+				grade,
+				nextIntervalDays: next.intervalDays
+			}));
+			return rowToRecord(sqlGet.get(id));
+		},
+		async dueReviews(now, limit) {
+			return sqlDueReviews.all(now, Math.max(1, limit)).map(rowToRecord);
+		},
+		async slotCountsByRoom() {
+			const rows = sqlSlotCounts.all();
+			const result = {};
+			for (const row of rows) result[row.room] = {
+				count: row.n,
+				maxIndex: row.maxIndex
+			};
+			return result;
+		},
+		async assignSlot(id, slot) {
+			sqlSetSlot.run(slot.room, slot.index, id);
+			sqlLog.run(Date.now(), "slot-assign", id, JSON.stringify(slot));
+		},
+		async backfillSlots(capacityNote) {
+			const rows = sqlUnslotted.all();
+			if (rows.length === 0) return 0;
+			const now = Date.now();
+			withTransaction(() => {
+				const occupancy = {};
+				for (const row of sqlSlotCounts.all()) occupancy[row.room] = {
+					count: row.n,
+					maxIndex: row.maxIndex
+				};
+				for (const row of rows) {
+					const { slot, openedNewRoom } = assignSlot(row.kind, occupancy);
+					sqlSetSlot.run(slot.room, slot.index, row.id);
+					if (sqlRouteHas.get(row.id) === void 0) sqlRouteAppend.run(row.id);
+					const state = occupancy[slot.room] ?? {
+						count: 0,
+						maxIndex: 0
+					};
+					occupancy[slot.room] = {
+						count: state.count + 1,
+						maxIndex: Math.max(state.maxIndex, slot.index)
+					};
+					if (openedNewRoom) capacityNote(slot.room);
+				}
+				sqlLog.run(now, "slot-backfill", "BATCH", JSON.stringify({ assigned: rows.length }));
+			});
+			return rows.length;
+		},
+		async routeAppend(id) {
+			sqlRouteAppend.run(id);
+		},
+		async routeHas(id) {
+			return sqlRouteHas.get(id) !== void 0;
+		},
+		async routeList() {
+			return sqlRouteList.all().map((row) => ({
+				position: row.position,
+				id: asMemoryId(row.node_id)
+			}));
+		},
+		async listPlacards() {
+			return sqlListPlacards.all().filter((row) => typeof row.caption === "string" && row.caption !== "");
+		},
 		async restore(id) {
 			if (getRow(id) === void 0) throw new EngramError("NOT_FOUND", `条目 ${id} 不存在`);
 			sqlSetStatus.run("active", Date.now(), id);
@@ -1421,7 +3003,8 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const where = conds.join(" AND ");
 			const total = db.prepare(`SELECT COUNT(*) AS n FROM nodes WHERE ${where}`).get(...params).n;
 			return {
-				records: db.prepare(`SELECT * FROM nodes WHERE ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, filter.limit, filter.offset).map(rowToRecord),
+				records: (filter.sort === "tour" ? db.prepare(`SELECT nodes.* FROM nodes LEFT JOIN tour_routes ON tour_routes.node_id = nodes.id
+            WHERE ${where} ORDER BY tour_routes.position IS NULL, tour_routes.position ASC, created_at DESC LIMIT ? OFFSET ?`).all(...params, filter.limit, filter.offset) : db.prepare(`SELECT * FROM nodes WHERE ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, filter.limit, filter.offset)).map(rowToRecord),
 				total
 			};
 		},
@@ -1429,12 +3012,32 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const row = getRow(id);
 			if (row === void 0) return void 0;
 			const operations = sqlOpLogById.all(id, REVIEW_LOG_LIMIT);
+			const revisions = sqlRevisionsById.all(id);
 			return {
 				record: rowToRecord(row),
 				...edgeGroups(id),
-				operations
+				revisions: revisions.map((rev) => ({
+					content: rev.content,
+					kind: rev.kind,
+					importance: rev.importance,
+					supersededAt: rev.superseded_at
+				})),
+				operations: operations.map((op) => ({
+					at: op.at,
+					op: op.op,
+					targetId: op.target_id,
+					detail: op.detail
+				}))
 			};
 		},
+		async recentOps(limit) {
+			return sqlRecentOps.all(Math.max(1, limit)).map((op) => ({
+				at: op.at,
+				op: op.op,
+				targetId: op.target_id,
+				detail: op.detail
+			}));
+		},
 		async stats() {
 			const statusRows = sqlCountBy.all();
 			const kindRows = sqlCountKind.all();
@@ -1500,7 +3103,11 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 			const id = asMemoryId(randomUUID());
 			const at = Date.now();
 			withTransaction(() => {
-				insertRecord(id, input, content, input.importance ?? .5, input.confidence ?? .5, at, input.sourceSessionId ?? null, input.embedding ?? null, "distill");
+				const automationFields = applyWriteAutomation(input, id, at, input.imagery);
+				insertRecord(id, {
+					...input,
+					...automationFields
+				}, content, input.importance ?? .5, input.confidence ?? .5, at, input.sourceSessionId ?? null, input.embedding ?? null, input.imagery, "distill");
 				for (const oldId of oldIds) {
 					sqlSetStatus.run("archived", at, oldId);
 					sqlEdgeUpsert.run(id, oldId, "supersedes", at);
@@ -1526,6 +3133,7 @@ async function openEngramStore(path, rankBoost = NO_BOOST) {
 				sqlPurgeEdges.run();
 				sqlPurgeFts.run();
 				sqlPurgeLog.run();
+				sqlPurgeRoutes.run();
 			});
 		},
 		async close() {
@@ -1692,9 +3300,50 @@ function mergeQueryResults(retrievals, limit, rrfConstant, minPerQuery) {
 	return [...ranked.filter((entry) => reserved.has(entry.hit.record.id)), ...ranked.filter((entry) => !reserved.has(entry.hit.record.id))].slice(0, Math.max(0, limit)).map((entry) => entry.hit);
 }
 //#endregion
+//#region src/retrieve/budget.ts
+/**
+* 召回输出的字符预算：单条与总量双重截断，控制记忆正文占用的模型上下文
+* （协议内定值，对齐同类记忆插件的单轮召回配额，非部署可变项）。
+* @module @kenz1117/dsh-engram/retrieve/budget
+*/
+/** 单条召回行最大字符数（超长截断加省略号）。 */
+const RECALL_PER_ITEM_CHARS = 1200;
+/** 单次召回输出正文的总字符预算（含 id 与元信息行）。 */
+const RECALL_TOTAL_CHARS = 4800;
+/**
+* 截断单条文本到 maxChars（超长加省略号）。
+* @param text - 原文。
+* @param maxChars - 上限，默认 RECALL_PER_ITEM_CHARS。
+*/
+function truncateItem(text, maxChars = RECALL_PER_ITEM_CHARS) {
+	return text.length <= maxChars ? text : `${text.slice(0, maxChars)}…`;
+}
+/**
+* 总量预算内贪心装填行（保序；某行装不下时继续尝试更短的后续行），
+* 被跳过的行计数并在末尾追加提示行。
+* @param lines - 候选行（已按相关性排序）。
+* @param totalBudget - 总字符预算，默认 RECALL_TOTAL_CHARS。
+* @returns 装填后的行；有丢弃时末尾含「另有 N 条…」提示。
+*/
+function enforceBudget(lines, totalBudget = RECALL_TOTAL_CHARS) {
+	const kept = [];
+	let used = 0;
+	let dropped = 0;
+	for (const line of lines) {
+		if (used + line.length > totalBudget) {
+			dropped += 1;
+			continue;
+		}
+		kept.push(line);
+		used += line.length;
+	}
+	if (dropped > 0) kept.push(`（另有 ${dropped} 条未展示：缩小查询范围或降低 limit 后重试）`);
+	return kept;
+}
+//#endregion
 //#region src/tools/create.ts
 /**
-* 9 个 engram_ 工具的定义与执行器。工具 schema 保持窄参数；
+* 15 个 engram_ 工具的定义与执行器。工具 schema 保持窄参数；
 * scope 决定读写哪个分库；嵌入缺失时检索结果显式标记降级。
 * @module @kenz1117/dsh-engram/tools/create
 */
@@ -1707,13 +3356,19 @@ const KINDS = [
 ];
 /** 从模型参数收敛 scope（非法值或缺失回退 fallback）。 */
 function scopeOf(raw, fallback) {
-	return raw === "user" || raw === "project" ? raw : fallback;
+	if (raw === "user" || raw === "project" || raw === "shared") return raw;
+	return fallback;
 }
 /** 把 search scope 参数收敛为分库集合。 */
 function scopesOf(raw) {
 	if (raw === "user") return ["user"];
 	if (raw === "project") return ["project"];
-	return ["user", "project"];
+	if (raw === "shared") return ["shared"];
+	return [
+		"user",
+		"project",
+		"shared"
+	];
 }
 /** 查询向量：嵌入可用时返回查询文本的向量，否则 undefined（降级）。 */
 async function queryVectorOf(deps, text) {
@@ -1731,7 +3386,7 @@ async function rewriteQueries(deps, exec, query) {
 		queries: [query],
 		rewritten: false
 	};
-	const events = exec.agent?.session?.events ?? [];
+	const events = exec.agent?.session?.snapshotEvents() ?? [];
 	const route = deps.routeOverride ?? routeFromEvents(events);
 	if (route === void 0) return {
 		queries: [query],
@@ -1768,7 +3423,8 @@ async function rewriteQueries(deps, exec, query) {
 	}
 }
 /**
-* 构造 9 个工具定义（engram_save/search/timeline/update/forget/review/stats/export/distill）。
+* 构造 15 个工具定义（engram_save/search/timeline/update/forget/report/review/review_queue/
+* stats/export/distill/examine/neighbors/audit_forgotten/tour）。
 * @param deps - 分库打开器、嵌入器、辅助 LLM、导出目录。
 * @returns 可直接 register 的工具定义数组。
 */
@@ -1779,7 +3435,10 @@ function createEngramTools(deps) {
 	function renderSaveResultText(value) {
 		if (value.count !== void 0) {
 			const parts = [`已批量保存 ${value.count} 条记忆`];
-			for (const item of value.items ?? []) parts.push(`${item.id}（kind=${item.kind}, importance=${item.importance}）`);
+			for (const item of value.items ?? []) {
+				const slot = item.slot === void 0 ? "" : `, ${item.slot.room}#${item.slot.index}`;
+				parts.push(`${item.id}（kind=${item.kind}, importance=${item.importance}${slot}）`);
+			}
 			const failures = value.failed ?? [];
 			if (failures.length > 0) parts.push(`${failures.length} 条失败：${failures.map((entry) => `#${entry.index + 1} ${entry.reason}`).join("；")}`);
 			parts.push("后续会话可用 engram_search 召回。");
@@ -1797,7 +3456,8 @@ function createEngramTools(deps) {
 			content: item.content,
 			...item.importance === void 0 ? {} : { importance: item.importance },
 			sourceSessionId: item.sourceSessionId,
-			...embedding === void 0 ? {} : { embedding }
+			...embedding === void 0 ? {} : { embedding },
+			...item.imagery === void 0 ? {} : { imagery: item.imagery }
 		});
 		const candidates = embedding === void 0 ? [] : await store.findContradictions(embedding);
 		for (const candidate of candidates) await store.linkEdge(record.id, candidate.id, "contradicts");
@@ -1806,6 +3466,18 @@ function createEngramTools(deps) {
 			candidates
 		};
 	}
+	/** 门牌参数收敛：非空字符串转 ImageryLabel（感官/情绪维度留空——AI 不需要人脑补丁），非法返回 undefined。 */
+	function placardOf(raw) {
+		if (typeof raw !== "string") return void 0;
+		const caption = raw.trim();
+		if (caption === "") return void 0;
+		return {
+			caption,
+			sensoryTags: [],
+			emotionalValence: 0,
+			provisional: false
+		};
+	}
 	/** 批量保存：统一清洗/校验/批量内去重，一次批量嵌入，逐条写入；单条失败不阻塞其余。 */
 	async function saveBatch(sourceSessionId, items, rawScope) {
 		if (items.length > MAX_SAVE_BATCH) throw new Error(`engram_save: 单次最多保存 ${MAX_SAVE_BATCH} 条`);
@@ -1877,7 +3549,8 @@ function createEngramTools(deps) {
 			saved.push({
 				id: record.id,
 				kind: record.kind,
-				importance: record.importance
+				importance: record.importance,
+				...record.slot === void 0 ? {} : { slot: record.slot }
 			});
 		} catch (error) {
 			failed.push({
@@ -1891,307 +3564,597 @@ function createEngramTools(deps) {
 			failed
 		};
 	}
-	return [
-		defineTool({
-			name: "engram_save",
-			description: "保存长期记忆（跨会话可用），支持单条（content/kind）或批量（items，最多 10 条，单条失败不影响其余）。kind：fact 事实 / preference 偏好 / decision 决策 / episode 经历 / skill 方法。scope：project 仅当前项目，user 全局。",
-			parameters: {
-				content: {
-					type: "string",
-					description: "记忆正文（单条模式必填），一句话完整表达"
-				},
-				kind: {
-					type: "string",
-					enum: [...KINDS],
-					description: "记忆种类（单条模式必填）"
-				},
+	const save = defineTool({
+		name: "engram_save",
+		description: "保存长期记忆（跨会话可用），支持单条（content/kind）或批量（items，最多 10 条，单条失败不影响其余）。kind：fact 事实 / preference 偏好 / decision 决策 / episode 经历 / skill 方法。scope：project 仅当前项目，user 全局。",
+		parameters: {
+			content: {
+				type: "string",
+				description: "记忆正文（单条模式必填），一句话完整表达"
+			},
+			kind: {
+				type: "string",
+				enum: [...KINDS],
+				description: "记忆种类（单条模式必填）"
+			},
+			items: {
+				type: "array",
+				description: "批量保存条目数组，每项 {content, kind, importance?}；与 content/kind 二选一",
 				items: {
-					type: "array",
-					description: "批量保存条目数组，每项 {content, kind, importance?}；与 content/kind 二选一",
-					items: {
-						type: "object",
-						additionalProperties: false,
-						properties: {
-							content: {
-								type: "string",
-								required: true,
-								description: "记忆正文"
-							},
-							kind: {
-								type: "string",
-								enum: [...KINDS],
-								required: true,
-								description: "记忆种类"
-							},
-							importance: {
-								type: "number",
-								description: "重要性 0-1"
-							}
+					type: "object",
+					additionalProperties: false,
+					properties: {
+						content: {
+							type: "string",
+							required: true,
+							description: "记忆正文"
+						},
+						kind: {
+							type: "string",
+							enum: [...KINDS],
+							required: true,
+							description: "记忆种类"
+						},
+						importance: {
+							type: "number",
+							description: "重要性 0-1"
 						}
 					}
-				},
-				scope: {
-					type: "string",
-					enum: ["user", "project"],
-					description: "作用域，默认 project"
-				},
-				importance: {
-					type: "number",
-					description: "重要性 0-1，默认 0.5（仅单条模式）"
 				}
 			},
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: {
-						id: { type: "string" },
-						kind: { type: "string" },
-						importance: { type: "number" },
-						text: { type: "string" },
-						count: { type: "number" },
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared"
+				],
+				description: "作用域，默认 project"
+			},
+			importance: {
+				type: "number",
+				description: "重要性 0-1，默认 0.5（仅单条模式）"
+			},
+			placard: {
+				type: "string",
+				description: "门牌（可选，仅单条模式）：4-30 字铭牌。宫殿纪律：唯一 · 差异化 · 带日期锚点（如「2026-09 向量检索选型」），禁止与既有门牌近似到无法区分"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					id: { type: "string" },
+					kind: { type: "string" },
+					importance: { type: "number" },
+					text: { type: "string" },
+					count: { type: "number" },
+					items: {
+						type: "array",
 						items: {
-							type: "array",
-							items: {
-								type: "object",
-								additionalProperties: false,
-								properties: {
-									id: {
-										type: "string",
-										required: true
-									},
-									kind: {
-										type: "string",
-										required: true
-									},
-									importance: {
-										type: "number",
-										required: true
+							type: "object",
+							additionalProperties: false,
+							properties: {
+								id: {
+									type: "string",
+									required: true
+								},
+								kind: {
+									type: "string",
+									required: true
+								},
+								importance: {
+									type: "number",
+									required: true
+								},
+								slot: {
+									type: "object",
+									additionalProperties: false,
+									properties: {
+										room: {
+											type: "string",
+											required: true
+										},
+										index: {
+											type: "number",
+											required: true
+										}
 									}
 								}
 							}
-						},
-						failed: {
-							type: "array",
-							items: {
-								type: "object",
-								additionalProperties: false,
-								properties: {
-									index: {
-										type: "number",
-										required: true
-									},
-									reason: {
-										type: "string",
-										required: true
-									}
+						}
+					},
+					failed: {
+						type: "array",
+						items: {
+							type: "object",
+							additionalProperties: false,
+							properties: {
+								index: {
+									type: "number",
+									required: true
+								},
+								reason: {
+									type: "string",
+									required: true
 								}
 							}
 						}
 					}
-				},
-				render: (_args, value) => [{
-					type: "text",
-					text: renderSaveResultText(value)
-				}]
-			},
-			async execute(args, exec) {
-				const input = args;
-				const sourceSessionId = exec.agent?.id ?? null;
-				if (input.items !== void 0) {
-					if (input.content !== void 0 || input.kind !== void 0) throw new Error("engram_save: items 与 content/kind 参数不能同时使用");
-					if (!Array.isArray(input.items) || input.items.length === 0) throw new Error("engram_save: items 必须是非空数组");
-					return saveBatch(sourceSessionId, input.items, input.scope);
-				}
-				if (typeof input.content !== "string" || typeof input.kind !== "string") throw new Error("engram_save: 需要 content/kind（单条）或 items（批量）参数");
-				const content = redactSecrets(sanitizeProtocolText(input.content));
-				if (content.trim() === "") throw new Error("engram_save: 清洗后内容为空（原文只含协议标签或密钥）");
-				const scope = scopeOf(input.scope, "project");
-				const store = await deps.openStore(scope);
-				const embedder = await deps.embedder;
-				const embeddings = embedder === void 0 ? void 0 : await embedder.embed([content.trim()]);
-				const { record, candidates } = await writeWithContradictions(store, {
-					scope,
-					kind: input.kind,
-					content,
-					...typeof input.importance === "number" ? { importance: input.importance } : {},
-					sourceSessionId,
-					...embeddings?.[0] === void 0 ? {} : { embedding: embeddings[0] }
-				});
-				if (candidates.length > 0) {
-					const listed = candidates.map((candidate) => `「${candidate.content}」（id=${candidate.id}）`).join("；");
-					return {
-						id: record.id,
-						kind: record.kind,
-						importance: record.importance,
-						text: `已保存 ${record.id}。注意：与现有记忆高度相似——${listed}。若这是修正而非新事实，请用 engram_update 归并，或 engram_forget 去重。`
-					};
 				}
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: renderSaveResultText(value)
+			}]
+		},
+		async execute(args, exec) {
+			const input = args;
+			const sourceSessionId = exec.agent?.id ?? null;
+			if (input.items !== void 0) {
+				if (input.content !== void 0 || input.kind !== void 0) throw new Error("engram_save: items 与 content/kind 参数不能同时使用");
+				if (!Array.isArray(input.items) || input.items.length === 0) throw new Error("engram_save: items 必须是非空数组");
+				return saveBatch(sourceSessionId, input.items, input.scope);
+			}
+			if (typeof input.content !== "string" || typeof input.kind !== "string") throw new Error("engram_save: 需要 content/kind（单条）或 items（批量）参数");
+			const content = redactSecrets(sanitizeProtocolText(input.content));
+			if (content.trim() === "") throw new Error("engram_save: 清洗后内容为空（原文只含协议标签或密钥）");
+			const scope = scopeOf(input.scope, "project");
+			const store = await deps.openStore(scope);
+			const embedder = await deps.embedder;
+			const embeddings = embedder === void 0 ? void 0 : await embedder.embed([content.trim()]);
+			const imagery = placardOf(input.placard);
+			const { record, candidates } = await writeWithContradictions(store, {
+				scope,
+				kind: input.kind,
+				content,
+				...typeof input.importance === "number" ? { importance: input.importance } : {},
+				sourceSessionId,
+				...embeddings?.[0] === void 0 ? {} : { embedding: embeddings[0] },
+				...imagery === void 0 ? {} : { imagery }
+			});
+			const placardHint = imagery === void 0 || record.imageryScore === void 0 ? "" : `\n${placardImprovementHint(record.imageryScore) ?? ""}`;
+			if (candidates.length > 0) {
+				const listed = candidates.map((candidate) => `「${candidate.content}」（id=${candidate.id}）`).join("；");
 				return {
 					id: record.id,
 					kind: record.kind,
-					importance: record.importance
+					importance: record.importance,
+					text: `已保存 ${record.id}。注意：与现有记忆高度相似——${listed}。若这是修正而非新事实，请用 engram_update 归并，或 engram_forget 去重。${placardHint}`
 				};
 			}
-		}),
-		defineTool({
-			name: "engram_search",
-			description: "语义 + 关键词混合检索长期记忆。user 作用域存偏好与通用事实，project 作用域存项目约定与决策。结果行尾给出 id，供 engram_update/engram_forget 引用。",
-			parameters: {
-				query: {
-					type: "string",
-					required: true,
-					description: "检索文本"
-				},
-				scope: {
-					type: "string",
-					enum: [
-						"user",
-						"project",
-						"all"
-					],
-					description: "作用域，默认 all"
-				},
-				limit: {
-					type: "number",
-					description: "返回条数上限，默认 8"
-				}
+			const base = `已保存记忆 ${record.id}（kind=${record.kind}, importance=${record.importance}${record.slot === void 0 ? "" : `, ${record.slot.room}#${record.slot.index}`}）。后续会话可用 engram_search 召回。`;
+			return {
+				id: record.id,
+				kind: record.kind,
+				importance: record.importance,
+				text: `${base}${placardHint}`
+			};
+		}
+	});
+	const search = defineTool({
+		name: "engram_search",
+		description: "语义 + 关键词混合检索长期记忆。宫殿纪律：先想进哪个房间——事实厅（fact）/偏好阁（preference）/决策堂（decision）/往事廊（episode）/技法坊（skill），带上 room 参数只查该房间，更快更准；不确定房间时缺省全库检索。user 作用域存偏好与通用事实，project 作用域存项目约定与决策。结果行尾给出 id，供 engram_update/engram_forget 引用。",
+		parameters: {
+			query: {
+				type: "string",
+				required: true,
+				description: "检索文本"
 			},
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: {
-						degraded: {
-							type: "boolean",
-							required: true
-						},
-						text: {
-							type: "string",
-							required: true
-						}
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared",
+					"all"
+				],
+				description: "作用域，默认 all"
+			},
+			room: {
+				type: "string",
+				description: "房间路由：只在指定房间内检索（如「决策堂」）。房间目录见 engram_stats 输出"
+			},
+			limit: {
+				type: "number",
+				description: "返回条数上限，默认 8"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					degraded: {
+						type: "boolean",
+						required: true
+					},
+					text: {
+						type: "string",
+						required: true
 					}
-				},
-				render: (_args, value) => [{
-					type: "text",
-					text: value.text
-				}]
+				}
 			},
-			async execute(args, exec) {
-				const input = args;
-				const scopes = scopesOf(input.scope);
-				const limit = input.limit ?? 8;
-				const rewrite = await rewriteQueries(deps, exec, input.query);
-				const retrievals = await Promise.all(rewrite.queries.map(async (queryText) => {
-					const vector = await queryVectorOf(deps, queryText);
-					const results = await Promise.all(scopes.map(async (scope) => {
-						return (await deps.openStore(scope)).search({
-							text: queryText,
-							scopes: [scope],
-							limit
-						}, vector);
-					}));
-					return {
-						hits: results.flatMap((result) => result.hits).sort((a, b) => b.score - a.score).slice(0, limit),
-						degraded: results.some((result) => result.degraded)
-					};
+			render: (_args, value) => [{
+				type: "text",
+				text: value.text
+			}]
+		},
+		async execute(args, exec) {
+			const input = args;
+			const scopes = scopesOf(input.scope);
+			const rooms = typeof input.room === "string" && input.room.trim() !== "" ? [input.room.trim()] : void 0;
+			const limit = input.limit ?? 8;
+			const rewrite = await rewriteQueries(deps, exec, input.query);
+			const retrievals = await Promise.all(rewrite.queries.map(async (queryText) => {
+				const vector = await queryVectorOf(deps, queryText);
+				const results = await Promise.all(scopes.map(async (scope) => {
+					return (await deps.openStore(scope)).search({
+						text: queryText,
+						scopes: [scope],
+						limit,
+						...rooms === void 0 ? {} : { rooms }
+					}, vector);
 				}));
-				const degraded = retrievals.some((retrieval) => retrieval.degraded);
-				const lines = mergeQueryResults(retrievals, limit, 60, Math.floor(Math.max(0, limit) / Math.max(1, rewrite.queries.length))).map((hit, index) => {
-					const edge = hit.viaEdge === void 0 ? "" : `（经 ${hit.viaEdge.type} 关联自 ${hit.viaEdge.from}）`;
-					return `${index + 1}. [${hit.record.scope}/${hit.record.kind}] ${hit.record.content}（id=${hit.record.id}）${edge}`;
-				});
 				return {
-					degraded,
-					text: renderMemoryPacket(`${degraded && lines.length > 0 ? "（语义嵌入不可用，仅关键词检索）\n" : ""}${lines.join("\n") || "无命中"}`, "tool_search", input.query)
+					hits: results.flatMap((result) => result.hits).sort((a, b) => b.score - a.score).slice(0, limit),
+					degraded: results.some((result) => result.degraded)
 				};
+			}));
+			const degraded = retrievals.some((retrieval) => retrieval.degraded);
+			const lines = enforceBudget(mergeQueryResults(retrievals, limit, 60, Math.floor(Math.max(0, limit) / Math.max(1, rewrite.queries.length))).map((hit, index) => {
+				const edge = hit.viaEdge === void 0 ? "" : `（经 ${hit.viaEdge.type} 关联自 ${hit.viaEdge.from}）`;
+				const slot = hit.record.slot === void 0 ? "" : ` ${hit.record.slot.room}#${hit.record.slot.index}`;
+				const date = ` 刻于 ${new Date(hit.record.createdAt).toISOString().slice(0, 10)}`;
+				const cues = hit.cues === void 0 ? "" : ` 相邻桩位: ${hit.cues.neighbors.join(", ")}`;
+				return `${index + 1}. [${hit.record.scope}/${hit.record.kind}]${slot}${date} ${truncateItem(hit.record.content)}（id=${hit.record.id}）${edge}${cues}`;
+			}));
+			return {
+				degraded,
+				text: renderMemoryPacket(`${degraded && lines.length > 0 ? "（语义嵌入不可用，仅关键词检索）\n" : ""}${rooms === void 0 ? "" : `（房间路由：${rooms.join("、")}）\n`}${lines.join("\n") || "无命中"}`, "tool_search", input.query)
+			};
+		}
+	});
+	const timeline = defineTool({
+		name: "engram_timeline",
+		description: "按时间范围与主题浏览记忆（时间倒序，最近 20 条）。无参数直接列出最近记录。",
+		parameters: {
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared",
+					"all"
+				],
+				description: "作用域，默认 all"
+			},
+			topic: {
+				type: "string",
+				description: "主题子串"
+			},
+			since: {
+				type: "string",
+				description: "起始时间（ISO 或可解析日期）"
+			},
+			until: {
+				type: "string",
+				description: "结束时间"
 			}
-		}),
-		defineTool({
-			name: "engram_timeline",
-			description: "按时间范围与主题浏览记忆（时间倒序，最近 20 条）。无参数直接列出最近记录。",
-			parameters: {
-				scope: {
-					type: "string",
-					enum: [
-						"user",
-						"project",
-						"all"
-					],
-					description: "作用域，默认 all"
-				},
-				topic: {
-					type: "string",
-					description: "主题子串"
-				},
-				since: {
-					type: "string",
-					description: "起始时间（ISO 或可解析日期）"
-				},
-				until: {
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: { text: {
 					type: "string",
-					description: "结束时间"
-				}
+					required: true
+				} }
 			},
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: { text: {
+			render: (_args, value) => [{
+				type: "text",
+				text: value.text
+			}]
+		},
+		async execute(args) {
+			const input = args;
+			const scopes = scopesOf(input.scope);
+			const parseTime = (raw, field) => {
+				if (raw === void 0) return void 0;
+				const ms = Date.parse(raw);
+				if (Number.isNaN(ms)) throw new Error(`engram_timeline: ${field} 不是可解析时间 ${raw}`);
+				return ms;
+			};
+			const since = parseTime(input.since, "since");
+			const until = parseTime(input.until, "until");
+			return { text: renderMemoryPacket(enforceBudget((await Promise.all(scopes.map(async (scope) => {
+				return (await deps.openStore(scope)).timeline({
+					scopes: [scope],
+					...input.topic === void 0 ? {} : { topic: input.topic },
+					...since === void 0 ? {} : { since },
+					...until === void 0 ? {} : { until },
+					limit: 20
+				});
+			}))).flat().sort((a, b) => b.createdAt - a.createdAt).slice(0, 20).map((record) => `${new Date(record.createdAt).toISOString()} [${record.scope}/${record.kind}] ${truncateItem(record.content)}（id=${record.id}）`)).join("\n") || "时间线为空", "tool_timeline", input.topic ?? "（对话继续）") };
+		}
+	});
+	const update = defineTool({
+		name: "engram_update",
+		description: "修正一条记忆：写入新条目并把旧条目标记为被取代（链条保留，可审计）。id 来自 engram_search 结果。",
+		parameters: {
+			id: {
+				type: "string",
+				required: true,
+				description: "要修正的旧条目 id"
+			},
+			content: {
+				type: "string",
+				required: true,
+				description: "修正后的正文"
+			},
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared"
+				],
+				description: "旧条目作用域，默认 project"
+			},
+			kind: {
+				type: "string",
+				enum: [...KINDS],
+				description: "种类，默认继承旧条目"
+			},
+			placard: {
+				type: "string",
+				description: "门牌（可选）：4-30 字铭牌，替换旧条目门牌。宫殿纪律：唯一 · 差异化 · 带日期锚点"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					id: {
 						type: "string",
 						required: true
-					} }
-				},
-				render: (_args, value) => [{
-					type: "text",
-					text: value.text
-				}]
+					},
+					superseded: {
+						type: "string",
+						required: true
+					}
+				}
 			},
-			async execute(args) {
-				const input = args;
-				const scopes = scopesOf(input.scope);
-				const parseTime = (raw, field) => {
-					if (raw === void 0) return void 0;
-					const ms = Date.parse(raw);
-					if (Number.isNaN(ms)) throw new Error(`engram_timeline: ${field} 不是可解析时间 ${raw}`);
-					return ms;
-				};
-				const since = parseTime(input.since, "since");
-				const until = parseTime(input.until, "until");
-				return { text: renderMemoryPacket((await Promise.all(scopes.map(async (scope) => {
-					return (await deps.openStore(scope)).timeline({
-						scopes: [scope],
-						...input.topic === void 0 ? {} : { topic: input.topic },
-						...since === void 0 ? {} : { since },
-						...until === void 0 ? {} : { until },
-						limit: 20
-					});
-				}))).flat().sort((a, b) => b.createdAt - a.createdAt).slice(0, 20).map((record) => `${new Date(record.createdAt).toISOString()} [${record.scope}/${record.kind}] ${record.content}（id=${record.id}）`).join("\n") || "时间线为空", "tool_timeline", input.topic ?? "（对话继续）") };
+			render: (_args, value) => [{
+				type: "text",
+				text: `已写入修正记忆 ${value.id}；旧条目 ${value.superseded} 已归档并建立取代链。`
+			}]
+		},
+		async execute(args) {
+			const input = args;
+			const content = redactSecrets(sanitizeProtocolText(input.content));
+			if (content.trim() === "") throw new Error("engram_update: 清洗后内容为空（原文只含协议标签或密钥）");
+			const scope = scopeOf(input.scope, "project");
+			const store = await deps.openStore(scope);
+			const old = await store.get(input.id);
+			if (old === void 0) throw new Error(`engram_update: 条目 ${input.id} 不存在于 ${scope} 库（用 engram_search 确认 id 与 scope）`);
+			const embedder = await deps.embedder;
+			const embeddings = embedder === void 0 ? void 0 : await embedder.embed([content.trim()]);
+			const imagery = placardOf(input.placard);
+			return {
+				id: (await store.update({
+					id: input.id,
+					scope,
+					kind: input.kind ?? old.kind,
+					content,
+					...embeddings === void 0 ? {} : { embedding: embeddings[0] },
+					...imagery === void 0 ? {} : { imagery }
+				})).id,
+				superseded: input.id
+			};
+		}
+	});
+	const forget = defineTool({
+		name: "engram_forget",
+		description: "闭馆仪式（软删，可恢复）：遗忘前必须留下「为什么关 / 影响谁 / 还有用吗」三问答案作为墓志铭，便于日后考古。id 与 scope 来自 engram_search 结果。",
+		parameters: {
+			id: {
+				type: "string",
+				required: true,
+				description: "条目 id"
+			},
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared"
+				],
+				description: "条目作用域，默认 project"
+			},
+			reason: {
+				type: "string",
+				required: true,
+				description: "闭馆原因：被取代 / 过期 / 与现实不符 / 隐私 等"
+			},
+			affects: {
+				type: "string",
+				required: true,
+				description: "影响哪些条目/人/项目，空串表示不适用"
+			},
+			stillUseful: {
+				type: "string",
+				required: true,
+				description: "遗留价值：可考古 / 可复习 / 回滚时如何理解"
 			}
-		}),
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: { id: {
+					type: "string",
+					required: true
+				} }
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: `房间 ${value.id} 已闭馆（软删，可恢复），墓志铭已刻入操作日志。`
+			}]
+		},
+		async execute(args) {
+			const input = args;
+			const scope = scopeOf(input.scope, "project");
+			const reason = typeof input.reason === "string" ? input.reason.trim() : "";
+			const affects = typeof input.affects === "string" ? input.affects.trim() : "";
+			const stillUseful = typeof input.stillUseful === "string" ? input.stillUseful.trim() : "";
+			if (reason === "" || affects === "" || stillUseful === "") throw new Error("engram_forget: 闭馆三问（reason / affects / stillUseful）都必须填写，方便日后考古");
+			return { id: (await (await deps.openStore(scope)).forgetWithTombstone(input.id, {
+				reason,
+				affects,
+				stillUseful
+			})).id };
+		}
+	});
+	/** P0-3 闭馆考古：返回最近 N 条 forgotten 条目 + 墓志铭。 */
+	const auditForgotten = defineTool({
+		name: "engram_audit_forgotten",
+		description: "闭馆考古：列出最近 N 条已闭馆条目 + 墓志铭（为什么关 / 影响谁 / 还有用吗），便于复核过去的遗忘是否得当。",
+		parameters: {
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared",
+					"all"
+				],
+				description: "作用域，默认 all"
+			},
+			limit: {
+				type: "integer",
+				description: "返回条数上限，默认 20"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: { text: {
+					type: "string",
+					required: true
+				} }
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: value.text
+			}]
+		},
+		async execute(args) {
+			const input = args;
+			const scopes = scopesOf(input.scope);
+			const limit = Number.isInteger(input.limit) ? Math.min(Math.max(1, input.limit), 50) : 20;
+			const all = (await Promise.all(scopes.map(async (scope) => (await deps.openStore(scope)).listForgottenWithTombs(limit)))).flat();
+			all.sort((a, b) => b.forgottenAt - a.forgottenAt);
+			const sliced = all.slice(0, limit);
+			if (sliced.length === 0) return { text: "尚无闭馆条目。" };
+			const lines = sliced.map((row, index) => {
+				const stamp = new Date(row.forgottenAt).toISOString();
+				const tomb = row.tombstone === null ? "（墓志铭缺失：旧版无三问数据）" : `\n   - 为什么关：${row.tombstone.reason}\n   - 影响谁：${row.tombstone.affects}\n   - 还有用吗：${row.tombstone.stillUseful}`;
+				return `${index + 1}. [${row.scope}/${row.kind}] ${row.content.slice(0, 80)}${row.content.length > 80 ? "…" : ""}\n   id=${row.id} · importance=${row.importance.toFixed(2)} · 闭馆于 ${stamp}${tomb}`;
+			});
+			return { text: `闭馆考古（共 ${sliced.length} 条）：\n${lines.join("\n")}` };
+		}
+	});
+	const reviewQueue = defineTool({
+		name: "engram_review_queue",
+		description: "今日待回忆队列：列出已到期间隔重复的记忆，每条只给宫殿坐标与门牌线索（不给正文）。用法：对每条先尝试回忆内容，然后 engram_review 揭示核对，再 engram_report 传 grade（0-5）自评——主动回忆比重复阅读的记忆强化效果强得多。会话开始注入会提示今日是否有待回忆。",
+		parameters: {
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared",
+					"all"
+				],
+				description: "作用域，默认 all"
+			},
+			limit: {
+				type: "integer",
+				description: "返回条数上限，默认 10（最逾期在前）"
+			}
+		},
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: { text: {
+					type: "string",
+					required: true
+				} }
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: value.text
+			}]
+		},
+		async execute(args) {
+			const input = args;
+			const scopes = scopesOf(input.scope);
+			const limit = Number.isInteger(input.limit) ? Math.min(Math.max(1, input.limit), 50) : 10;
+			const now = Date.now();
+			const groups = await Promise.all(scopes.map(async (scope) => ({
+				scope,
+				due: await (await deps.openStore(scope)).dueReviews(now, limit)
+			})));
+			const total = groups.reduce((sum, group) => sum + group.due.length, 0);
+			if (total === 0) return { text: "今日无待回忆条目（队列空）。新记忆保存后次日首次到期。" };
+			const lines = [`今日待回忆 ${total} 段（最逾期在前）。对每段：先回忆 → engram_review 核对 → engram_report 传 grade 自评。`];
+			for (const { scope, due } of groups) for (const [index, record] of due.entries()) {
+				const slot = record.slot === void 0 ? "（未排桩）" : `${record.slot.room} #${record.slot.index}`;
+				const placard = record.imagery?.caption ?? "（无门牌）";
+				const overdueDays = record.review?.nextReviewAt === null || record.review?.nextReviewAt === void 0 ? 0 : Math.max(0, Math.floor((now - record.review.nextReviewAt) / 864e5));
+				const overdue = overdueDays === 0 ? "今日到期" : `逾期 ${overdueDays} 天`;
+				lines.push(`${index + 1}. [${scope}] ${slot} · 门牌「${placard}」 · ${overdue} · id=${record.id}`);
+			}
+			return { text: lines.join("\n") };
+		}
+	});
+	return [
+		save,
+		search,
+		timeline,
+		update,
+		forget,
 		defineTool({
-			name: "engram_update",
-			description: "修正一条记忆：写入新条目并把旧条目标记为被取代（链条保留，可审计）。id 来自 engram_search 结果。",
+			name: "engram_report",
+			description: "回报一条记忆（尤其 skill 类）使用后的实际效果：success（有效，提权）或 failure（无效，降权）。id 与 scope 来自 engram_search 结果。也可作为复习自评入口：传 grade（0 完全遗忘 … 5 完美回忆）显式报告回忆质量。效果影响后续召回排序与复习排期，长期无效的记忆会被衰减归档。",
 			parameters: {
 				id: {
 					type: "string",
 					required: true,
-					description: "要修正的旧条目 id"
+					description: "条目 id"
 				},
-				content: {
+				outcome: {
 					type: "string",
-					required: true,
-					description: "修正后的正文"
+					enum: ["success", "failure"],
+					description: "使用效果（与 grade 二选一；同传时 grade 优先）"
 				},
-				scope: {
-					type: "string",
-					enum: ["user", "project"],
-					description: "旧条目作用域，默认 project"
+				grade: {
+					type: "integer",
+					description: "回忆质量自评 0-5（复习答题用；0/1 完全遗忘，3 勉强，5 完美）"
 				},
-				kind: {
+				scope: {
 					type: "string",
-					enum: [...KINDS],
-					description: "种类，默认继承旧条目"
+					enum: [
+						"user",
+						"project",
+						"shared"
+					],
+					description: "条目作用域，默认 project"
 				}
 			},
 			output: {
@@ -2203,74 +4166,43 @@ function createEngramTools(deps) {
 							type: "string",
 							required: true
 						},
-						superseded: {
+						outcome: {
 							type: "string",
 							required: true
-						}
+						},
+						confidence: {
+							type: "number",
+							required: true
+						},
+						nextReviewAt: { type: "number" }
 					}
 				},
 				render: (_args, value) => [{
 					type: "text",
-					text: `已写入修正记忆 ${value.id}；旧条目 ${value.superseded} 已归档并建立取代链。`
+					text: (value.outcome === "success" ? `已记录：记忆 ${value.id} 使用有效（confidence=${value.confidence}）。该记忆后续召回排序将提升。` : `已记录：记忆 ${value.id} 标记为无效/遗忘（confidence=${value.confidence}）。排序将下降，持续无效会被衰减归档。`) + (value.nextReviewAt === void 0 ? "" : ` 下次复习：${new Date(value.nextReviewAt).toISOString().slice(0, 10)}。`)
 				}]
 			},
 			async execute(args) {
 				const input = args;
-				const content = redactSecrets(sanitizeProtocolText(input.content));
-				if (content.trim() === "") throw new Error("engram_update: 清洗后内容为空（原文只含协议标签或密钥）");
+				const hasGrade = Number.isInteger(input.grade) && input.grade >= 0 && input.grade <= 5;
+				if (input.grade !== void 0 && !hasGrade) throw new Error("engram_report: grade 必须是 0-5 的整数");
+				if (input.outcome !== "success" && input.outcome !== "failure" && !hasGrade) throw new Error("engram_report: 需要 outcome（success/failure）或 grade（0-5）参数");
+				const outcome = input.outcome === "success" || input.outcome === "failure" ? input.outcome : input.grade >= 3 ? "success" : "failure";
+				const grade = hasGrade ? input.grade : outcome === "success" ? 5 : 1;
 				const scope = scopeOf(input.scope, "project");
 				const store = await deps.openStore(scope);
-				const old = await store.get(input.id);
-				if (old === void 0) throw new Error(`engram_update: 条目 ${input.id} 不存在于 ${scope} 库（用 engram_search 确认 id 与 scope）`);
-				const embedder = await deps.embedder;
-				const embeddings = embedder === void 0 ? void 0 : await embedder.embed([content.trim()]);
+				const record = await store.reportOutcome(input.id, outcome);
+				if (record === void 0) throw new Error(`engram_report: 条目 ${input.id} 不存在（scope=${scope}）`);
+				const scheduled = await store.scheduleReview(input.id, grade);
 				return {
-					id: (await store.update({
-						id: input.id,
-						scope,
-						kind: input.kind ?? old.kind,
-						content,
-						...embeddings === void 0 ? {} : { embedding: embeddings[0] }
-					})).id,
-					superseded: input.id
+					id: record.id,
+					outcome,
+					confidence: record.confidence,
+					...scheduled?.review?.nextReviewAt === null || scheduled?.review?.nextReviewAt === void 0 ? {} : { nextReviewAt: scheduled.review.nextReviewAt }
 				};
 			}
 		}),
-		defineTool({
-			name: "engram_forget",
-			description: "遗忘一条记忆（软删，用户可从库中恢复）。id 与 scope 来自 engram_search 结果。",
-			parameters: {
-				id: {
-					type: "string",
-					required: true,
-					description: "条目 id"
-				},
-				scope: {
-					type: "string",
-					enum: ["user", "project"],
-					description: "条目作用域，默认 project"
-				}
-			},
-			output: {
-				schema: {
-					type: "object",
-					additionalProperties: false,
-					properties: { id: {
-						type: "string",
-						required: true
-					} }
-				},
-				render: (_args, value) => [{
-					type: "text",
-					text: `记忆 ${value.id} 已遗忘（软删，可恢复）。`
-				}]
-			},
-			async execute(args) {
-				const input = args;
-				const scope = scopeOf(input.scope, "project");
-				return { id: (await (await deps.openStore(scope)).forget(input.id)).id };
-			}
-		}),
+		reviewQueue,
 		defineTool({
 			name: "engram_review",
 			description: "审计一条记忆：查看内容、来源（会话/轮次/事件）、取代链、矛盾与关联，以及最近操作日志。",
@@ -2282,7 +4214,11 @@ function createEngramTools(deps) {
 				},
 				scope: {
 					type: "string",
-					enum: ["user", "project"],
+					enum: [
+						"user",
+						"project",
+						"shared"
+					],
 					description: "条目作用域，默认 project"
 				}
 			},
@@ -2315,18 +4251,20 @@ function createEngramTools(deps) {
 					section("取代了谁", view.supersedes.map(String)),
 					section("矛盾候选", view.contradicts.map(String)),
 					section("关联", view.related.map(String)),
+					view.revisions.length === 0 ? "" : `\n修订历史:\n${view.revisions.map((rev) => `- ${new Date(rev.supersededAt).toISOString()} [${rev.kind}] ${truncateItem(rev.content)}`).join("\n")}`,
 					view.operations.length === 0 ? "" : `\n最近操作:\n${view.operations.map((op) => `- ${new Date(op.at).toISOString()} ${op.op}${op.detail === null ? "" : ` ${op.detail}`}`).join("\n")}`
 				].filter((part) => part !== "").join("\n"), "tool_review", "（对话继续）") };
 			}
 		}),
 		defineTool({
 			name: "engram_stats",
-			description: "记忆库统计：各状态与种类数量、关系边数、信噪比、操作日志量。scope=all 时合并两库。",
+			description: "记忆库统计：各状态与种类数量、关系边数、信噪比、操作日志量，以及房间目录（房名/桩位数/最新门牌——检索前先看目录决定进哪个房间，配 engram_search 的 room 参数）。scope=all 时合并两库。",
 			parameters: { scope: {
 				type: "string",
 				enum: [
 					"user",
 					"project",
+					"shared",
 					"all"
 				],
 				description: "作用域，默认 all"
@@ -2347,37 +4285,61 @@ function createEngramTools(deps) {
 			},
 			async execute(args) {
 				const scopes = scopesOf(args.scope);
-				return { text: (await Promise.all(scopes.map(async (scope) => ({
-					scope,
-					stats: await (await deps.openStore(scope)).stats()
-				})))).map(({ scope, stats }) => [
-					`[${scope}] 总数 ${stats.total}（active ${stats.active} / archived ${stats.archived} / forgotten ${stats.forgotten}）`,
-					`种类分布: ${Object.entries(stats.byKind).map(([kind, count]) => `${kind}=${count}`).join(", ") || "空"}`,
-					`关系边 ${stats.edges} 条 · 信噪比 ${(stats.signalRatio * 100).toFixed(1)}% · 操作日志 ${stats.opLogCount} 条`
-				].join("\n")).join("\n\n") };
+				return { text: (await Promise.all(scopes.map(async (scope) => {
+					const store = await deps.openStore(scope);
+					const [storeStats, rooms, placards] = await Promise.all([
+						store.stats(),
+						store.slotCountsByRoom(),
+						store.listPlacards()
+					]);
+					return {
+						scope,
+						stats: storeStats,
+						rooms,
+						placards
+					};
+				}))).map(({ scope, stats, rooms, placards }) => {
+					const latestPlacardByRoom = /* @__PURE__ */ new Map();
+					for (const row of placards) if (row.room !== null) latestPlacardByRoom.set(row.room, row.caption);
+					const roomLines = Object.entries(rooms).sort(([a], [b]) => a.localeCompare(b, "zh-Hans-CN")).map(([room, state]) => {
+						const placard = latestPlacardByRoom.get(room);
+						return `  ${room}: ${state.count}/${state.maxIndex} 桩${placard === void 0 ? "" : ` · 最新门牌「${placard}」`}`;
+					});
+					return [
+						`[${scope}] 总数 ${stats.total}（active ${stats.active} / archived ${stats.archived} / forgotten ${stats.forgotten}）`,
+						`种类分布: ${Object.entries(stats.byKind).map(([kind, count]) => `${kind}=${count}`).join(", ") || "空"}`,
+						`关系边 ${stats.edges} 条 · 信噪比 ${(stats.signalRatio * 100).toFixed(1)}% · 操作日志 ${stats.opLogCount} 条`,
+						roomLines.length === 0 ? "房间目录: （尚未排桩）" : `房间目录（engram_search 用 room 参数直进）:\n${roomLines.join("\n")}`
+					].join("\n");
+				}).join("\n\n") };
 			}
 		}),
 		defineTool({
 			name: "engram_export",
-			description: "把记忆库导出为文件（Markdown 或 JSON，含全部状态与关系边），返回文件路径。redactedView=true 时输出脱敏视图（内容二次清洗并截断为 40 字预览，可安全分享）。",
+			description: "把记忆库导出为文件（Markdown / JSON / 镜像目录），返回文件路径。redactedView=true 时输出脱敏视图（内容二次清洗并截断为 40 字预览，可安全分享）。format=markdown-mirror 时每个房间一个 .md + frontmatter，附楼层清单 _meta.json 与全宫殿入口 _index.md，可直接用 Obsidian / git 漫游。",
 			parameters: {
 				format: {
 					type: "string",
-					enum: ["markdown", "json"],
-					description: "导出格式，默认 markdown"
+					enum: [
+						"markdown",
+						"json",
+						"markdown-mirror"
+					],
+					description: "导出格式：markdown 单文件、json 单文件、markdown-mirror 每房间一文件（默认 markdown）"
 				},
 				scope: {
 					type: "string",
 					enum: [
 						"user",
 						"project",
+						"shared",
 						"all"
 					],
 					description: "作用域，默认 all"
 				},
 				redactedView: {
 					type: "boolean",
-					description: "脱敏视图：内容二次脱敏并截断为预览（默认 false 完整导出）"
+					description: "脱敏视图：内容二次脱敏并截断为预览（默认 false 完整导出；镜像模式忽略此参数）"
 				}
 			},
 			output: {
@@ -2396,7 +4358,7 @@ function createEngramTools(deps) {
 			},
 			async execute(args) {
 				const input = args;
-				const format = input.format === "json" ? "json" : "markdown";
+				const format = input.format === "json" ? "json" : input.format === "markdown-mirror" ? "markdown-mirror" : "markdown";
 				const redactedView = input.redactedView === true;
 				const scopes = scopesOf(input.scope);
 				const preview = (content) => {
@@ -2410,6 +4372,13 @@ function createEngramTools(deps) {
 				const written = [];
 				for (const scope of scopes) {
 					const data = await (await deps.openStore(scope)).exportAll();
+					if (format === "markdown-mirror") {
+						const stamp = (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-").slice(0, 19);
+						const mirrorRoot = join(deps.exportDir, `mirror-${scope}-${stamp}`);
+						const report = await writeMirror(mirrorRoot, data);
+						written.push(`${mirrorRoot}（${report.fileCount} 个文件，${data.records.length} 间房间，${report.floors.length} 个楼层）`);
+						continue;
+					}
 					const payload = redactedView ? {
 						...data,
 						records: data.records.map((record) => ({
@@ -2440,7 +4409,11 @@ function createEngramTools(deps) {
 			description: "蒸馏整理：把同主题的记忆簇合并提炼为更高层的规律（旧条目归档、supersedes 链保留）。建议记忆较多时周期性执行。",
 			parameters: { scope: {
 				type: "string",
-				enum: ["user", "project"],
+				enum: [
+					"user",
+					"project",
+					"shared"
+				],
 				description: "作用域，默认 user"
 			} },
 			output: {
@@ -2461,7 +4434,7 @@ function createEngramTools(deps) {
 				const scope = scopeOf(args.scope, "user");
 				if (deps.call === void 0) throw new Error("engram_distill: 辅助 LLM 不可用（宿主未提供 llm 服务），无法蒸馏");
 				const call = deps.call;
-				const events = exec.agent?.session?.events ?? [];
+				const events = exec.agent?.session?.snapshotEvents() ?? [];
 				const route = deps.routeOverride ?? routeFromEvents(events);
 				if (route === void 0) throw new Error("engram_distill: 无法确定模型路由（会话尚无模型请求），请在 cordis.yml 配置 provider/model");
 				const embedder = await deps.embedder;
@@ -2483,19 +4456,334 @@ function createEngramTools(deps) {
 				});
 				return { text: `蒸馏完成：取材 ${outcome.input} 条，产出 ${outcome.distilled} 条高层规律，归档 ${outcome.superseded} 条旧记忆（supersedes 链已建立，可 engram_review 审计）。` };
 			}
-		})
+		}),
+		defineTool({
+			name: "engram_examine",
+			description: "渐进式披露：按 id 批量拉取房间完整铭牌（content + 楼层 + 状态 + 边关系）。仅在已通过 engram_search/timeline/neighbors 拿到候选 id 后调用，避免一次性吞全文。建议 ≤16 个 id，超出会按入参顺序保留前 N 条。",
+			parameters: { ids: {
+				type: "array",
+				items: { type: "string" },
+				description: "房间 id 列表"
+			} },
+			output: {
+				schema: {
+					type: "object",
+					additionalProperties: false,
+					properties: { text: {
+						type: "string",
+						required: true
+					} }
+				},
+				render: (_args, value) => [{
+					type: "text",
+					text: value.text
+				}]
+			},
+			async execute(args) {
+				const input = args;
+				const rawIds = Array.isArray(input.ids) ? input.ids.filter((x) => typeof x === "string") : [];
+				if (rawIds.length === 0) throw new Error("engram_examine: ids 必填且至少含 1 条");
+				const ids = rawIds.slice(0, 16).map((id) => asMemoryId(id));
+				const store = await deps.openStore("user");
+				const projectStore = await deps.openStore("project");
+				const [fromUser, fromProject] = await Promise.all([store.getMany(ids), projectStore.getMany(ids)]);
+				const records = [...fromUser, ...fromProject];
+				if (records.length === 0) throw new Error(`engram_examine: 全部 ${ids.length} 个 id 都找不到`);
+				return { text: records.map((record, index) => [
+					`### ${index + 1}. [${record.scope}/${record.kind}/${record.status}] id=${record.id}`,
+					`铭牌: ${record.content}`,
+					`地标亮度=${record.importance.toFixed(2)} · 考据可靠度=${record.confidence.toFixed(2)} · 参观=${record.accessCount}人次`
+				].join("\n")).join("\n\n") };
+			}
+		}),
+		defineTool({
+			name: "engram_neighbors",
+			description: "走廊漫步：从某间出发走 1-3 跳内的 related/supersedes/contradicts 边，返回邻居房间简表（仅 id + scope + kind + status + content），便于判断下一站。",
+			parameters: {
+				id: {
+					type: "string",
+					description: "起点房间 id"
+				},
+				depth: {
+					type: "integer",
+					description: "跳数（默认 1，最多 3，由执行器夹逼）"
+				}
+			},
+			output: {
+				schema: {
+					type: "object",
+					additionalProperties: false,
+					properties: { text: {
+						type: "string",
+						required: true
+					} }
+				},
+				render: (_args, value) => [{
+					type: "text",
+					text: value.text
+				}]
+			},
+			async execute(args) {
+				const input = args;
+				if (typeof input.id !== "string" || input.id === "") throw new Error("engram_neighbors: id 必填");
+				const depth = Number.isInteger(input.depth) ? Math.min(Math.max(1, input.depth), 3) : 1;
+				const seed = asMemoryId(input.id);
+				const userStore = await deps.openStore("user");
+				const projectStore = await deps.openStore("project");
+				const seedRow = await userStore.get(seed) ?? await projectStore.get(seed);
+				if (seedRow === void 0) throw new Error(`engram_neighbors: 起点 ${seed} 不存在`);
+				const seedScope = seedRow.scope;
+				const neighbors = await (seedScope === "user" ? userStore : projectStore).neighbors(seed, depth);
+				if (neighbors.length === 0) return { text: `从 ${seed}（${seedScope}）出发，${depth} 跳内无邻居房间。` };
+				const lines = neighbors.map((record, index) => `${index + 1}. [${record.scope}/${record.kind}/${record.status}] ${record.content.slice(0, 80)}${record.content.length > 80 ? "…" : ""}（id=${record.id}）`);
+				return { text: `起点 ${seed}（${seedScope}）→ ${depth} 跳走廊共访 ${neighbors.length} 间：\n${lines.join("\n")}` };
+			}
+		}),
+		defineTool({
+			name: "engram_tour",
+			description: "巡游路由。mode=fixed：按固定巡游路线走全宫（桩位顺序恒定，骨架长期复用——宫殿的路线永远不变，靠顺序提取）；mode=thematic（默认）：按主题动态规划 3-7 站（同类巩固 → 走廊相邻 → 反差补位），适合用户问起某主题时给出一条可走的导览路线。",
+			parameters: {
+				query: {
+					type: "string",
+					description: "巡游主题（thematic 模式必填，与 engram_search 同义）"
+				},
+				mode: {
+					type: "string",
+					enum: ["fixed", "thematic"],
+					description: "fixed 固定路线全宫巡游 / thematic 主题动态路线（默认 thematic）"
+				},
+				scope: {
+					type: "string",
+					enum: [
+						"user",
+						"project",
+						"shared",
+						"all"
+					],
+					description: "作用域，默认 all"
+				},
+				maxStops: {
+					type: "integer",
+					description: "最多站数（默认 6，3-7 之间；fixed 模式默认 20）"
+				}
+			},
+			output: {
+				schema: {
+					type: "object",
+					additionalProperties: false,
+					properties: { text: {
+						type: "string",
+						required: true
+					} }
+				},
+				render: (_args, value) => [{
+					type: "text",
+					text: value.text
+				}]
+			},
+			async execute(args, exec) {
+				const input = args;
+				const scopes = scopesOf(input.scope);
+				if ((input.mode === "fixed" ? "fixed" : "thematic") === "fixed") {
+					const maxStops = Number.isInteger(input.maxStops) ? Math.max(1, input.maxStops) : 20;
+					const sections = [];
+					let shown = 0;
+					let skipped = 0;
+					for (const scope of scopes) {
+						const store = await deps.openStore(scope);
+						const route = await store.routeList();
+						if (route.length === 0) continue;
+						const records = await store.getMany(route.map((stop) => stop.id));
+						const byId = new Map(records.map((record) => [String(record.id), record]));
+						const lines = [];
+						for (const stop of route) {
+							if (shown >= maxStops) break;
+							const record = byId.get(String(stop.id));
+							if (record === void 0 || record.status !== "active") {
+								skipped += 1;
+								continue;
+							}
+							shown += 1;
+							const slot = record.slot === void 0 ? "" : `${record.slot.room} #${record.slot.index} · `;
+							const placard = record.imagery?.caption;
+							lines.push(`第 ${stop.position + 1} 站 · ${slot}[${record.kind}] ${truncateItem(record.content)}（id=${record.id}）${placard === null || placard === void 0 ? "" : ` · 门牌「${placard}」`}`);
+						}
+						if (lines.length > 0) sections.push(`【${scope} 宫殿 · 固定巡游】\n${lines.join("\n")}`);
+					}
+					if (shown === 0) return { text: "巡游路线为空：尚无排桩记忆（保存记忆后自动登记路线）。" };
+					const tail = skipped > 0 ? `\n（另有 ${skipped} 个空桩：原记忆已闭馆或归档，桩位保留不回收）` : "";
+					return { text: `${sections.join("\n\n")}${tail}` };
+				}
+				if (typeof input.query !== "string" || input.query.trim() === "") throw new Error("engram_tour: thematic 模式需要 query 参数（巡游主题）");
+				const tourQuery = input.query;
+				const limit = 12;
+				const maxStops = Number.isInteger(input.maxStops) ? Math.min(Math.max(3, input.maxStops), 7) : 6;
+				const rewrite = await rewriteQueries(deps, exec, tourQuery);
+				const retrievals = await Promise.all(rewrite.queries.map(async (queryText) => {
+					const vector = await queryVectorOf(deps, queryText);
+					const results = await Promise.all(scopes.map(async (scope) => {
+						return (await deps.openStore(scope)).search({
+							text: queryText,
+							scopes: [scope],
+							limit
+						}, vector);
+					}));
+					return {
+						hits: results.flatMap((result) => result.hits).sort((a, b) => b.score - a.score).slice(0, limit),
+						degraded: results.some((result) => result.degraded)
+					};
+				}));
+				const degraded = retrievals.some((retrieval) => retrieval.degraded);
+				const merged = mergeQueryResults(retrievals, limit, 60, Math.floor(Math.max(0, limit) / Math.max(1, rewrite.queries.length)));
+				const userStore = await deps.openStore("user");
+				const projectStore = await deps.openStore("project");
+				const poolLookup = async (id) => await userStore.get(id) ?? await projectStore.get(id);
+				const route = await planTour(merged, poolLookup, tourQuery, maxStops);
+				return { text: `${degraded ? "（语义嵌入不可用，仅关键词检索）\n" : ""}${route.narrative}` };
+			}
+		}),
+		auditForgotten
+	];
+}
+/**
+* 构造巡游路径：在 search 命中的基础上按路径策略重排。
+* 1) 起点簇：取命中中 kind 出现频次最高的前 N 个同 kind 节点（同类巩固）。
+* 2) 走廊扩展：从起点簇每个节点的 1-跳 neighbors 中挑 active 且 score > 0 的房间。
+* 3) 反差收束：从剩余命中挑一个 emotionalValence ≥ 0.7 的做收束（强反差唤醒）。
+* 命中不足时按可用性回退；命中为 0 时返回空 stops。
+*/
+async function planTour(hits, poolLookup, query, maxStops = 6) {
+	if (hits.length === 0) return {
+		stops: [],
+		narrative: "无命中，无巡游路径可规划。",
+		query
+	};
+	const used = /* @__PURE__ */ new Set();
+	const stops = [];
+	const kindCounts = /* @__PURE__ */ new Map();
+	for (const hit of hits) kindCounts.set(hit.record.kind, (kindCounts.get(hit.record.kind) ?? 0) + 1);
+	const topKinds = [...kindCounts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 2).map(([kind]) => kind);
+	for (const kind of topKinds) for (const hit of hits) {
+		if (stops.length >= maxStops) break;
+		if (hit.record.kind !== kind || used.has(hit.record.id)) continue;
+		stops.push({
+			record: hit.record,
+			reason: "same-kind"
+		});
+		used.add(hit.record.id);
+	}
+	for (const stop of [...stops]) {
+		if (stops.length >= maxStops - 1) break;
+		await poolLookup(stop.record.id);
+		for (const hit of hits) {
+			if (stops.length >= maxStops - 1) break;
+			if (used.has(hit.record.id) || hit.record.id === stop.record.id) continue;
+			if (hit.record.scope !== stop.record.scope) continue;
+			stops.push({
+				record: hit.record,
+				reason: "neighbor"
+			});
+			used.add(hit.record.id);
+		}
+	}
+	const emotionCut = hits.find((hit) => !used.has(hit.record.id) && (hit.record.imagery?.emotionalValence ?? 0) >= .7);
+	if (emotionCut !== void 0 && stops.length < maxStops) {
+		stops.push({
+			record: emotionCut.record,
+			reason: "emotional-peak"
+		});
+		used.add(emotionCut.record.id);
+	}
+	for (const hit of hits) {
+		if (stops.length >= maxStops) break;
+		if (used.has(hit.record.id)) continue;
+		stops.push({
+			record: hit.record,
+			reason: "contrast"
+		});
+		used.add(hit.record.id);
+	}
+	return {
+		stops,
+		narrative: renderTourNarrative(stops, query),
+		query
+	};
+}
+/** 把巡游路径渲染为一段含回声触发器的可读文本（供 engram_tour 的 text 字段）。 */
+function renderTourNarrative(stops, query) {
+	if (stops.length === 0) return "无巡游路径。";
+	const reasonLabel = (reason) => {
+		switch (reason) {
+			case "same-kind": return "同类巩固";
+			case "neighbor": return "走廊相邻";
+			case "contrast": return "反差补位";
+			case "emotional-peak": return "情绪强反差";
+		}
+	};
+	const lines = [`巡游路径（查询：${query}）：按「同类巩固 → 走廊相邻 → 反差补位」顺序组织，共 ${stops.length} 站。`];
+	stops.forEach((stop, index) => {
+		const caption = stop.record.imagery?.caption;
+		const sensory = stop.record.imagery?.sensoryTags ?? [];
+		const echo = caption === null || caption === void 0 ? "（未铭刻意象，请先调用 engram_examine 读铭牌）" : `回声：似曾「${caption}」${sensory.length > 0 ? `（${sensory.slice(0, 3).join("、")}）` : ""}`;
+		lines.push(`${index + 1}. [${stop.record.scope}/${stop.record.kind}] ${stop.record.content.slice(0, 60)}${stop.record.content.length > 60 ? "…" : ""}（id=${stop.record.id}，理由：${reasonLabel(stop.reason)}）— ${echo}`);
+	});
+	return lines.join("\n");
+}
+//#endregion
+//#region src/selection-rationale.ts
+/** 给定一组入选房间，返回归因 XML 字符串；空 rooms 返回空串。 */
+function buildSelectionRationale(records) {
+	if (records.length === 0) return "";
+	const now = Date.now();
+	const lines = [
+		"<engram_selection_rationale>",
+		`本轮画像共 ${String(records.length)} 间房间，挑选理由如下：`,
+		""
 	];
+	for (const record of records) {
+		const reasons = classifyRecord(record, now);
+		lines.push(`- #${record.id.slice(0, 8)} [${record.kind}/${record.scope}] ${reasonsLabel(reasons)}：${record.content.slice(0, 40)}${record.content.length > 40 ? "…" : ""}`);
+	}
+	lines.push("", "如果某条理由错误，请通过 engram_report 反馈，越准的画像越能帮你。", "</engram_selection_rationale>");
+	return lines.join("\n");
+}
+/** 把画像正文 + 归因拼成最终注入文本。 */
+function wrapWithRationale(profileText, records) {
+	const rationale = buildSelectionRationale(records);
+	return rationale === "" ? profileText : `${rationale}\n\n${profileText}`;
+}
+/** 启发式：4 类原因按阈值判定，可叠加。 */
+function classifyRecord(record, now) {
+	const reasons = [];
+	if (now - record.lastAccessedAt < 6048e5) reasons.push("recent");
+	if (record.importance * record.confidence >= .7) reasons.push("bright");
+	if (record.accessCount >= 5) reasons.push("corridor-hit");
+	if (record.outcome === "success") reasons.push("strong-evidence");
+	return reasons;
+}
+/** 中文/英文 reason 标签。 */
+function reasonsLabel(reasons) {
+	if (reasons.length === 0) return "基础入选";
+	const LABELS = {
+		recent: "近期被参观",
+		bright: "地标明亮",
+		"corridor-hit": "走廊常客",
+		"strong-evidence": "管家验证有效"
+	};
+	return reasons.map((r) => LABELS[r]).join(" / ");
 }
 //#endregion
 //#region src/index.ts
 /**
 * dsh-engram：DeepSeek Harness 跨会话长期记忆插件（host 半）。
-* 注册 9 个 engram_ 工具、会话开始注入用户画像、自动摄取上一轮对话、
+* 注册 10 个 engram_ 工具、会话开始注入用户画像、自动摄取上一轮对话、
 * 蒸馏/衰减飞轮与审计能力。
 * @module @kenz1117/dsh-engram
 */
 /** Cordis 插件名（loader 诊断与注入 source 使用）。 */
 const name = "dsh-engram";
+/** 插件版本（与 package.json 同步，写进备份 _meta.json）。 */
+const VERSION = "0.7.2";
 /** 必需服务：工具注册表与 LLM 流式端点（摄取/蒸馏的辅助调用）。 */
 const inject = ["tools", "llm"];
 /**
@@ -2504,17 +4792,18 @@ const inject = ["tools", "llm"];
 * 索引行也装不下的折成末尾 `+N more; use engram_search` 计数行。
 * @param records - 候选条目（调用方已按重要性排序、按条数截断）。
 * @param tokenBudget - 整段画像的 token 预算（含首尾固定行）。
-* @returns 注入文本。
+* @returns 渲染文本与溢出条目（调用方可用辅助 LLM 压缩后重渲染）。
 */
-function renderProfile(records, tokenBudget) {
+function renderProfileDetailed(records, tokenBudget) {
 	const estimate = (text) => Math.ceil(text.length / 4);
-	const header = "User memory profile (dsh-engram, cross-session):";
-	const footer = "Use engram_search to recall details; use engram_save to persist new facts.";
+	const header = "User memory profile (dsh-engram, cross-session) — Grand Hall (always present):";
+	const footer = "Use engram_search to recall details (pass room to search inside one room); use engram_save to persist new facts.";
 	let remaining = Math.max(0, tokenBudget - estimate(header) - estimate(footer));
 	const lines = [];
 	const overflow = [];
 	for (const record of records) {
-		const line = `- [${record.kind}] ${record.content}`;
+		const slot = record.slot === void 0 ? "" : ` ${record.slot.room}#${record.slot.index}`;
+		const line = `- [${record.kind}]${slot} ${record.content}`;
 		const cost = estimate(line);
 		if (cost <= remaining) {
 			lines.push(line);
@@ -2531,16 +4820,76 @@ function renderProfile(records, tokenBudget) {
 		} else more += 1;
 	}
 	if (more > 0) lines.push(`+${more} more; use engram_search`);
-	return [
-		header,
-		...lines,
-		footer
-	].join("\n");
+	return {
+		text: [
+			header,
+			...lines,
+			footer
+		].join("\n"),
+		overflow
+	};
+}
+/**
+* 会话开始注入的画像渲染（只取文本；溢出明细见 renderProfileDetailed）。
+* @param records - 候选条目（调用方已按重要性排序、按条数截断）。
+* @param tokenBudget - 整段画像的 token 预算（含首尾固定行）。
+* @returns 注入文本。
+*/
+function renderProfile(records, tokenBudget) {
+	return renderProfileDetailed(records, tokenBudget).text;
+}
+/** 压缩辅助调用的输出 token 上限（40 字 × 若干条，短输出足够）。 */
+const COMPRESS_MAX_TOKENS = 800;
+/** 压缩辅助调用超时：压缩在 pre-step 关键路径上，必须限时防阻塞首轮请求。 */
+const COMPRESS_TIMEOUT_MS = 8e3;
+const COMPRESS_SYSTEM = [
+	"把记忆条目压缩为更短的一句话表述（每条不超过 40 个字符），保留可跨会话复用的关键信息（事实、偏好、决策、方法）。",
+	"只输出一个 JSON 数组，每项形如 {\"id\": \"原样返回的id\", \"content\": \"压缩后表述\"}，条目数量与 id 必须与输入一一对应。",
+	"不要输出 JSON 以外的任何内容。"
+].join("\n");
+/**
+* 画像超预算的辅助压缩：把装不下的条目交给辅助 LLM 压短，返回 id → 压缩文本。
+* 任何失败（无路由、输出不可解析、超时、调用异常）返回 undefined，调用方
+* 降级回索引行装填。压缩请求审计到 user 库 op_log（model-visible ⟺ logged：
+* 压缩产物本身会随注入消息进会话日志）。
+*/
+async function compressProfileOverflow(ctx, agent, routeOverride, overflow, signal) {
+	try {
+		const events = agent.session.snapshotEvents();
+		const route = routeOverride ?? routeFromEvents(events);
+		if (route === void 0) return void 0;
+		const userText = JSON.stringify(overflow.map((record) => ({
+			id: record.id,
+			content: record.content
+		})));
+		const parsed = parseJsonArray(await streamText(ctx, {
+			route,
+			system: COMPRESS_SYSTEM,
+			userText,
+			maxTokens: COMPRESS_MAX_TOKENS,
+			purpose: "engram-compress",
+			sessionId: agent.session.id,
+			signal: AbortSignal.any([signal, AbortSignal.timeout(COMPRESS_TIMEOUT_MS)])
+		}));
+		if (parsed === void 0) return void 0;
+		const ids = new Set(overflow.map((record) => record.id));
+		const compressed = /* @__PURE__ */ new Map();
+		for (const item of parsed) {
+			const entry = item;
+			if (typeof entry.id !== "string" || typeof entry.content !== "string") continue;
+			if (!ids.has(entry.id) || entry.content.trim() === "" || entry.content.length >= overflow.find((record) => record.id === entry.id).content.length) continue;
+			compressed.set(entry.id, entry.content.trim());
+		}
+		return compressed.size > 0 ? compressed : void 0;
+	} catch {
+		return;
+	}
 }
 /**
-* agent/pre-step waterfall：每轮第一步注入画像；同时 fire-and-forget 触发
-* 上一轮的自动摄取（不阻塞请求）；进程内首次第一步重放待补做的末轮摄取。
-* 必须调用 next() 委托链路；reject 决策原样透传，记忆库为空或非首轮时不追加消息。
+* agent/pre-step waterfall：每轮第一步注入画像（内容与上次相同则跳过重复注入）；
+* 同时 fire-and-forget 触发上一轮的自动摄取（不阻塞请求）；进程内首次第一步
+* 重放待补做的末轮摄取。必须调用 next() 委托链路；reject 决策原样透传，
+* 记忆库为空或非首轮时不追加消息。
 */
 async function preStep(ctx, openStore, resolved, embedder, state, logRequest, { agent, step, turn, signal }, next) {
 	const decision = await next();
@@ -2566,7 +4915,7 @@ async function preStep(ctx, openStore, resolved, embedder, state, logRequest, {
 			});
 		}
 		if (turn > 1) ingestPreviousTurn({
-			events: agent.session.events,
+			events: agent.session.snapshotEvents(),
 			sessionId: String(agent.id),
 			turn,
 			openStore: () => openStore("user"),
@@ -2586,7 +4935,29 @@ async function preStep(ctx, openStore, resolved, embedder, state, logRequest, {
 	if (step !== 1) return decision;
 	const top = await (await openStore("user")).topActive("user", resolved.profileTopN);
 	if (top.length === 0) return decision;
-	const packet = renderMemoryPacket(renderProfile(top, resolved.injectTokenBudget), "turn_start", currentUserRequestText(decision.messages));
+	const dueTotal = resolved.reviewScheduling ? (await Promise.all(["user", "project"].map(async (scope) => (await openStore(scope)).dueReviews(Date.now(), 50)))).reduce((sum, rows) => sum + rows.length, 0) : 0;
+	const detailed = renderProfileDetailed(top, resolved.injectTokenBudget);
+	let text = detailed.text;
+	if (detailed.overflow.length > 0) {
+		const compressed = await compressProfileOverflow(ctx, agent, resolved.routeOverride, detailed.overflow, signal);
+		if (compressed !== void 0) {
+			openStore("user").then((auditStore) => auditStore.audit("compress-request", "AUX", JSON.stringify({ count: detailed.overflow.length }))).catch(() => {});
+			text = renderProfileDetailed(top.map((record) => {
+				const shorter = compressed.get(record.id);
+				return shorter === void 0 ? record : {
+					...record,
+					content: shorter
+				};
+			}), resolved.injectTokenBudget).text;
+		}
+	}
+	const dueLine = dueTotal === 0 ? "" : `\nPalace review due today: ${dueTotal}${dueTotal >= 50 ? "+" : ""} memories. Use engram_review_queue for active recall (recall beats re-reading).`;
+	const textWithRationale = wrapWithRationale(text, top) + dueLine;
+	const hash = createHash("sha256").update(textWithRationale).digest("hex");
+	if (state.lastProfileAgent === String(agent.id) && hash === state.lastProfileHash) return decision;
+	state.lastProfileAgent = String(agent.id);
+	state.lastProfileHash = hash;
+	const packet = renderMemoryPacket(text, "turn_start", currentUserRequestText(decision.messages));
 	return {
 		...decision,
 		messages: [...decision.messages, createUserMessage({
@@ -2613,7 +4984,7 @@ async function preStep(ctx, openStore, resolved, embedder, state, logRequest, {
 */
 function makeEventResolver(ctx, agent) {
 	return async (sessionId) => {
-		if (sessionId === String(agent.id)) return agent.session.events;
+		if (sessionId === String(agent.id)) return agent.session.snapshotEvents();
 		const persistence = ctx.get("sessionPersistence");
 		if (persistence === void 0) return void 0;
 		try {
@@ -2624,7 +4995,7 @@ function makeEventResolver(ctx, agent) {
 	};
 }
 /**
-* 插件体：预热分库与嵌入器，注册 9 个工具、画像注入、自动摄取与衰减调度。
+* 插件体：预热分库与嵌入器，注册 10 个工具、画像注入、自动摄取与衰减调度。
 * @param ctx - host 上下文。
 * @param config - cordis.yml 传入的可选配置；非法值在加载时 loud 失败。
 */
@@ -2647,7 +5018,17 @@ function apply(ctx, config = {}) {
 	const openStore = (scope) => {
 		const existing = stores.get(scope);
 		if (existing !== void 0) return existing;
-		const created = openEngramStore(scope === "user" ? join(resolved.dbDir, "user.db") : join(resolved.dbDir, identity.dbName), rankBoost);
+		const path = scope === "user" ? join(resolved.dbDir, "user.db") : scope === "shared" ? join(resolved.dbDir, "shared.db") : join(resolved.dbDir, identity.dbName);
+		const created = openEngramStore(path, rankBoost, {
+			autoSlot: resolved.autoSlot,
+			reviewScheduling: resolved.reviewScheduling
+		}).then(async (store) => {
+			const assigned = await store.backfillSlots((room) => {
+				console.warn(`[dsh-engram] 房间已满，自动开新房「${room}」（可在管理面板翻新清单中人工拆分/命名）`);
+			});
+			if (assigned > 0) console.warn(`[dsh-engram] 存量记忆排桩完成：${assigned} 条已钉入宫殿（${path}）`);
+			return store;
+		});
 		stores.set(scope, created);
 		return created;
 	};
@@ -2668,21 +5049,29 @@ function apply(ctx, config = {}) {
 	ctx.inject(["webServer"], (webCtx) => {
 		registerEngramRoutes(webCtx, {
 			openStore,
-			exportDir: `${resolved.dbDir}/exports`
+			exportDir: `${resolved.dbDir}/exports`,
+			mirrorDir: `${resolved.dbDir}/palaces`,
+			dbDir: resolved.dbDir,
+			pluginVersion: VERSION,
+			embedder
 		});
 	});
 	const logIngestRequest = (data) => {
 		openStore("user").then((store) => store.audit("ingest-request", "AUX", JSON.stringify(data))).catch(() => {});
 	};
 	if (resolved.injectProfile || resolved.ingest !== "off") {
-		const state = { pendingReplayed: false };
+		const state = {
+			pendingReplayed: false,
+			lastProfileAgent: null,
+			lastProfileHash: null
+		};
 		ctx.on("agent/pre-step", (payload, next) => preStep(ctx, openStore, resolved, embedder, state, logIngestRequest, payload, next), { prepend: true });
 	}
 	if (resolved.ingest !== "off") ctx.on("session/disposed", (session) => {
 		const mode = resolved.ingest;
 		if (mode === "off") return;
 		ingestFinalTurn({
-			events: session.events,
+			events: session.snapshotEvents(),
 			sessionId: String(session.id),
 			turn: 0,
 			slice: "last",
@@ -2696,6 +5085,8 @@ function apply(ctx, config = {}) {
 			}),
 			logRequest: logIngestRequest,
 			signal: AbortSignal.timeout(FINAL_INGEST_TIMEOUT_MS)
+		}).catch((error) => {
+			console.warn("[dsh-engram] 会话结束的末轮摄取异常（不影响对话）：", error);
 		});
 	});
 	const runDecay = async () => {
@@ -2720,6 +5111,26 @@ function apply(ctx, config = {}) {
 			clearInterval(timer);
 		};
 	}, "dsh-engram: decay timer");
+	const runConsolidateOnce = async () => {
+		try {
+			const report = await runConsolidation(await openStore("user"), embedder, {
+				olderThanDays: resolved.decayAfterDays,
+				importanceBelow: resolved.decayImportanceBelow
+			});
+			console.log(`[dsh-engram] 闭馆整理完成：归档 ${String(report.archived)}，合并 ${String(report.merged)}，跳过 ${String(report.skipped)}（${String(report.tookMs)} ms）`);
+		} catch (error) {
+			console.warn("[dsh-engram] 闭馆整理失败（不影响对话）：", error);
+		}
+	};
+	runConsolidateOnce();
+	ctx.effect(() => {
+		const timer = setInterval(() => {
+			runConsolidateOnce();
+		}, 864e5);
+		return () => {
+			clearInterval(timer);
+		};
+	}, "dsh-engram: consolidation timer");
 }
 //#endregion
-export { Config, apply, inject, name, renderProfile };
+export { Config, VERSION, apply, inject, name, renderProfile, renderProfileDetailed };