dsh-plugin-om 0.0.33 → 0.0.34

package/README.md

@@ -10,8 +10,8 @@
 - **工具驱动压缩**：摘要生成走多轮工具会话，模型经 getHistory 查看区间条目、compressHistory 分批替换 assistant 条目、completeCompression 结束。首条消息仅含压缩指令与 index 区间，不含历史内容。用户消息与系统消息不可压缩且原样保留；未压缩条目原样保留，条目正文一律以 CDATA 包裹；skill 加载条目以 `<skill_content name="…" index="…">` 元素呈现，内含 `<skill_resources>` 与 `<skill_instructions>` 两段，首次压缩时要求模型再次确认相关性，压缩后变为常规 assistant 摘要条目。最终 `<history>` 块由插件构建，天然合法无需校验
 - **压缩会话记录**：每次压缩的工具循环完整对话与压缩统计（起止时间、总耗时、逐轮请求耗时与 token usage 及合计）落盘为 one-shot 子会话，成功为会话记录、失败为失败日志，便于查看模型实际的查看与压缩行为及其 token 成本。主会话日志只保留汇总：`compaction/summary` 携带 usage 与起止时间、总耗时，失败路径 `compaction/end` 携带总耗时
 - **降级容错**：systemPrompt 或 tokenMeter 服务异常时按 0 计继续压缩，问题通过 console 输出与 log-only `om/warning` 会话事件上报，同会话同一问题至多一条
-- **recall 工具**：按完整消息 index 区间回看原始会话，含被压缩内容，图片附件随结果保留
-- **recall-semantic 工具**：本地嵌入模型 paraphrase-multilingual-MiniLM-L12-v2 按语义检索全部完整消息，只匹配文本，纯图片消息不进候选池
+- **recall 工具**：按完整消息 index 区间回看原始会话，含被压缩内容；输出为 XML 条目序列（`<user_message>`、`<sys>`、`<assistant type="text"|"toolcall">`），正文一律以 CDATA 包裹逐字原样，toolcall 条目内嵌 `<tool-args>`（合法 JSON，仅一层转义）与 `<tool-result>` CDATA 子元素，图片附件随结果保留
+- **recall-semantic 工具**：本地嵌入模型 paraphrase-multilingual-MiniLM-L12-v2 按语义检索全部完整消息，输出与 recall 相同的 XML 条目序列并以 XML 注释标注相似度与命中词；只匹配文本，纯图片消息不进候选池，本次调用自身的 toolcall 不参与检索
 - **压缩卡片**：浏览器客户端渲染折叠式已压缩卡片、压缩中提示行与可展开的失败错误行
 - **降级警告行**：浏览器客户端把 om 警告会话事件渲染为可展开的警告行
 
@@ -71,6 +71,8 @@ preset-agent 自带 compaction-basic 压缩，阈值为上下文窗口的 80%，
 | `recallEnabled` | `true` | 是否注册 `recall` 工具 |
 | `semanticRecallEnabled` | `true` | 是否注册 `recall-semantic` 工具，关闭时不触发模型下载 |
 
+> 检测到未压缩消息到达观察阈值后，插件会等待至少 tailMessageCount 后再压缩之前的消息，因此这个配置可以影响首次压缩的时机，也可以保留更多的会话信息。
+
 合理设置 `observeThresholdTokens` 和 `compressSkipReasoning`：
 - 若模型 reasoning 输出质量差且会把关键结论以 text 形式输出（例如glm和deepseek），无需携带reasoning
 - 若使用 openai/responses 或 anthropic/messages API，reasoning 内容包含大量决策信息，建议携带reasoning
@@ -108,6 +110,7 @@ src/
 ├── rate-limit.ts                # 全局 429 限流冷却门，进程级共享状态
 ├── log-index.ts                 # 完整消息索引与渲染，recall 与压缩共用同一套编号
 ├── recall.ts                    # recall 工具：按完整消息 index 区间回看
+├── recall-xml.ts                # 完整消息到 CDATA 包裹 XML 条目的渲染（recall 系工具共用）
 ├── recall-output.ts             # recall 输出契约：{ text, images } 与 render 投影
 ├── semantic-recall.ts           # recall-semantic 工具：本地嵌入语义检索
 ├── embedding.ts                 # 本地 ONNX 嵌入：懒加载、批量、运行时按需下载编排

