@zooique/memora 3.0.1 → 5.0.0

package/dist/utils/eventEmitter.d.ts

@@ -1,12 +1,26 @@
 import type { AskQuestion } from '../agent/types.js';
+import type { CompressTarget } from '../agent/loop.js';
+import type { BackgroundTaskNaturalStatus } from '../agent/backgroundTasks.js';
 /** Agent 事件名常量（运行时真理源，与 AgentEventMap 键集一致） */
 export declare const AGENT_EVENTS: {
     readonly memoryAdded: "memoryAdded";
     readonly rolePackSwitched: "rolePackSwitched";
     readonly memoryRecalled: "memoryRecalled";
     readonly sessionForked: "sessionForked";
-    readonly projectSwitched: "projectSwitched";
+    /**
+     * 会话身份切换完成（switchToSession 换会话成功后触发，载荷指向**被切走的旧会话**）。
+     * 内核自消费事件：agent 归档监听器据此对旧会话做会话级归档（summary/keyTopics 进
+     * SessionMeta 搜索索引）。宿主零消费 = 刻意设计（宿主是切换发起方，无增量信息），
+     * protocolGuard V-2 已登记 KERNEL_SELF_CONSUMED_EVENTS 豁免。
+     */
+    readonly sessionSwitched: "sessionSwitched";
     readonly archiveFailed: "archiveFailed";
+    /**
+     * 会话归档写入成功（updatedFields 非空才发，与 archiveFailed 对称）。
+     * 宿主据此重拉会话列表：切走时归档异步完成，列表快照若无此信号则条目摘要永不更新
+     * （悬停 tooltip 一直为空）。手动触发同样经 ArchiveCoordinator 发射。
+     */
+    readonly sessionArchived: "sessionArchived";
     readonly contextTruncated: "contextTruncated";
     /** LLM 主动压缩完成（第二级压缩，与 contextTruncated 的内核自动截断区分） */
     readonly contextCompressed: "contextCompressed";
@@ -14,7 +28,6 @@ export declare const AGENT_EVENTS: {
     readonly archiveModeChanged: "archiveModeChanged";
     readonly rolePackSwitchLocked: "rolePackSwitchLocked";
     readonly workProjectionGenerated: "workProjectionGenerated";
-    readonly dedupCompleted: "dedupCompleted";
     readonly sessionPauseTimedOut: "sessionPauseTimedOut";
     readonly sessionResumeBlocked: "sessionResumeBlocked";
     /** 订阅时宿主据此判断重要事件并 toast 提示 */
@@ -23,7 +36,6 @@ export declare const AGENT_EVENTS: {
     readonly inputTooLarge: "inputTooLarge";
     /** 回答中 LLM 调 ask_user 工具主动提问（唯一「提问后暂停」通道） */
     readonly questionPending: "questionPending";
-    readonly goalDriftDetected: "goalDriftDetected";
     readonly sessionPaused: "sessionPaused";
     readonly sessionResumed: "sessionResumed";
     readonly sessionError: "sessionError";
@@ -37,6 +49,16 @@ export declare const AGENT_EVENTS: {
      * 一次 chat() 只触发一次，载荷带 roundId 溯源。
      */
     readonly roundSummaryGenerated: "roundSummaryGenerated";
+    /**
+     * 后台任务**自然终态**（`run_command` background 进程自己跑完 / 到点超时强杀）。
+     * 宿主据此推 UI 快照——脱管后 turn 已结束，宿主周期性推送（step_boundary /
+     * background_report）覆盖不到「turn 结束后任务自然跑完」，缺此事件 UI 会一直显示
+     * 假活跃的「运行中」。
+     * ⚠️ **主动 kill 不发本事件**：注册表 kill 刻意不回调（防结果双份消费）——
+     * UI 终止按钮路径由宿主 kill 后自行回拉快照；LLM 调 kill_command 后靠下一个
+     * step_boundary（若 turn 当场结束则无推送点，已登记边界，见后台任务跨轮存活方案）。
+     */
+    readonly backgroundTaskSettled: "backgroundTaskSettled";
 };
 /** 事件名联合类型（由 AGENT_EVENTS 推导，新增事件只需在此加一项） */
 export type AgentEventName = keyof typeof AGENT_EVENTS;
@@ -48,6 +70,9 @@ export interface AgentEventMap extends Record<AgentEventName, unknown> {
         id: string;
         source: string;
         name: string;
+        /** 记忆正文（5.0.0 起可选携带）：宿主「已沉淀」提示按用户心智显示内容而非 name 标识。
+         * 可选 = 跨 dist 契约：4.x 内核不发此字段，宿主须容错缺失回退 name（老数据 name 可读性有限）。 */
+        content?: string;
     };
     rolePackSwitched: {
         from: string | null;
@@ -56,28 +81,54 @@ export interface AgentEventMap extends Record<AgentEventName, unknown> {
     memoryRecalled: {
         count: number;
         query: string;
+        /** 命中明细（4.1.0 新增，MEM-EVENT-1）：三字段各有消费面（宿主 S3-1 可展开行渲染 + S3-3 反馈按 id 寻址）。
+         * 可选 = 跨 dist 契约：4.0.x 内核不发此字段，宿主须容错缺失降级为条数提示（类型层强制消费方容错）。
+         * 条数上限真源 = search_memories 的 parseLimit 钳制（50），载荷全量映射不截断（不另立截断常量）。 */
+        hits?: {
+            id: string;
+            name: string;
+            source: string;
+            /** 命中正文（5.0.0 起可选携带）：宿主命中明细按用户心智显示内容而非 name 标识。
+             * 可选 = 跨 dist 契约：4.x 内核 hits 元素无此字段，宿主须容错缺失回退 name。 */
+            contentPreview?: string;
+        }[];
+        /** 发起本次召回的 tool_call 唯一 ID（4.1.x 新增，MEM-EVENT-2）：宿主据此把命中明细挂回
+         * 对应 search_memories 工具折叠块，而非按轮次全局堆在回复体上方。
+         * 可选 = 跨 dist 契约 + 直调容错：老内核/测试直调 searchMemories 不带 ID，宿主须回退
+         * 「无配对目标 → 轮次级兜底落位」路径（类型层强制消费方容错）。
+         * 唯一来源 = toolExecutor.execute 的 toolCallId 形参（loop → toolRunner 已全程透传）。 */
+        toolCallId?: string;
     };
     sessionForked: {
         from: string;
         to: string;
         roundCount: number;
     };
-    projectSwitched: {
-        from: string | null;
-        to: string;
-        projectName: string;
+    /** date/session = 被切走的旧会话（归档对象）；fromSessionId/toSessionId = 旧/新完整会话标识 */
+    sessionSwitched: {
+        date: string;
+        session: string;
+        fromSessionId: string;
+        toSessionId: string;
     };
     archiveFailed: {
         stage: 'session';
         message: string;
     };
+    /** 会话归档写入成功载荷：sessionId = `${date}-${session}`；updatedFields = 实际落库字段（summary/keyTopics/autoName） */
+    sessionArchived: {
+        sessionId: string;
+        updatedFields: string[];
+    };
     contextTruncated: {
         skippedCount: number;
         keptCount: number;
     };
-    /** LLM 主动压缩完成载荷：压缩目标 + 被替换消息数 + 摘要长度 */
+    /** LLM 主动压缩完成载荷：压缩目标 + 被替换消息数 + 摘要长度
+     * ⚠️ target 类型**引用 loop 的 CompressTarget**（不另写字面量联合）——枚举增补时
+     * 本处自动跟随，禁在此复制一份（两份字面量 = 必然漂移）。 */
     contextCompressed: {
-        target: 'earliest_round' | 'largest_tool_result';
+        target: CompressTarget;
         replacedCount: number;
         summaryLength: number;
     };
@@ -96,10 +147,6 @@ export interface AgentEventMap extends Record<AgentEventName, unknown> {
         sourcePath: string;
         summary: string;
     };
-    dedupCompleted: {
-        deduplicatedCount: number;
-        demotedIds: string[];
-    };
     sessionPauseTimedOut: {
         sessionId: string;
         pauseDuration: number;
@@ -121,16 +168,6 @@ export interface AgentEventMap extends Record<AgentEventName, unknown> {
         hint: string;
     };
     questionPending: AskQuestion[];
-    goalDriftDetected: {
-        sessionId: string;
-        mainGoal: string;
-        newGoal: string;
-        similarity: number;
-        level: 'same' | 'confirm' | 'drift';
-        constraints: string[];
-        /** 原名 goalVersion，仅载荷不承担校验 */
-        goalChangeSeq: number;
-    };
     sessionPaused: {
         reason: string;
         source: string;
@@ -156,6 +193,22 @@ export interface AgentEventMap extends Record<AgentEventName, unknown> {
         roundId: string;
         success: boolean;
     };
+    /**
+     * 后台任务**自然终态**载荷：只读投影（与 `agent.listBackgroundTasks()` 的元素同形状）。
+     *
+     * ⚠️ **仅进程自行完成 / 超时发射**（status 类型即契约，running/killed 不可能出现）：
+     * 主动 kill 不发此事件——注册表 `kill()` 刻意不回调 completion listener，防同一份输出
+     * 被 `kill_command` 返回值与完成回流双份消费；kill 后的 UI 刷新走宿主 kill 处理路径
+     * 自行回推快照。
+     *
+     * 宿主只需 taskId 即可推全量快照，**刻意不携带输出**（命令输出体量可达 KB~MB，
+     * UI 不呈现——同 `BackgroundTaskView` 刻意不含 `result` 的口径）。
+     */
+    backgroundTaskSettled: {
+        taskId: string;
+        command: string;
+        status: BackgroundTaskNaturalStatus;
+    };
 }
 /** 事件处理器类型 */
 export type AgentEventHandler<T> = (event: T) => void;

package/dist/utils/eventEmitter.d.ts.map

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

package/dist/utils/eventEmitter.js

@@ -10,8 +10,20 @@ export const AGENT_EVENTS = {
     rolePackSwitched: 'rolePackSwitched',
     memoryRecalled: 'memoryRecalled',
     sessionForked: 'sessionForked',
-    projectSwitched: 'projectSwitched',
+    /**
+     * 会话身份切换完成（switchToSession 换会话成功后触发，载荷指向**被切走的旧会话**）。
+     * 内核自消费事件：agent 归档监听器据此对旧会话做会话级归档（summary/keyTopics 进
+     * SessionMeta 搜索索引）。宿主零消费 = 刻意设计（宿主是切换发起方，无增量信息），
+     * protocolGuard V-2 已登记 KERNEL_SELF_CONSUMED_EVENTS 豁免。
+     */
+    sessionSwitched: 'sessionSwitched',
     archiveFailed: 'archiveFailed',
+    /**
+     * 会话归档写入成功（updatedFields 非空才发，与 archiveFailed 对称）。
+     * 宿主据此重拉会话列表：切走时归档异步完成，列表快照若无此信号则条目摘要永不更新
+     * （悬停 tooltip 一直为空）。手动触发同样经 ArchiveCoordinator 发射。
+     */
+    sessionArchived: 'sessionArchived',
     contextTruncated: 'contextTruncated',
     /** LLM 主动压缩完成（第二级压缩，与 contextTruncated 的内核自动截断区分） */
     contextCompressed: 'contextCompressed',
@@ -19,7 +31,6 @@ export const AGENT_EVENTS = {
     archiveModeChanged: 'archiveModeChanged',
     rolePackSwitchLocked: 'rolePackSwitchLocked',
     workProjectionGenerated: 'workProjectionGenerated',
-    dedupCompleted: 'dedupCompleted',
     sessionPauseTimedOut: 'sessionPauseTimedOut',
     sessionResumeBlocked: 'sessionResumeBlocked',
     /** 订阅时宿主据此判断重要事件并 toast 提示 */
@@ -28,7 +39,6 @@ export const AGENT_EVENTS = {
     inputTooLarge: 'inputTooLarge',
     /** 回答中 LLM 调 ask_user 工具主动提问（唯一「提问后暂停」通道） */
     questionPending: 'questionPending',
-    goalDriftDetected: 'goalDriftDetected',
     sessionPaused: 'sessionPaused',
     sessionResumed: 'sessionResumed',
     sessionError: 'sessionError',
@@ -42,6 +52,16 @@ export const AGENT_EVENTS = {
      * 一次 chat() 只触发一次，载荷带 roundId 溯源。
      */
     roundSummaryGenerated: 'roundSummaryGenerated',
+    /**
+     * 后台任务**自然终态**（`run_command` background 进程自己跑完 / 到点超时强杀）。
+     * 宿主据此推 UI 快照——脱管后 turn 已结束，宿主周期性推送（step_boundary /
+     * background_report）覆盖不到「turn 结束后任务自然跑完」，缺此事件 UI 会一直显示
+     * 假活跃的「运行中」。
+     * ⚠️ **主动 kill 不发本事件**：注册表 kill 刻意不回调（防结果双份消费）——
+     * UI 终止按钮路径由宿主 kill 后自行回拉快照；LLM 调 kill_command 后靠下一个
+     * step_boundary（若 turn 当场结束则无推送点，已登记边界，见后台任务跨轮存活方案）。
+     */
+    backgroundTaskSettled: 'backgroundTaskSettled',
 };
 /** 运行时校验用集合（由 AGENT_EVENTS 派生） */
 export const AGENT_EVENT_SET = new Set(Object.values(AGENT_EVENTS));

package/dist/utils/eventEmitter.js.map

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

package/dist/utils/time.d.ts

@@ -1,13 +1,16 @@
 /**
  * 时间工具函数
  *
- * 从 messageHistory.ts 提取的公共时间格式化函数，
- * 消除跨模块 `new Date().toISOString()` 内联重复。
+ * 从 messageHistory.ts 提取的公共时间格式化函数，作用域 = **内核 `src/` 内部**。
  *
- * API 对齐：formatDateKey(date) 与精灵 shared/dateUtils.ts 语义一致，
+ * ⚠️ 「消除跨模块内联重复」不成立 —— `nowIso` **未**进 `src/index.ts` 公开导出面，
+ * 宿主拿不到它（实测宿主 `nowIso` 引用 = 0），宿主侧取当前时间仍是各自内联。
+ * 本文件只是内核内部的推荐入口，不是跨包单一真源。
+ *
+ * API 对齐（历史）：formatDateKey(date) 曾与精灵宿主 shared/dateUtils.ts 语义一致（该宿主已移除），
  * 用于格式化任意 Date 为 YYYY-MM-DD（本地时区）。
  */
-/** 一天对应的毫秒数（跨层共享，供天数差换算：诊断展示 daysSinceLastAccess / 推荐时效权重） */
+/** 一天对应的毫秒数（天数差换算基准；当前消费者 = 存储契约测试构造 purgeExpired 过期时间戳） */
 export declare const ONE_DAY_MS: number;
 /**
  * 获取当前时间的 ISO 8601 时间戳
@@ -22,7 +25,7 @@ export declare function nowIso(): string;
  * 修复场景：Asia/Shanghai 凌晨 00:00-08:00 期间 UTC 仍是前一天，导致按日期分组的
  * 计数（chatTurns / dailyMessageCount）写入错误的日期 key。
  *
- * 与精灵 shared/dateUtils.ts:formatDateKey 行为完全对齐。
+ * 历史对齐对象：精灵宿主 shared/dateUtils.ts:formatDateKey（该宿主已移除，现本函数为内核内唯一实现）。
  *
  * @param date Date 对象
  * @returns YYYY-MM-DD 字符串（本地日期）

package/dist/utils/time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAeD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAInF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4DAA4D;AAC5D,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAeD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAInF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/utils/time.js

@@ -1,13 +1,16 @@
 /**
  * 时间工具函数
  *
- * 从 messageHistory.ts 提取的公共时间格式化函数，
- * 消除跨模块 `new Date().toISOString()` 内联重复。
+ * 从 messageHistory.ts 提取的公共时间格式化函数，作用域 = **内核 `src/` 内部**。
  *
- * API 对齐：formatDateKey(date) 与精灵 shared/dateUtils.ts 语义一致，
+ * ⚠️ 「消除跨模块内联重复」不成立 —— `nowIso` **未**进 `src/index.ts` 公开导出面，
+ * 宿主拿不到它（实测宿主 `nowIso` 引用 = 0），宿主侧取当前时间仍是各自内联。
+ * 本文件只是内核内部的推荐入口，不是跨包单一真源。
+ *
+ * API 对齐（历史）：formatDateKey(date) 曾与精灵宿主 shared/dateUtils.ts 语义一致（该宿主已移除），
  * 用于格式化任意 Date 为 YYYY-MM-DD（本地时区）。
  */
-/** 一天对应的毫秒数（跨层共享，供天数差换算：诊断展示 daysSinceLastAccess / 推荐时效权重） */
+/** 一天对应的毫秒数（天数差换算基准；当前消费者 = 存储契约测试构造 purgeExpired 过期时间戳） */
 export const ONE_DAY_MS = 24 * 60 * 60 * 1000;
 /**
  * 获取当前时间的 ISO 8601 时间戳
@@ -24,7 +27,7 @@ export function nowIso() {
  * 修复场景：Asia/Shanghai 凌晨 00:00-08:00 期间 UTC 仍是前一天，导致按日期分组的
  * 计数（chatTurns / dailyMessageCount）写入错误的日期 key。
  *
- * 与精灵 shared/dateUtils.ts:formatDateKey 行为完全对齐。
+ * 历史对齐对象：精灵宿主 shared/dateUtils.ts:formatDateKey（该宿主已移除，现本函数为内核内唯一实现）。
  *
  * @param date Date 对象
  * @returns YYYY-MM-DD 字符串（本地日期）

package/dist/utils/time.js.map

@@ -1 +1 @@
-{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,8CAA8C;AAC9C,gEAAgE;AAChE,qDAAqD;AACrD,iEAAiE;AACjE,uDAAuD;AACvD,sDAAsD;AACtD,EAAE;AACF,wBAAwB;AACxB,qDAAqD;AACrD,oEAAoE;AACpE,0CAA0C;AAC1C,4BAA4B;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,8CAA8C;AAC9C,gEAAgE;AAChE,qDAAqD;AACrD,iEAAiE;AACjE,uDAAuD;AACvD,sDAAsD;AACtD,EAAE;AACF,wBAAwB;AACxB,qDAAqD;AACrD,oEAAoE;AACpE,0CAA0C;AAC1C,4BAA4B;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACtD,CAAC"}

package/dist/utils/toError.d.ts

@@ -4,7 +4,7 @@
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
  * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging/ 模块。
  *
- * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
+ * 转换规则（5 分支；历史对齐对象精灵宿主 shared/toError.ts 已随该宿主移除，现为内核内唯一实现）：
  *   1. Error 实例：原样返回
  *   2. 字符串：包装为 Error
  *   3. 含 message 属性的对象：提取 message 包装为 Error

package/dist/utils/toError.js

@@ -4,7 +4,7 @@
  * 将 catch 块中的 unknown 值安全转换为 Error 对象。
  * 从 errors.ts 中提取，确保浏览器端可直接 import 而不引入 logging/ 模块。
  *
- * 转换规则（5 分支，与精灵 shared/toError.ts 行为对齐）：
+ * 转换规则（5 分支；历史对齐对象精灵宿主 shared/toError.ts 已随该宿主移除，现为内核内唯一实现）：
  *   1. Error 实例：原样返回
  *   2. 字符串：包装为 Error
  *   3. 含 message 属性的对象：提取 message 包装为 Error

package/dist/web-fetch/loginWall.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 登录墙识别（SEARCH-QUALITY-1 P2-1）
+ *
+ * 问题：HTTP 200 的登录页被 `stripHtmlToText` 洗成「正文」——LLM 拿到一堆
+ * 「请登录 / 输入密码 / 注册新账号」的表单碎片，还以为是目标页面内容
+ * （「搜不准」的第二种形态：搜到了、也抓到了，但抓到的是一堵墙）。
+ *
+ * 判据（保守取向——**漏判 = 现状（可读页照常交付），误判 = 藏起可读页**，
+ * 故宁漏勿误，两条路径都要求「不像普通内容」才判墙）：
+ * 1. **URL 强信号**：host/path 的**段边界**命中 login/signin/logon/passport/sso
+ *    （段边界 = 段首/段尾由 `/` `.` `?` 或串首尾界定——防 `how-to-login`
+ *    教程、`mylogin` 之类词内子串误判；查询参数**值**里的 login 不算；
+ *    `#fragment` 先剥除——锚点是**页内位置**不是页面身份，`article#login` 是文章）。
+ *    只认重定向后的 finalUrl（`FetchedPage.url`）：带登录态参数的原始 URL
+ *    常常恰恰是要抓的页面，不能拿它判墙。
+ * 2. **弱信号组合**：标题登录词 **且** 正文密码词 **且** 正文很短
+ *    （< `LOGIN_WALL_MAX_CONTENT_CHARS`）——单标题命中放行（教程/文档页
+ *    常谈「如何登录」），三条件同时满足才判墙。
+ *    ⚠️ 长度判据只在**正文未被截断到阈值以下**时可信：调用方须传 `contentCap`
+ *    （本次抓取的截断上限），cap < 阈值时「短正文」可能是截断假象 → 弱信号禁用
+ *    （强信号不受影响——URL 身份与正文长短无关）。
+ *
+ * 纯函数：无 IO、零依赖，判据集中单点（toolExecutor web_fetch case 消费）。
+ * 命中后由调用方返回 hedged 提示（「可能」需登录——判据是启发式，不谎称确定）；
+ * 「这页是否抓取失败」不归本函数（调用方以 `FetchedPage.fetchFailed` 先行排除）。
+ */
+/**
+ * 判定抓取结果是否为登录墙（保守启发式，见文件头「宁漏勿误」）
+ *
+ * @param finalUrl 重定向后的实际 URL（`FetchedPage.url`；空串 = 无 URL 信息）
+ * @param title 页面标题（清洗后）
+ * @param content 页面正文（清洗后）
+ * @param contentCap 本次抓取的正文截断上限（toolExecutor 传 maxChars）：
+ *   小于弱信号阈值时「短正文」可能是截断假象 → 弱信号禁用（强信号照常）；
+ *   缺省 = 视为未截断（向后兼容既有调用形状）
+ * @returns true = 判为登录墙（调用方应明示不可读并引导换源）
+ */
+export declare function isLoginWallPage(finalUrl: string, title: string, content: string, contentCap?: number): boolean;
+//# sourceMappingURL=loginWall.d.ts.map

package/dist/web-fetch/loginWall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginWall.d.ts","sourceRoot":"","sources":["../../src/web-fetch/loginWall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA2BH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAoBT"}

package/dist/web-fetch/loginWall.js

@@ -0,0 +1,78 @@
+/**
+ * 登录墙识别（SEARCH-QUALITY-1 P2-1）
+ *
+ * 问题：HTTP 200 的登录页被 `stripHtmlToText` 洗成「正文」——LLM 拿到一堆
+ * 「请登录 / 输入密码 / 注册新账号」的表单碎片，还以为是目标页面内容
+ * （「搜不准」的第二种形态：搜到了、也抓到了，但抓到的是一堵墙）。
+ *
+ * 判据（保守取向——**漏判 = 现状（可读页照常交付），误判 = 藏起可读页**，
+ * 故宁漏勿误，两条路径都要求「不像普通内容」才判墙）：
+ * 1. **URL 强信号**：host/path 的**段边界**命中 login/signin/logon/passport/sso
+ *    （段边界 = 段首/段尾由 `/` `.` `?` 或串首尾界定——防 `how-to-login`
+ *    教程、`mylogin` 之类词内子串误判；查询参数**值**里的 login 不算；
+ *    `#fragment` 先剥除——锚点是**页内位置**不是页面身份，`article#login` 是文章）。
+ *    只认重定向后的 finalUrl（`FetchedPage.url`）：带登录态参数的原始 URL
+ *    常常恰恰是要抓的页面，不能拿它判墙。
+ * 2. **弱信号组合**：标题登录词 **且** 正文密码词 **且** 正文很短
+ *    （< `LOGIN_WALL_MAX_CONTENT_CHARS`）——单标题命中放行（教程/文档页
+ *    常谈「如何登录」），三条件同时满足才判墙。
+ *    ⚠️ 长度判据只在**正文未被截断到阈值以下**时可信：调用方须传 `contentCap`
+ *    （本次抓取的截断上限），cap < 阈值时「短正文」可能是截断假象 → 弱信号禁用
+ *    （强信号不受影响——URL 身份与正文长短无关）。
+ *
+ * 纯函数：无 IO、零依赖，判据集中单点（toolExecutor web_fetch case 消费）。
+ * 命中后由调用方返回 hedged 提示（「可能」需登录——判据是启发式，不谎称确定）；
+ * 「这页是否抓取失败」不归本函数（调用方以 `FetchedPage.fetchFailed` 先行排除）。
+ */
+/**
+ * URL 登录段（段边界匹配）
+ *
+ * 段界定符：串首 `^`、`/`、`.`、`?`、串尾 `$`（`#fragment` 在判定前已剥除——
+ * 锚点是页内位置不是页面身份，`article#login` 是文章不是登录页）。
+ * `-` 刻意**不在**界定符内——`how-to-login` / `sign-in-page` 这类连字符复合词
+ * 是教程页的高频形态，放行它们（漏判代价）优于误判（藏可读页）。
+ * `sign-in` 以显式 alternation 收录（它是登录墙的常见路径形态）。
+ */
+const URL_LOGIN_SEGMENT_RE = /(?:^|\/|\.|\?)(?:login|logon|signin|sign-in|passport|sso)(?:\/|\.|\?|$)/i;
+/** 标题登录词（中英；不含「密码」——谈密码的文章标题不应触发弱信号） */
+const TITLE_LOGIN_RE = /登录|登陆|登入|sign\s*in|log\s*in|logon/i;
+/** 正文密码词（登录表单/提示语特征） */
+const PASSWORD_WORD_RE = /密码|password|passcode/i;
+/**
+ * 弱信号组合的正文长度上限（字符）
+ *
+ * 登录墙表单页天然短（几个输入框 + 按钮）；长正文即使带登录词也更是教程/文档。
+ */
+const LOGIN_WALL_MAX_CONTENT_CHARS = 600;
+/**
+ * 判定抓取结果是否为登录墙（保守启发式，见文件头「宁漏勿误」）
+ *
+ * @param finalUrl 重定向后的实际 URL（`FetchedPage.url`；空串 = 无 URL 信息）
+ * @param title 页面标题（清洗后）
+ * @param content 页面正文（清洗后）
+ * @param contentCap 本次抓取的正文截断上限（toolExecutor 传 maxChars）：
+ *   小于弱信号阈值时「短正文」可能是截断假象 → 弱信号禁用（强信号照常）；
+ *   缺省 = 视为未截断（向后兼容既有调用形状）
+ * @returns true = 判为登录墙（调用方应明示不可读并引导换源）
+ */
+export function isLoginWallPage(finalUrl, title, content, contentCap) {
+    // 强信号：URL 段边界命中即判（不要求正文佐证——登录态 URL 抓到 200 就是墙）。
+    // 先剥 #fragment：锚点是页内位置不是页面身份（article#login 是文章）；
+    // split('#') 安全——合法 URL 中首个 # 即 fragment 起点（RFC 3986，查询串内 # 同义）
+    const urlWithoutFragment = finalUrl.split('#')[0] ?? finalUrl;
+    if (urlWithoutFragment && URL_LOGIN_SEGMENT_RE.test(urlWithoutFragment))
+        return true;
+    // 弱信号组合：标题登录词 + 正文密码词 + 短正文，三条件同时满足才判。
+    // contentCap < 阈值 → 长度判据失真（截断制造伪短正文）→ 整组禁用（宁漏勿误）
+    const weakSignalsUsable = contentCap === undefined || contentCap >= LOGIN_WALL_MAX_CONTENT_CHARS;
+    if (weakSignalsUsable &&
+        title &&
+        TITLE_LOGIN_RE.test(title) &&
+        content &&
+        PASSWORD_WORD_RE.test(content) &&
+        content.length < LOGIN_WALL_MAX_CONTENT_CHARS) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=loginWall.js.map

package/dist/web-fetch/loginWall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loginWall.js","sourceRoot":"","sources":["../../src/web-fetch/loginWall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GACxB,0EAA0E,CAAC;AAE7E,wCAAwC;AACxC,MAAM,cAAc,GAAG,oCAAoC,CAAC;AAE5D,wBAAwB;AACxB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,UAAmB;IAEnB,gDAAgD;IAChD,iDAAiD;IACjD,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAC9D,IAAI,kBAAkB,IAAI,oBAAoB,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,uCAAuC;IACvC,iDAAiD;IACjD,MAAM,iBAAiB,GAAG,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,4BAA4B,CAAC;IACjG,IACE,iBAAiB;QACjB,KAAK;QACL,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B,OAAO;QACP,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,CAAC,MAAM,GAAG,4BAA4B,EAC7C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/web-fetch/types.d.ts

@@ -13,6 +13,14 @@ export interface FetchedPage {
     content: string;
     /** 内容类型（如 "text/html"、"application/pdf"），无法识别时为空串 */
     contentType?: string;
+    /**
+     * 抓取失败降级页标记（safeFetch 专有；成功路径恒缺省，宿主自定义 provider 不打标）
+     *
+     * 值恒 `true`：只有降级页会置位，无人能置 false——「这不是一次成功抓取」是单向事实。
+     * 消费方（toolExecutor 登录墙判断）据此排除「抓取失败 + 登录段 URL 被误报为登录墙」
+     * 的谎报路径（失败语义不得改写成别的原因）。可选字段 = 契约放宽，向后兼容。
+     */
+    fetchFailed?: true;
 }
 /** 抓取选项 */
 export interface FetchOptions {

package/dist/web-fetch/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-fetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web-fetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClE"}

package/dist/web-fetch/webFetchProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webFetchProvider.d.ts","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtF;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAoBtB"}
+{"version":3,"file":"webFetchProvider.d.ts","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtF;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC,CAsBtB"}

package/dist/web-fetch/webFetchProvider.js

@@ -12,12 +12,14 @@ export async function safeFetch(provider, url, options) {
         return await Promise.race([provider.fetch(url, options), timeoutPromise]);
     }
     catch (err) {
-        // 抓取失败不抛异常，返回降级提示页
+        // 抓取失败不抛异常，返回降级提示页；fetchFailed 单向标记 = 「这不是一次成功抓取」，
+        // 供消费方（toolExecutor 登录墙判断）排除「失败被误报为登录墙」的谎报路径
         const message = err instanceof Error ? err.message : String(err);
         return {
             url,
             title: '网页抓取暂不可用',
             content: `抓取失败：${message}。请稍后重试，或检查网络连接。`,
+            fetchFailed: true,
         };
     }
     finally {

package/dist/web-fetch/webFetchProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"webFetchProvider.js","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAMA,mBAAmB;AACnB,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAwB,EACxB,GAAW,EACX,OAAsB;IAEtB,IAAI,KAAgD,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAc,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC5D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mBAAmB;QACnB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,GAAG;YACH,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,QAAQ,OAAO,iBAAiB;SAC1C,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"webFetchProvider.js","sourceRoot":"","sources":["../../src/web-fetch/webFetchProvider.ts"],"names":[],"mappings":"AAMA,mBAAmB;AACnB,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAwB,EACxB,GAAW,EACX,OAAsB;IAEtB,IAAI,KAAgD,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAc,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC5D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mDAAmD;QACnD,6CAA6C;QAC7C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,GAAG;YACH,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,QAAQ,OAAO,iBAAiB;YACzC,WAAW,EAAE,IAAI;SAClB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/web-search/fetchWebSearchProvider.js

@@ -2,34 +2,39 @@ import { BROWSER_UA, fetchWithTimeout } from '../utils/http.js';
 /** 单端点请求超时（ms）：Bing 通常 1-2s 返回，10s 覆盖慢网络且不至于拖死主循环 */
 const ENDPOINT_TIMEOUT_MS = 10_000;
 /**
- * 从 Bing 结果页 HTML 提取结果：标题+链接在 <h2><a>，摘要在 <p class="b_lineclamp*">。
+ * 从 Bing 结果页 HTML 提取结果：结果条目 = `<li class="b_algo">` 块，块内 `<h2><a>` 取
+ * 标题+链接、块内 `<p class="b_lineclamp*">` 取摘要。
  * 用正则而非 DOM 解析，避免引入 jsdom 依赖。
+ *
+ * **块内配对**（而非全文两个正则数组按 index 配对，SEARCH-QUALITY-1 P2-2 修订）：
+ * 标题与摘要必须在同一结果块内成对——全文收集 `titles[]`/`snippets[]` 后按 index 配对时，
+ * 结果块之外的任何 `b_lineclamp`（推荐位/广告位/侧栏）都会造成错位：模块摘要被贴到
+ * 下一个结果标题上，LLM 读到「标题二 + 干扰摘要」的错位组合（搜不准的解析层根因）。
+ * 结构漂移（无 b_algo 块）→ 零结果 → 降级链切下一端点 = 诚实失败，不产错位垃圾。
+ * 块内提取范式同 parseBaiduHtml（仓内既有正确先例，嫁接而非新造）。
  */
 function parseBingHtml(html, limit) {
     const results = [];
-    const titleRegex = /<h2[^>]*><a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a><\/h2>/g;
-    const snippetRegex = /<p[^>]*class="b_lineclamp[^"]*"[^>]*>([\s\S]*?)<\/p>/g;
-    const titles = [];
+    // 结果块：<li …b_algo…>…</li>（[^>]* 容忍附加 class/属性，如 b_algoBorder）。
+    // ⚠️ 正则内**禁写引号**（如 class="[^"]*b_algo…）：toolFailurePrefixGuard 的字符串字面量
+    // 提取器会把正则内的引号配对成伪字面量（`[^` → 盲区标记 `^`，旧 `^>` 同源产物）——
+    // 无引号写法对 Bing 的 <li class="b_algo"> 同等正确且不新增扫描噪声。
+    const blockRegex = /<li[^>]*b_algo[^>]*>([\s\S]*?)<\/li>/gi;
     let match;
-    while ((match = titleRegex.exec(html)) !== null && titles.length < limit) {
-        const url = match[1].replace(/&amp;/g, '&').trim();
-        const title = match[2].replace(/<[^>]*>/g, '').trim();
-        if (title && url) {
-            titles.push({ url, title });
-        }
-    }
-    const snippets = [];
-    while ((match = snippetRegex.exec(html)) !== null && snippets.length < limit) {
-        const snippet = match[1].replace(/<[^>]*>/g, '').trim();
-        if (snippet)
-            snippets.push(snippet);
-    }
-    for (let i = 0; i < Math.min(titles.length, limit); i++) {
-        results.push({
-            title: titles[i].title,
-            url: titles[i].url,
-            snippet: snippets[i] ?? '',
-        });
+    while ((match = blockRegex.exec(html)) !== null && results.length < limit) {
+        const block = match[1];
+        // 标题 + 链接：块内 <h2><a href>（块内无标题 = 非结果块，跳过不占结果位）
+        const titleMatch = /<h2[^>]*><a[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/i.exec(block);
+        if (!titleMatch)
+            continue;
+        const url = titleMatch[1].replace(/&amp;/g, '&').trim();
+        const title = titleMatch[2].replace(/<[^>]*>/g, '').trim();
+        if (!url || !title)
+            continue;
+        // 摘要：块内 <p class="b_lineclamp*>（块内无摘要 → 空串，不跨块借用）
+        const snipMatch = /<p[^>]*class="b_lineclamp[^"]*"[^>]*>([\s\S]*?)<\/p>/i.exec(block);
+        const snippet = snipMatch?.[1]?.replace(/<[^>]*>/g, '').trim() ?? '';
+        results.push({ title, url, snippet });
     }
     return results;
 }