dsh-plugin-om 0.0.31 → 0.0.32

package/dist/index.mjs

@@ -16,7 +16,8 @@ var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).expor
 /**
 * 共享常量：插件级魔法字符串，集中定义避免散落各模块。
 * 导出 PLUGIN_LABEL / HISTORY_TAG / HISTORY_TIP / COMPLETE_MESSAGE_DEFINITION /
-* COMPACT_CHECKPOINT_PLUGIN / COMPACTION_ABORTED_ERROR / isPluginOwnedSource。
+* HISTORY_FORMAT_NOTE / SKILL_TOOL_NAME / COMPACT_CHECKPOINT_PLUGIN /
+* COMPACTION_ABORTED_ERROR / isPluginOwnedSource。
 */
 /** 插件标识：压缩消息 source.plugin 取值与日志前缀。 */
 const PLUGIN_LABEL = "dsh-plugin-om";
@@ -29,8 +30,12 @@ const HISTORY_TIP = "当前块是历史消息的压缩产物，不要复述";
 * 完整消息是摘要日志与 recall 共用的定位单位；首条 index 为 0，按会话顺序递增、全局稳定。
 */
 const COMPLETE_MESSAGE_DEFINITION = "`完整消息`指一条`用户消息`、`系统消息`、`模型输出文本`或`具有result的toolcall`；首条 index 为 0，按会话顺序递增。";
