dsh-plugin-om 0.0.15 → 0.0.17

package/dist/index.mjs

@@ -19,8 +19,15 @@ const HISTORY_TIP = "当前块是历史消息的压缩产物，不要复述";
 /**
 * 「完整消息」定义（提示词 / recall 工具描述 / 块顶注释共用同一字符串）。
 * 完整消息是摘要日志与 recall 共用的定位单位；首条 index 为 0，按会话顺序递增、全局稳定。
+* 用户消息指 user_message 中 source.kind 为 user 的部分；其余部分（宿主注入的上下文等）
+* 为系统消息，同样是一条完整消息。
 */
-const COMPLETE_MESSAGE_DEFINITION = "`用户消息`，`模型输出文本`和`具有result的toolcall`被视作`完整消息`。首条`完整消息`的index是0，后续的index递增。";
+const COMPLETE_MESSAGE_DEFINITION = "`完整消息`被定义为`用户消息`，`系统消息`，`模型输出文本`和`具有result的toolcall`的集合。首条`完整消息`的index是0，后续的index递增。";
+/** 判定 user/message 的 source 是否为本插件自产（压缩日志机制消息；含兼容旧宿主 checkpoint 标记 'compact'）。这类消息不占完整消息 index。 */
+function isPluginOwnedSource(source) {
+	if (source?.kind !== "plugin") return false;
+	return source.plugin === "dsh-plugin-om" || source.plugin === "compact";
+}
 //#endregion
 //#region src/utils.ts
 /** 判断值是否为普通对象：typeof object 且非 null 且非数组（类型收窄用）。 */
@@ -42,6 +49,15 @@ function blocksToText(blocks) {
 	for (const block of blocks) if (isRecord(block) && block.type === "text" && typeof block.text === "string") out.push(block.text);
 	return out.join("");
 }
