@cicctencent/agent-core 1.0.17 → 1.0.18

package/dist/cjs/utils/token-counter.js

@@ -1,6 +1,6 @@
 "use strict";
 // ============================================================
-// Token 计数器 — 基于 tiktoken 的精确 token 计数
+// Token 计数器 - 基于 tiktoken 的精确 token 计数
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.countTokens = countTokens;
@@ -9,15 +9,21 @@ exports.estimateTokens = estimateTokens;
 const js_tiktoken_1 = require("js-tiktoken");
 /** 默认编码器（cl100k_base，兼容 GPT-4 / Claude 等主流模型） */
 let encoder = null;
+/** 字符估算伪编码器（tiktoken 不可用时兜底，约 4 字符 ≈ 1 token） */
+function createFallbackEncoder() {
+    return { encode: (text) => new Array(Math.ceil(text.length / 4)) };
+}
 /**
  * LRU 缓存：避免对相同文本重复计算 token
  * 缓存容量 2000 条，命中率高时可显著减少 encode 调用
+ * lastInsertedKey 追踪最近写入的 key，命中时若为同 key 则跳过 delete+set
  */
 const TOKEN_CACHE_MAX = 2000;
 const tokenCache = new Map();
+let lastInsertedKey;
 /**
  * 获取 tiktoken 编码器实例（延迟初始化）
- * P2 #13: 兼容 ESM 环境 — require 可能未定义，回退到字符估算
+ * 兼容 ESM 环境 - require 可能未定义，回退到字符估算
  */
 function getEncoder() {
     if (encoder)
@@ -27,21 +33,13 @@ function getEncoder() {
     }
     catch {
         try {
-            // P2 #13: ESM 兼容 — 尝试 require，失败则回退到字符估算
             const ranks = (typeof require !== 'undefined')
                 ? require('js-tiktoken/ranks/cl100k_base')
                 : undefined;
-            if (ranks) {
-                encoder = new js_tiktoken_1.Tiktoken(ranks);
-            }
-            else {
-                // ESM 环境无法加载 ranks — 使用伪 encoder 走字符估算
-                encoder = { encode: (text) => new Array(Math.ceil(text.length / 4)) };
-            }
+            encoder = ranks ? new js_tiktoken_1.Tiktoken(ranks) : createFallbackEncoder();
         }
         catch {
-            // 完全无法加载 tiktoken — 使用伪 encoder 走字符估算
-            encoder = { encode: (text) => new Array(Math.ceil(text.length / 4)) };
+            encoder = createFallbackEncoder();
         }
     }
     return encoder;
@@ -57,9 +55,12 @@ function countTokens(text) {
     // 缓存查找
     const cached = tokenCache.get(text);
     if (cached !== undefined) {
-        // LRU: 删除旧位置并在末尾重新插入
-        tokenCache.delete(text);
-        tokenCache.set(text, cached);
+        // LRU: 仅当不是最近插入的条目时才移动到末尾（O(1) 判断，避免展开全部 keys）
+        if (lastInsertedKey !== text) {
+            tokenCache.delete(text);
+            tokenCache.set(text, cached);
+            lastInsertedKey = text;
+        }
         return cached;
     }
     const count = getEncoder().encode(text).length;
@@ -71,6 +72,7 @@ function countTokens(text) {
             tokenCache.delete(oldestKey);
     }
     tokenCache.set(text, count);
+    lastInsertedKey = text;
     return count;
 }
 /**
@@ -80,6 +82,8 @@ function countTokens(text) {
  * @returns 总 token 数量
  */
 function countMessageTokens(messages) {
+    if (!messages || messages.length === 0)
+        return 0;
     let total = 0;
     for (const msg of messages) {
         // 每条消息 overhead: role + content 分隔
@@ -119,7 +123,7 @@ function countMessageTokens(messages) {
  * - TextPart: 精确计数
  * - ImagePart: 按详情级别估算（参考 OpenAI Vision 定价）
  *   - low: ~85 tokens（512x512 固定）
- *   - high: ~170 tokens/tile（最多 4 tiles → ~680）
+ *   - high: ~170 tokens/tile（最多 4 tiles -> ~680）
  *   - auto: 默认按 low 估算
  * - FilePart: 计数文本内容
  */

package/dist/cjs/utils/token-counter.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../../src/utils/token-counter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../../../src/utils/token-counter.ts"],"names":[],"mappings":"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"}

package/dist/esm/agent/compaction.d.ts

@@ -0,0 +1,26 @@
+import type { ToolDefinition } from '../tool/types.js';
+/**
+ * 生成工具调用的简短摘要（用于历史摘要）。
+ * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
+ *
+ * @param name 工具名
+ * @param args 工具参数
+ */
+export declare function summarizeToolCall(name: string, args: Record<string, unknown>): string;
+/** 工具定义摘要选项 */
+export interface SummarizeToolDefOptions {
+    /** 摘要范围：'mcp'=仅 MCP 工具摘要, 'all'=所有传入工具摘要, null=保持原样 */
+    scope: 'mcp' | 'all' | null;
+    /** 最大描述长度（默认 100） */
+    maxDesc?: number;
+    /** 判断工具分类的回调（由调用方注入 ToolRegistry 依赖，保持此处无硬依赖） */
+    getCategory?: (name: string) => string | undefined;
+}
+/**
+ * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
+ *
+ * @param def 原始工具定义
+ * @param options 摘要选项（含 category 查询注入）
+ */
+export declare function summarizeToolDef(def: ToolDefinition, options: SummarizeToolDefOptions): ToolDefinition;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/esm/agent/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/agent/compaction.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAkBvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA0BrF;AAED,eAAe;AACf,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,uBAAuB,GAC/B,cAAc,CAoBhB"}

package/dist/esm/agent/compaction.js

@@ -0,0 +1,91 @@
+// ============================================================
+// Compaction — 历史压缩纯逻辑（从 engine.ts 抽离）
+// ============================================================
+//
+// 本文件承载 AgentEngine 历史压缩相关的「纯函数」部分，与运行时/LLM 调用解耦，
+// 以便独立单元测试。拆分目标：在重构 engine.ts（~2000 行）前，先锁定这些
+// 可被精确断言的纯逻辑行为，避免拆分引入隐性回归。
+//
+// 依赖说明：
+// - summarizeToolCall: 无外部依赖，纯字符串变换
+// - summarizeToolDef: 需要 ToolRegistry 判断 category（保留轻量依赖）
+/**
+ * 安全序列化值为字符串（处理 JSON.stringify 的边界情况）。
+ * - undefined / function / Symbol → String(v)
+ * - 循环引用 → '[Circular]'
+ */
+function safeSerialize(v) {
+    if (v === undefined || typeof v === 'function' || typeof v === 'symbol') {
+        return String(v);
+    }
+    try {
+        return JSON.stringify(v) ?? String(v);
+    }
+    catch {
+        return '[Circular]';
+    }
+}
+/**
+ * 生成工具调用的简短摘要（用于历史摘要）。
+ * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
+ *
+ * @param name 工具名
+ * @param args 工具参数
+ */
+export function summarizeToolCall(name, args) {
+    switch (name) {
+        case 'delegate_task': {
+            const agent = args.agent || '';
+            const task = typeof args.task === 'string' ? args.task.slice(0, 80) : '';
+            return `delegate_task(agent=${agent}, task="${task}...")`;
+        }
+        case 'create_report':
+        case 'create_presentation':
+        case 'create_document':
+        case 'create_pdf':
+        case 'save_artifact': {
+            const filename = (args.filename || args.title || '').slice(0, 60);
+            return `${name}(filename="${filename}")`;
+        }
+        default: {
+            // 通用：展示前 3 个参数的键名和值摘要
+            const keys = Object.keys(args).slice(0, 3);
+            const parts = keys.map(k => {
+                const v = args[k];
+                const s = typeof v === 'string' ? v.slice(0, 50) : safeSerialize(v).slice(0, 50);
+                return `${k}=${s}`;
+            });
+            return `${name}(${parts.join(', ')})`;
+        }
+    }
+}
+/**
+ * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
+ *
+ * @param def 原始工具定义
+ * @param options 摘要选项（含 category 查询注入）
+ */
+export function summarizeToolDef(def, options) {
+    const { scope, maxDesc = 100, getCategory } = options;
+    if (scope === null)
+        return def;
+    if (scope === 'mcp' && getCategory?.(def.function.name) !== 'mcp')
+        return def;
+    const desc = def.function.description.length > maxDesc
+        ? def.function.description.slice(0, maxDesc) + '...'
+        : def.function.description;
+    return {
+        ...def,
+        type: 'function',
+        function: {
+            name: def.function.name,
+            description: desc + ` (use read_tool_doc to get full schema before calling; use read_tool_doc(tool_name="list") to see all available tools)`,
+            parameters: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        },
+    };
+}
+//# sourceMappingURL=compaction.js.map

package/dist/esm/agent/compaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.js","sourceRoot":"","sources":["../../../src/agent/compaction.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,uCAAuC;AACvC,+DAA+D;AAC/D,EAAE;AACF,kDAAkD;AAClD,8CAA8C;AAC9C,2BAA2B;AAC3B,EAAE;AACF,QAAQ;AACR,oCAAoC;AACpC,0DAA0D;AAI1D;;;;GAIG;AACH,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAA6B;IAC3E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,OAAO,uBAAuB,KAAK,WAAW,IAAI,OAAO,CAAC;QAC5D,CAAC;QACD,KAAK,eAAe,CAAC;QACrB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,iBAAiB,CAAC;QACvB,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAkB,IAAI,IAAI,CAAC,KAAe,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtF,OAAO,GAAG,IAAI,cAAc,QAAQ,IAAI,CAAC;QAC3C,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,sBAAsB;YACtB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACzB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjF,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAmB,EACnB,OAAgC;IAEhC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IACtD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,GAAG,CAAC;IAC/B,IAAI,KAAK,KAAK,KAAK,IAAI,WAAW,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IAC9E,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,OAAO;QACpD,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,KAAK;QACpD,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC7B,OAAO;QACL,GAAG,GAAG;QACN,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;YACvB,WAAW,EAAE,IAAI,GAAG,wHAAwH;YAC5I,UAAU,EAAE;gBACV,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/agent/engine.d.ts

@@ -140,8 +140,7 @@ export declare class AgentEngine {
     private resolveToolDefs;
     /**
      * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
-     * @param def 原始工具定义
-     * @param scope 摘要范围：'mcp'=仅MCP工具摘要, 'all'=所有传入工具摘要, null=保持原样
+     * 实现抽离至 ./compaction.ts，保持单一来源。
      */
     private summarizeToolDef;
     /** 构建 ToolContext */
@@ -167,16 +166,16 @@ export declare class AgentEngine {
      * - 且这些调用**全部失败** → 最终产出的数据必然来自模型记忆（真实历史或编造，执行层无法区分）；
      * - → 追加「未经实时核验」声明。
      *
-     * 不触发（正确放行）：
-     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
-     * - 外部数据工具**有成功** → 数据已核验，无需水印。
-     *
-     * @returns 需要追加的声明文本；无需水印时返回空串
-     */
-    private buildProvenanceNotice;
     /**
      * 对最终回复应用数据出处水印（幂等）。
      * 仅当有实际文本内容、需要水印、且尚未包含水印标记时追加。
+     *
+     * 触发（添加水印）：
+     * - 本轮调用过外部数据获取工具且全部失败 → 最终回复中的数据必然来自记忆 → 需要声明；
+     *
+     * 不触发（正确放行）：
+     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
+     * - 外部数据工具**有成功** → 数据已核验，无需水印。
      */
     private applyProvenanceNotice;
     /**

package/dist/esm/agent/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine.ts"],"names":[],"mappings":"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"}

package/dist/esm/agent/engine.js

@@ -9,6 +9,7 @@ import { LLMCaller } from "./llm-caller.js";
 import { AgentToolExecutor } from "./tool-executor.js";
 import { logEvent } from "../observability/logger.js";
 import { rateLimitManager } from "./rate-limit-manager.js";
+import { summarizeToolCall, summarizeToolDef } from "./compaction.js";
 /** 默认系统提示词 */
 const DEFAULT_BASE_PROMPT = `You are a helpful AI assistant with access to tools. Use tools when needed to accomplish tasks. Always explain your actions clearly.`;
 /**
@@ -68,42 +69,27 @@ function buildSkillCatalog(skillManager) {
     const manifests = skillManager.getAllManifests();
     if (manifests.length === 0)
         return null;
+    let hasResources = false;
     const lines = manifests.map(m => {
         const aliases = m.aliases?.length ? ` (also known as: ${m.aliases.join(', ')})` : '';
-        return `- \`${m.id}\`: ${m.name}${aliases} — ${m.description || '(no description)'}`;
+        // 标注标准目录包资源（脚本/参考文档/静态资源），引导 agent 按需访问
+        const res = m.resources;
+        const badges = [];
+        if (res?.scripts?.length)
+            badges.push(`${res.scripts.length} scripts`);
+        if (res?.references?.length)
+            badges.push(`${res.references.length} refs`);
+        if (res?.assets?.length)
+            badges.push(`${res.assets.length} assets`);
+        if (badges.length)
+            hasResources = true;
+        const resBadge = badges.length ? ` [resources: ${badges.join(', ')}]` : '';
+        return `- \`${m.id}\`: ${m.name}${aliases} — ${m.description || '(no description)'}${resBadge}`;
     });
-    return `## Available Skills\n\nYou have access to the following skills. **Before using any tools, ALWAYS check if the user's request matches one of these skills first.** If a skill is relevant, call \`load_skill(skill_id="<id>")\` to load its full instructions, then follow those instructions. Skill names and aliases may not exactly match the user's wording - use semantic judgment to identify matches.\n\n${lines.join('\n')}`;
-}
-/**
- * 生成工具调用的简短摘要（用于历史摘要）。
- * 保留工具名和关键参数，让 LLM 在后续轮次中能复用之前的调用参数。
- */
-function summarizeToolCall(name, args) {
-    switch (name) {
-        case 'delegate_task': {
-            const agent = args.agent || '';
-            const task = typeof args.task === 'string' ? args.task.slice(0, 80) : '';
-            return `delegate_task(agent=${agent}, task="${task}...")`;
-        }
-        case 'create_report':
-        case 'create_presentation':
-        case 'create_document':
-        case 'create_pdf':
-        case 'save_artifact': {
-            const filename = (args.filename || args.title || '').slice(0, 60);
-            return `${name}(filename="${filename}")`;
-        }
-        default: {
-            // 通用：展示前 3 个参数的键名和值摘要
-            const keys = Object.keys(args).slice(0, 3);
-            const parts = keys.map(k => {
-                const v = args[k];
-                const s = typeof v === 'string' ? v.slice(0, 50) : JSON.stringify(v)?.slice(0, 50);
-                return `${k}=${s}`;
-            });
-            return `${name}(${parts.join(', ')})`;
-        }
-    }
+    const resourceGuide = hasResources
+        ? `\n\nSkills marked with [resources: ...] are standard packages bundling docs and scripts. After loading such a skill with load_skill, read bundled reference docs on demand via \`read_skill_reference(skill_id, path)\` and execute bundled scripts via \`run_skill_script(skill_id, script, args)\` — do NOT read all resources upfront.`
+        : '';
+    return `## Available Skills\n\nYou have access to the following skills. **Before using any tools, ALWAYS check if the user's request matches one of these skills first.** If a skill is relevant, call \`load_skill(skill_id="<id>")\` to load its full instructions, then follow those instructions. Skill names and aliases may not exactly match the user's wording - use semantic judgment to identify matches.\n\n${lines.join('\n')}${resourceGuide}`;
 }
 export class AgentEngine {
     config;
@@ -726,31 +712,14 @@ ${textHistory.join('\n')}`;
     }
     /**
      * 将工具定义转为摘要形式（截断 description + 清空 parameters）。
-     * @param def 原始工具定义
-     * @param scope 摘要范围：'mcp'=仅MCP工具摘要, 'all'=所有传入工具摘要, null=保持原样
+     * 实现抽离至 ./compaction.ts，保持单一来源。
      */
     summarizeToolDef(def, scope) {
-        if (scope === null)
-            return def;
-        const tool = this.config.toolRegistry.get(def.function.name);
-        if (scope === 'mcp' && tool?.category !== 'mcp')
-            return def;
-        const maxDesc = this.config.toolSummaryMaxDesc ?? 100;
-        const desc = def.function.description.length > maxDesc
-            ? def.function.description.slice(0, maxDesc) + '...'
-            : def.function.description;
-        return {
-            type: 'function',
-            function: {
-                name: def.function.name,
-                description: desc + ` (use read_tool_doc to get full schema before calling; use read_tool_doc(tool_name="list") to see all available tools)`,
-                parameters: {
-                    type: 'object',
-                    properties: {},
-                    required: [],
-                },
-            },
-        };
+        return summarizeToolDef(def, {
+            scope,
+            maxDesc: this.config.toolSummaryMaxDesc ?? 100,
+            getCategory: (name) => this.config.toolRegistry.get(name)?.category,
+        });
     }
     // ---- 准备阶段（续） ----
     /** 构建 ToolContext */
@@ -1183,32 +1152,25 @@ ${textHistory.join('\n')}`;
      * - 且这些调用**全部失败** → 最终产出的数据必然来自模型记忆（真实历史或编造，执行层无法区分）；
      * - → 追加「未经实时核验」声明。
      *
-     * 不触发（正确放行）：
-     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
-     * - 外部数据工具**有成功** → 数据已核验，无需水印。
-     *
-     * @returns 需要追加的声明文本；无需水印时返回空串
-     */
-    buildProvenanceNotice(state) {
-        const externalCalls = state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool));
-        if (externalCalls.length === 0)
-            return ''; // 未尝试外部数据源 → 不判定
-        if (externalCalls.some(r => !r.isError))
-            return ''; // 有成功获取 → 视为已核验
-        return PROVENANCE_UNVERIFIED_NOTICE; // 尝试过但全失败 → 数据来自记忆
-    }
     /**
      * 对最终回复应用数据出处水印（幂等）。
      * 仅当有实际文本内容、需要水印、且尚未包含水印标记时追加。
+     *
+     * 触发（添加水印）：
+     * - 本轮调用过外部数据获取工具且全部失败 → 最终回复中的数据必然来自记忆 → 需要声明；
+     *
+     * 不触发（正确放行）：
+     * - 从未调用外部数据工具（纯本地/推理任务）→ 无需水印；
+     * - 外部数据工具**有成功** → 数据已核验，无需水印。
      */
     applyProvenanceNotice(state, content) {
         if (!content || content.includes(PROVENANCE_MARKER))
             return content;
-        const notice = this.buildProvenanceNotice(state);
-        if (!notice)
+        const externalCalls = state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool));
+        if (externalCalls.length === 0 || externalCalls.some(r => !r.isError))
             return content;
-        logEvent({ event: 'engine.provenance_notice', sessionId: state.sessionId, level: 'warn', data: { iteration: state.iteration, externalCalls: state.toolCallRecords.filter(r => this.externalDataFetchTools.has(r.tool)).length } });
-        return content + notice;
+        logEvent({ event: 'engine.provenance_notice', sessionId: state.sessionId, level: 'warn', data: { iteration: state.iteration, externalCalls: externalCalls.length } });
+        return content + PROVENANCE_UNVERIFIED_NOTICE;
     }
     /**
      * 生成兜底总结（当 LLM 调用失败或无内容输出时使用）。