-/** 最终 <history> 块内文块首的格式说明注释（XML 注释，完整消息定义 + 条目标签语义）。 */
-const HISTORY_FORMAT_NOTE = `<!-- 完整消息：${COMPLETE_MESSAGE_DEFINITION} <TAG index="N">表示单条完整消息，<TAG start="A" end="B"> 表示连续模块，start/end 是首尾完整消息的 index；<sys type="KIND" index="N"> 表示被压缩的系统消息，块中为空 -->`;
+/**
+* 最终 <history> 块内文块首的格式说明注释（XML 注释，完整消息定义 + 条目标签语义 + CDATA 约定）。
+*/
+const HISTORY_FORMAT_NOTE = `<!-- 完整消息：${COMPLETE_MESSAGE_DEFINITION} <TAG index="N">表示单条完整消息，<TAG start="A" end="B"> 表示连续模块，start/end 是首尾完整消息的 index；<sys type="KIND" index="N"> 表示被压缩的系统消息，块中为空；条目正文一律以 CDATA 包裹，CDATA 内为逐字原样内容；<skill_content name="S" index="N"> 表示未压缩的 skill 加载条目，内含 <skill_resources> 与 <skill_instructions> 两段，各自以 CDATA 包裹，内文为其工具返回内容 -->`;
+/** skill 工具名：toolcall 条目的工具名为该值时视为 skill 加载，<history> 块中以 <skill_content> 元素呈现。 */
+const SKILL_TOOL_NAME = "skill";
 /**
 * 压缩因 signal 中止而放弃时 compaction/end 的 error 标识（服务端写入、客户端过滤）：
 * 中止不是失败，客户端据此隐藏失败行（宿主不变量要求无 summary 的 end 必须带 error）。
@@ -134,13 +139,79 @@ function phaseLabel(phase) {
 function compressionRecordLabel(phase, rounds, success) {
 	return `OM 压缩${success ? "会话记录" : "失败日志"}（${phaseLabel(phase)} · ${rounds} 轮）`;
 }
+/** usage 各桶文案（缺失桶显示 -）。 */
+function usageLine(usage) {
+	const field = (value) => value === void 0 ? "-" : String(value);
+	return `input ${field(usage.inputTokens)} / output ${field(usage.outputTokens)} / cacheRead ${field(usage.cacheReadTokens)} / cacheWrite ${field(usage.cacheWriteTokens)} / reasoning ${field(usage.reasoningTokens)} tokens`;
+}
+/** 汇总逐轮 usage（各桶任一轮存在即求和保留；全部轮次无 usage 时返回 undefined）。 */
+function sumRoundUsage(rounds) {
+	let total;
+	for (const round of rounds) {
+		if (round.usage === void 0) continue;
+		if (total === void 0) {
+			total = { ...round.usage };
+			continue;
+		}
+		const sum = (a, b) => a === void 0 && b === void 0 ? void 0 : (a ?? 0) + (b ?? 0);
+		const merged = {
+			inputTokens: (total.inputTokens ?? 0) + (round.usage.inputTokens ?? 0),
+			outputTokens: (total.outputTokens ?? 0) + (round.usage.outputTokens ?? 0)
+		};
+		const cacheRead = sum(total.cacheReadTokens, round.usage.cacheReadTokens);
+		const cacheWrite = sum(total.cacheWriteTokens, round.usage.cacheWriteTokens);
+		const reasoning = sum(total.reasoningTokens, round.usage.reasoningTokens);
+		if (cacheRead !== void 0) merged.cacheReadTokens = cacheRead;
+		if (cacheWrite !== void 0) merged.cacheWriteTokens = cacheWrite;
+		if (reasoning !== void 0) merged.reasoningTokens = reasoning;
+		total = merged;
+	}
+	return total;
+}
+/**
+* 格式化压缩循环统计为统计消息文本：起止时间（ISO）、总耗时、逐轮请求耗时与
+* usage、usage 合计。随会话记录在子会话末尾落盘。
+*/
+function formatCompressionStats(phase, success, stats) {
+	const lines = [
+		"【压缩统计】",
+		`阶段：${phaseLabel(phase)}｜结果：${success ? "成功" : "失败"}`,
+		`开始：${new Date(stats.startedAt).toISOString()}`,
+		`结束：${new Date(stats.completedAt).toISOString()}`,
+		`总耗时：${stats.durationMs} ms`,
+		`请求轮数：${stats.rounds.length}`
+	];
+	if (stats.rounds.length > 0) {
+		lines.push("逐轮：");
+		for (const round of stats.rounds) lines.push(`- 第 ${round.round} 轮：耗时 ${round.durationMs} ms${round.usage === void 0 ? "" : `，${usageLine(round.usage)}`}`);
+	}
+	const usage = sumRoundUsage(stats.rounds);
+	if (usage !== void 0) lines.push(`usage 合计：${usageLine(usage)}`);
+	return lines.join("\n");
+}
+/** 构造插件自产 user 消息（子会话统计消息；id 为品牌类型 MessageId）。 */
+function makeStatsMessage(text) {
+	return {
+		id: uuid(),
+		role: "user",
+		content: [{
+			type: "text",
+			text
+		}],
+		source: {
+			kind: "plugin",
+			plugin: PLUGIN_LABEL
+		}
+	};
+}
 /**
 * 把一次压缩工具循环的完整会话消息组落盘为子会话：ctx.sessions.create 创建子会话
 * （header origin 'subagent'、parentSession 指向主会话、delegationDepth = 父 + 1、
 * cwd 继承主会话），追加 one-shot descriptor（provider om-compaction-log，label 含
 * 压缩阶段与轮数），逐消息原样追加（user 指令/提醒与 tool-result 为 user/message，
-* assistant 含 tool-call 块为 assistant/message），flush 持久化，返回子会话 id。
-* 成功与失败均调用；落盘自身绝不抛错，任何失败仅 logger.warn 并返回 undefined。
+* assistant 含 tool-call 块为 assistant/message），末尾追加插件来源统计消息（起止
+* 时间、总耗时、逐轮耗时与 usage），flush 持久化，返回子会话 id。成功与失败均调用；
+* 落盘自身绝不抛错，任何失败仅 logger.warn 并返回 undefined。
 */
 async function recordCompressionSession(ctx, parentSession, options) {
 	const logger = makeLogger(ctx, options.debug);
@@ -156,7 +227,7 @@ async function recordCompressionSession(ctx, parentSession, options) {
 			version: SUBAGENT_DESCRIPTOR_VERSION,
 			mode: "one-shot",
 			provider: COMPACTION_LOG_PROVIDER,
-			label: compressionRecordLabel(options.phase, options.rounds, options.success)
+			label: compressionRecordLabel(options.phase, options.stats.rounds.length, options.success)
 		});
 		let step = 0;
 		for (const message of options.messages) {
@@ -168,6 +239,7 @@ async function recordCompressionSession(ctx, parentSession, options) {
 			}, { surfaceOp: "append" });
 			else child.append("user/message", message, { surfaceOp: "append" });
 		}
