@kenz1117/dsh-engram 0.7.8 → 0.7.11

package/lib/index.js

@@ -28,11 +28,15 @@ const CONFIG_KEYS = /* @__PURE__ */ new Set([
 	"decayAfterDays",
 	"decayImportanceBelow",
 	"injectTokenBudget",
+	"injectItemBudgetStart",
+	"injectItemBudgetDecay",
+	"injectItemBudgetFloor",
 	"rankRecencyWeight",
 	"rankProofWeight",
 	"queryRewrite",
 	"autoSlot",
 	"reviewScheduling",
+	"assessReminder",
 	"historyBackfillDays",
 	"historyBackfillMaxTurnsPerSession",
 	"historyBackfillMaxTotalTurns",
@@ -59,11 +63,15 @@ const Config = z.object({
 	decayAfterDays: z.number().step(1).min(1).max(3650),
 	decayImportanceBelow: z.number().min(0).max(1),
 	injectTokenBudget: z.number().step(1).min(128).max(8192),
+	injectItemBudgetStart: z.number().step(1).min(40).max(2e3),
+	injectItemBudgetDecay: z.number().min(.5).max(1),
+	injectItemBudgetFloor: z.number().step(1).min(8).max(200),
 	rankRecencyWeight: z.number().min(0).max(2),
 	rankProofWeight: z.number().min(0).max(2),
 	queryRewrite: z.boolean(),
 	autoSlot: z.boolean(),
 	reviewScheduling: z.boolean(),
+	assessReminder: z.boolean(),
 	historyBackfillDays: z.number().step(1).min(0).max(3650),
 	historyBackfillMaxTurnsPerSession: z.number().step(1).min(1).max(500),
 	historyBackfillMaxTotalTurns: z.number().step(1).min(1).max(5e3),
@@ -88,6 +96,11 @@ function resolveConfig(config = {}) {
 	if (config.decayAfterDays !== void 0 && (!Number.isInteger(config.decayAfterDays) || config.decayAfterDays < 1 || config.decayAfterDays > 3650)) throw new Error("dsh-engram: decayAfterDays must be an integer in [1, 3650]");
 	if (config.decayImportanceBelow !== void 0 && (config.decayImportanceBelow < 0 || config.decayImportanceBelow > 1)) throw new Error("dsh-engram: decayImportanceBelow must be in [0, 1]");
 	if (config.injectTokenBudget !== void 0 && (!Number.isInteger(config.injectTokenBudget) || config.injectTokenBudget < 128 || config.injectTokenBudget > 8192)) throw new Error("dsh-engram: injectTokenBudget must be an integer in [128, 8192]");
+	if (config.injectItemBudgetStart !== void 0 && (!Number.isInteger(config.injectItemBudgetStart) || config.injectItemBudgetStart < 40 || config.injectItemBudgetStart > 2e3)) throw new Error("dsh-engram: injectItemBudgetStart must be an integer in [40, 2000]");
+	if (config.injectItemBudgetDecay !== void 0 && (config.injectItemBudgetDecay < .5 || config.injectItemBudgetDecay > 1)) throw new Error("dsh-engram: injectItemBudgetDecay must be in [0.5, 1]");
+	if (config.injectItemBudgetFloor !== void 0 && (!Number.isInteger(config.injectItemBudgetFloor) || config.injectItemBudgetFloor < 8 || config.injectItemBudgetFloor > 200)) throw new Error("dsh-engram: injectItemBudgetFloor must be an integer in [8, 200]");
+	if (config.injectItemBudgetStart !== void 0 && config.injectItemBudgetFloor !== void 0 && config.injectItemBudgetFloor > config.injectItemBudgetStart) throw new Error("dsh-engram: injectItemBudgetFloor must not exceed injectItemBudgetStart");
+	if (config.assessReminder !== void 0 && typeof config.assessReminder !== "boolean") throw new Error("dsh-engram: assessReminder must be a boolean");
 	if (config.rankRecencyWeight !== void 0 && (config.rankRecencyWeight < 0 || config.rankRecencyWeight > 2)) throw new Error("dsh-engram: rankRecencyWeight must be in [0, 2]");
 	if (config.rankProofWeight !== void 0 && (config.rankProofWeight < 0 || config.rankProofWeight > 2)) throw new Error("dsh-engram: rankProofWeight must be in [0, 2]");
 	if (config.historyBackfillDays !== void 0 && (!Number.isInteger(config.historyBackfillDays) || config.historyBackfillDays < 0 || config.historyBackfillDays > 3650)) throw new Error("dsh-engram: historyBackfillDays must be an integer in [0, 3650] (0 = unlimited)");
@@ -109,6 +122,10 @@ function resolveConfig(config = {}) {
 		decayAfterDays: config.decayAfterDays ?? 30,
 		decayImportanceBelow: config.decayImportanceBelow ?? .3,
 		injectTokenBudget: config.injectTokenBudget ?? 1024,
+		injectItemBudgetStart: config.injectItemBudgetStart ?? 160,
+		injectItemBudgetDecay: config.injectItemBudgetDecay ?? .9,
+		injectItemBudgetFloor: config.injectItemBudgetFloor ?? 24,
+		assessReminder: config.assessReminder ?? true,
 		rankRecencyWeight: config.rankRecencyWeight ?? .2,
 		rankProofWeight: config.rankProofWeight ?? .1,
 		queryRewrite: config.queryRewrite ?? true,
@@ -130,6 +147,8 @@ function resolveConfig(config = {}) {
 function asMemoryId(raw) {
 	return raw;
 }
+/** episode 情景时间线的时间邻近扩展缺省窗口：锚点 createdAt ± 60 分钟。 */
+const EPISODE_PROXIMITY_MS_DEFAULT = 36e5;
 /** dsh-engram 统一错误：加载/使用期的可诊断失败都抛此类型。 */
 var EngramError = class extends Error {
 	/** 机器可读原因码，如 EMBEDDER_DOWNLOAD_FAILED / SCHEMA_INCOMPATIBLE。 */
@@ -415,7 +434,7 @@ function redacted(kind) {
 * @returns 脱敏后的文本；无命中时原样返回。
 */
 function redactSecrets(text) {
-	return text.replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g, redacted("private-key")).replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/gi, `Bearer ${redacted("bearer-token")}`).replace(/\bsk-(?:proj-|cp-|ant-|svcacct-)?[A-Za-z0-9_-]{16,}/g, redacted("api-key")).replace(/\bgh[pousr]_[A-Za-z0-9]{20,}/g, redacted("github-token")).replace(/\bAKIA[0-9A-Z]{16}\b/g, redacted("aws-access-key")).replace(/\b(password|passwd|pwd|token|secret|api[_-]?key|access[_-]?key|auth[_-]?token)\b\s*[=:]\s*("[^"\n]*"|'[^'\n]*'|[^'",;\s)\]}]+)/gi, (_match, key) => `${key}=${redacted("secret-value")}`);
+	return text.replace(/-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g, redacted("private-key")).replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/gi, `Bearer ${redacted("bearer-token")}`).replace(/\bsk-(?:proj-|cp-|ant-|svcacct-)?[A-Za-z0-9_-]{16,}/g, redacted("api-key")).replace(/\bgh[pousr]_[A-Za-z0-9]{20,}/g, redacted("github-token")).replace(/\bAKIA[0-9A-Z]{16}\b/g, redacted("aws-access-key")).replace(/\b(password|passwd|pwd|token|secret|api[_-]?key|access[_-]?key|auth[_-]?token)\b\s*[=:]\s*("[^"\n]*"|'[^'\n]*'|[^'",;\s)\]}]+)/gi, (_match, key) => `${key}=${redacted("secret-value")}`).replace(/(密码|口令)[是为:：\s]{0,3}([A-Za-z0-9!@#$%^&*()_+=\[\]{}<>/?\\|`~.-]{4,})/g, (_match, key) => `${key}=${redacted("password")}`).replace(/(?<!\d)1[3-9]\d{9}(?!\d)/g, redacted("phone")).replace(/\b[1-9]\d{5}(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dXx]\b/g, redacted("id-number"));
 }
 //#endregion
 //#region src/security/recall.ts
@@ -484,6 +503,42 @@ function omitRecallToolResults(events) {
 		};
 	});
 }