+/** 消息内容的字符数：递归计入 text 块与 tool-result 内嵌文本（与宿主 token 估算口径一致）。 */
+function textCharCount(message) {
+	if (!message || !Array.isArray(message.content)) return 0;
+	/** 累计字符数。 */
+	let total = 0;
+	for (const block of message.content) if (block.type === "text") total += block.text.length;
+	else if (block.type === "tool-result") total += blocksToText(block.content).length;
+	return total;
+}
 /** 面向 recall 的完整消息呈现：text 原样；tool-call 展开（参数=代码）；tool-result 取文本。 */
 function renderMessageText(message) {
 	if (!message || !Array.isArray(message.content)) return "";
@@ -79,7 +95,22 @@ function routedTarget(session) {
 //#endregion
 //#region src/log-index.ts
 /**
-* 完整消息索引：按日志顺序把消息事件折叠为完整消息序列（三类，见文件头）。
+* 会话日志索引：完整消息索引（index 定位完整消息，recall 与摘要共用同一套编号），
+* 以及表层节点定位辅助。事件日志仅追加（被遮蔽的事件仍可读，recall 依赖此性质）。
+*
+* 完整消息是摘要日志与 recall 共用的定位单位，分四类：
+*  - user：用户消息（user/message 中 source.kind === 'user'）占一条；
+*  - sys：系统消息（user/message 中其余 source.kind 的部分，如宿主注入的上下文）
+*    占一条；压缩日志中以 <sys type="KIND" index="N"> 空块表示（内容不进入输入）；
+*  - assistant：模型输出文本（assistant/message 中的文本块）占一条；
+*  - toolcall：单个工具调用及其结果占一条（同一条 AI 消息里的文本与工具调用拆开，
+*    tool/result 按 source.callId 匹配其 tool-call；未匹配的 result 独立成条，防御）。
+* 本插件自产的压缩日志消息（source.kind === 'plugin' 且 plugin 为本插件标识）不占 index。
+* index 从 0 起、按日志顺序递增、只追加不重排 → 会话内全局稳定，
+* 压缩后旧摘要条目引用的 index 仍然有效。
+*/
+/**
+* 完整消息索引：按日志顺序把消息事件折叠为完整消息序列（四类，见文件头）。
 * 工具调用结果按 source.callId 匹配其 tool-call 并入该条；未匹配的 result 独立成条（防御）。
 * 插件在 agent/pre-step 触发压缩（日志 call-result 完备），因此压缩时不存在未闭合的
 * tool-call；索引对未闭合调用不设特殊处理。
@@ -96,12 +127,20 @@ function indexCompleteMessages(session) {
 		const event = events[seq];
 		if (!event) continue;
 		if (event.type === "user/message") {
-			if (event.data.source?.kind === "plugin") continue;
-			cms.push({
+			/** 事件 source（区分用户消息与宿主注入/插件消息）。 */
+			const source = event.data.source;
+			if (isPluginOwnedSource(source)) continue;
+			if (source?.kind === "user") cms.push({
 				index: cms.length,
 				type: "user",
 				seqs: [seq]
 			});
+			else cms.push({
+				index: cms.length,
+				type: "sys",
+				seqs: [seq],
+				...source?.kind === void 0 ? {} : { kind: source.kind }
+			});
 		} else if (event.type === "assistant/message") {
 			/** 助手消息（含文本与 tool-call 块）。 */
 			const message = event.data.message;
@@ -153,13 +192,13 @@ function indexCompleteMessages(session) {
 }
 /**
 * 渲染一条完整消息的文本（recall 输出 / new 模式输入共用）：
-*  - user：消息原文；
+*  - user / sys：消息原文；
 *  - assistant：仅文本块；
 *  - toolcall：调用块（工具名 + 参数）+ 结果文本（pruner 裁剪超大结果）。
 */
 function renderCompleteMessage(session, cm, pruner) {
-	if (cm.type === "user") {
-		/** 用户消息事件（seq 缺失则无法渲染）。 */
+	if (cm.type === "user" || cm.type === "sys") {
+		/** 用户/系统消息事件（seq 缺失则无法渲染）。 */
 		const seq = cm.seqs[0];
 		const event = seq === void 0 ? void 0 : session.events[seq];
 		/** 派生的消息对象。 */
@@ -7382,13 +7421,14 @@ function buildHistoryPrompt() {
 		"- <history> 是历史消息的记录块：输入与输出都是合法的 <history> 块，块内条目是「模型消息 + index」的表达形式。",
 		`- 完整消息：${COMPLETE_MESSAGE_DEFINITION}`,
 		"- <user_message index=\"N\">：用户消息条目（N 为该条完整消息的 index；文本原样，图片/文件等以注释补充）。",
-		"- <system-reminder>：可能出现在 <user_message> 内的提醒块（宿主注入），视为真实元素；压缩产物中保留其块结构与内容原样（标签不转义）。",
+		"- <sys type=\"(kind)\" index=\"N\">：系统消息条目（user_message 中非 kind:user 的部分，如宿主注入的上下文），块中为空，内容不进入压缩输入。",
 		"- <reasoning>：模型的思考过程，仅作压缩参考，产物中不要出现。",
 		"- <assistant index=\"N\">：单条完整消息（模型输出文本，或 toolcall 及其 result）。",
 		"- <assistant start=\"A\" end=\"B\">：多条连续完整消息聚合的模块（A/B 为模块首尾完整消息的 index）。",
 		"",
 		"【压缩要求】",
 		"- 完整保留用户消息：<user_message> 条目逐条保留原文，不概括、不省略。",
+		"- 完整保留系统消息：<sys> 条目逐条原样保留（type 与 index 不变），块中为空，不概括、不省略、不填充内容。",
 		"- <reasoning> 只作参考，输出产物中不包含 <reasoning> 块。",
 		"- 将具有关联性的 <assistant> 消息按内在逻辑连贯性划分为连续模块，聚合为 <assistant start=\"\" end=\"\"> 块：块内描述模块的目的、行为与结果；涉及的具体文件保留在模块内容中，多个前缀相同的路径合并简写。",
 		"- 单条重要的完整消息以 <assistant index=\"\"> 单独呈现，内容不受限制。",
@@ -7400,6 +7440,7 @@ function buildHistoryPrompt() {
 		"<user_message index=\"(index)\">",
 		"(user 消息原文)",
 		"</user_message>",
+		"<sys type=\"(kind)\" index=\"(index)\"></sys>",
 		"<assistant start=\"(起始 index)\" end=\"(结束 index)\">",
 		"(模块的目的、行为与结果摘要)",
 		"</assistant>",
@@ -7411,73 +7452,6 @@ function buildHistoryPrompt() {
 		"【数据源】下方的 <history> 消息记录是本次要压缩的全部消息；压缩结果作为一个新的 <history> 块输出。"
 	].join("\n");
 }
-/** 合法 <system-reminder> 块匹配：完整开闭标签对（非贪婪最短闭合；不匹配缺闭标签的残缺文本）。 */
-const SYSTEM_REMINDER_RE = /<system-reminder>[\s\S]*?<\/system-reminder>/g;
-/**
-* 解析 system-reminder 块（合法性判定）：块可被 XML 解析且根元素为 <system-reminder> 时
-* 视为合法块并返回其根元素；否则（缺闭标签 / 内容含非法字符等）返回 null，按普通文本处理。
-*/
-function parseSystemReminder(block) {
-	try {
-		/** 根元素（必须为 system-reminder）。 */
-		const root = new import_lib.DOMParser().parseFromString(block, "text/xml").documentElement;
-		return root && root.nodeName === "system-reminder" ? root : null;
-	} catch {
-		return null;
-	}
-}
-/**
-* 把解析出的 system-reminder 元素按原样复制进目标文档（标签与内容均不转义）：
-* xmldom 无 importNode，手动递归复制元素 / 文本 / CDATA / 注释节点。
-*/
-function copySystemReminder(doc, source) {
-	/** 目标元素（同标签名）。 */
-	const el = doc.createElement(source.nodeName);
-	for (let i = 0; i < source.attributes.length; i += 1) {
-		/** 源属性（名称 + 值原样复制）。 */
-		const attr = source.attributes[i];
-		if (attr) el.setAttribute(attr.name, attr.value);
-	}
-	for (const child of Array.from(source.childNodes)) if (child.nodeType === 1) el.appendChild(copySystemReminder(doc, child));
-	else if (child.nodeType === 3) el.appendChild(doc.createTextNode(child.nodeValue ?? ""));
-	else if (child.nodeType === 4) el.appendChild(doc.createCDATASection(child.nodeValue ?? ""));
-	else if (child.nodeType === 8) el.appendChild(doc.createComment(child.nodeValue ?? ""));
-	return el;
-}
-/**
-* 追加用户文本到 user_message 元素：合法 <system-reminder> 块整块原样插入（不转义），
-* 其余文本按普通文本 XML 转义（createTextNode）。
-*/
-function appendUserText(doc, el, text) {
-	/** 已消费的文本位置。 */
-	let last = 0;
-	for (const m of text.matchAll(SYSTEM_REMINDER_RE)) {
-		/** 匹配起点（缺省 0）。 */
-		const start = m.index ?? 0;
-		/** 块前的普通文本（转义）。 */
-		if (start > last) el.appendChild(doc.createTextNode(text.slice(last, start)));
-		/** 块原文。 */
-		const block = m[0];
-		/** 合法判定（可被 XML 解析）。 */
-		const parsed = parseSystemReminder(block);
-		if (parsed !== null) el.appendChild(copySystemReminder(doc, parsed));
-		else el.appendChild(doc.createTextNode(block));
-		/** 消费位置推进到块尾。 */
-		last = start + block.length;
-	}
-	/** 末尾剩余普通文本（转义）。 */
-	if (last < text.length) el.appendChild(doc.createTextNode(text.slice(last)));
-}
-/**
-* 提取文本中全部合法的 <system-reminder> 块（完整开闭标签对且内容可被 XML 解析）；
-* 供渲染（原样插入）与未压缩消息测量（不计入）共用；不合法部分按普通文本处理。
-*/
-function legitimateSystemReminderBlocks(text) {
-	/** 合法块缓冲区。 */
-	const out = [];
-	for (const m of text.matchAll(SYSTEM_REMINDER_RE)) if (parseSystemReminder(m[0]) !== null) out.push(m[0]);
-	return out;
-}
 /** 渲染用户消息条目（DOM 元素）：文本块原样；图片/文件等非文本块以注释补充（说明传入了什么）。 */
 function renderUserEntry(doc, session, cm) {
 	/** 用户消息事件（seq 缺失则无法渲染）。 */
@@ -7492,7 +7466,7 @@ function renderUserEntry(doc, session, cm) {
 	/** 是否存在可输出内容（文本或注释）。 */
 	let hasContent = false;
 	for (const block of message.content) if (block.type === "text") {
-		appendUserText(doc, el, String(block.text));
+		el.appendChild(doc.createTextNode(String(block.text)));
 		hasContent = true;
 	} else if (block.type === "image") {
 		/** 图片附件元数据（名称 / 媒体类型 / 尺寸 / 字节数）。 */
@@ -7512,11 +7486,12 @@ function renderUserEntry(doc, session, cm) {
 }
 /**
 * 渲染完整消息记录（观察输入，new 模式）：输出一个合法的 <history> 块——
-*  - user → <user_message index="N">（文本原样，其中合法 <system-reminder> 块整块原样保留、不转义；图片/文件注释）；
+*  - user → <user_message index="N">（文本原样；图片/文件注释）；
+*  - sys → <sys type="KIND" index="N"></sys>（系统消息空块，内容不进入压缩输入）；
 *  - 每条 assistant 消息的 reasoning → <reasoning>（参考条目，产物中没有）；
 *  - assistant / toolcall → <assistant index="N">（模型输出文本 / toolcall&result 原样）。
 * 文本经 XML 序列化自动转义（用户输入 / 文本 / reasoning 中的特殊字符不破坏 XML 合法性）。
-* 仅渲染 seqs 全部落在给定集合内的完整消息（插件自产消息天然不占位）。
+* 仅渲染 seqs 全部落在给定集合内的完整消息（本插件自产消息天然不占位）。
 */
 function renderMessages(session, seqs) {
 	/** 遮蔽 seq 集合。 */
@@ -7542,6 +7517,15 @@ function renderMessages(session, seqs) {
 	const entries = [];
 	for (const cm of indexCompleteMessages(session)) {
 		if (!cm.seqs.every((seq) => shadowed.has(seq))) continue;
+		if (cm.type === "sys") {
+			/** sys 元素（type=source.kind，index=完整消息序号）。 */
+			const sysEl = doc.createElement("sys");
+			sysEl.setAttribute("type", cm.kind ?? "");
+			sysEl.setAttribute("index", String(cm.index));
+			sysEl.appendChild(doc.createTextNode(""));
+			entries.push(sysEl);
+			continue;
+		}
 		if (cm.type === "user") {
 			/** 用户消息条目（无文本且无注释则跳过）。 */
 			const rendered = renderUserEntry(doc, session, cm);
@@ -7640,7 +7624,7 @@ function buildSummaryOptions(session, instruction, contextText, maxTokens, targe
 	};
 }
 /** 产出日志后插入首个 <history> 后的格式说明（XML 注释，完整消息定义 + 条目标签语义）。 */
-const HISTORY_FORMAT_NOTE = `<!-- 完整消息：${COMPLETE_MESSAGE_DEFINITION} <user_message index="N"> 与 <assistant index="N"> 表示单条完整消息，<assistant start="A" end="B"> 表示连续模块，start/end 是首尾完整消息的 index -->`;
+const HISTORY_FORMAT_NOTE = `<!-- 完整消息：${COMPLETE_MESSAGE_DEFINITION} <TAG index="N">表示单条完整消息，<TAG start="A" end="B"> 表示连续模块，start/end 是首尾完整消息的 index；<sys type="KIND" index="N"> 表示被压缩的系统消息，块中为空 -->`;
 /** 读取元素整数属性（非负整数；缺失 / 非数字返回 undefined）。 */
 function intAttr(el, name) {
 	/** 属性原始值（缺失为 null）。 */
@@ -7653,7 +7637,7 @@ function intAttr(el, name) {
 * 用 XML 解析器解析一个 <history> 块（结构合法性校验）：
 *  - 非法 XML（标签不匹配 / 未闭合 / 多根等）→ null；
 *  - 根节点必须是 <history>；
-*  - 顶层只允许 user_message / assistant 条目元素（其余元素类型视为不合法）；
+*  - 顶层只允许 user_message / assistant / sys 条目元素（其余元素类型视为不合法）；
 *  - 出现 <reasoning> 元素时标记 hasReasoning（产物不允许）。
 * 条目按文档顺序提取（index / start / end 属性缺失或不合法 → 不合法）。
 */
@@ -7694,6 +7678,14 @@ function parseHistoryBlock(xml) {
 				kind: "user",
 				index
 			});
+		} else if (tag === "sys") {
+			/** index 属性（缺失/非法 → 不合法）。 */
+			const index = intAttr(el, "index");
+			if (index === void 0) return null;
+			entries.push({
+				kind: "sys",
+				index
+			});
 		} else if (tag === "assistant") {
 			/** 单条 index 或模块 start..end（二选一）。 */
 			const index = intAttr(el, "index");
@@ -7918,10 +7910,9 @@ function reflectExpectedEnd(contextText) {
 */
 function historyTextOf(event) {
 	if (event?.type !== "user/message") return void 0;
-	/** 消息 source（插件自产消息的标记）。 */
+	/** 消息 source（本插件自产消息的标记；含兼容旧宿主 checkpoint 标记）。 */
 	const source = event.data.source;
-	if (source?.kind !== "plugin") return void 0;
-	if (source.plugin !== "compact" && source.plugin !== "dsh-plugin-om") return void 0;
+	if (!isPluginOwnedSource(source)) return void 0;
 	/** 消息纯文本。 */
 	const text = blocksToText(event.data.content);
 	/** 首个 <history 出现位置（无则非压缩日志）。 */
@@ -7932,26 +7923,22 @@ function historyTextOf(event) {
 	if (!rest.startsWith(">") && !rest.startsWith(" tip=")) return void 0;
 	return text;
 }
-/**
-* 消息文本中合法 <system-reminder> 块的 token 估算（4 字符 ≈ 1 token，与 estimateTextTokens
-* 一致）：宿主注入的提醒不计入未压缩消息，避免推高观察阈值触发压缩。
-*/
-function systemReminderTokens(message) {
-	/** 消息内容块（非记录或非数组则无文本可计）。 */
-	const content = isRecord(message) && Array.isArray(message.content) ? message.content : null;
-	if (!content) return 0;
-	/** token 合计。 */
-	let total = 0;
-	for (const block of content) {
-		if (!isRecord(block) || block.type !== "text" || typeof block.text !== "string") continue;
-		for (const sr of legitimateSystemReminderBlocks(block.text)) total += estimateTextTokens(sr);
-	}
-	return total;
+/** 提取 <history> 块内文（去掉开/闭标签与首尾空白；非块文本原样返回）。 */
+function historyInnerText(text) {
+	/** 闭标签。 */
+	const closeTag = `</${HISTORY_TAG}>`;
+	const close = text.lastIndexOf(closeTag);
+	if (close === -1) return text;
+	const open = text.indexOf(`<${HISTORY_TAG}`);
+	if (open === -1) return text;
+	const gt = text.indexOf(">", open);
+	if (gt === -1 || gt >= close) return text;
+	return text.slice(gt + 1, close).trim();
 }
 /**
 * 未压缩消息 token 估算：最后一个 <history> 块之后的表层节点合计
 * （其前含自身视为已压缩，不计入观察阈值衡量对象；无压缩日志时计全部）。
-* 用户消息中合法 <system-reminder> 块（宿主注入的提醒）的 token 扣除，不计入阈值。
+* 系统消息（user/message 中非 kind:user 的部分，如宿主注入的上下文）不计入阈值。
 */
 function measureUncompressedTokens(session, meter) {
 	/** 压缩边界（最后一个 history 块的 seq；无则 undefined）。 */
@@ -7969,9 +7956,10 @@ function measureUncompressedTokens(session, meter) {
 		const event = session.events[seq];
 		const message = event ? session.deriveEventMessage(event) : null;
 		if (!message) continue;
-		/** 消息 token 估算（用户消息扣除其中合法 system-reminder 块，宿主提醒不计入未压缩消息）。 */
-		const tokens = event?.type === "user/message" ? Math.max(0, meter.estimateMessage(message) - systemReminderTokens(message)) : meter.estimateMessage(message);
-		total += tokens;
+		if (event?.type === "user/message") {
+			if (event.data.source?.kind !== "user") continue;
+		}
+		total += meter.estimateMessage(message);
 	}
 	return total;
 }
@@ -8078,7 +8066,8 @@ function appendCompactionStart(session, lifecycle) {
 * summary 为完整合并后的 <history> 内文；usage 由摘要调用提取（无则省略）。
 */
 function appendCompactionSummary(session, data) {
-	return session.append("compaction/summary", {
+	/** summary 事件载荷（宿主类型 + 插件扩展 shadowedCharCount；宿主 append 不做 schema 剥离，扩展字段原样持久化）。 */
+	const payload = {
 		compactionId: data.lifecycle.compactionId,
 		summary: [{
 			type: "text",
@@ -8087,11 +8076,13 @@ function appendCompactionSummary(session, data) {
 		shadowedRange: data.shadowedRange,
 		shadowedSeqs: data.shadowedSeqs,
 		shadowedTokenCount: data.shadowedTokenCount,
+		shadowedCharCount: data.shadowedCharCount,
 		provider: data.provider,
 		model: data.model,
 		maxTokens: data.maxTokens,
 		...data.usage === void 0 ? {} : { usage: data.usage }
-	}).seq;
+	};
+	return session.append("compaction/summary", payload).seq;
 }
 /** 追加 compaction/end（log-only，结束生命周期；error 记录失败原因）。 */
 function appendCompactionEnd(session, lifecycle, error) {
@@ -8144,6 +8135,8 @@ async function reflectPass(ctx, agent, config, window, target, signal) {
 	const threshold = Math.floor(window * config.historyMergeRatio);
 	/** 全部块 token 估算合计（摘要总长）。 */
 	const tokens = blocks.reduce((total, block) => total + estimateTextTokens(block.text), 0);
+	/** 被压缩块区段的字符数合计（压缩前内文长度；UI 标题统计用，与观察路径一致只计内容不计标签）。 */
+	const shadowedCharCount = blocks.reduce((total, block) => total + historyInnerText(block.text).length, 0);
 	if (tokens < threshold) {
 		logger.step(`反思：摘要 ${tokens} tokens < 阈值 ${threshold}，跳过`);
 		return;
@@ -8197,6 +8190,7 @@ async function reflectPass(ctx, agent, config, window, target, signal) {
 			},
 			shadowedSeqs: blockSeqs,
 			shadowedTokenCount: tokens,
+			shadowedCharCount,
 			provider: target.provider,
 			model: target.model,
 			maxTokens: config.compressMaxTokens,
@@ -8290,6 +8284,14 @@ async function observePass(ctx, agent, config, window, tailCount, target, signal
 		const message = event ? session.deriveEventMessage(event) : null;
 		return total + (message ? ctx.tokenMeter.estimateMessage(message) : 0);
 	}, 0);
+	/** 被替换消息的字符数合计（压缩前文本长度；UI 标题统计用，递归计入 tool-result 内嵌文本）。 */
+	const shadowedCharCount = replaceSeqs.reduce((total, seq) => {
+		/** 当前表层事件。 */
+		const event = session.events[seq];
+		/** 事件对应的消息（取文本块字符数）。 */
+		const message = event ? session.deriveEventMessage(event) : null;
+		return total + (message ? textCharCount(message) : 0);
+	}, 0);
 	/** 本次压缩生命周期（compactionId + 当前轮次；摘要成功后才写入日志）。 */
 	const lifecycle = {
 		compactionId: newCompactionId(),
@@ -8309,6 +8311,7 @@ async function observePass(ctx, agent, config, window, tailCount, target, signal
 			},
 			shadowedSeqs: replaceSeqs,
 			shadowedTokenCount,
+			shadowedCharCount,
 			provider: target.provider,
 			model: target.model,
 			maxTokens: config.compressMaxTokens,
@@ -8684,7 +8687,8 @@ function resolveConfig(raw) {
 //#region src/recall.ts
 /**
 * recall 工具：按「完整消息」序号（index）回看原始会话（start/end 为完整消息 index，
-* offset 为相对 start 的完整消息步数）。完整消息即 `用户消息`，`模型输出文本`和`具有result的
+* offset 为相对 start 的完整消息步数）。完整消息即 `用户消息`（user_message 中 kind 为 user
+* 的部分）、`系统消息`（user_message 中其余 kind 的部分）、`模型输出文本`和`具有result的
 * toolcall`；首条完整消息的 index 为 0，后续递增、会话内全局稳定，与摘要日志条目同一套编号。
 * recall 自身不设输出上限：超大的工具结果由 tool-result-pruner 裁剪（pruneContent），
 * 输出 token 由 pruner 配置控制。
@@ -8718,20 +8722,20 @@ function parseRecallArgs(raw) {
 function buildRecallTool(getPruner) {
 	return {
 		name: "recall",
-		description: "根据完整消息序号（index），回看指定区间的过往消息。`用户消息`，`模型输出文本`和`具有result的toolcall`被视作`完整消息`。首条`完整消息`的index是0，后续的index递增。start 必须传入，是区间的基准；end 和 offset 二选一：end 指定另一个边界（含两端，与 start 的位置关系不影响结果），offset 指定区间包含的完整消息数量（正数向后、负数向前）。",
+		description: `${COMPLETE_MESSAGE_DEFINITION}此工具可以精确查询完整消息。用index指定一个区间，返回区间内所有完整消息的内容。`,
 		parameters: {
 			start: {
 				type: "number",
-				description: "完整消息序号（index），区间的基准边界",
+				description: "完整消息序号（index），作为基准边界，和end或offset配合，指定区间",
 				required: true
 			},
 			end: {
 				type: "number",
-				description: "与 offset 互斥，指定区间的另一个边界（含）。与 start 的位置关系不影响结果。"
+				description: "与 offset 互斥，指定区间的另一个边界。"
 			},
 			offset: {
 				type: "number",
-				description: "与 end 互斥，指定区间包含的完整消息数量。传入正数查看 start 之后的若干条，负数则是之前的。"
+				description: "与 end 互斥。相对 start 的步数：正数向后、负数向前。"
 			}
 		},
 		output: {
@@ -8795,7 +8799,8 @@ function buildRecallTool(getPruner) {
 //#region src/semantic-recall.ts
 /**
 * recall-semantic 工具：按自然语言 query 对会话全部完整消息（含被压缩/遮蔽的）做语义
-* 检索，返回最匹配的完整消息与匹配说明。完整消息即 `用户消息`，`模型输出文本`和`具有result的
+* 检索，返回最匹配的完整消息与匹配说明。完整消息即 `用户消息`（user_message 中 kind 为 user
+* 的部分）、`系统消息`（user_message 中其余 kind 的部分）、`模型输出文本`和`具有result的
 * toolcall`；首条完整消息的 index 为 0，后续递增、会话内全局稳定。
 *
 * - 参数：query 必填；top_k（默认 3，1-10）；start/end/offset 限定检索区间
@@ -8898,7 +8903,7 @@ function matchExplanation(query, text, score) {
 	return `相似度 ${score.toFixed(3)}${keywords}`;
 }
 /** 模型未就绪时返回给模型的文案（告知即可；下载完成后无需另行通知，直接再次调用）。 */
-const SEMANTIC_MODEL_NOT_READY_MESSAGE = "语义检索暂不可用：本地嵌入模型尚未就绪（正在后台下载约 113MB；下载完成后无需提示，直接再次调用本工具即可。若下载失败，下次调用会自动重试）。可稍后重试，或先用 recall 工具按完整消息 index 精确检索。";
+const SEMANTIC_MODEL_NOT_READY_MESSAGE = "语义检索暂不可用，本地向量模型尚未就绪。";
 /** 构建 recall-semantic 工具定义（embedder/modelStatus 可注入，测试传替身；缺省用本地模型）。 */
 function buildSemanticRecallTool(options) {
 	/** pruner 获取器（可选，裁剪超大工具结果）。 */
@@ -8907,7 +8912,7 @@ function buildSemanticRecallTool(options) {
 	const embed = options?.embedder ?? ((texts) => getEmbedder().then((fn) => fn(texts)));
 	return {
 		name: "recall-semantic",
-		description: "按语义（自然语言含义）在会话全部完整消息中检索：`用户消息`，`模型输出文本`和`具有result的toolcall`被视作`完整消息`。首条`完整消息`的index是0，后续的index递增。用一句话描述你要找的内容（可混用中英文与代码术语）。返回最匹配的若干条完整消息、index 与匹配说明；如需精确定位某个 index 周边的消息，请再用 recall 工具。",
+		description: `${COMPLETE_MESSAGE_DEFINITION}此工具可以按自然语言含义，检索最符合的完整消息。默认在全消息范围搜索，可以指定区间。`,
 		parameters: {
 			query: {
 				type: "string",
@@ -8920,15 +8925,15 @@ function buildSemanticRecallTool(options) {
 			},
 			start: {
 				type: "number",
-				description: "完整消息序号（index），可选。限定检索区间：以该条为基准边界（意义同 recall）。缺省检索全部消息。区间不合法（越界）时自动回退全量检索并在结果中说明。"
+				description: "完整消息序号（index），可选。作为基准边界，和end或offset配合，指定搜索区间。"
 			},
 			end: {
 				type: "number",
-				description: "与 offset 互斥，限定区间的另一个边界（含；意义同 recall）。"
+				description: "必须和start配合使用，与 offset 互斥，指定搜索区间的另一个边界。"
 			},
 			offset: {
 				type: "number",
-				description: "与 end 互斥。相对 start 的步数：正数向后、负数向前（意义同 recall）。"
+				description: "必须和start配合使用，与 end 互斥。相对 start 的步数：正数向后、负数向前。"
 			}
 		},
 		output: {

package/dist/log-index.d.ts

@@ -1,16 +1,3 @@
-/**
- * 会话日志索引：完整消息索引（index 定位完整消息，recall 与摘要共用同一套编号），
- * 以及表层节点定位辅助。事件日志仅追加（被遮蔽的事件仍可读，recall 依赖此性质）。
- *
- * 完整消息是摘要日志与 recall 共用的定位单位，分三类：
- *  - user：用户消息（user/message）占一条；
- *  - assistant：模型输出文本（assistant/message 中的文本块）占一条；
- *  - toolcall：单个工具调用及其结果占一条（同一条 AI 消息里的文本与工具调用拆开，
- *    tool/result 按 source.callId 匹配其 tool-call；未匹配的 result 独立成条，防御）。
- * 插件自产消息（<history>、运行时快照等 source.kind === 'plugin'）不占 index。
- * index 从 0 起、按日志顺序递增、只追加不重排 → 会话内全局稳定，
- * 压缩后旧摘要条目引用的 index 仍然有效。
- */
 import type { CompleteMessage, MessageIndex, Session, SessionEvent } from './types.ts';
 /** 工具结果裁剪器结构（tool-result-pruner；超大结果渲染前裁剪）。 */
 export type PrunerLike = {
@@ -26,7 +13,7 @@ export declare function messageIdOfEvent(event: SessionEvent | undefined): strin
 /** 消息索引：按日志顺序列出全部消息事件，并按 message_id 定位其在消息序列中的下标。 */
 export declare function indexMessages(session: Session): MessageIndex;
 /**
- * 完整消息索引：按日志顺序把消息事件折叠为完整消息序列（三类，见文件头）。
+ * 完整消息索引：按日志顺序把消息事件折叠为完整消息序列（四类，见文件头）。
  * 工具调用结果按 source.callId 匹配其 tool-call 并入该条；未匹配的 result 独立成条（防御）。
  * 插件在 agent/pre-step 触发压缩（日志 call-result 完备），因此压缩时不存在未闭合的
  * tool-call；索引对未闭合调用不设特殊处理。
@@ -34,7 +21,7 @@ export declare function indexMessages(session: Session): MessageIndex;
 export declare function indexCompleteMessages(session: Session): CompleteMessage[];
 /**
  * 渲染一条完整消息的文本（recall 输出 / new 模式输入共用）：
- *  - user：消息原文；
+ *  - user / sys：消息原文；
  *  - assistant：仅文本块；
  *  - toolcall：调用块（工具名 + 参数）+ 结果文本（pruner 裁剪超大结果）。
  */

package/dist/log-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-index.d.ts","sourceRoot":"","sources":["../src/log-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EAEZ,OAAO,EACP,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG;IAAE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA0B5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CAkEzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAgER"}
+{"version":3,"file":"log-index.d.ts","sourceRoot":"","sources":["../src/log-index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EAEZ,OAAO,EACP,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG;IAAE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,EAAE,GAAG,IAAI,CAAA;CAAE,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CA0B5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA2EzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAgER"}

package/dist/recall.d.ts

@@ -1,6 +1,7 @@
 /**
  * recall 工具：按「完整消息」序号（index）回看原始会话（start/end 为完整消息 index，
- * offset 为相对 start 的完整消息步数）。完整消息即 `用户消息`，`模型输出文本`和`具有result的
+ * offset 为相对 start 的完整消息步数）。完整消息即 `用户消息`（user_message 中 kind 为 user
+ * 的部分）、`系统消息`（user_message 中其余 kind 的部分）、`模型输出文本`和`具有result的
  * toolcall`；首条完整消息的 index 为 0，后续递增、会话内全局稳定，与摘要日志条目同一套编号。
  * recall 自身不设输出上限：超大的工具结果由 tool-result-pruner 裁剪（pruneContent），
  * 输出 token 由 pruner 配置控制。

package/dist/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAQzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAsFzE"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAQzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAYxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAoFzE"}

package/dist/semantic-recall.d.ts

@@ -1,6 +1,7 @@
 /**
  * recall-semantic 工具：按自然语言 query 对会话全部完整消息（含被压缩/遮蔽的）做语义
- * 检索，返回最匹配的完整消息与匹配说明。完整消息即 `用户消息`，`模型输出文本`和`具有result的
+ * 检索，返回最匹配的完整消息与匹配说明。完整消息即 `用户消息`（user_message 中 kind 为 user
+ * 的部分）、`系统消息`（user_message 中其余 kind 的部分）、`模型输出文本`和`具有result的
  * toolcall`；首条完整消息的 index 为 0，后续递增、会话内全局稳定。
  *
  * - 参数：query 必填；top_k（默认 3，1-10）；start/end/offset 限定检索区间
@@ -45,7 +46,7 @@ export declare function tokenize(text: string): Set<string>;
 /** 命中消息的匹配说明行：相似度 + 与 query 共有的关键词（最多 8 个）。 */
 export declare function matchExplanation(query: string, text: string, score: number): string;
 /** 模型未就绪时返回给模型的文案（告知即可；下载完成后无需另行通知，直接再次调用）。 */
-export declare const SEMANTIC_MODEL_NOT_READY_MESSAGE = "\u8BED\u4E49\u68C0\u7D22\u6682\u4E0D\u53EF\u7528\uFF1A\u672C\u5730\u5D4C\u5165\u6A21\u578B\u5C1A\u672A\u5C31\u7EEA\uFF08\u6B63\u5728\u540E\u53F0\u4E0B\u8F7D\u7EA6 113MB\uFF1B\u4E0B\u8F7D\u5B8C\u6210\u540E\u65E0\u9700\u63D0\u793A\uFF0C\u76F4\u63A5\u518D\u6B21\u8C03\u7528\u672C\u5DE5\u5177\u5373\u53EF\u3002\u82E5\u4E0B\u8F7D\u5931\u8D25\uFF0C\u4E0B\u6B21\u8C03\u7528\u4F1A\u81EA\u52A8\u91CD\u8BD5\uFF09\u3002\u53EF\u7A0D\u540E\u91CD\u8BD5\uFF0C\u6216\u5148\u7528 recall \u5DE5\u5177\u6309\u5B8C\u6574\u6D88\u606F index \u7CBE\u786E\u68C0\u7D22\u3002";
+export declare const SEMANTIC_MODEL_NOT_READY_MESSAGE = "\u8BED\u4E49\u68C0\u7D22\u6682\u4E0D\u53EF\u7528\uFF0C\u672C\u5730\u5411\u91CF\u6A21\u578B\u5C1A\u672A\u5C31\u7EEA\u3002";
 /** 构建 recall-semantic 工具定义（embedder/modelStatus 可注入，测试传替身；缺省用本地模型）。 */
 export declare function buildSemanticRecallTool(options?: {
     getPruner?: () => unknown;

package/dist/semantic-recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBAUjC,CAAC;AAEL,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAWxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CA2Bb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,+CAA+C;AAC/C,eAAO,MAAM,gCAAgC,0iBACoE,CAAC;AAElH,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD,GAAG,cAAc,CAuHjB"}
+{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBAUjC,CAAC;AAEL,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,+CAA+C;AAC/C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAWxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CA2Bb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,+CAA+C;AAC/C,eAAO,MAAM,gCAAgC,6HAAyB,CAAC;AAEvE,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD,GAAG,cAAc,CAqHjB"}

package/dist/summarize.d.ts

@@ -5,9 +5,10 @@
  * 输入与输出都是合法的 <history> 块（模型消息 + index 的表达形式），先定义块、要求压缩、
  * 再给出数据源（下方 <history> 消息记录）。
  *
- * 观察输入由 renderMessages 渲染为 <history> 块：用户消息文本原样（其中合法
- * <system-reminder> 块整块原样保留、不转义；图片/文件以注释补充）、
- * <reasoning> 参考条目（产物中没有）、assistant 文本与 toolcall&result 原样。
+ * 观察输入由 renderMessages 渲染为 <history> 块：用户消息文本原样（图片/文件以
+ * 注释补充）、系统消息（user_message 中非 kind:user 的部分）渲染为
+ * <sys type="KIND" index="N"> 空块（内容不进入输入）、<reasoning> 参考条目
+ * （产物中没有）、assistant 文本与 toolcall&result 原样。
  * 输出经 extractSummaryLog 校验：合法 <history> 块、不含 <reasoning>、index/start/end 连续
  * （与预期覆盖区间一致），失败按 config.compressRetryCount 重试。
  * token usage 从流式响应的 usage chunk 提取，归入主会话记录。仅主会话生效（index.ts 守卫）。
@@ -20,18 +21,14 @@ import { type RoutedTarget } from './utils.ts';
  * index/start/end 连续）、输出格式（一个合法 <history> 块，无 reasoning）、数据源说明。
  */
 export declare function buildHistoryPrompt(): string;
-/**
- * 提取文本中全部合法的 <system-reminder> 块（完整开闭标签对且内容可被 XML 解析）；
- * 供渲染（原样插入）与未压缩消息测量（不计入）共用；不合法部分按普通文本处理。
- */
-export declare function legitimateSystemReminderBlocks(text: string): string[];
 /**
  * 渲染完整消息记录（观察输入，new 模式）：输出一个合法的 <history> 块——
- *  - user → <user_message index="N">（文本原样，其中合法 <system-reminder> 块整块原样保留、不转义；图片/文件注释）；
+ *  - user → <user_message index="N">（文本原样；图片/文件注释）；
+ *  - sys → <sys type="KIND" index="N"></sys>（系统消息空块，内容不进入压缩输入）；
  *  - 每条 assistant 消息的 reasoning → <reasoning>（参考条目，产物中没有）；
  *  - assistant / toolcall → <assistant index="N">（模型输出文本 / toolcall&result 原样）。
  * 文本经 XML 序列化自动转义（用户输入 / 文本 / reasoning 中的特殊字符不破坏 XML 合法性）。
- * 仅渲染 seqs 全部落在给定集合内的完整消息（插件自产消息天然不占位）。
+ * 仅渲染 seqs 全部落在给定集合内的完整消息（本插件自产消息天然不占位）。
  */
 export declare function renderMessages(session: Session, seqs: readonly number[]): string;
 /** 摘要调用结果：文本 + 可选 token usage（摘要请求自身消耗，随 compaction/summary 归入主会话记录）。 */
@@ -42,10 +39,10 @@ export type SummarySubagentResult = {
 /** 日志最小有效长度：<history> 中间内容小于该长度视为不合法（C 段校验）。 */
 export declare const MIN_HISTORY_LENGTH = 10;
 /** 产出日志后插入首个 <history> 后的格式说明（XML 注释，完整消息定义 + 条目标签语义）。 */
-export declare const HISTORY_FORMAT_NOTE = "<!-- \u5B8C\u6574\u6D88\u606F\uFF1A`\u7528\u6237\u6D88\u606F`\uFF0C`\u6A21\u578B\u8F93\u51FA\u6587\u672C`\u548C`\u5177\u6709result\u7684toolcall`\u88AB\u89C6\u4F5C`\u5B8C\u6574\u6D88\u606F`\u3002\u9996\u6761`\u5B8C\u6574\u6D88\u606F`\u7684index\u662F0\uFF0C\u540E\u7EED\u7684index\u9012\u589E\u3002 <user_message index=\"N\"> \u4E0E <assistant index=\"N\"> \u8868\u793A\u5355\u6761\u5B8C\u6574\u6D88\u606F\uFF0C<assistant start=\"A\" end=\"B\"> \u8868\u793A\u8FDE\u7EED\u6A21\u5757\uFF0Cstart/end \u662F\u9996\u5C3E\u5B8C\u6574\u6D88\u606F\u7684 index -->";
+export declare const HISTORY_FORMAT_NOTE = "<!-- \u5B8C\u6574\u6D88\u606F\uFF1A`\u5B8C\u6574\u6D88\u606F`\u88AB\u5B9A\u4E49\u4E3A`\u7528\u6237\u6D88\u606F`\uFF0C`\u7CFB\u7EDF\u6D88\u606F`\uFF0C`\u6A21\u578B\u8F93\u51FA\u6587\u672C`\u548C`\u5177\u6709result\u7684toolcall`\u7684\u96C6\u5408\u3002\u9996\u6761`\u5B8C\u6574\u6D88\u606F`\u7684index\u662F0\uFF0C\u540E\u7EED\u7684index\u9012\u589E\u3002 <TAG index=\"N\">\u8868\u793A\u5355\u6761\u5B8C\u6574\u6D88\u606F\uFF0C<TAG start=\"A\" end=\"B\"> \u8868\u793A\u8FDE\u7EED\u6A21\u5757\uFF0Cstart/end \u662F\u9996\u5C3E\u5B8C\u6574\u6D88\u606F\u7684 index\uFF1B<sys type=\"KIND\" index=\"N\"> \u8868\u793A\u88AB\u538B\u7F29\u7684\u7CFB\u7EDF\u6D88\u606F\uFF0C\u5757\u4E2D\u4E3A\u7A7A -->";
 /** history 块内条目（单条 index 或模块 start/end）。 */
 export type HistoryEntryRange = {
-    kind: 'user' | 'assistant';
+    kind: 'user' | 'assistant' | 'sys';
     index?: number;
     start?: number;
     end?: number;

package/dist/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAoC3C;AA4ED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE;AAyCD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA2DhF;AAED,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,CAAC;AA8EF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,gjBAAyK,CAAC;AAE1M,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA8EF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAYrE;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAiC/F;AACD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAK/C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAA;CAAE,GACpE,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA+EvC"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../src/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAAE,KAAK,EAAmB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,KAAK,YAAY,EAAQ,MAAM,YAAY,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAsC3C;AA0CD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAqEhF;AAED,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,CAAC;AA8EF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,yrBAA6K,CAAC;AAE9M,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoFF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAYrE;AACD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAAE,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuBvC;AAED,sCAAsC;AACtC,MAAM,MAAM,sBAAsB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAiC/F;AACD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAK/C;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAA;CAAE,GACpE,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA+EvC"}