+		child.append("user/message", makeStatsMessage(formatCompressionStats(options.phase, options.success, options.stats)), { surfaceOp: "append" });
 		try {
 			await ctx.sessions.flush(child);
 		} catch (error) {
@@ -7316,8 +7388,9 @@ var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 * 会话日志索引：完整消息索引与渲染。
 * 导出 indexCompleteMessages（完整消息四类折叠索引，recall 与摘要共用同一套编号）、
 * indexMessages / surfaceIndexOf / messageIdOfEvent（消息级定位辅助）、
-* collectImageRefs / renderCompleteMessageParts / renderCompleteMessage（完整消息渲染
-* 与图片附件收集）。事件日志仅追加（被遮蔽的事件仍可读，recall 依赖此性质）。
+* collectImageRefs / toolResultMessageOf / renderToolResultText / renderCompleteMessageParts /
+* renderCompleteMessage（完整消息渲染与图片附件收集）。事件日志仅追加（被遮蔽的事件仍可读，
+* recall 依赖此性质）。
 *
 * 完整消息分四类：user（用户消息）、sys（系统消息，压缩日志中以 <sys> 空块表示）、
 * assistant（模型输出文本）、toolcall（单个工具调用及其结果，result 按 callId 匹配并入）。
@@ -7418,7 +7491,28 @@ function collectImageRefs(content, out) {
 	}
 }
 /**
-* 渲染一条完整消息为「文本 + 图片」（recall / recall-semantic 输出用）：
+* 取 toolcall 完整消息的 tool/result 消息（超大结果经 pruner 裁剪）：
+* 结果文本渲染与 <skill> 条目正文共用；非 toolcall 或无配对 result 时返回 undefined。
+*/
+function toolResultMessageOf(session, cm, pruner) {
+	if (cm.type !== "toolcall") return void 0;
+	const resultSeq = cm.seqs[1];
+	const resultEvent = resultSeq === void 0 ? void 0 : session.events[resultSeq];
+	if (resultEvent?.type !== "tool/result") return void 0;
+	const message = session.deriveEventMessage(resultEvent);
+	if (!message) return void 0;
+	const pruned = pruner?.pruneContent?.(message.content);
+	return pruned ? {
+		...message,
+		content: pruned
+	} : message;
+}
+/** 渲染 toolcall 完整消息的工具返回文本（仅 result 内容；无配对 result 时为空串）。 */
+function renderToolResultText(session, cm, pruner) {
+	const message = toolResultMessageOf(session, cm, pruner);
+	return message ? renderMessageText(message) : "";
+}
+/** 渲染一条完整消息为「文本 + 图片」（recall / recall-semantic 输出用）：
 * user/sys 取消息原文，assistant 取文本块，toolcall 为调用块 + 结果文本
 * （pruner 裁剪超大结果）；同时收集该条完整消息携带的图片附件（含 tool-result 嵌套，
 * pruner 裁剪掉的图片不收集）。
@@ -7465,19 +7559,10 @@ function renderCompleteMessageParts(session, cm, pruner) {
 			if (call) parts.push(`[tool-call ${String(call.name ?? "")} id=${String(call.id ?? "")}]\n${safeJson(call.arguments)}`);
 		}
 	}
-	const resultSeq = cm.seqs[1];
-	const resultEvent = resultSeq === void 0 ? void 0 : session.events[resultSeq];
-	if (resultEvent?.type === "tool/result") {
-		let message = session.deriveEventMessage(resultEvent);
-		if (message && pruner?.pruneContent) {
-			const pruned = pruner.pruneContent(message.content);
-			if (pruned) message = {
-				...message,
-				content: pruned
-			};
-		}
-		if (message && Array.isArray(message.content)) collectImageRefs(message.content, images);
-		const text = message ? renderMessageText(message) : "";
+	const resultMessage = toolResultMessageOf(session, cm, pruner);
+	if (resultMessage && Array.isArray(resultMessage.content)) {
+		collectImageRefs(resultMessage.content, images);
+		const text = renderMessageText(resultMessage);
 		if (text.trim() !== "") parts.push(`[result]\n${text}`);
 	}
 	return {
@@ -7533,6 +7618,26 @@ function toolCallNameOf(session, cm) {
 	for (const block of message.content) if (block.type === "tool-call" && String(block.id ?? "") === (cm.callId ?? "")) return String(block.name ?? "");
 }
 /**
+* 提取 skill 条目的 skill 名（tool-call 参数 JSON 的 name 字段）。非 skill 工具的
+* toolcall 返回 undefined；toolName 为 skill 但参数缺失或非法时返回空串。
+*/
+function skillNameOf(session, cm) {
+	if (toolCallNameOf(session, cm) !== "skill") return void 0;
+	const seq = cm.seqs[0];
+	const event = seq === void 0 ? void 0 : session.events[seq];
+	if (event?.type !== "assistant/message") return "";
+	const message = event.data.message;
+	if (!message || !Array.isArray(message.content)) return "";
+	for (const block of message.content) if (block.type === "tool-call" && String(block.id ?? "") === (cm.callId ?? "")) {
+		try {
+			const args = JSON.parse(String(block.arguments ?? ""));
+			if (isRecord(args) && typeof args.name === "string") return args.name;
+		} catch {}
+		return "";
+	}
+	return "";
+}
+/**
 * 观察视图：被压缩区间（表层 seq 集合）内的完整消息投影为条目——
 * user → 原文（图片等非文本块为注释）、sys → 空条目、assistant/toolcall → 原文渲染，
 * reasoning 作为参考条目置于其所属 assistant 条目之前（每条 assistant 消息输出一次；
@@ -7590,15 +7695,18 @@ function buildObserveView(session, seqs, options = {}) {
 				});
 			}
 		}
-		const text = renderCompleteMessage(session, cm);
-		if (text.trim() === "") continue;
 		const toolName = cm.type === "toolcall" ? toolCallNameOf(session, cm) : void 0;
+		const isSkill = toolName === SKILL_TOOL_NAME;
+		const text = isSkill ? renderToolResultText(session, cm) : renderCompleteMessage(session, cm);
+		if (text.trim() === "") continue;
+		const skillName = isSkill ? skillNameOf(session, cm) : void 0;
 		entries.push({
 			kind: "assistant",
 			lo: cm.index,
 			hi: cm.index,
 			text,
-			...toolName === void 0 ? {} : { toolName }
+			...toolName === void 0 ? {} : { toolName },
+			...skillName === void 0 ? {} : { skillName }
 		});
 	}
 	return {
@@ -7638,10 +7746,50 @@ function intAttr(el, name) {
 	if (!/^\d+$/.test(raw)) return void 0;
 	return Number(raw);
 }
+/** 读取元素第一个指定名子元素的正文（缺失返回 undefined）。 */
+function childText(el, tag) {
+	const child = el.getElementsByTagName(tag)[0];
+	return child === void 0 ? void 0 : child.textContent ?? "";
+}
+/**
+* 提取 skill 工具返回内容（原生 <skill_content> 包裹）中 <skill_resources> 与
+* <skill_instructions> 两段正文。非该包裹形态、两段缺失或两段之间存在其他内容时
+* 返回 undefined（调用方回退为整体 CDATA 原文）。
+*/
+function skillContentSections(text) {
+	const wrapper = /^[\s]*<skill_content\b[^>]*>([\s\S]*)<\/skill_content>[\s]*$/.exec(text);
+	if (!wrapper) return void 0;
+	const body = wrapper[1] ?? "";
+	const match = /^([\s\S]*?)<skill_resources>([\s\S]*?)<\/skill_resources>([\s\S]*?)<skill_instructions>([\s\S]*?)<\/skill_instructions>([\s\S]*)$/.exec(body);
+	if (!match) return void 0;
+	const before = match[1] ?? "";
+	const resources = match[2] ?? "";
+	const between = match[3] ?? "";
+	const instructions = match[4] ?? "";
+	const after = match[5] ?? "";
+	if (before.trim() !== "" || between.trim() !== "" || after.trim() !== "") return void 0;
+	return {
+		resources,
+		instructions
+	};
+}
+/**
+* 向元素追加 CDATA 正文：正文统一以 CDATA 包裹（逐字原样，不做实体转义）。
+* 正文含 ]]> 时拆为相邻多个 CDATA 段，拼接后逐字还原原文，对读取方透明。
+*/
+function appendCdataText(doc, el, text) {
+	const parts = text.split("]]>");
+	for (let i = 0; i < parts.length; i += 1) if (i === 0) el.appendChild(doc.createCDATASection(parts[0] ?? ""));
+	else {
+		el.appendChild(doc.createCDATASection("]]"));
+		el.appendChild(doc.createCDATASection(`>${parts[i] ?? ""}`));
+	}
+}
 /**
 * 解析一个已有 <history> 块的内条目（反思视图）：user_message / sys / assistant
-* （index 单条或 start/end 区间）/ reasoning。整块无法解析或根非 <history> 时降级为
-* 单条不可定位的历史遗留条目（text 为块内文原文，构建最终块时原样保留）。
+* （index 单条或 start/end 区间）/ skill_content（name 属性 + index 定位）/ reasoning。
+* 整块无法解析或根非 <history> 时降级为单条不可定位的历史遗留条目（text 为块内文原文，
+* 构建最终块时原样保留）。
 */
 function parseBlockEntries(blockText, blockSeq) {
 	const opaque = () => [{
@@ -7707,6 +7855,23 @@ function parseBlockEntries(blockText, blockSeq) {
 				text,
 				blockSeq
 			});
+		} else if (el.nodeName === "skill_content") {
+			const index = intAttr(el, "index");
+			if (index !== void 0) {
+				const name = el.getAttribute("name");
+				const resources = childText(el, "skill_resources");
+				const instructions = childText(el, "skill_instructions");
+				const text = resources !== void 0 && instructions !== void 0 ? `<skill_content${name === null ? "" : ` name="${name}"`}><skill_resources>${resources}</skill_resources><skill_instructions>${instructions}</skill_instructions></skill_content>` : el.textContent ?? "";
+				entries.push({
+					kind: "assistant",
+					lo: index,
+					hi: index,
+					text,
+					toolName: SKILL_TOOL_NAME,
+					...name === null ? {} : { skillName: name },
+					blockSeq
+				});
+			}
 		} else if (el.nodeName === "reasoning") entries.push({
 			kind: "reasoning",
 			text,
@@ -7731,14 +7896,14 @@ function buildReflectView(blocks, options = {}) {
 	};
 }
 /**
-* 把一个视图条目构建为 XML 元素（文本经 DOM 文本节点自动转义；user 条目的注释
+* 把一个视图条目构建为 XML 元素（正文统一以 CDATA 包裹，逐字原样；user 条目的注释
 * 输出为 XML 注释节点）。getHistory 输出与最终 <history> 块共用。
 */
 function entryToElement(doc, entry) {
 	if (entry.kind === "user") {
 		const el = doc.createElement("user_message");
 		if (entry.lo !== void 0) el.setAttribute("index", String(entry.lo));
-		el.appendChild(doc.createTextNode(entry.text));
+		appendCdataText(doc, el, entry.text);
 		for (const note of entry.notes ?? []) el.appendChild(doc.createComment(note));
 		return el;
 	}
@@ -7746,12 +7911,27 @@ function entryToElement(doc, entry) {
 		const el = doc.createElement("sys");
 		el.setAttribute("type", entry.sysKind ?? "");
 		if (entry.lo !== void 0) el.setAttribute("index", String(entry.lo));
-		el.appendChild(doc.createTextNode(""));
+		appendCdataText(doc, el, "");
 		return el;
 	}
 	if (entry.kind === "reasoning") {
 		const el = doc.createElement("reasoning");
-		el.appendChild(doc.createTextNode(entry.text));
+		appendCdataText(doc, el, entry.text);
+		return el;
+	}
+	if (entry.kind === "assistant" && entry.toolName === "skill") {
+		const el = doc.createElement("skill_content");
+		el.setAttribute("name", entry.skillName ?? "");
+		if (entry.lo !== void 0 && entry.lo === entry.hi) el.setAttribute("index", String(entry.lo));
+		const sections = skillContentSections(entry.text);
+		if (sections) {
+			const resources = doc.createElement("skill_resources");
+			appendCdataText(doc, resources, sections.resources);
+			el.appendChild(resources);
+			const instructions = doc.createElement("skill_instructions");
+			appendCdataText(doc, instructions, sections.instructions);
+			el.appendChild(instructions);
+		} else appendCdataText(doc, el, entry.text);
 		return el;
 	}
 	const el = doc.createElement("assistant");
@@ -7760,7 +7940,7 @@ function entryToElement(doc, entry) {
 		el.setAttribute("start", String(entry.lo));
 		el.setAttribute("end", String(entry.hi));
 	}
-	el.appendChild(doc.createTextNode(entry.text));
+	appendCdataText(doc, el, entry.text);
 	return el;
 }
 /**
@@ -7772,6 +7952,8 @@ function renderEntriesXml(entries) {
 	const serializer = new import_lib.XMLSerializer();
 	return entries.map((entry) => serializer.serializeToString(entryToElement(doc, entry))).join("\n");
 }
+//#endregion
+//#region src/compress-tools.ts
 /** 压缩会话的工具状态：视图 + 替换记录 + skill 二次确认标记 + 完成标记。 */
 var CompressionState = class CompressionState {
 	view;
@@ -7893,6 +8075,10 @@ var CompressionState = class CompressionState {
 			text: "content 必须是非空摘要文本",
 			isError: true
 		};
+		if (content.includes("<![CDATA[")) return {
+			text: "content 必须是纯文本摘要，不要包含 CDATA 包裹（<![CDATA[…]]>）；CDATA 由插件在构建块时自动添加，请去除后重新提交",
+			isError: true
+		};
 		const hasIndex = args.index !== void 0 && args.index !== null;
 		const hasStart = args.start !== void 0 && args.start !== null;
 		const hasEnd = args.end !== void 0 && args.end !== null;
@@ -7999,7 +8185,7 @@ var CompressionState = class CompressionState {
 	}
 	/**
 	* 构建最终 <history> 块：按 index 顺序合并视图条目与替换记录——user / sys 条目
-	* 原样、被替换区间生成 <assistant index|start end> 摘要条目（content 转义嵌入）、
+	* 原样、被替换区间生成 <assistant index|start end> 摘要条目（content 以 CDATA 包裹嵌入）、
 	* 未替换 assistant 条目原样保留、reasoning 不进产物；块首为格式说明注释，开标签
 	* 携带 tip 属性。产物为合法 XML，无需校验。
 	*/
@@ -8017,7 +8203,7 @@ var CompressionState = class CompressionState {
 				el.setAttribute("start", String(rep.lo));
 				el.setAttribute("end", String(rep.hi));
 			}
-			el.appendChild(doc.createTextNode(rep.content));
+			appendCdataText(doc, el, rep.content);
 			root.appendChild(el);
 		};
 		const flushReplacementsBefore = (lo) => {
@@ -8080,7 +8266,7 @@ const COMPRESSION_TOOL_SCHEMAS = [
 				},
 				content: {
 					type: "string",
-					description: "替换后的摘要文本（纯文本）"
+					description: "替换后的摘要文本（纯文本，不要包含 CDATA 包裹，插件自动包裹）"
 				}
 			},
 			required: ["content"]
@@ -8155,7 +8341,7 @@ async function gateRateLimit(waitMs, signal) {
 * 工具驱动的压缩循环：以新会话方式直连 ctx.llm.stream()，模型通过 getHistory /
 * compressHistory / completeCompression 三个工具完成压缩，替代直出 <history> 块。
 * 导出 runCompressionLoop / buildCompressionPrompt / buildCompressionTaskText /
-* CompressionLoopOptions / CompressionOutcome / COMPRESSION_NUDGE_TEXT。
+* CompressionLoopOptions / CompressionOutcome / CompressionStats / COMPRESSION_NUDGE_TEXT。
 *
 * - 首条 user 消息仅含压缩指令与 start/end 区间（buildCompressionTaskText），不含
 *   历史消息内容；共享压缩提示词作为 system
@@ -8166,7 +8352,8 @@ async function gateRateLimit(waitMs, signal) {
 * - 模型输出纯文本（无工具调用）时追加提醒消息继续，连续 2 轮仍无工具调用判失败
 * - 429 限流走全局限流等待门（gateRateLimit / noteRateLimit）；其余请求级错误依赖
 *   dsh 运行时重试，插件不做整体重试，错误直接判失败
-* - signal 中止标记 aborted；token usage 汇总全部轮次
+* - signal 中止标记 aborted；token usage 汇总全部轮次；统计循环起止时间戳、总耗时
+*   与逐轮请求统计（CompressionStats），随结果返回并随会话记录落盘
 * - 成功与失败均把循环消息组原样落盘为子会话（recordCompressionSession），成功记
 *   录 sessionId 于日志，失败记录作为诊断子会话 id 向上传播
 */
@@ -8182,7 +8369,7 @@ function buildCompressionPrompt(skipReasoning) {
 		"",
 		"【工具】",
 		"- getHistory(option?: {start?, end?})：查看压缩区间内的历史条目。start/end 缺省为要求区间的第一个/最后一个完整消息 index，必须在要求区间内。返回压缩视图：已压缩内容以摘要条目呈现，区间切入已压缩块时返回整块，不带 <history> 包裹。",
-		"- compressHistory(option?: {index?, start?, end?, content})：把 index 单条或 start..end 连续区间的 assistant 类条目替换为 content 摘要（纯文本）。index 与 start/end 二选一，start==end 等同 index。区间不得覆盖用户消息或系统消息；与已有替换区间部分重叠会被拒绝，完全包含则覆盖。",
+		"- compressHistory(option?: {index?, start?, end?, content})：把 index 单条或 start..end 连续区间的 assistant 类条目替换为 content 摘要（纯文本，不要包含 CDATA 包裹，插件自动包裹）。index 与 start/end 二选一，start==end 等同 index。区间不得覆盖用户消息或系统消息；与已有替换区间部分重叠会被拒绝，完全包含则覆盖。",
 		"- completeCompression()：全部压缩完成后调用，立即结束。",
 		"",
 		"【压缩要求】",
@@ -8192,7 +8379,8 @@ function buildCompressionPrompt(skipReasoning) {
 		"- 单条重要的完整消息以 index 单独压缩",
 		"- 压缩后的 assistant 消息内，应当描述**行为逻辑**，强调关键的**结论、产出和任务**；涉及到的具体文件保留完整路径",
 		"- 摘要粒度越往后越细：靠近末尾（最近）的消息保留更多细节，开头（较早）的消息简写。",
-		"- 加载的 skill 属于关键信息。仅在你明确判断该 skill 与后续任务无关时，压缩它；如果该 skill 与后续任务相关，或者你无法判断，不要压缩，**保持原文**。",
+		"- <history> 条目正文一律以 CDATA 包裹，CDATA 内为逐字原样内容。",
+		"- 加载的 skill 以 <skill_content name=\"…\" index=\"N\"> 条目呈现，内含 <skill_resources> 与 <skill_instructions> 两段，内文为其工具返回内容，属于关键信息。仅在你明确判断该 skill 与后续任务无关时，压缩它；如果该 skill 与后续任务相关，或者你无法判断，不要压缩，**保持原文**。",
 		"- 未压缩的条目将原样保留；宁可保留也不要强行压缩不确定的内容。",
 		"- 全部完成后调用 completeCompression 结束；不要输出与工具调用无关的文本。"
 	].join("\n");
@@ -8277,20 +8465,34 @@ async function runCompressionLoop(ctx, session, options) {
 	let rounds = 0;
 	let nudges = 0;
 	let usage;
-	const recordSessionId = async (success) => recordCompressionSession(ctx, session, {
+	const startedAt = Date.now();
+	const roundStats = [];
+	/** 汇总当前循环统计（completedAt 取调用时刻；rounds 数组为引用共享）。 */
+	const buildStats = () => {
+		const completedAt = Date.now();
+		return {
+			startedAt,
+			completedAt,
+			durationMs: completedAt - startedAt,
+			rounds: roundStats
+		};
+	};
+	const recordSessionId = async (success, stats) => recordCompressionSession(ctx, session, {
 		phase: options.phase,
 		target: options.target,
 		messages,
-		rounds,
+		stats,
 		success,
 		debug: options.debug
 	});
 	const failWith = async (error, aborted) => {
-		const id = await recordSessionId(false);
+		const stats = buildStats();
+		const id = await recordSessionId(false, stats);
 		return {
 			ok: false,
 			error,
 			aborted,
+			stats,
 			...id === void 0 ? {} : { recordSessionId: id }
 		};
 	};
@@ -8304,6 +8506,7 @@ async function runCompressionLoop(ctx, session, options) {
 			logger.warn("压缩循环中止（限流等待被 signal 中止），放弃本次压缩");
 			return await failWith(COMPACTION_ABORTED_ERROR, true);
 		}
+		const roundStartedAt = Date.now();
 		const requestOptions = {
 			provider: options.target.provider,
 			model: options.target.model,
@@ -8346,6 +8549,12 @@ async function runCompressionLoop(ctx, session, options) {
 		}
 		rounds += 1;
 		if (assembler.usage !== void 0) usage = addUsage(usage, assembler.usage);
+		roundStats.push({
+			round: rounds,
+			startedAt: roundStartedAt,
+			durationMs: Date.now() - roundStartedAt,
+			...assembler.usage === void 0 ? {} : { usage: assembler.usage }
+		});
 		const assistantMessage = assembler.message({
 			kind: "model",
 			provider: options.target.provider,
@@ -8378,11 +8587,13 @@ async function runCompressionLoop(ctx, session, options) {
 			const text = state.buildFinalBlock();
 			if (state.replacementCount === 0) logger.warn("压缩完成但未执行任何压缩替换（空提交）");
 			logger.info(`压缩循环完成（${rounds} 轮，${state.replacementCount} 次压缩替换，输出 ${text.length} 字符）`);
-			const id = await recordSessionId(true);
+			const stats = buildStats();
+			const id = await recordSessionId(true, stats);
 			return {
 				ok: true,
 				text,
 				rounds,
+				stats,
 				...usage === void 0 ? {} : { usage },
 				...id === void 0 ? {} : { recordSessionId: id }
 			};
@@ -8542,7 +8753,7 @@ async function runPassLoop(ctx, session, lifecycle, options, logger, phase) {
 	if (!outcome.ok) {
 		logger.warn(`${phase === "reflect" ? "反思" : "观察"}：压缩循环失败（${outcome.error}），诊断子会话 ${outcome.recordSessionId ?? "未落盘"}，追加 compaction/end(error)`);
 		try {
-			appendCompactionEnd(session, lifecycle, outcome.error, outcome.recordSessionId);
+			appendCompactionEnd(session, lifecycle, outcome.error, outcome.recordSessionId, outcome.stats.durationMs);
 		} catch {}
 		return outcome;
 	}
@@ -8703,7 +8914,8 @@ function appendCompactionStart(session, lifecycle, phase) {
 }
 /**
 * 追加 compaction/summary（log-only，承担影子价格认领：紧随其后的替换消息消费 claim）。
-* summary 为完整合并后的 <history> 内文；usage 由摘要调用提取（无则省略）。
+* summary 为完整合并后的 <history> 内文；usage 由摘要调用提取（无则省略）；stats 提供
+* 压缩循环计时（startedAt/completedAt/durationMs）。
 */
 function appendCompactionSummary(session, data) {
 	const payload = {
@@ -8719,21 +8931,25 @@ function appendCompactionSummary(session, data) {
 		provider: data.provider,
 		model: data.model,
 		...data.maxTokens === void 0 ? {} : { maxTokens: data.maxTokens },
-		attemptCount: data.attemptCount,
+		startedAt: data.stats.startedAt,
+		completedAt: data.stats.completedAt,
+		durationMs: data.stats.durationMs,
 		...data.usage === void 0 ? {} : { usage: data.usage }
 	};
 	return session.append("compaction/summary", payload).seq;
 }
 /**
 * 追加 compaction/end（log-only，结束生命周期；error 记录失败原因，
-* diagnosticSessionId 记录最后一次摘要尝试（无论成功或失败）的诊断子会话 id）。
+* diagnosticSessionId 记录最后一次摘要尝试（无论成功或失败）的诊断子会话 id，
+* durationMs 记录失败路径的压缩循环耗时）。
 */
-function appendCompactionEnd(session, lifecycle, error, diagnosticSessionId) {
+function appendCompactionEnd(session, lifecycle, error, diagnosticSessionId, durationMs) {
 	const payload = {
 		compactionId: lifecycle.compactionId,
 		turn: lifecycle.turn,
 		...error === void 0 ? {} : { error },
-		...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId }
+		...diagnosticSessionId === void 0 ? {} : { diagnosticSessionId },
+		...durationMs === void 0 ? {} : { durationMs }
 	};
 	return session.append("compaction/end", payload).seq;
 }
@@ -8837,7 +9053,7 @@ async function reflectPass(ctx, agent, config, target, signal) {
 			provider: target.provider,
 			model: target.model,
 			maxTokens: config.compressMaxTokens,
-			attemptCount: summaryResult.rounds,
+			stats: summaryResult.stats,
 			...summaryResult.usage === void 0 ? {} : { usage: summaryResult.usage }
 		});
 		logger.step("反思提交：替换整个 <history> 块区段为合并摘要");
@@ -8854,7 +9070,7 @@ async function reflectPass(ctx, agent, config, target, signal) {
 		const message = error instanceof Error ? error.message : String(error);
 		logger.warn(`反思提交失败: ${message}`);
 		try {
-			appendCompactionEnd(session, lifecycle, message);
+			appendCompactionEnd(session, lifecycle, message, void 0, summaryResult.stats.durationMs);
 		} catch {}
 		return { failed: false };
 	}
@@ -9075,7 +9291,7 @@ async function observePass(ctx, agent, config, waitCount, target, signal) {
 			provider: target.provider,
 			model: target.model,
 			maxTokens: config.compressMaxTokens,
-			attemptCount: summaryResult.rounds,
+			stats: summaryResult.stats,
 			...usage === void 0 ? {} : { usage }
 		});
 		logger.step("观察提交：替换被压缩新消息区间为 <history>（旧块保留）");
@@ -9093,7 +9309,7 @@ async function observePass(ctx, agent, config, waitCount, target, signal) {
 		const message = error instanceof Error ? error.message : String(error);
 		logger.warn(`观察压缩提交失败: ${message}`);
 		try {
-			appendCompactionEnd(session, lifecycle, message);
+			appendCompactionEnd(session, lifecycle, message, void 0, summaryResult.stats.durationMs);
 		} catch {}
 		return { failed: false };
 	}

package/dist/log-index.d.ts

@@ -1,5 +1,5 @@
 import type { ImageRefValue } from './recall-output.ts';
-import type { CompleteMessage, MessageIndex, Session, SessionEvent } from './types.ts';
+import type { CompleteMessage, Message, MessageIndex, Session, SessionEvent } from './types.ts';
 /** 工具结果裁剪器结构（tool-result-pruner；超大结果渲染前裁剪）。 */
 export type PrunerLike = {
     pruneContent?: (blocks: readonly unknown[]) => unknown[] | null;
@@ -22,7 +22,13 @@ export declare function indexCompleteMessages(session: Session): CompleteMessage
  */
 export declare function collectImageRefs(content: unknown, out: ImageRefValue[]): void;
 /**
- * 渲染一条完整消息为「文本 + 图片」（recall / recall-semantic 输出用）：
+ * 取 toolcall 完整消息的 tool/result 消息（超大结果经 pruner 裁剪）：
+ * 结果文本渲染与 <skill> 条目正文共用；非 toolcall 或无配对 result 时返回 undefined。
+ */
+export declare function toolResultMessageOf(session: Session, cm: CompleteMessage, pruner?: PrunerLike): Message | undefined;
+/** 渲染 toolcall 完整消息的工具返回文本（仅 result 内容；无配对 result 时为空串）。 */
+export declare function renderToolResultText(session: Session, cm: CompleteMessage, pruner?: PrunerLike): string;
+/** 渲染一条完整消息为「文本 + 图片」（recall / recall-semantic 输出用）：
  * user/sys 取消息原文，assistant 取文本块，toolcall 为调用块 + 结果文本
  * （pruner 裁剪超大结果）；同时收集该条完整消息携带的图片附件（含 tool-result 嵌套，
  * 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":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,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,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAoB5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA+DzE;AACD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,IAAI,CA+B7E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAuD3C;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAER"}
+{"version":3,"file":"log-index.d.ts","sourceRoot":"","sources":["../src/log-index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EACf,OAAO,EACP,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,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMpF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAoB5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA+DzE;AACD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,IAAI,CA+B7E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,GAAG,SAAS,CASrB;AAED,4DAA4D;AAC5D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAiD3C;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAER"}