+/**
+* 判定一条新内容的处置。
+* 嵌入不可用 / 库内无向量条目 / 最近邻低于 DEFER_COSINE → accept；
+* 最近邻同 kind 且 ≥ MERGE_COSINE → merge；其余达到 DEFER_COSINE 的 → defer。
+* @param store - 目标分库
+* @param kind - 新内容的记忆种类（MERGE 要求同 kind，跨 kind 高度相似按 defer 处理）
+* @param embedding - 新内容的向量；undefined = 嵌入不可用，直接 accept
+*/
+async function decideWrite(store, kind, embedding) {
+	if (embedding === void 0) return { disposition: "accept" };
+	const nearest = await store.nearestNeighbor(embedding);
+	if (nearest === void 0 || nearest.similarity < .88) return { disposition: "accept" };
+	if (nearest.similarity >= .92 && nearest.record.kind === kind) return {
+		disposition: "merge",
+		into: nearest.record,
+		similarity: nearest.similarity
+	};
+	return {
+		disposition: "defer",
+		neighbor: nearest.record,
+		similarity: nearest.similarity
+	};
+}
+/**
+* MERGE 落地：强化既有条目（accessCount+1 / confidence+0.05）并记 write-merge 审计行。
+* @returns 强化后的既有条目；目标在并发窗口内被物理清除时抛错（loud，调用方按写入失败处理）。
+*/
+async function applyMerge(store, decision, content) {
+	const note = JSON.stringify({
+		content: content.slice(0, 40),
+		similarity: Number(decision.similarity.toFixed(4))
+	});
+	const record = await store.reinforce(decision.into.id, note);
+	if (record === void 0) throw new Error(`write-disposition: 并入目标 ${decision.into.id} 不存在`);
+	return record;
+}
 //#endregion
 //#region src/ingest/hook.ts
 /** 档位参数（协议内常量，非部署 tunables）。 */
@@ -695,6 +750,9 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: 0,
 		candidates: 0,
 		written: 0,
+		merged: 0,
+		deferred: 0,
+		dropped: 0,
 		skipped: typeof sliceMode === "number" ? "no-such-turn" : "no-previous-turn"
 	};
 	const store = await deps.openStore();
@@ -704,6 +762,9 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: slice.length,
 		candidates: 0,
 		written: 0,
+		merged: 0,
+		deferred: 0,
+		dropped: 0,
 		skipped: "already-ingested"
 	};
 	if (sliceMode === "previous" || deps.throttle === true) {
@@ -712,6 +773,9 @@ async function ingestPreviousTurn(deps) {
 			scannedEvents: slice.length,
 			candidates: 0,
 			written: 0,
+			merged: 0,
+			deferred: 0,
+			dropped: 0,
 			skipped: throttled
 		};
 	}
@@ -722,6 +786,9 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: slice.length,
 		candidates: 0,
 		written: 0,
+		merged: 0,
+		deferred: 0,
+		dropped: 0,
 		skipped: "no-user-content"
 	};
 	const route = deps.routeOverride ?? routeFromEvents(deps.events);
@@ -729,6 +796,9 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: slice.length,
 		candidates: 0,
 		written: 0,
+		merged: 0,
+		deferred: 0,
+		dropped: 0,
 		skipped: "no-route-in-log"
 	};
 	const recallNote = hasRecallToolCalls(scoped) ? "（注意：上一轮调用过记忆召回工具（engram_search 等），其返回已省略；助手回答中复述的既有记忆不是新信息，不要提取。）" : "";
@@ -752,16 +822,28 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: slice.length,
 		candidates: 0,
 		written: 0,
+		merged: 0,
+		deferred: 0,
+		dropped: 0,
 		skipped: "unparseable-output"
 	};
 	const embedder = await deps.embedder;
 	const writtenContents = [];
 	let written = 0;