package/dist/compress-view.d.ts

@@ -70,10 +70,9 @@ export declare function buildObserveView(session: Session, seqs: readonly number
 /** 提取 <history> 块的内文（去开/闭标签；非块文本原样返回）。 */
 export declare function historyInner(text: string): string;
 /**
- * 向元素追加 CDATA 正文：正文统一以 CDATA 包裹（逐字原样，不做实体转义）。
- * 正文含 ]]> 时拆为相邻多个 CDATA 段，拼接后逐字还原原文，对读取方透明。
+ * 向元素追加 CDATA 正文（实现在 utils.ts，此处再导出保持既有导入路径）。
  */
-export declare function appendCdataText(doc: Document, el: Element, text: string): void;
+export { appendCdataText } from './utils.ts';
 /**
  * 反思视图：全部 <history> 块（historySection 收集，按表层顺序）的内条目投影为条目。
  * 要求区间为全部块内条目引用的最小 / 最大 index；块解析失败降级为不可定位遗留条目；

package/dist/compress-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress-view.d.ts","sourceRoot":"","sources":["../src/compress-view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3D;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY;IACZ,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;IACjD,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG;IAC5B,uDAAuD;IACvD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyCF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAaxF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAmBrF;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAmEjB;AAiBD,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAyCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAW9E;AAsFD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5C,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAUjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAkDvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAO7D"}
+{"version":3,"file":"compress-view.d.ts","sourceRoot":"","sources":["../src/compress-view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3D;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY;IACZ,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;IACjD,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG;IAC5B,uDAAuD;IACvD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAyCF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAaxF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAmBrF;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAmEjB;AAiBD,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAyCD;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsF7C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5C,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAUjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAkDvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAO7D"}

package/dist/index.mjs

@@ -99,7 +99,7 @@ function renderMessageText(message) {
 	const parts = [];
 	for (const block of message.content) if (block.type === "text") parts.push(block.text);
 	else if (block.type === "tool-call") parts.push(`[tool-call ${block.name} id=${String(block.id)}]
-${safeJson(block.arguments)}`);
+${toolArgsJson(block.arguments)}`);
 	else if (block.type === "tool-result") parts.push(blocksToText(block.content));
 	return parts.join("\n");
 }
@@ -111,6 +111,27 @@ function safeJson(value) {
 		return String(value);
 	}
 }
+/**
+* 工具调用参数的 JSON 文本（CDATA 内保持只有一层 JSON 转义）：
+* 字符串参数是模型产出的原始 JSON 串，原样返回（本身即合法 JSON，不再二次序列化）；
+* 其余结构 JSON.stringify 序列化一次。
+*/
+function toolArgsJson(args) {
+	if (typeof args === "string") return args;
+	return safeJson(args);
+}
+/**
+* 向元素追加 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] ?? ""}`));
+	}
+}
 /** 主会话判定：subagent 会话 header.origin === 'subagent'。 */
 function isMainSession(session) {
 	return session.header?.origin !== "subagent";
@@ -7388,7 +7409,8 @@ var import_lib = (/* @__PURE__ */ __commonJSMin(((exports) => {
 * 会话日志索引：完整消息索引与渲染。
 * 导出 indexCompleteMessages（完整消息四类折叠索引，recall 与摘要共用同一套编号）、
 * indexMessages / surfaceIndexOf / messageIdOfEvent（消息级定位辅助）、
-* collectImageRefs / toolResultMessageOf / renderToolResultText / renderCompleteMessageParts /
+* collectImageRefs / toolCallBlockOf / toolResultMessageOf / renderToolResultText /
+* renderCompleteMessageParts /
 * renderCompleteMessage（完整消息渲染与图片附件收集）。事件日志仅追加（被遮蔽的事件仍可读，
 * recall 依赖此性质）。
 *
@@ -7491,6 +7513,19 @@ function collectImageRefs(content, out) {
 	}
 }
 /**
+* 取 toolcall 完整消息对应的 tool-call 块（调用参数渲染与 XML 条目渲染共用）：
+* 非 toolcall、调用事件缺失或块内 id 不匹配时返回 undefined。
+*/
+function toolCallBlockOf(session, cm) {
+	if (cm.type !== "toolcall") return void 0;
+	const callSeq = cm.seqs[0];
+	const callEvent = callSeq === void 0 ? void 0 : session.events[callSeq];
+	if (callEvent?.type !== "assistant/message") return void 0;
+	const message = session.deriveEventMessage(callEvent);
+	if (!message || !Array.isArray(message.content)) return void 0;
+	for (const block of message.content) if (block.type === "tool-call" && String(block.id ?? "") === (cm.callId ?? "")) return block;
+}
+/**
 * 取 toolcall 完整消息的 tool/result 消息（超大结果经 pruner 裁剪）：
 * 结果文本渲染与 <skill> 条目正文共用；非 toolcall 或无配对 result 时返回 undefined。
 */
@@ -7546,19 +7581,8 @@ function renderCompleteMessageParts(session, cm, pruner) {
 		};
 	}
 	const parts = [];
-	const callSeq = cm.seqs[0];
-	const callEvent = callSeq === void 0 ? void 0 : session.events[callSeq];
-	if (callEvent?.type === "assistant/message") {
-		const message = session.deriveEventMessage(callEvent);
-		if (message && Array.isArray(message.content)) {
-			let call;
-			for (const block of message.content) if (block.type === "tool-call" && String(block.id ?? "") === (cm.callId ?? "")) {
-				call = block;
-				break;
-			}
-			if (call) parts.push(`[tool-call ${String(call.name ?? "")} id=${String(call.id ?? "")}]\n${safeJson(call.arguments)}`);
-		}
-	}
+	const call = toolCallBlockOf(session, cm);
+	if (call) parts.push(`[tool-call ${String(call.name ?? "")} id=${String(call.id ?? "")}]\n${toolArgsJson(call.arguments)}`);
 	const resultMessage = toolResultMessageOf(session, cm, pruner);
 	if (resultMessage && Array.isArray(resultMessage.content)) {
 		collectImageRefs(resultMessage.content, images);
@@ -7577,7 +7601,7 @@ function renderCompleteMessage(session, cm, pruner) {
 //#endregion
 //#region src/compress-view.ts
 /** 静默 DOMParser：非致命解析问题不刷 console，fatalError 仍抛 ParseError、解析语义不变。 */
-function newQuietParser() {
+function newQuietParser$1() {
 	return new import_lib.DOMParser({ onError: () => {} });
 }
 /**
@@ -7774,18 +7798,6 @@ function skillContentSections(text) {
 	};
 }
 /**
-* 向元素追加 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 区间）/ skill_content（name 属性 + index 定位）/ reasoning。
 * 整块无法解析或根非 <history> 时降级为单条不可定位的历史遗留条目（text 为块内文原文，
@@ -7799,7 +7811,7 @@ function parseBlockEntries(blockText, blockSeq) {
 	}];
 	let doc;
 	try {
-		doc = newQuietParser().parseFromString(blockText, "text/xml");
+		doc = newQuietParser$1().parseFromString(blockText, "text/xml");
 	} catch {
 		return opaque();
 	}
@@ -7948,7 +7960,7 @@ function entryToElement(doc, entry) {
 */
 function renderEntriesXml(entries) {
 	if (entries.length === 0) return "";
-	const doc = newQuietParser().parseFromString("<root />", "text/xml");
+	const doc = newQuietParser$1().parseFromString("<root />", "text/xml");
 	const serializer = new import_lib.XMLSerializer();
 	return entries.map((entry) => serializer.serializeToString(entryToElement(doc, entry))).join("\n");
 }
@@ -9640,7 +9652,7 @@ const RECALL_OUTPUT_SCHEMA = {
 	properties: {
 		text: {
 			type: "string",
-			description: "完整消息内容的文本部分（带图位置以 [图片附件：…] 标注行提示）。"
+			description: "完整消息的 XML 条目序列（CDATA 包裹正文；图片位置以 XML 注释 [图片附件：…] 标注）。"
 		},
 		images: {
 			type: "array",
@@ -9702,12 +9714,112 @@ function renderRecallOutput(value) {
 	return blocks;
 }
 //#endregion
+//#region src/recall-xml.ts
+/** 静默 DOMParser：非致命解析问题不刷 console。 */
+function newQuietParser() {
+	return new import_lib.DOMParser({ onError: () => {} });
+}
+/** XML 注释文本：注释内不允许连续连字符，`--` 统一替换为破折号。 */
+function xmlCommentText(text) {
+	return text.replace(/--/g, "——");
+}
+/** 向元素追加图片附件注释（每张图片一条，附在元素正文之后）。 */
+function appendImageComments(doc, el, images) {
+	for (const ref of images) el.appendChild(doc.createComment(` ${xmlCommentText(imageNote(ref))} `));
+}
+/** 正文有内容时以 CDATA 追加，无内容时不追加（元素自然自闭合或仅含注释）。 */
+function appendBodyText(doc, el, text) {
+	if (text !== "") appendCdataText(doc, el, text);
+}
+/** toolcall 完整消息的元素：<assistant type="toolcall"> 内嵌 <tool-args> / <tool-result>。 */
+function toolcallElement(doc, session, cm, pruner, images) {
+	const el = doc.createElement("assistant");
+	el.setAttribute("index", String(cm.index));
+	el.setAttribute("type", "toolcall");
+	const call = toolCallBlockOf(session, cm);
+	const toolName = call === void 0 ? "" : String(call.name ?? "");
+	if (toolName !== "") el.setAttribute("tool-name", toolName);
+	if (cm.callId) el.setAttribute("callId", cm.callId);
+	if (call) {
+		const args = doc.createElement("tool-args");
+		appendCdataText(doc, args, toolArgsJson(call.arguments));
+		el.appendChild(args);
+	}
+	const resultMessage = toolResultMessageOf(session, cm, pruner);
+	if (resultMessage && Array.isArray(resultMessage.content)) {
+		collectImageRefs(resultMessage.content, images);
+		const resultText = renderMessageText(resultMessage);
+		if (resultText.trim() !== "") {
+			const result = doc.createElement("tool-result");
+			appendCdataText(doc, result, resultText);
+			el.appendChild(result);
+		}
+	}
+	appendImageComments(doc, el, images);
+	return el;
+}
+/** 按完整消息类别构建元素（user / sys / assistant 文本条目复用 parts 渲染）。 */
+function buildElement(doc, session, cm, pruner, images) {
+	if (cm.type === "toolcall") return toolcallElement(doc, session, cm, pruner, images);
+	const parts = renderCompleteMessageParts(session, cm, pruner);
+	images.push(...parts.images);
+	if (cm.type === "sys") {
+		const el = doc.createElement("sys");
+		el.setAttribute("index", String(cm.index));
+		if (cm.kind !== void 0) el.setAttribute("type", cm.kind);
+		appendBodyText(doc, el, parts.text);
+		appendImageComments(doc, el, parts.images);
+		return el;
+	}
+	const el = doc.createElement(cm.type === "user" ? "user_message" : "assistant");
+	el.setAttribute("index", String(cm.index));
+	if (cm.type === "assistant") el.setAttribute("type", "text");
+	appendBodyText(doc, el, parts.text);
+	appendImageComments(doc, el, parts.images);
+	return el;
+}
+/** 主渲染失败时的回退元素：按完整消息类别输出最简形态，正文为回退文本。 */
+function fallbackElement(doc, cm, text) {
+	if (cm.type === "sys") {
+		const el = doc.createElement("sys");
+		el.setAttribute("index", String(cm.index));
+		if (cm.kind !== void 0) el.setAttribute("type", cm.kind);
+		return el;
+	}
+	const el = doc.createElement(cm.type === "user" ? "user_message" : "assistant");
+	el.setAttribute("index", String(cm.index));
+	if (cm.type !== "user") el.setAttribute("type", cm.type === "toolcall" ? "toolcall" : "text");
+	appendBodyText(doc, el, text);
+	return el;
+}
+/**
+* 渲染一条完整消息为 XML 条目（序列化后的字符串）与其携带的图片附件元数据。
+* 主渲染失败且提供 fallbackText 时降级为最简元素；两者皆不可用时向上抛出，
+* 由调用方决定跳过或回退。
+*/
+function renderCompleteMessageXml(session, cm, options = {}) {
+	const images = [];
+	const doc = newQuietParser().parseFromString("<root />", "text/xml");
+	let el;
+	try {
+		el = buildElement(doc, session, cm, options.pruner, images);
+	} catch (error) {
+		if (options.fallbackText === void 0) throw error;
+		images.length = 0;
+		el = fallbackElement(doc, cm, options.fallbackText);
+	}
+	return {
+		xml: new import_lib.XMLSerializer().serializeToString(el),
+		images
+	};
+}
+//#endregion
 //#region src/recall.ts
 /**
 * recall 工具：按完整消息 index 区间回看原始会话（含被压缩内容）。
 * 导出 recallArgsSchema / RecallArgs / parseRecallArgs / buildRecallTool。
-* 输出值为 { text, images }（契约见 recall-output.ts）；recall 自身不设输出上限，
-* 超大工具结果由 tool-result-pruner 裁剪。
+* 输出值为 { text, images }（契约见 recall-output.ts），text 为 XML 条目序列
+* （形态见 recall-xml.ts）；recall 自身不设输出上限，超大工具结果由 tool-result-pruner 裁剪。
 */
 /**
 * recall 工具参数 schema：start 必填；end 与 offset 至少提供一个（同时给出时 end 优先）。
@@ -9731,7 +9843,7 @@ function parseRecallArgs(raw) {
 function buildRecallTool(getPruner) {
 	return {
 		name: "recall",
-		description: `${COMPLETE_MESSAGE_DEFINITION}按 index 区间精确返回区间内全部完整消息的内容。`,
+		description: `在你需要查看历史消息时调用。${COMPLETE_MESSAGE_DEFINITION}此工具按 index 区间精确返回区间内全部完整消息的内容。`,
 		parameters: parametersFromZod(recallArgsSchema),
 		output: {
 			schema: RECALL_OUTPUT_SCHEMA,
@@ -9762,24 +9874,15 @@ function buildRecallTool(getPruner) {
 			for (let i = lo; i <= hi; i += 1) {
 				const cm = cms[i];
 				if (!cm) continue;
-				let text = "";
-				let cmImages = [];
 				try {
-					const rendered = renderCompleteMessageParts(session, cm, pruner);
-					text = rendered.text;
-					cmImages = rendered.images;
+					const rendered = renderCompleteMessageXml(session, cm, { pruner });
+					parts.push(rendered.xml);
+					images.push(...rendered.images);
 				} catch {}
-				const callAttr = cm.type === "toolcall" && cm.callId ? ` callId=${cm.callId}` : "";
-				let body = text;
-				if (cmImages.length > 0) {
-					body += (body === "" ? "" : "\n") + cmImages.map(imageNote).join("\n");
-					images.push(...cmImages);
-				}
-				parts.push(`-- [index ${cm.index}] ${cm.type}${callAttr} --\n${body}`);
 			}
 			if (parts.length === 0) return textOnly("指定区间没有完整消息");
 			return {
-				text: parts.join("\n\n"),
+				text: parts.join("\n"),
 				images
 			};
 		}
@@ -9794,7 +9897,9 @@ function buildRecallTool(getPruner) {
 * resolveSemanticRange / tokenize / matchExplanation / buildSemanticRecallTool。
 * 向量为本地 ONNX 嵌入（cosine 相似度）；只匹配文本，纯图片消息不进候选池；
 * 区间缺省检索全部、区间不合法回退全量并在输出中告知；输出契约同 recall
-* （{ text, images }，超大结果由 tool-result-pruner 裁剪）；仅主会话可用。
+* （{ text, images }，条目为 XML 形态见 recall-xml.ts，超大结果由 tool-result-pruner
+* 裁剪）；候选池排除本次调用自身的 toolcall 完整消息（其渲染文本含 query 原文，
+* 必居榜首）；仅主会话可用。
 */
 /** recall-semantic 工具参数 schema：query 必填；top_k 默认 3（1-10）；区间参数均可选。 */
 const semanticRecallArgsSchema = z.object({
@@ -9882,7 +9987,7 @@ function buildSemanticRecallTool(options) {
 	const embed = options?.embedder ?? ((texts) => getEmbedder().then((fn) => fn(texts)));
 	return {
 		name: "recall-semantic",
-		description: `${COMPLETE_MESSAGE_DEFINITION}按自然语言含义检索最符合的完整消息，默认全量搜索，可指定区间。注意：只匹配文本。`,
+		description: `在你需要按语义检索历史消息时调用。${COMPLETE_MESSAGE_DEFINITION}此工具按自然语言含义检索最符合的完整消息，默认全量搜索，可指定区间。注意：只匹配文本。`,
 		parameters: parametersFromZod(semanticRecallArgsSchema),
 		output: {
 			schema: RECALL_OUTPUT_SCHEMA,
@@ -9901,10 +10006,12 @@ function buildSemanticRecallTool(options) {
 				end,
 				offset
 			});
+			const selfCallId = String(exec.callId ?? "");
 			const candidates = [];
 			for (let i = range.lo; i <= range.hi; i += 1) {
 				const cm = cms[i];
 				if (!cm) continue;
+				if (selfCallId !== "" && cm.type === "toolcall" && cm.callId === selfCallId) continue;
 				let text = "";
 				try {
 					text = renderCompleteMessage(session, cm);
@@ -9929,27 +10036,32 @@ function buildSemanticRecallTool(options) {
 			const parts = [];
 			const images = [];
 			const rangeNote = range.fallback ? "指定区间不合法（start/end 越界等），已回退检索全部消息" : start === void 0 ? `检索全部消息（${candidates.length} 条可嵌入）` : `检索区间 [${range.lo}..${range.hi}]（${candidates.length} 条可嵌入）`;
-			parts.push(`查询: ${query}`);
-			parts.push(rangeNote);
-			parts.push(`匹配 TOP-${hits.length}（共 ${scored.length} 条候选）:`);
+			parts.push(`<!-- ${xmlCommentText(`查询: ${query}`)} -->`);
+			parts.push(`<!-- ${xmlCommentText(rangeNote)} -->`);
+			parts.push(`<!-- ${xmlCommentText(`匹配 TOP-${hits.length}（共 ${scored.length} 条候选）`)} -->`);
 			for (let i = 0; i < hits.length; i += 1) {
 				const hit = hits[i];
 				if (!hit) continue;
-				const callAttr = hit.cm.type === "toolcall" && hit.cm.callId ? ` callId=${hit.cm.callId}` : "";
-				let text = hit.text;
+				const note = `<!-- ${xmlCommentText(`${i + 1}. ${matchExplanation(query, hit.text, hit.score)}`)} -->`;
+				let xml;
 				let hitImages = [];
 				try {
 					const pruner = getPruner();
-					const rendered = renderCompleteMessageParts(session, hit.cm, pruner);
-					text = rendered.text;
+					const rendered = renderCompleteMessageXml(session, hit.cm, {
+						pruner,
+						fallbackText: hit.text
+					});
+					xml = rendered.xml;
 					hitImages = rendered.images;
-				} catch {}
-				parts.push(`-- [${i + 1}] index ${hit.cm.index} ${hit.cm.type}${callAttr} — ${matchExplanation(query, hit.text, hit.score)} --`);
-				parts.push(hitImages.length > 0 ? [text, ...hitImages.map(imageNote)].join("\n") : text);
+				} catch {
+					xml = hit.text;
+				}
+				parts.push(note);
+				parts.push(xml);
 				images.push(...hitImages);
 			}
 			return {
-				text: parts.join("\n\n"),
+				text: parts.join("\n"),
 				images
 			};
 		}

package/dist/log-index.d.ts

@@ -21,6 +21,15 @@ export declare function indexCompleteMessages(session: Session): CompleteMessage
  * image 块按附件元数据收集（字段不全则忽略）；tool-result 块递归收集其 content。
  */
 export declare function collectImageRefs(content: unknown, out: ImageRefValue[]): void;
+/**
+ * 取 toolcall 完整消息对应的 tool-call 块（调用参数渲染与 XML 条目渲染共用）：
+ * 非 toolcall、调用事件缺失或块内 id 不匹配时返回 undefined。
+ */
+export declare function toolCallBlockOf(session: Session, cm: CompleteMessage): {
+    name?: unknown;
+    id?: unknown;
+    arguments?: unknown;
+} | undefined;
 /**
  * 取 toolcall 完整消息的 tool/result 消息（超大结果经 pruner 裁剪）：
  * 结果文本渲染与 <skill> 条目正文共用；非 toolcall 或无配对 result 时返回 undefined。

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,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"}
+{"version":3,"file":"log-index.d.ts","sourceRoot":"","sources":["../src/log-index.ts"],"names":[],"mappings":"AAcA,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,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,GAClB;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAWnE;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,CAoC3C;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAER"}

package/dist/recall-output.d.ts

@@ -1,8 +1,9 @@
 /**
  * recall / recall-semantic 共享输出契约：输出值为固定形态 { text, images }。
- * text 为完整消息的文本内容（带图消息附图片标注行），images 为图片附件元数据
- * （按 attachmentId 引用，不含字节）。导出 ImageRefValue / RecallOutputValue /
- * RECALL_OUTPUT_SCHEMA / textOnly / imageNote / renderRecallOutput。
+ * text 为完整消息的 XML 条目序列（形态见 recall-xml.ts，图片位置以 XML 注释标注），
+ * images 为图片附件元数据（按 attachmentId 引用，不含字节）。
+ * 导出 ImageRefValue / RecallOutputValue / RECALL_OUTPUT_SCHEMA / textOnly / imageNote /
+ * renderRecallOutput。
  */
 import type { ContentBlock } from '@deepseek-ai/dsh-llm';
 import type { JsonSchemaNode } from '@deepseek-ai/dsh-tools';

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

@@ -1 +1 @@
-{"version":3,"file":"recall-output.d.ts","sourceRoot":"","sources":["../src/recall-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG;IAC1B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF,uBAAuB;AACvB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAExD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAGpD;AAED,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,cA4BlC,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAY3E"}
+{"version":3,"file":"recall-output.d.ts","sourceRoot":"","sources":["../src/recall-output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG;IAC1B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF,uBAAuB;AACvB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAExD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAGpD;AAED,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,cA6BlC,CAAC;AAEF,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAY3E"}

package/dist/recall-xml.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 完整消息的 XML 条目渲染：recall / recall-semantic 的输出条目形态。
+ * 每条完整消息渲染为一个 XML 元素，正文统一以 CDATA 包裹（逐字原样，不做实体转义与
+ * 再次序列化），从构建源头避免多层转义：
+ * - user → <user_message index>，正文 CDATA，图片等非文本块为 XML 注释
+ * - sys → <sys index type>，无正文时自闭合（与压缩日志的 sys 条目同形态）
+ * - assistant 文本 → <assistant index type="text">，正文 CDATA
+ * - toolcall → <assistant index type="toolcall" tool-name callId>，内嵌 <tool-args>
+ *   （合法 JSON，仅一层 JSON 转义）与 <tool-result>（工具返回正文）两个 CDATA 子元素
+ * 导出 RenderCompleteMessageXmlOptions / renderCompleteMessageXml / xmlCommentText。
+ */
+import { type PrunerLike } from './log-index.ts';
+import { type ImageRefValue } from './recall-output.ts';
+import type { CompleteMessage, Session } from './types.ts';
+/** 渲染选项：pruner 裁剪超大工具结果；fallbackText 为主渲染失败时的回退正文。 */
+export type RenderCompleteMessageXmlOptions = {
+    pruner?: PrunerLike | undefined;
+    fallbackText?: string;
+};
+/** XML 注释文本：注释内不允许连续连字符，`--` 统一替换为破折号。 */
+export declare function xmlCommentText(text: string): string;
+/**
+ * 渲染一条完整消息为 XML 条目（序列化后的字符串）与其携带的图片附件元数据。
+ * 主渲染失败且提供 fallbackText 时降级为最简元素；两者皆不可用时向上抛出，
+ * 由调用方决定跳过或回退。
+ */
+export declare function renderCompleteMessageXml(session: Session, cm: CompleteMessage, options?: RenderCompleteMessageXmlOptions): {
+    xml: string;
+    images: ImageRefValue[];
+};
+//# sourceMappingURL=recall-xml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall-xml.d.ts","sourceRoot":"","sources":["../src/recall-xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,aAAa,EAAa,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG3D,sDAAsD;AACtD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAOF,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AA0FD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,eAAe,EACnB,OAAO,GAAE,+BAAoC,GAC5C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAY1C"}

package/dist/recall.d.ts

@@ -1,8 +1,8 @@
 /**
  * recall 工具：按完整消息 index 区间回看原始会话（含被压缩内容）。
  * 导出 recallArgsSchema / RecallArgs / parseRecallArgs / buildRecallTool。
- * 输出值为 { text, images }（契约见 recall-output.ts）；recall 自身不设输出上限，
- * 超大工具结果由 tool-result-pruner 裁剪。
+ * 输出值为 { text, images }（契约见 recall-output.ts），text 为 XML 条目序列
+ * （形态见 recall-xml.ts）；recall 自身不设输出上限，超大工具结果由 tool-result-pruner 裁剪。
  */
 import { z } from 'zod';
 import type { ToolDefinition } from './types.ts';

package/dist/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAYzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAUxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CAoEzE"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src/recall.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;iBAYzB,CAAC;AAEL,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAUxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,GAAG,cAAc,CA2DzE"}

package/dist/semantic-recall.d.ts

@@ -5,7 +5,9 @@
  * resolveSemanticRange / tokenize / matchExplanation / buildSemanticRecallTool。
  * 向量为本地 ONNX 嵌入（cosine 相似度）；只匹配文本，纯图片消息不进候选池；
  * 区间缺省检索全部、区间不合法回退全量并在输出中告知；输出契约同 recall
- * （{ text, images }，超大结果由 tool-result-pruner 裁剪）；仅主会话可用。
+ * （{ text, images }，条目为 XML 形态见 recall-xml.ts，超大结果由 tool-result-pruner
+ * 裁剪）；候选池排除本次调用自身的 toolcall 完整消息（其渲染文本含 query 原文，
+ * 必居榜首）；仅主会话可用。
  */
 import { z } from 'zod';
 import { type EmbedFn, type ModelStatus } from './embedding.ts';

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;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAgB/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBAoBjC,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,CAUxE;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;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CAqBb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAMlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnF;AAED,qCAAqC;AACrC,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,CA+EjB"}
+{"version":3,"file":"semantic-recall.d.ts","sourceRoot":"","sources":["../src/semantic-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAW/F,OAAO,KAAK,EAAmB,cAAc,EAAkB,MAAM,YAAY,CAAC;AAGlF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;iBAoBjC,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,CAUxE;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;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC,GACzD,WAAW,CAqBb;AAED,uCAAuC;AACvC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAMlD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnF;AAED,qCAAqC;AACrC,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,CAsFjB"}

package/dist/utils.d.ts

@@ -1,9 +1,10 @@
 /**
  * 零依赖工具函数：文本呈现、主会话判定、路由解析等通用辅助（不 import 运行时包）。
- * 导出 isRecord / uuid / blocksToText / textCharCount / renderMessageText / safeJson /
- * isMainSession / routedTarget。
+ * 导出 isRecord / uuid / blocksToText / textCharCount / renderMessageText / toolArgsJson /
+ * safeJson / appendCdataText / isMainSession / routedTarget。
  */
 import type { Message } from '@deepseek-ai/dsh-llm';
+import type { Document, Element } from '@xmldom/xmldom';
 import type { Session } from './types.ts';
 /** 判断值是否为普通对象（非 null、非数组）。 */
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
@@ -17,6 +18,17 @@ export declare function textCharCount(message: Message | null | undefined): numb
 export declare function renderMessageText(message: Message | null | undefined): string;
 /** 安全 JSON 序列化：序列化失败时退回 String 呈现。 */
 export declare function safeJson(value: unknown): string;
+/**
+ * 工具调用参数的 JSON 文本（CDATA 内保持只有一层 JSON 转义）：
+ * 字符串参数是模型产出的原始 JSON 串，原样返回（本身即合法 JSON，不再二次序列化）；
+ * 其余结构 JSON.stringify 序列化一次。
+ */
+export declare function toolArgsJson(args: unknown): string;
+/**
+ * 向元素追加 CDATA 正文：正文统一以 CDATA 包裹（逐字原样，不做实体转义）。
+ * 正文含 ]]> 时拆为相邻多个 CDATA 段，拼接后逐字还原原文，对读取方透明。
+ */
+export declare function appendCdataText(doc: Document, el: Element, text: string): void;
 /** 主会话判定：subagent 会话 header.origin === 'subagent'。 */
 export declare function isMainSession(session: Session): boolean;
 /** 会话路由目标：provider + model。 */

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,iDAAiD;AACjD,wBAAgB,IAAI,IAAI,MAAM,CAI7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc7E;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAQvE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,iDAAiD;AACjD,wBAAgB,IAAI,IAAI,MAAM,CAI7B;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAWzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAc7E;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGlD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAW9E;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAQvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-om",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "type": "module",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",