+	let merged = 0;
+	let deferred = 0;
+	let dropped = 0;
 	for (const item of parsed.slice(0, limits.maxCandidates)) {
 		const candidate = item;
-		if (typeof candidate.content !== "string" || candidate.content.trim() === "") continue;
+		if (typeof candidate.content !== "string" || candidate.content.trim() === "") {
+			dropped += 1;
+			continue;
+		}
 		const content = redactSecrets(sanitizeProtocolText(candidate.content.trim()));
-		if (content === "") continue;
+		if (content === "") {
+			dropped += 1;
+			continue;
+		}
 		const kind = typeof candidate.kind === "string" && [
 			"fact",
 			"preference",
@@ -773,12 +855,19 @@ async function ingestPreviousTurn(deps) {
 		const scope = deps.perCandidateScope === true && modelScope !== void 0 ? modelScope : deps.writeScope ?? "user";
 		const target = deps.resolveStore === void 0 ? store : await deps.resolveStore(scope);
 		const importance = typeof candidate.importance === "number" && Number.isFinite(candidate.importance) ? Math.min(1, Math.max(0, candidate.importance)) : .5;
-		if (embedder !== void 0) {
-			const vector = (await embedder.embed([content]))[0];
-			if (vector !== void 0 && (await target.findContradictions(vector, 1)).length > 0) continue;
+		if (writtenContents.includes(content)) {
+			dropped += 1;
+			continue;
+		}
+		const vector = embedder === void 0 ? void 0 : (await embedder.embed([content]))[0];
+		const decision = await decideWrite(target, kind, vector);
+		if (decision.disposition === "merge") {
+			await applyMerge(target, decision, content);
+			writtenContents.push(content);
+			merged += 1;
+			continue;
 		}
-		if (writtenContents.includes(content)) continue;
-		await target.write({
+		const record = await target.write({
 			scope,
 			kind,
 			content,
@@ -787,9 +876,13 @@ async function ingestPreviousTurn(deps) {
 			sourceSessionId: deps.sessionId,
 			sourceRound: round,
 			...minSeq === null ? {} : { sourceSeq: minSeq },
-			...embedder === void 0 ? {} : { embedding: (await embedder.embed([content]))[0] },
+			...vector === void 0 ? {} : { embedding: vector },
 			...deps.history === true ? { initialReviewAt: null } : {}
 		});
+		if (decision.disposition === "defer") {
+			await target.linkEdge(record.id, decision.neighbor.id, "contradicts");
+			deferred += 1;
+		}
 		writtenContents.push(content);
 		written += 1;
 	}
@@ -798,6 +891,9 @@ async function ingestPreviousTurn(deps) {
 		scannedEvents: slice.length,
 		candidates: parsed.length,
 		written,
+		merged,
+		deferred,
+		dropped,
 		skipped: null
 	};
 }
@@ -836,6 +932,62 @@ async function ingestFinalTurn(deps) {
 		return null;
 	}
 }
+/** 会话摘要提示词：一句话概括整场会话，供情景时间线的组头展示。 */
+const SESSION_SUMMARY_SYSTEM = ["概括下面这段会话：用一句话（不超过 60 字）说明这场会话主要做了什么、达成了什么结果。", "直接输出摘要本身，不要前缀、引号或任何解释。"].join("\n");
+/** 会话摘要输出 token 上限（一句话足够）。 */
+const SESSION_SUMMARY_MAX_TOKENS = 160;
+/** 会话摘要的输入截断上限（字符）：摘要只需主题级信息，超长会话截尾。 */
+const SESSION_SUMMARY_TEXT_LIMIT = 4e3;
+/** 收集整场会话的对话文本（用户跳过插件注入快照 + 助手），脱敏后拼接并截断。 */
+function collectSessionText(events) {
+	const texts = [];
+	for (const event of events) if (event.type === "user/message") {
+		const data = event.data;
+		if (data?.source?.kind === "plugin") continue;
+		const segments = (data?.content ?? []).filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text);
+		if (segments.length > 0) texts.push(...segments);
+	} else if (event.type === "assistant/message") {
+		const segments = (event.data?.content ?? []).filter((block) => block?.type === "text" && typeof block.text === "string").map((block) => block.text);
+		if (segments.length > 0) texts.push(...segments);
+	}
+	const joined = texts.map((text) => redactSecrets(sanitizeProtocolText(text))).filter((text) => text !== "").join("\n");
+	return joined.length > SESSION_SUMMARY_TEXT_LIMIT ? `${joined.slice(0, SESSION_SUMMARY_TEXT_LIMIT)}…` : joined;
+}
+/**
+* 会话循环结束处生成一句话摘要（情景时间线组头的增强信息）：
+* 已有摘要直接跳过（重跑幂等，不再起 LLM）；无可用路由 / 已中止 / 无对话文本同样跳过。
+* LLM 失败静默：摘要是增强信息，实时路径挂在 dispose 观察器、回填路径在批次循环里，
+* 一次限流/超时都不值得升级为告警或失败。
+*/
+async function ensureSessionSummary(deps) {
+	if (deps.signal.aborted) return;
+	const route = deps.routeOverride ?? routeFromEvents(deps.events);
+	if (route === void 0) return;
+	const dialog = collectSessionText(deps.events);
+	if (dialog === "") return;
+	const store = await deps.openStore();
+	if (await store.getSessionSummary(deps.sessionId) !== void 0) return;
+	const userText = `概括下面这段会话：\n${dialog}`;
+	deps.logRequest({
+		route,
+		round: deps.round ?? 0,
+		userText,
+		maxTokens: SESSION_SUMMARY_MAX_TOKENS,
+		mode: deps.mode
+	});
+	try {
+		const summary = (await deps.call({
+			route,
+			system: SESSION_SUMMARY_SYSTEM,
+			userText,
+			maxTokens: SESSION_SUMMARY_MAX_TOKENS,
+			purpose: "engram-session-summary",
+			signal: deps.signal
+		})).trim();
+		if (summary === "") return;
+		await store.setSessionSummary(deps.sessionId, summary);
+	} catch {}
+}
 /**
 * 重放待补做的末轮摄取（下次会话首次 pre-step 调用）。已有 done 标记或键损坏的
 * pending 直接出队；事件源不可得的保留到下次。单个键失败抛出，剩余键留待下次。
@@ -1147,6 +1299,17 @@ async function runHistoryBackfill(deps, defaults, overrides, onProgress, signal)
 			}
 			progress.turnsDone += 1;
 		}
+		await ensureSessionSummary({
+			events: candidate.events,
+			sessionId: candidate.header.id,
+			openStore: () => candidate.openStore(),
+			call: deps.call,
+			logRequest: deps.logRequest,
+			mode: deps.mode,
+			routeOverride,
+			signal,
+			round: candidate.turns[candidate.turns.length - 1]
+		});
 		progress.sessionsDone += 1;
 		onProgress({
 			...progress,
@@ -2104,6 +2267,58 @@ function registerEngramRoutes(ctx, deps) {
 					});
 					return;
 				}
+				if (req.method === "GET" && route === "episode-timeline") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const since = toNumber(url.searchParams.get("since"));
+					const until = toNumber(url.searchParams.get("until"));
+					const sessionId = url.searchParams.get("sessionId") ?? void 0;
+					const around = url.searchParams.get("around") ?? void 0;
+					const windowMinutes = Math.min(1440, Math.max(1, toNumber(url.searchParams.get("windowMinutes")) ?? 60));
+					const limit = Math.min(200, Math.max(1, toNumber(url.searchParams.get("limit")) ?? 100));
+					const store = await storeFor(scope);
+					if (around !== void 0 && around !== "") {
+						const view = (await store.episodeTimeline({
+							scopes: [scope],
+							around,
+							proximityMs: windowMinutes * 6e4,
+							limit
+						})).around;
+						json(res, 200, { around: {
+							anchor: {
+								id: view.anchor.id,
+								kind: view.anchor.kind,
+								content: view.anchor.content,
+								createdAt: view.anchor.createdAt
+							},
+							neighbors: view.neighbors.map((record) => ({
+								id: record.id,
+								kind: record.kind,
+								content: record.content,
+								createdAt: record.createdAt
+							}))
+						} });
+						return;
+					}
+					json(res, 200, { groups: (await store.episodeTimeline({
+						scopes: [scope],
+						...since === void 0 ? {} : { since },
+						...until === void 0 ? {} : { until },
+						...sessionId === void 0 || sessionId === "" ? {} : { sessionId },
+						limit
+					})).groups.map((group) => ({
+						sessionId: group.sessionId,
+						...group.summary === void 0 ? {} : { summary: group.summary },
+						startedAt: group.startedAt,
+						endedAt: group.endedAt,
+						episodes: group.episodes.map((record) => ({
+							id: record.id,
+							kind: record.kind,
+							content: record.content,
+							createdAt: 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) => {
@@ -2378,6 +2593,18 @@ function registerEngramRoutes(ctx, deps) {
 					json(res, 200, await deps.history.models());
 					return;
 				}
+				if (req.method === "GET" && route === "profile-block") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const store = await storeFor(scope);
+					const block = await store.getProfileBlock(scope);
+					const versions = await store.listProfileBlockVersions(scope, 20);
+					json(res, 200, {
+						scope,
+						block: block ?? null,
+						versions
+					});
+					return;
+				}
 				if (req.method === "GET" && route === "history-backfill") {
 					json(res, 200, {
 						defaults: deps.history.defaults,
@@ -2877,14 +3104,20 @@ function placardImprovementHint(score) {
 * @module @kenz1117/dsh-engram/store/sqlite
 */
 /** 当前 schema 版本；结构性变更必须 +1。可空列与伴随表走增量迁移（见 openEngramStore 的迁移段）。 */
-const SCHEMA_VERSION = 6;
+const SCHEMA_VERSION = 9;
 /** 增量迁移表：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 幂等补齐。 */
+*   全部可空或带默认值，存量条目零搬运；排桩由 backfillSlots 幂等补齐。
+*  v6 → v7：画像 curated block 两表（profile_blocks 当前态 + profile_block_versions
+*   追加式版本链）。scope 作主键，每 scope 至多一个 block；版本链只增不改，rollback 数据源。
+*  v7 → v8：episode 情景时间线两个专用索引（kind+created_at 日期范围扫描、
+*   source_session_id+created_at 会话过滤）。列自 v1 就存在，纯索引迁移，零数据搬运。
+*  v8 → v9：会话摘要表 session_summaries（摄取期 LLM 生成的一句话会话摘要，
+*   组头展示用；与 nodes 无外键，会话 id 仅作逻辑关联）。 */
 const MIGRATIONS = {
 	"2": "ALTER TABLE nodes ADD COLUMN outcome TEXT",
 	"3": `CREATE TABLE IF NOT EXISTS nodes_revisions (
@@ -2901,7 +3134,17 @@ const MIGRATIONS = {
     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);`
+    CREATE INDEX IF NOT EXISTS nodes_review_due ON nodes (next_review_at);`,
+	"6": `CREATE TABLE IF NOT EXISTS profile_blocks (
+    scope TEXT PRIMARY KEY, content TEXT NOT NULL, version INTEGER NOT NULL,
+    updated_at INTEGER NOT NULL);
+    CREATE TABLE IF NOT EXISTS profile_block_versions (
+      scope TEXT NOT NULL, version INTEGER NOT NULL, content TEXT NOT NULL,
+      source TEXT NOT NULL, at INTEGER NOT NULL, PRIMARY KEY (scope, version));`,
+	"7": `CREATE INDEX IF NOT EXISTS nodes_kind_created ON nodes (kind, created_at);
+    CREATE INDEX IF NOT EXISTS nodes_session_created ON nodes (source_session_id, created_at);`,
+	"8": `CREATE TABLE IF NOT EXISTS session_summaries (
+    session_id TEXT PRIMARY KEY, summary TEXT NOT NULL, updated_at INTEGER NOT NULL);`
 };
 /** RRF 融合常数：score = Σ 1/(K + rank)。 */
 const RRF_K = 60;
@@ -3079,8 +3322,18 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
       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 TABLE IF NOT EXISTS profile_blocks (
+      scope TEXT PRIMARY KEY, content TEXT NOT NULL, version INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL);
+    CREATE TABLE IF NOT EXISTS profile_block_versions (
+      scope TEXT NOT NULL, version INTEGER NOT NULL, content TEXT NOT NULL,
+      source TEXT NOT NULL, at INTEGER NOT NULL, PRIMARY KEY (scope, version));
+    CREATE TABLE IF NOT EXISTS session_summaries (
+      session_id TEXT PRIMARY KEY, summary TEXT NOT NULL, updated_at INTEGER 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);
+    CREATE INDEX IF NOT EXISTS nodes_kind_created ON nodes (kind, created_at);
+    CREATE INDEX IF NOT EXISTS nodes_session_created ON nodes (source_session_id, created_at);
   `);
 	const versionRow = db.prepare("SELECT value FROM meta WHERE key = 'schema_version'").get();
 	if (versionRow === void 0) {
@@ -3184,6 +3437,19 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
 	const sqlPurgeFts = db.prepare("DELETE FROM nodes_fts");
 	const sqlPurgeLog = db.prepare("DELETE FROM op_log");
 	const sqlPurgeRoutes = db.prepare("DELETE FROM tour_routes");
+	const sqlPurgeProfileBlocks = db.prepare("DELETE FROM profile_blocks");
+	const sqlPurgeProfileVersions = db.prepare("DELETE FROM profile_block_versions");
+	const sqlPurgeSessionSummaries = db.prepare("DELETE FROM session_summaries");
+	const sqlProfileBlockGet = db.prepare("SELECT scope, content, version, updated_at FROM profile_blocks WHERE scope = ?");
+	const sqlProfileBlockUpsert = db.prepare(`INSERT INTO profile_blocks (scope, content, version, updated_at) VALUES (?, ?, ?, ?)
+    ON CONFLICT(scope) DO UPDATE SET content = excluded.content, version = excluded.version, updated_at = excluded.updated_at`);
+	const sqlProfileVersionInsert = db.prepare("INSERT INTO profile_block_versions (scope, version, content, source, at) VALUES (?, ?, ?, ?, ?)");
+	const sqlProfileVersionsList = db.prepare("SELECT scope, version, content, source, at FROM profile_block_versions WHERE scope = ? ORDER BY version DESC LIMIT ?");
+	const sqlProfileVersionGet = db.prepare("SELECT scope, version, content, source, at FROM profile_block_versions WHERE scope = ? AND version = ?");
+	const sqlSessionSummaryUpsert = db.prepare(`INSERT INTO session_summaries (session_id, summary, updated_at) VALUES (?, ?, ?)
+    ON CONFLICT(session_id) DO UPDATE SET summary = excluded.summary, updated_at = excluded.updated_at`);
+	const sqlSessionSummaryGet = db.prepare("SELECT session_id, summary FROM session_summaries WHERE session_id = ?");
+	const sqlSessionSummaryMany = db.prepare("SELECT session_id, summary FROM session_summaries WHERE session_id IN (SELECT value FROM json_each(?))");
 	/** FTS 道：按 scope 集合检索（占位符动态生成，scope 集合由调用方去重）；rooms 非空时只查指定房间。 */
 	const ftsSearch = (match, scopes, rooms) => {
 		const placeholders = scopes.map(() => "?").join(",");
@@ -3414,6 +3680,78 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
 			return (query.order === "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, nodes.created_at DESC LIMIT ?`).all(...params) : db.prepare(`SELECT nodes.* FROM nodes WHERE ${where} ORDER BY nodes.created_at DESC LIMIT ?`).all(...params)).map(rowToRecord);
 		},
+		async episodeTimeline(query) {
+			const limit = Math.max(1, Math.floor(query.limit ?? 100));
+			const placeholders = query.scopes.map(() => "?").join(",");
+			if (query.around !== void 0) {
+				const anchorRow = getRow(query.around);
+				if (anchorRow === void 0) throw new EngramError("NOT_FOUND", `邻近扩展锚点 ${query.around} 不存在`);
+				const window = Math.max(0, Math.floor(query.proximityMs ?? 36e5));
+				const rows = db.prepare(`SELECT * FROM nodes
+            WHERE kind = 'episode' AND status = 'active' AND scope IN (${placeholders})
+              AND id != ? AND created_at >= ? AND created_at <= ?
+            ORDER BY created_at ASC LIMIT ?`).all(...query.scopes, query.around, anchorRow.created_at - window, anchorRow.created_at + window, limit);
+				return {
+					groups: [],
+					around: {
+						anchor: rowToRecord(anchorRow),
+						neighbors: rows.map(rowToRecord)
+					}
+				};
+			}
+			const params = [
+				...query.scopes,
+				query.since ?? null,
+				query.since ?? null,
+				query.until ?? null,
+				query.until ?? null,
+				query.sessionId ?? null,
+				query.sessionId ?? null,
+				limit
+			];
+			const rows = db.prepare(`SELECT * FROM nodes
+          WHERE kind = 'episode' AND status = 'active' AND scope IN (${placeholders})
+            AND (? IS NULL OR created_at >= ?) AND (? IS NULL OR created_at <= ?)
+            AND (? IS NULL OR source_session_id = ?)
+          ORDER BY created_at DESC LIMIT ?`).all(...params);
+			const bySession = /* @__PURE__ */ new Map();
+			for (const row of rows) {
+				const record = rowToRecord(row);
+				const bucket = bySession.get(record.sourceSessionId);
+				if (bucket === void 0) bySession.set(record.sourceSessionId, [record]);
+				else bucket.push(record);
+			}
+			const groups = [...bySession.entries()].map(([sessionId, episodesDesc]) => {
+				const episodes = [...episodesDesc].reverse();
+				return {
+					sessionId,
+					episodes,
+					startedAt: episodes[0].createdAt,
+					endedAt: episodes[episodes.length - 1].createdAt
+				};
+			});
+			groups.sort((a, b) => b.startedAt - a.startedAt);
+			const sessionIds = groups.map((g) => g.sessionId).filter((id) => id !== null);
+			const summaries = /* @__PURE__ */ new Map();
+			if (sessionIds.length > 0) {
+				const rows = sqlSessionSummaryMany.all(JSON.stringify(sessionIds));
+				for (const row of rows) summaries.set(row.session_id, row.summary);
+			}
+			return { groups: groups.map((group) => {
+				const summary = group.sessionId === null ? void 0 : summaries.get(group.sessionId);
+				return {
+					...group,
+					...summary === void 0 ? {} : { summary }
+				};
+			}) };
+		},
+		async setSessionSummary(sessionId, summary) {
+			sqlSessionSummaryUpsert.run(sessionId, summary, Date.now());
+			sqlLog.run(Date.now(), "session-summary", sessionId, JSON.stringify({ length: summary.length }));
+		},
+		async getSessionSummary(sessionId) {
+			return sqlSessionSummaryGet.get(sessionId)?.summary;
+		},
 		async update(input) {
 			const old = getRow(input.id);
 			if (old === void 0) throw new EngramError("NOT_FOUND", `条目 ${input.id} 不存在`);
@@ -3572,6 +3910,54 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
 		async listPlacards() {
 			return sqlListPlacards.all().filter((row) => typeof row.caption === "string" && row.caption !== "");
 		},
+		async getProfileBlock(scope) {
+			const row = sqlProfileBlockGet.get(scope);
+			if (row === void 0) return void 0;
+			return {
+				scope: row.scope,
+				content: row.content,
+				version: row.version,
+				updatedAt: row.updated_at
+			};
+		},
+		async saveProfileBlock(scope, expectedVersion, content, source) {
+			if (content.trim() === "") throw new EngramError("EMPTY_CONTENT", "画像 block 内容不能为空");
+			const current = sqlProfileBlockGet.get(scope);
+			if (current === void 0 && expectedVersion !== void 0) throw new EngramError("VERSION_CONFLICT", `画像 block 不存在（${scope}），不能带 expectedVersion=${String(expectedVersion)} 编辑；先传 undefined 创建`);
+			if (current !== void 0 && expectedVersion !== current.version) throw new EngramError("VERSION_CONFLICT", `画像 block 版本冲突（${scope}）：当前 v${String(current.version)}，请求基于 v${String(expectedVersion)}；请重读最新版本后再改`);
+			const nextVersion = current === void 0 ? 1 : current.version + 1;
+			const now = Date.now();
+			withTransaction(() => {
+				sqlProfileVersionInsert.run(scope, nextVersion, content, source, now);
+				sqlProfileBlockUpsert.run(scope, content, nextVersion, now);
+			});
+			return {
+				scope,
+				content,
+				version: nextVersion,
+				updatedAt: now
+			};
+		},
+		async listProfileBlockVersions(scope, limit) {
+			return sqlProfileVersionsList.all(scope, Math.max(1, limit)).map((row) => ({
+				scope: row.scope,
+				version: row.version,
+				content: row.content,
+				source: row.source === "rollback" ? "rollback" : "edit",
+				at: row.at
+			}));
+		},
+		async getProfileBlockVersion(scope, version) {
+			const row = sqlProfileVersionGet.get(scope, version);
+			if (row === void 0) return void 0;
+			return {
+				scope: row.scope,
+				version: row.version,
+				content: row.content,
+				source: row.source === "rollback" ? "rollback" : "edit",
+				at: row.at
+			};
+		},
 		async restore(id) {
 			if (getRow(id) === void 0) throw new EngramError("NOT_FOUND", `条目 ${id} 不存在`);
 			sqlSetStatus.run("active", Date.now(), id);
@@ -3694,6 +4080,27 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
 		async linkEdge(from, to, type) {
 			sqlEdgeUpsert.run(from, to, type, Date.now());
 		},
+		async nearestNeighbor(embedding) {
+			const pool = db.prepare("SELECT * FROM nodes WHERE status = 'active' AND embedding IS NOT NULL AND scope IN ('user','project')").all();
+			let best;
+			for (const row of pool) {
+				const sim = cosine(embedding, blobToVec(row.embedding));
+				if (best === void 0 || sim > best.sim) best = {
+					row,
+					sim
+				};
+			}
+			return best === void 0 ? void 0 : {
+				record: rowToRecord(best.row),
+				similarity: best.sim
+			};
+		},
+		async reinforce(id, note) {
+			if (sqlGet.get(id) === void 0) return void 0;
+			sqlTouch.run(Date.now(), id);
+			sqlLog.run(Date.now(), "write-merge", id, note);
+			return rowToRecord(sqlGet.get(id));
+		},
 		async supersedeMany(input, oldIds) {
 			const content = input.content.trim();
 			if (content === "") throw new EngramError("EMPTY_CONTENT", "content 不能为空");
@@ -3731,6 +4138,9 @@ async function openEngramStore(path, rankBoost = NO_BOOST, automation = DEFAULT_
 				sqlPurgeFts.run();
 				sqlPurgeLog.run();
 				sqlPurgeRoutes.run();
+				sqlPurgeProfileBlocks.run();
+				sqlPurgeProfileVersions.run();
+				sqlPurgeSessionSummaries.run();
 			});
 		},
 		async close() {
@@ -3962,6 +4372,18 @@ const NEXT_STRATEGIES = [
 	"stop"
 ];
 /**
+* 构造证据门收尾提醒（agent 面向文本，英文与检索工具输出一致）。
+* @param pendingCount - 尚未判定的批次数。
+* @param insufficientStreak - 连续不足判定次数。
+* @returns 提醒文本；无待判定批次返回 undefined（不需要提醒）。
+*/
+function buildAssessReminder(pendingCount, insufficientStreak) {
+	if (pendingCount <= 0) return void 0;
+	const base = `Evidence gate: ${pendingCount} search batch(es) from this conversation have not been assessed. Before answering, call engram_assess with the batchId and your evidence refs — or briefly state why assessment is not needed.`;
+	if (insufficientStreak < 2) return base;
+	return `${base} Multiple insufficient verdicts in a row — try a different room (engram_search room=), engram_timeline, or ask the user for the missing details.`;
+}
+/**
 * 判断字符串是否为合法策略。
 * @param value - 待判定字符串。
 */
@@ -3981,6 +4403,8 @@ function evidenceRefOf(scope, id, slot) {
 /** 批次注册表：按会话隔离，超出上限丢最旧的批次。 */
 var EvidenceBatches = class {
 	bySession = /* @__PURE__ */ new Map();
+	/** 每会话连续不足判定的次数（sufficient 判定即清零；提醒据此升级措辞）。 */
+	insufficientStreaks = /* @__PURE__ */ new Map();
 	counter = 0;
 	/**
 	* 注册一个批次。
@@ -4016,11 +4440,41 @@ var EvidenceBatches = class {
 		return this.bySession.get(sessionId)?.get(batchId);
 	}
 	/**
-	* 清理会话的全部批次（会话销毁时调用，避免长驻进程累积）。
+	* 记录批次判定结果，并维护连续不足计数（sufficient 清零）。
+	* @param sessionId - 会话标识。
+	* @param batchId - 批次 id。
+	* @param verdict - 代码校验后的判定结果。
+	*/
+	recordVerdict(sessionId, batchId, verdict) {
+		const batch = this.get(sessionId, batchId);
+		if (batch === void 0) return;
+		batch.verdict = verdict;
+		const streak = this.insufficientStreaks.get(sessionId) ?? 0;
+		this.insufficientStreaks.set(sessionId, verdict.sufficient ? 0 : streak + 1);
+	}
+	/**
+	* 会话内尚未判定的批次（注册顺序，最旧在前）。
+	* @param sessionId - 会话标识。
+	*/
+	pendingBatches(sessionId) {
+		const batches = this.bySession.get(sessionId);
+		if (batches === void 0) return [];
+		return [...batches.values()].filter((batch) => batch.verdict === void 0);
+	}
+	/**
+	* 连续不足判定次数（sufficient 判定清零；未判定批次不影响计数）。
+	* @param sessionId - 会话标识。
+	*/
+	insufficientStreak(sessionId) {
+		return this.insufficientStreaks.get(sessionId) ?? 0;
+	}
+	/**
+	* 清理会话的全部批次与判定计数（会话销毁时调用，避免长驻进程累积）。
 	* @param sessionId - 会话标识。
 	*/
 	clear(sessionId) {
 		this.bySession.delete(sessionId);
+		this.insufficientStreaks.delete(sessionId);
 	}
 };
 /** 进程内批次注册表：插件为单实例，会话销毁时调用 clear 释放该会话的批次。 */
@@ -4065,7 +4519,7 @@ function assessEvidence(batch, request) {
 //#endregion
 //#region src/tools/create.ts
 /**
-* 17 个 engram_ 工具的定义与执行器。工具 schema 保持窄参数；
+* 19 个 engram_ 工具的定义与执行器。工具 schema 保持窄参数；
 * scope 决定读写哪个分库；嵌入缺失时检索结果显式标记降级。
 * @module @kenz1117/dsh-engram/tools/create
 */
@@ -4087,6 +4541,21 @@ function sessionCwdOf(exec) {
 	const cwd = exec.agent?.session?.header?.cwd;
 	return cwd === void 0 || cwd === "" ? void 0 : cwd;
 }
+/** 工具入参时间解析：ISO 或可解析日期字符串 → epoch 毫秒；缺省 undefined；不可解析 loud 失败。 */
+function parseTimeParam(raw, toolName, field) {
+	if (raw === void 0) return void 0;
+	const ms = Date.parse(raw);
+	if (Number.isNaN(ms)) throw new Error(`${toolName}: ${field} 不是可解析时间 ${raw}`);
+	return ms;
+}
+/** 工具入参正数解析（分钟/条数等计数）：缺省 fallback；非有限数字或越界 loud 失败。 */
+function parseCountParam(raw, toolName, field, fallback, min, max) {
+	if (raw === void 0) return fallback;
+	if (typeof raw !== "number" || !Number.isFinite(raw)) throw new Error(`${toolName}: ${field} 必须是有限数字，收到 ${String(raw)}`);
+	const value = Math.floor(raw);
+	if (value < min || value > max) throw new Error(`${toolName}: ${field} 需在 ${String(min)}-${String(max)} 之间，收到 ${String(value)}`);
+	return value;
+}
 /** 历史回填估算的模型可读文本（零成本，先看数再决定跑不跑）。 */
 function renderHistoryEstimate(estimate) {
 	if (estimate.unavailable !== void 0) return `历史回填不可用：${estimate.unavailable}`;
@@ -4119,7 +4588,7 @@ const STRATEGY_HINT = {
 	answer: "可以据此作答",
 	search_keyword: "换关键词再检索（engram_search）",
 	search_room: "收窄到具体房间再检索（engram_search 带 room）",
-	search_timeline: "按时间线找（engram_timeline）",
+	search_timeline: "按时间线找（engram_timeline 或 engram_episode_timeline 查情景）",
 	ask_user: "向用户澄清缺失的信息",
 	stop: "不回答，并向用户说明缺少什么"
 };
@@ -4203,8 +4672,8 @@ async function rewriteQueries(deps, exec, query) {
 	}
 }
 /**
-* 构造 17 个工具定义（engram_save/search/assess/timeline/update/forget/report/review/review_queue/
-* stats/export/distill/examine/neighbors/audit_forgotten/tour/ingest_history）。
+* 构造 19 个工具定义（engram_save/search/assess/timeline/episode_timeline/update/forget/report/review/review_queue/
+* stats/export/distill/examine/neighbors/audit_forgotten/tour/ingest_history/profile_edit）。
 * @param baseDeps - 分库打开器、嵌入器、辅助 LLM、导出目录。
 * @returns 可直接 register 的工具定义数组（execute 已绑定会话 cwd 的项目宫殿路由）。
 */
@@ -4222,10 +4691,18 @@ function createEngramTools(baseDeps) {
 	/** engram_save 呈现文本：矛盾警告 text 优先；批量输出汇总成功与失败。 */
 	function renderSaveResultText(value) {
 		if (value.count !== void 0) {
+			const items = value.items ?? [];
+			const merged = items.filter((item) => item.disposition === "merge").length;
+			const deferred = items.filter((item) => item.disposition === "defer").length;
 			const parts = [`已批量保存 ${value.count} 条记忆`];
-			for (const item of value.items ?? []) {
+			const states = [];
+			if (merged > 0) states.push(`并入强化 ${merged} 条既有记忆`);
+			if (deferred > 0) states.push(`${deferred} 条与现有记忆高度相似待裁决`);
+			if (states.length > 0) parts.push(states.join("，"));
+			for (const item of 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 state = item.disposition === "merge" ? `, 并入 ${item.mergedInto}` : item.disposition === "defer" ? ", 待裁决" : "";
+				parts.push(`${item.id}（kind=${item.kind}, importance=${item.importance}${slot}${state}）`);
 			}
 			const failures = value.failed ?? [];
 			if (failures.length > 0) parts.push(`${failures.length} 条失败：${failures.map((entry) => `#${entry.index + 1} ${entry.reason}`).join("；")}`);
@@ -4235,9 +4712,20 @@ function createEngramTools(baseDeps) {
 		if (value.text !== void 0) return value.text;
 		return `已保存记忆 ${value.id}（kind=${value.kind}, importance=${value.importance}）。后续会话可用 engram_search 召回。`;
 	}
-	/** 写入单条已清洗内容并按嵌入建矛盾边；返回记录与矛盾候选（调用方决定呈现）。 */
-	async function writeWithContradictions(store, item) {
+	/**
+	* 写入单条已清洗内容（四态处置）：MERGE 不新建条目只强化既有；
+	* DEFER 写入并建 contradicts 边待裁决；ACCEPT 原样写入。
+	*/
+	async function writeWithDisposition(store, item) {
 		const { embedding } = item;
+		const decision = await decideWrite(store, item.kind, embedding);
+		if (decision.disposition === "merge") return {
+			disposition: "merge",
+			record: await applyMerge(store, decision, item.content),
+			relatedId: decision.into.id,
+			similarity: decision.similarity,
+			candidates: []
+		};
 		const record = await store.write({
 			scope: item.scope,
 			kind: item.kind,
@@ -4247,11 +4735,21 @@ function createEngramTools(baseDeps) {
 			...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");
+		if (decision.disposition === "defer") {
+			const candidates = await store.findContradictions(embedding);
+			for (const candidate of candidates) await store.linkEdge(record.id, candidate.id, "contradicts");
+			return {
+				disposition: "defer",
+				record,
+				relatedId: decision.neighbor.id,
+				similarity: decision.similarity,
+				candidates
+			};
+		}
 		return {
+			disposition: "accept",
 			record,
-			candidates
+			candidates: []
 		};
 	}
 	/** 门牌参数收敛：非空字符串转 ImageryLabel（感官/情绪维度留空——AI 不需要人脑补丁），非法返回 undefined。 */
@@ -4326,7 +4824,7 @@ function createEngramTools(baseDeps) {
 		const saved = [];
 		for (const [position, item] of prepared.entries()) try {
 			const embedding = vectors?.[position];
-			const { record } = await writeWithContradictions(store, {
+			const outcome = await writeWithDisposition(store, {
 				scope,
 				kind: item.kind,
 				content: item.content,
@@ -4335,10 +4833,12 @@ function createEngramTools(baseDeps) {
 				...embedding === void 0 ? {} : { embedding }
 			});
 			saved.push({
-				id: record.id,
-				kind: record.kind,
-				importance: record.importance,
-				...record.slot === void 0 ? {} : { slot: record.slot }
+				id: outcome.record.id,
+				kind: outcome.record.kind,
+				importance: outcome.record.importance,
+				disposition: outcome.disposition,
+				...outcome.disposition === "merge" || outcome.record.slot === void 0 ? {} : { slot: outcome.record.slot },
+				...outcome.disposition === "merge" && outcome.relatedId !== void 0 ? { mergedInto: outcome.relatedId } : {}
 			});
 		} catch (error) {
 			failed.push({
@@ -4416,6 +4916,16 @@ function createEngramTools(baseDeps) {
 					id: { type: "string" },
 					kind: { type: "string" },
 					importance: { type: "number" },
+					disposition: {
+						type: "string",
+						enum: [
+							"accept",
+							"merge",
+							"defer"
+						]
+					},
+					mergedInto: { type: "string" },
+					similarity: { type: "number" },
 					text: { type: "string" },
 					count: { type: "number" },
 					items: {
@@ -4436,6 +4946,16 @@ function createEngramTools(baseDeps) {
 									type: "number",
 									required: true
 								},
+								disposition: {
+									type: "string",
+									enum: [
+										"accept",
+										"merge",
+										"defer"
+									],
+									required: true
+								},
+								mergedInto: { type: "string" },
 								slot: {
 									type: "object",
 									additionalProperties: false,
@@ -4493,7 +5013,7 @@ function createEngramTools(baseDeps) {
 			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, {
+			const outcome = await writeWithDisposition(store, {
 				scope,
 				kind: input.kind,
 				content,
@@ -4502,13 +5022,28 @@ function createEngramTools(baseDeps) {
 				...embeddings?.[0] === void 0 ? {} : { embedding: embeddings[0] },
 				...imagery === void 0 ? {} : { imagery }
 			});
+			const { record, candidates } = outcome;
+			if (outcome.disposition === "merge") {
+				const sim = (outcome.similarity ?? 0).toFixed(2);
+				return {
+					id: record.id,
+					kind: record.kind,
+					importance: record.importance,
+					disposition: "merge",
+					...outcome.relatedId === void 0 ? {} : { mergedInto: outcome.relatedId },
+					...outcome.similarity === void 0 ? {} : { similarity: outcome.similarity },
+					text: `与既有记忆高度重复（相似度 ${sim}），已并入 ${outcome.relatedId} 并强化其置信度与访问计数，未新建条目。若这是修正而非复述，请用 engram_update 归并。`
+				};
+			}
 			const placardHint = imagery === void 0 || record.imageryScore === void 0 ? "" : `\n${placardImprovementHint(record.imageryScore) ?? ""}`;
-			if (candidates.length > 0) {
+			if (outcome.disposition === "defer") {
 				const listed = candidates.map((candidate) => `「${candidate.content}」（id=${candidate.id}）`).join("；");
 				return {
 					id: record.id,
 					kind: record.kind,
 					importance: record.importance,
+					disposition: "defer",
+					...outcome.similarity === void 0 ? {} : { similarity: outcome.similarity },
 					text: `已保存 ${record.id}。注意：与现有记忆高度相似——${listed}。若这是修正而非新事实，请用 engram_update 归并，或 engram_forget 去重。${placardHint}`
 				};
 			}
@@ -4517,6 +5052,7 @@ function createEngramTools(baseDeps) {
 				id: record.id,
 				kind: record.kind,
 				importance: record.importance,
+				disposition: "accept",
 				text: `${base}${placardHint}`
 			};
 		}
@@ -4680,6 +5216,7 @@ function createEngramTools(baseDeps) {
 				missing: typeof input.missing === "string" ? input.missing : "",
 				nextStrategy: typeof input.nextStrategy === "string" ? input.nextStrategy : ""
 			});
+			if (sessionId !== void 0) evidenceBatches.recordVerdict(sessionId, batch.batchId, verdict);
 			await (await deps.openStore("user")).audit("assess", batch.batchId, JSON.stringify({
 				batchId: batch.batchId,
 				sufficient: verdict.sufficient,
@@ -4744,14 +5281,8 @@ function createEngramTools(baseDeps) {
 			const input = args;
 			const scopes = scopesOf(input.scope);
 			const order = input.order === "tour" ? "tour" : "time";
-			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");
+			const since = parseTimeParam(input.since, "engram_timeline", "since");
+			const until = parseTimeParam(input.until, "engram_timeline", "until");
 			const results = await Promise.all(scopes.map(async (scope) => {
 				return (await deps.openStore(scope)).timeline({
 					scopes: [scope],
@@ -4770,6 +5301,106 @@ function createEngramTools(baseDeps) {
 			return { text: renderMemoryPacket(`${body.join("\n") || "时间线为空"}${tail}`, "tool_timeline", input.topic ?? "（对话继续）") };
 		}
 	});
+	const episodeTimeline = defineTool({
+		name: "engram_episode_timeline",
+		description: "episode 情景记忆的独立时间线：按日期范围与来源会话浏览经历，输出按会话分组（组间新→旧，组内时间升序），适合回答「那天/那段时间我们做了什么」。around 传锚点记忆 id 时切换为时间邻近扩展——列出锚点创建时刻 ± 窗口内的情景（忽略日期过滤），回答「当时前后还发生了什么」。",
+		parameters: {
+			scope: {
+				type: "string",
+				enum: [
+					"user",
+					"project",
+					"shared",
+					"all"
+				],
+				description: "作用域，默认 all"
+			},
+			since: {
+				type: "string",
+				description: "起始日期（ISO 或可解析日期）"
+			},
+			until: {
+				type: "string",
+				description: "结束日期"
+			},
+			sessionId: {
+				type: "string",
+				description: "只看该来源会话的情景（id 精确匹配，从本工具输出的「会话 …」组头取得）"
+			},
+			around: {
+				type: "string",
+				description: "锚点记忆 id：切换为时间邻近扩展模式（与 since/until/sessionId 互斥，此时忽略它们）"
+			},
+			windowMinutes: {
+				type: "number",
+				description: `邻近窗口分钟数（around 模式，默认 ${String(EPISODE_PROXIMITY_MS_DEFAULT / 6e4)}）`
+			},
+			limit: {
+				type: "number",
+				description: `最多返回条数（默认 ${String(100)}）`
+			}
+		},
+		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 since = parseTimeParam(input.since, "engram_episode_timeline", "since");
+			const until = parseTimeParam(input.until, "engram_episode_timeline", "until");
+			const limit = parseCountParam(input.limit, "engram_episode_timeline", "limit", 100, 1, 500);
+			const sessionId = input.sessionId?.trim();
+			const aroundId = input.around?.trim();
+			const renderRow = (record) => `${new Date(record.createdAt).toISOString()} [${record.scope}/${record.kind}] ${truncateItem(record.content)}（id=${record.id}）`;
+			if (aroundId !== void 0 && aroundId !== "") {
+				const windowMinutes = parseCountParam(input.windowMinutes, "engram_episode_timeline", "windowMinutes", EPISODE_PROXIMITY_MS_DEFAULT / 6e4, 1, 1440);
+				const anchor = asMemoryId(aroundId);
+				for (const scope of scopes) {
+					const store = await deps.openStore(scope);
+					if (await store.get(anchor) === void 0) continue;
+					const around = (await store.episodeTimeline({
+						scopes: [scope],
+						around: anchor,
+						proximityMs: windowMinutes * 6e4,
+						limit
+					})).around;
+					return { text: renderMemoryPacket(enforceBudget(around.neighbors.length === 0 ? [`锚点：${renderRow(around.anchor)}`, "邻近窗口内没有情景记忆。"] : [
+						`锚点：${renderRow(around.anchor)}`,
+						`邻近情景（±${String(windowMinutes)} 分钟，${String(around.neighbors.length)} 条，按时间正序）：`,
+						...around.neighbors.map(renderRow)
+					]).join("\n"), "tool_episode_timeline", aroundId) };
+				}
+				throw new Error(`engram_episode_timeline: 锚点 ${aroundId} 不存在`);
+			}
+			const groups = (await Promise.all(scopes.map(async (scope) => {
+				return (await deps.openStore(scope)).episodeTimeline({
+					scopes: [scope],
+					...since === void 0 ? {} : { since },
+					...until === void 0 ? {} : { until },
+					...sessionId === void 0 || sessionId === "" ? {} : { sessionId },
+					limit
+				});
+			}))).flatMap((result) => result.groups).sort((a, b) => b.startedAt - a.startedAt);
+			const lines = [];
+			for (const group of groups) {
+				lines.push(group.sessionId === null ? `[无会话来源] ${new Date(group.startedAt).toISOString()} ~ ${new Date(group.endedAt).toISOString()}（${String(group.episodes.length)} 条）` : `[会话 ${group.sessionId}] ${new Date(group.startedAt).toISOString()} ~ ${new Date(group.endedAt).toISOString()}（${String(group.episodes.length)} 条）`);
+				if (group.summary !== void 0) lines.push(`  摘要：${group.summary}`);
+				for (const record of group.episodes) lines.push(`- ${renderRow(record)}`);
+			}
+			return { text: renderMemoryPacket(enforceBudget(lines).join("\n") || "情景时间线为空", "tool_episode_timeline", sessionId ?? "（对话继续）") };
+		}
+	});
 	const update = defineTool({
 		name: "engram_update",
 		description: "修正一条记忆：写入新条目并把旧条目标记为被取代（链条保留，可审计）。id 来自 engram_search 结果。",
@@ -5086,6 +5717,7 @@ function createEngramTools(baseDeps) {
 		search,
 		assess,
 		timeline,
+		episodeTimeline,
 		update,
 		forget,
 		defineTool({
@@ -5602,7 +6234,109 @@ function createEngramTools(baseDeps) {
 			}
 		}),
 		auditForgotten,
-		ingestHistory
+		ingestHistory,
+		defineTool({
+			name: "engram_profile_edit",
+			description: "编辑会话开始注入的用户画像 curated block（注入时位于自动派生画像之前，是画像的最高优先层）。action=view 查看当前内容与版本历史；action=edit 编辑（乐观锁：须带当前 expectedVersion，版本冲突会报错，重读最新版本后再改；首次创建省略 expectedVersion）；action=rollback 回滚（把 toVersion 版本的内容作为新版本写入，历史不改写）。内容入库前做协议剥离与密钥脱敏。",
+			parameters: {
+				action: {
+					type: "string",
+					enum: [
+						"view",
+						"edit",
+						"rollback"
+					],
+					required: true,
+					description: "view 查看 / edit 编辑 / rollback 回滚"
+				},
+				scope: {
+					type: "string",
+					enum: [
+						"user",
+						"project",
+						"shared"
+					],
+					description: "作用域，默认 user"
+				},
+				content: {
+					type: "string",
+					description: "edit 必填：新的画像内容（多行文本，会话开始按原文注入）"
+				},
+				expectedVersion: {
+					type: "integer",
+					description: "edit 带上=并发保护（乐观锁）；省略=仅当尚无 block 时创建 v1"
+				},
+				toVersion: {
+					type: "integer",
+					description: "rollback 必填：要回滚到的历史版本号（用 view 查得）"
+				}
+			},
+			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 action = input.action === "edit" || input.action === "rollback" || input.action === "view" ? input.action : void 0;
+				if (action === void 0) throw new Error("engram_profile_edit: action 必须是 view / edit / rollback 之一");
+				const scope = scopeOf(input.scope, "user");
+				const store = await deps.openStore(scope);
+				if (action === "view") {
+					const block = await store.getProfileBlock(scope);
+					if (block === void 0) return { text: `${scope} 库暂无 curated 画像 block。用 action=edit（省略 expectedVersion）即可创建 v1；创建后会话开始时优先于自动派生画像注入。` };
+					const versions = await store.listProfileBlockVersions(scope, 10);
+					return { text: [
+						`当前 curated 画像（${scope}，v${block.version}）：`,
+						block.content,
+						"",
+						`版本历史（最近 ${versions.length} 条，新→旧；rollback 用 toVersion 指定）：`,
+						...versions.map((version) => `- v${version.version} · ${version.source === "rollback" ? "回滚" : "编辑"} · ${new Date(version.at).toISOString().slice(0, 16).replace("T", " ")} · ${version.content.length} 字`)
+					].join("\n") };
+				}
+				if (action === "edit") {
+					if (typeof input.content !== "string" || input.content.trim() === "") throw new Error("engram_profile_edit: edit 需要 content 参数");
+					let expectedVersion;
+					if (input.expectedVersion !== void 0) {
+						if (!Number.isInteger(input.expectedVersion)) throw new Error("engram_profile_edit: expectedVersion 必须是整数（用 action=view 查得）");
+						expectedVersion = input.expectedVersion;
+					}
+					const content = redactSecrets(sanitizeProtocolText(input.content));
+					if (content.trim() === "") throw new Error("engram_profile_edit: 清洗后内容为空（原文只含协议标签或密钥）");
+					const block = await store.saveProfileBlock(scope, expectedVersion, content, "edit");
+					await store.audit("profile-edit", scope, JSON.stringify({
+						action: "edit",
+						fromVersion: expectedVersion ?? null,
+						toVersion: block.version,
+						chars: content.length
+					}));
+					return { text: `curated 画像已写入（${scope}，v${block.version}）。下一轮会话开始时将优先于自动派生画像注入。` };
+				}
+				if (!Number.isInteger(input.toVersion)) throw new Error("engram_profile_edit: rollback 需要 toVersion（目标历史版本号，用 action=view 查得）");
+				const target = await store.getProfileBlockVersion(scope, input.toVersion);
+				if (target === void 0) throw new Error(`engram_profile_edit: ${scope} 库不存在版本 v${input.toVersion}（用 action=view 查看版本历史）`);
+				const current = await store.getProfileBlock(scope);
+				if (current === void 0) throw new Error(`engram_profile_edit: ${scope} 库尚无 curated 画像 block，无从回滚`);
+				const updated = await store.saveProfileBlock(scope, current.version, target.content, "rollback");
+				await store.audit("profile-edit", scope, JSON.stringify({
+					action: "rollback",
+					fromVersion: current.version,
+					toVersion: updated.version,
+					restoredFrom: target.version,
+					chars: target.content.length
+				}));
+				return { text: `已把 v${target.version} 的内容作为 v${updated.version} 写入（${scope}；版本链只增不改，可继续回滚）。` };
+			}
+		})
 	].map((tool) => ({
 		...tool,
 		execute: (args, exec) => execSessionCwd.run(sessionCwdOf(exec), () => tool.execute(args, exec))
@@ -5771,8 +6505,8 @@ function estimateTokens(text) {
 //#region src/index.ts
 /**
 * dsh-engram：DeepSeek Harness 跨会话长期记忆插件（host 半）。
-* 注册 10 个 engram_ 工具、会话开始注入用户画像、自动摄取上一轮对话、
-* 蒸馏/衰减飞轮与审计能力。
+* 注册 18 个 engram_ 工具、会话开始注入画像（curated block 优先于派生画像）、
+* 自动摄取上一轮对话、蒸馏/衰减飞轮与审计能力。
 * @module @kenz1117/dsh-engram
 */
 /** Cordis 插件名（loader 诊断与注入 source 使用）。 */
@@ -5781,31 +6515,41 @@ const name = "dsh-engram";
 const VERSION = "0.7.6";
 /** 必需服务：工具注册表与 LLM 流式端点（摄取/蒸馏的辅助调用）。 */
 const inject = ["tools", "llm"];
+/** 分级递减预算默认值（配置缺省时由 resolveConfig 显式落地，同值于此）。 */
+const DEFAULT_ITEM_BUDGET = {
+	start: 160,
+	decay: .9,
+	floor: 24
+};
 /**
-* 会话开始注入的画像渲染：按重要性降序在 token 预算内整行装填（估算见
-* estimateTokens：中文按 1.5 token/字、其余按 4 字符/token，超预算的行跳过不截断、
-* 继续试更短行）；装不下的条目降级为索引行（#id + 前 40 字），
-* 索引行也装不下的折成末尾 `+N more; use engram_search` 计数行；计数行同样占用预算。
+* 会话开始注入的画像渲染：按重要性降序装填，单条正文按分级递减预算截断
+* （首条 160 字、逐条 ×0.9、下限 24 字——排名越靠后单条越短，平滑降级替代
+* 整条降级索引行）；token 预算（估算见 estimateTokens：中文按 1.5 token/字、
+* 其余按 4 字符/token）是外层硬约束：截断后仍装不下的条目先以 40 字索引行
+* 兜底，索引行也装不下的折成末尾 `+N more; use engram_search` 计数行；计数行同样占用预算。
 * @param records - 候选条目（调用方已按重要性排序、按条数截断）。
 * @param tokenBudget - 整段画像的 token 预算（含首尾固定行）。
+* @param itemBudget - 分级递减的单条正文预算（缺省用 DEFAULT_ITEM_BUDGET；配置面在 resolveConfig）。
 * @returns 渲染文本与溢出条目（调用方可用辅助 LLM 压缩后重渲染）。
 */
-function renderProfileDetailed(records, tokenBudget) {
+function renderProfileDetailed(records, tokenBudget, itemBudget = DEFAULT_ITEM_BUDGET) {
 	const estimate = estimateTokens;
 	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) {
+	records.forEach((record, index) => {
+		const budget = Math.max(itemBudget.floor, Math.round(itemBudget.start * itemBudget.decay ** index));
+		const content = record.content.length > budget ? `${record.content.slice(0, budget)}…` : record.content;
 		const slot = record.slot === void 0 ? "" : ` ${record.slot.room}#${record.slot.index}`;
-		const line = `- [${record.kind}]${slot} ${record.content}`;
+		const line = `- [${record.kind}]${slot} ${content}`;
 		const cost = estimate(line);
 		if (cost <= remaining) {
 			lines.push(line);
 			remaining -= cost;
 		} else overflow.push(record);
-	}
+	});
 	let more = 0;
 	remaining -= overflow.length === 0 ? 0 : estimate(`+${overflow.length} more; use engram_search`);
 	for (const record of overflow) {
@@ -5835,6 +6579,28 @@ function renderProfileDetailed(records, tokenBudget) {
 function renderProfile(records, tokenBudget) {
 	return renderProfileDetailed(records, tokenBudget).text;
 }
+/** curated block 段的标题行（模型据此知道这一段是人工维护的最高优先画像）。 */
+const CURATED_HEADER = "Curated profile (user-maintained via engram_profile_edit; authoritative over derived facts):";
+/**
+* 画像渲染（curated 优先）：有 curated block 时其全文置于派生画像之前（模型可见的
+* 第一段），并先从 token 预算中扣除自身占用，剩余预算才给派生条目装填；派生段
+* 照旧走分级递减与索引行/计数行降级。curated 是用户显式维护的意志，即使超出剩余
+* 预算也完整注入（与 due 行同理）；block 缺省时等同 renderProfileDetailed。
+* @param curated - 当前态 curated block；undefined = 尚未编辑过。
+* @param records - 派生画像候选条目（调用方已按重要性排序、按条数截断）。
+* @param tokenBudget - 整段画像的 token 预算（curated 段与派生段共享）。
+* @param itemBudget - 分级递减的单条正文预算（透传 renderProfileDetailed）。
+* @returns 渲染文本与派生段的溢出条目。
+*/
+function renderProfileWithCurated(curated, records, tokenBudget, itemBudget = DEFAULT_ITEM_BUDGET) {
+	if (curated === void 0) return renderProfileDetailed(records, tokenBudget, itemBudget);
+	const curatedSection = `${CURATED_HEADER}\n${curated.content}`;
+	const detailed = renderProfileDetailed(records, Math.max(0, tokenBudget - estimateTokens(curatedSection)), itemBudget);
+	return {
+		text: `${curatedSection}\n${detailed.text}`,
+		overflow: detailed.overflow
+	};
+}
 /** 压缩辅助调用的输出 token 上限（40 字 × 若干条，短输出足够）。 */
 const COMPRESS_MAX_TOKENS = 800;
 /** 压缩辅助调用超时：压缩在 pre-step 关键路径上，必须限时防阻塞首轮请求。 */
@@ -5937,23 +6703,59 @@ async function preStep(ctx, openStore, openStoreForProjectCwd, resolved, embedde
 			console.warn("[dsh-engram] 本轮自动摄取失败（已跳过，不影响对话）：", error);
 		});
 	}
+	if (step !== 1 && resolved.assessReminder) {
+		const sessionId = String(agent.session.id);
+		const pending = evidenceBatches.pendingBatches(sessionId).length;
+		const reminder = buildAssessReminder(pending, evidenceBatches.insufficientStreak(sessionId));
+		if (reminder !== void 0 && reminder !== state.lastAssessReminder) {
+			state.lastAssessReminder = reminder;
+			return {
+				...decision,
+				messages: [...decision.messages, createUserMessage({
+					content: [{
+						type: "text",
+						text: reminder
+					}],
+					source: {
+						kind: "plugin",
+						plugin: name,
+						form: "snapshot",
+						sections: [{
+							name,
+							text: reminder
+						}]
+					}
+				})]
+			};
+		}
+	}
 	if (step !== 1) return decision;
-	const top = await (await openStore("user")).topActive("user", resolved.profileTopN);
-	if (top.length === 0) return decision;
+	const store = await openStore("user");
+	const curated = await store.getProfileBlock("user");
+	const top = await store.topActive("user", resolved.profileTopN);
+	if (top.length === 0 && curated === void 0) return decision;
 	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);
+	const detailed = renderProfileWithCurated(curated, top, resolved.injectTokenBudget, {
+		start: resolved.injectItemBudgetStart,
+		decay: resolved.injectItemBudgetDecay,
+		floor: resolved.injectItemBudgetFloor
+	});
 	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) => {
+			text = renderProfileWithCurated(curated, top.map((record) => {
 				const shorter = compressed.get(record.id);
 				return shorter === void 0 ? record : {
 					...record,
 					content: shorter
 				};
-			}), resolved.injectTokenBudget).text;
+			}), resolved.injectTokenBudget, {
+				start: resolved.injectItemBudgetStart,
+				decay: resolved.injectItemBudgetDecay,
+				floor: resolved.injectItemBudgetFloor
+			}).text;
 		}
 	}
 	const dueLine = dueTotal === 0 ? "" : `\nPalace review due today: ${dueTotal}${dueTotal >= 50 ? "+" : ""} memories. Use engram_review_queue for active recall (recall beats re-reading).`;
@@ -6111,6 +6913,7 @@ function apply(ctx, config = {}) {
 		pendingReplayed: false,
 		lastProfileAgent: null,
 		lastProfileHash: null,
+		lastAssessReminder: null,
 		route: void 0
 	};
 	/** 会话持久化服务（可选；缺席时历史回填不可用）。 */
@@ -6354,14 +7157,17 @@ function apply(ctx, config = {}) {
 	if (resolved.ingest !== "off") ctx.on("session/disposed", (session) => {
 		const mode = resolved.ingest;
 		if (mode === "off") return;
+		const events = session.snapshotEvents();
+		const sessionId = String(session.id);
+		const cwd = sessionCwd(session);
 		ingestFinalTurn({
-			events: session.snapshotEvents(),
-			sessionId: String(session.id),
+			events,
+			sessionId,
 			turn: 0,
 			slice: "last",
 			openStore: () => openStore("user"),
 			openAuditStore: () => openStore("user"),
-			...ingestWriteRouting(sessionCwd(session), openStoreForProjectCwd, openStore),
+			...ingestWriteRouting(cwd, openStoreForProjectCwd, openStore),
 			embedder,
 			mode,
 			routeOverride: resolved.routeOverride,
@@ -6371,8 +7177,24 @@ function apply(ctx, config = {}) {
 			}),
 			logRequest: logIngestRequest,
 			signal: AbortSignal.timeout(FINAL_INGEST_TIMEOUT_MS)
+		}).then((outcome) => {
+			if (outcome === null) return void 0;
+			return ensureSessionSummary({
+				events,
+				sessionId,
+				openStore: () => cwd === void 0 ? openStore("user") : openStoreForProjectCwd(cwd),
+				call: (params) => streamText(ctx, {
+					...params,
+					sessionId: session.id
+				}),
+				logRequest: logIngestRequest,
+				mode,
+				routeOverride: resolved.routeOverride,
+				signal: AbortSignal.timeout(FINAL_INGEST_TIMEOUT_MS),
+				round: lastTurnNumber(events)
+			});
 		}).catch((error) => {
-			console.warn("[dsh-engram] 会话结束的末轮摄取异常（不影响对话）：", error);
+			console.warn("[dsh-engram] 会话结束的收尾处理异常（不影响对话）：", error);
 		});
 	});
 	const runDecay = async () => {
@@ -6430,4 +7252,4 @@ function apply(ctx, config = {}) {
 	}, "dsh-engram: consolidation timer");
 }
 //#endregion
-export { Config, VERSION, apply, inject, name, renderProfile, renderProfileDetailed };
+export { CURATED_HEADER, Config, DEFAULT_ITEM_BUDGET, VERSION, apply, inject, name, renderProfile, renderProfileDetailed, renderProfileWithCurated };